목차
생성자
속성
메서드
- addScore
- createCall
- finishCall
- finishCallWithException
- get
- getAgentCustomAttributes
- getAgentSpanStats
- getAgentSpans
- getAgentTurn
- getAgentTurns
- getAgentVersions
- getAgents
- getCall
- getCallStack
- getCalls
- getCallsIterator
- getCurrentAttributes
- linkPromptToRegistry
- publish
- pushNewCall
- runWithAttributes
- runWithCallStack
- saveCallEnd
- saveCallStart
- saveOp
- searchAgents
- serializeAudio
- updateCall
- waitForBatchProcessing
생성자
생성자
«destructured»): WeaveClient
매개변수
| 이름 | 유형 |
|---|---|
«destructured» | 객체 |
› projectId | string |
› settings? | Partial<Settings> |
› traceServerApi | Api<any> |
반환값
WeaveClient
정의된 위치
속성
projectId
string
정의된 위치
settings
Settings
정의된 위치
traceServerApi
Api<any>
정의된 위치
메서드
addScore
predictCallId, scorerCallId, runnableRefUri, scorerOutput): Promise<string>
call에 scorer 결과(예: scorer 출력)를 추가합니다.
명령형 평가에서 scorer 결과를 predict call에 연결할 때 사용됩니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
predictCallId | string | 피드백을 연결할 predict call의 ID |
scorerCallId | string | 피드백을 생성한 scorer call의 ID |
runnableRefUri | string | scorer의 URI(Op 또는 Object ref) |
scorerOutput | any | scorer의 출력값 |
반환값
Promise<string>
정의된 위치
createCall
internalCall, opRef, params, parameterNames, thisArg, currentCall, parentCall, startTime, displayName?, attributes?): Promise<void>
매개변수
| 이름 | 유형 | |
|---|---|---|
internalCall | InternalCall | |
opRef | any | |
params | any[] | |
parameterNames | ParameterNamesOption | |
thisArg | any | |
currentCall | CallStackEntry | |
parentCall | undefined | CallStackEntry |
startTime | Date | |
displayName? | string | |
attributes? | Record<string, any> |
반환값
Promise<void>
정의된 위치
finishCall
call, result, currentCall, parentCall, summarize, endTime, startCallPromise): Promise<void>
매개변수
| 이름 | 유형 | |
|---|---|---|
call | InternalCall | |
result | any | |
currentCall | CallStackEntry | |
parentCall | undefined | CallStackEntry |
summarize | undefined | (result: any) => Record<string, any> |
endTime | Date | |
startCallPromise | Promise<void> |
반환값
Promise<void>
정의된 위치
finishCallWithException
call, error, currentCall, parentCall, endTime, startCallPromise): Promise<void>
매개변수
| 이름 | 유형 | |
|---|---|---|
call | InternalCall | |
error | any | |
currentCall | CallStackEntry | |
parentCall | undefined | CallStackEntry |
endTime | Date | |
startCallPromise | Promise<void> |
반환값
Promise<void>
정의된 위치
get
ref): Promise<any>
매개변수
| 이름 | 유형 |
|---|---|
ref | ObjectRef |
반환값
Promise<any>
정의된 위치
getAgentCustomAttributes
options): Promise<Response<GetAgentCustomAttributesResult>>
프로젝트의 에이전트 span에서 관찰된 유형 지정 맞춤형 속성 키를 조회합니다. 각 결과 행은 (source, key, value_type) 트리플 하나와 해당 값을 가진 span 수로 구성되며, spans query/group/stats API는 이 정보를 사용해 맞춤형 속성을 참조합니다.
고려할 span을 필터링하려면 query(구조화된 span 필터), startedAfter / startedBefore(ISO-8601), 또는 둘 다를 전달하세요. 발견된 키를 페이지별로 보려면 limit / offset을 사용하세요.
매개변수
| 이름 | 유형 |
|---|---|
options | GetAgentCustomAttributesOptions |
반환값
Promise<Response<GetAgentCustomAttributesResult>>
예시
정의된 위치
getAgentSpanStats
options): Promise<Response<GetAgentSpanStatsResult>>
프로젝트의 에이전트 spans를 집계하며, 시계열 / 버킷 기반 시각화에 적합한 행 + 열 메타데이터 형태로 반환합니다.
start(필수)와 end는 시간 범위를 정의합니다. metrics의 각 항목은
추출할 필드와 집계 방식(sum,
avg, count, 백분위수 등)을 지정합니다. granularity(초)를 전달하면
행을 시간 기준으로 버킷화하고, groupBy를 전달하면 결과를 에이전트 /
공급자 / 모델 / 기타 기준별로 나눌 수 있습니다. query는 집계 전에
기본 spans를 필터링합니다.
매개변수
| 이름 | 유형 |
|---|---|
options | GetAgentSpanStatsOptions |
반환값
Promise<Response<GetAgentSpanStatsResult>>
예시
정의된 위치
getAgentSpans
options): Promise<Response<GetAgentSpansResult>>
에이전트 이름 및/또는 Mongo 스타일
쿼리 표현식으로 선택적으로 필터링하여 에이전트 span을 조회합니다.
매개변수
| 이름 | 유형 |
|---|---|
options | GetAgentSpansOptions |
반환값
Promise<Response<GetAgentSpansResult>>
예시
예시
정의된 위치
getAgentTurn
options): Promise<Response<AgentTraceChatRes>>
traceId를 기준으로 단일 턴의 데이터(메시지 포함)를 조회합니다.
매개변수
| 이름 | 유형 |
|---|---|
options | GetAgentTurnOptions |
반환값
Promise<Response<AgentTraceChatRes>>
예시
정의된 위치
getAgentTurns
options): Promise<Response<GetAgentTurnsResult>>
conversationId를 기준으로 여러 턴의 데이터(메시지 포함)를 조회합니다.
매개변수
| 이름 | 유형 |
|---|---|
options | GetAgentTurnsOptions |
반환값
Promise<Response<GetAgentTurnsResult>>
예시
정의된 위치
getAgentVersions
options): Promise<Response<GetAgentVersionsResult>>
특정 에이전트의 버전 목록을 조회합니다.
매개변수
| 이름 | 유형 |
|---|---|
options | GetAgentVersionsOptions |
반환값
Promise<Response<GetAgentVersionsResult>>
예시
정의된 위치
getAgents
options?): Promise<Response<GetAgentsResult>>
집계 통계가 포함된 에이전트 목록을 조회합니다.
매개변수
| 이름 | 유형 |
|---|---|
options | GetAgentsOptions |
반환값
Promise<Response<GetAgentsResult>>
예시
정의된 위치
getCall
callId, includeCosts?): Promise<Call>
매개변수
| 이름 | 유형 | 기본값 |
|---|---|---|
callId | string | undefined |
includeCosts | boolean | false |
반환값
Promise<Call>
정의된 위치
getCallStack
CallStack
반환값
CallStack
정의된 위치
getCalls
options?): Promise<Call[]>
매개변수
| 이름 | 유형 |
|---|---|
options? | GetCallsOptions |
반환값
Promise<Call[]>
정의된 위치
options?, includeCosts?, limit?): Promise<Call[]>
매개변수
| 이름 | 유형 |
|---|---|
options? | CallsFilter |
includeCosts? | boolean |
limit? | number |
반환값
Promise<Call[]>
정의된 위치
getCallsIterator
options?, includeCosts?, limit?): AsyncIterableIterator<CallSchema, any, any>
매개변수
| 이름 | 유형 |
|---|---|
options? | CallsFilter |
includeCosts? | boolean |
limit? | number |
반환값
AsyncIterableIterator<CallSchema, any, any>
정의된 위치
options?): AsyncIterableIterator<CallSchema, any, any>
매개변수
| 이름 | 유형 |
|---|---|
options? | GetCallsOptions |
반환값
AsyncIterableIterator<CallSchema, any, any>
정의된 위치
getCurrentAttributes
Record<string, any>
반환값
Record<string, any>
정의된 위치
linkPromptToRegistry
prompt, options): Promise<LinkAssetToRegistryRes>
게시된 프롬프트 버전을 레지스트리 포트폴리오에 연결합니다.
매개변수
| 이름 | 유형 |
|---|---|
prompt | RegistryLinkable |
options | LinkPromptToRegistryOptions |
반환값
Promise<LinkAssetToRegistryRes>
정의된 위치
publish
obj, objId?): Promise<ObjectRef>
매개변수
| 이름 | 유형 |
|---|---|
obj | any |
objId? | string |
반환값
Promise<ObjectRef>
정의된 위치
pushNewCall
객체
반환값
객체
| 이름 | 유형 |
|---|---|
currentCall | CallStackEntry |
newStack | CallStack |
parentCall? | CallStackEntry |
정의된 위치
runWithAttributes
T>(attributes, fn): T
유형 매개변수
| 이름 |
|---|
T |
매개변수
| 이름 | 유형 |
|---|---|
attributes | Record<string, any> |
fn | () => T |
반환값
T
정의된 위치
runWithCallStack
T>(callStack, fn): T
유형 매개변수
| 이름 |
|---|
T |
매개변수
| 이름 | 유형 |
|---|---|
callStack | CallStack |
fn | () => T |
반환값
T
정의된 위치
saveCallEnd
callEnd): void
파라미터
| 이름 | 유형 |
|---|---|
callEnd | EndedCallSchemaForInsert |
반환값
void
정의된 위치
saveCallStart
callStart): void
파라미터
| 이름 | 유형 |
|---|---|
callStart | StartedCallSchemaForInsert |
반환값
void
정의된 위치
saveOp
op, objId?): Promise<OpRef>
매개변수
| 이름 | 유형 |
|---|---|
op | Op<(…args: any[]) => any> |
objId? | string |
반환값
Promise<OpRef>
정의된 위치
searchAgents
options): Promise<Response<SearchAgentsResult>>
프로젝트 내 에이전트 메시지 전체에서 전문 검색을 수행합니다. 일치 항목은 대화별로
그룹화되어 반환되며, 각 일치 메시지의 미리보기도 함께 제공됩니다.
query는 전문 검색어입니다. 빈 string을 전달하면 텍스트 일치 없이 구조화된 필터
(agentName, conversationId, traceId)에 일치하는 모든 메시지를 가져옵니다. limit /
offset을 사용해 결과를 페이지별로 확인하세요.
매개변수
| 이름 | 유형 |
|---|---|
options | SearchAgentsOptions |
반환값
Promise<Response<SearchAgentsResult>>
예시
정의된 위치
serializeAudio
data, audioType?): Promise<SerializedFileBlob>
원시 오디오 바이트를 Weave 콘텐츠 저장소에 업로드하고,
call 출력에 포함할 수 있는 CustomWeaveType 플레이스홀더를 반환합니다.
finishCall의 자동 직렬화 파이프라인을 사용하지 않는 경우
(예: saveCallEnd를 통해) call 출력을 수동으로 구축할 때 사용하세요.
매개변수
| 이름 | 유형 | 기본값 | 설명 |
|---|---|---|---|
data | Buffer<ArrayBufferLike> | undefined | 원시 오디오 바이트(WAV 형식이 브라우저 호환성에 가장 좋음) |
audioType | "wav" | DEFAULT_AUDIO_TYPE | 파일 형식 — 현재는 ‘wav’만 지원됩니다 |
반환값
Promise<SerializedFileBlob>
정의된 위치
updateCall
callId, displayName): Promise<void>
매개변수
| 이름 | 유형 |
|---|---|
callId | string |
displayName | string |
반환값
Promise<void>
정의된 위치
waitForBatchProcessing
Promise<void>
반환값
Promise<void>