Call 스키마 레퍼런스

이 레퍼런스에서는 W&B Weave의 Call 객체 스키마를 설명합니다. Call의 속성, 실행 중에 summary 딕셔너리에 맞춤형 데이터를 기록하는 방법, Call이 완료된 후 summary 데이터를 조회하는 방법을 다룹니다. Weave가 각 Call에 대해 기록하는 데이터를 검사, 필터링 또는 확장하려면 이 페이지를 참고하세요. Call 쿼리에 대한 자세한 내용은 Call 쿼리 및 내보내기를 참조하세요.

Call 속성

다음 표는 Weave에서 Call의 주요 속성을 정리한 것입니다. 전체 구현은 다음을 참조하세요.

Python SDK의 class: CallSchema
TypeScript SDK의 Interface: CallSchema

속성	유형	설명
`id`	string (uuid)	Call의 고유 식별자
`project_id`	string (optional)	연결된 프로젝트의 식별자
`op_name`	string	오퍼레이션 이름(레퍼런스일 수 있음)
`display_name`	string (optional)	Call의 표시 이름
`trace_id`	string (uuid)	이 Call이 속한 트레이스의 식별자
`parent_id`	string (uuid)	부모 Call의 식별자
`started_at`	datetime	Call 시작 타임스탬프
`attributes`	Dict[str, Any]	Call에 대한 사용자 정의 메타데이터 (실행 중에는 읽기 전용)
`inputs`	Dict[str, Any]	Call의 입력 매개변수
`ended_at`	datetime (optional)	Call 종료 타임스탬프
`exception`	string (optional)	Call이 실패한 경우의 오류 메시지
`output`	Any (optional)	Call의 결과
`summary`	Optional[SummaryMap]	실행 후 summary 정보입니다. 실행 중에 이 값을 수정해 커스텀 메트릭을 기록할 수 있습니다.
`wb_user_id`	Optional[str]	연결된 W&B 사용자 ID
`wb_run_id`	Optional[str]	연결된 W&B Run ID
`deleted_at`	datetime (optional)	Call 삭제 타임스탬프(해당하는 경우)

속성 세부 정보

CallSchema 속성을 사용하면 Call을 추적하고 관리할 수 있습니다.

id, trace_id, parent_id 속성은 시스템 내에서 Call을 정리하고 서로 연관 짓는 데 사용됩니다.
타이밍 정보(started_at, ended_at)를 활용해 성능을 분석할 수 있습니다.
attributes 및 inputs 속성은 Call의 컨텍스트를 제공합니다. Attributes는 Call이 시작되면 고정되므로, 호출하기 전에 weave.attributes() 컨텍스트 매니저로 설정하세요. output 및 summary는 결과를 캡처합니다.
wb_user_id 및 wb_run_id를 사용하여 Call을 W&B 사용자 및 run에 연결하세요.

이러한 속성을 함께 활용하면 프로젝트 전반에서 Call을 상세하게 추적하고 분석할 수 있습니다.

Call summary 사용하기

summary 속성을 사용하면 실행 후 생성된 맞춤형 데이터를 Call에 첨부해 두었다가 나중에 Weave의 기본 제공 메트릭과 함께 분석할 수 있습니다. 이 속성은 Call이 실행되는 동안 값을 기록할 수 있는 딕셔너리입니다. Call이 종료되면 Weave는 사용자가 기록한 값을 자체 계산 데이터와 딥 병합(deep-merge)한 뒤 그 결과를 저장합니다. 이 딕셔너리는 두 영역으로 나뉩니다.

맞춤형 키: call.summary["accuracy"] = 0.95처럼 call.summary에 직접 기록하는 모든 값입니다. 이 값은 summary 딕셔너리의 최상위 수준에 저장됩니다.
summary["weave"]: Call이 완료될 때 Weave가 자동으로 채우는 예약된 namespace입니다. 이 키에는 직접 값을 기록하지 마세요.

또한 Weave는 모델 응답에 포함된 원시 LLM 토큰 수를 summary["usage"]에 캡처합니다(모델 이름별로 키가 지정됨). 이 값은 공급자가 제공한 원본 데이터를 그대로 전달한 것으로, Weave가 계산한 값이 아닙니다. 반면 summary["weave"] 내부의 costs 필드는 Weave가 이 사용 데이터와 토큰 가격을 바탕으로 산출한 값입니다. summary["weave"] 내부에서 Weave가 계산하는 필드는 다음과 같습니다.

필드	설명
`status`	실행 상태로, `SUCCESS`, `ERROR`, `RUNNING`, `DESCENDANT_ERROR`(Call 자체는 성공했지만 하위 Call에서 오류가 발생한 경우) 중 하나입니다.
`latency_ms`	`started_at`부터 `ended_at`까지의 소요 시간(밀리초)입니다. `status`가 `RUNNING`이면 `null`입니다.
`costs`	`summary["usage"]`와 토큰 가격 데이터를 바탕으로 산출한 모델별 비용 내역입니다. 자세한 내용은 비용 추적을 참조하세요.
`trace_name`	내부 Op 레퍼런스 URI를 파싱해 얻은, 사람이 읽기 쉬운 Op 이름입니다. 화면 표시 및 필터링에 사용됩니다.

Call 실행 중에 쓰기

summary 딕셔너리를 사용하면 Call 실행 중에 맞춤형 데이터 값을 추가할 수 있습니다.

Python
TypeScript

Python에서는 weave.get_current_call()을 사용해 실행 중 언제든지 call.summary에 값을 부여할 수 있습니다.

import weave

@weave.op()
def my_op(x):
    result = do_work(x)
    call = weave.get_current_call()
    # summary에 맞춤형 데이터 값을 추가합니다.
    call.summary["accuracy"] = 0.95
    call.summary["num_retries"] = 2
    return result

TypeScript에서는 op()의 옵션으로 summarize 함수를 전달하세요. 이 함수는 최종 결과를 받아 Call이 완료될 때 summary 데이터를 반환합니다.

const myOp = weave.op(
  async (x: any) => {
    const result = await doWork(x);
    return result;
  },
  {
    name: 'my_op',
    summarize: (result) => ({
      accuracy: result.accuracy,
      numRetries: result.numRetries,
    }),
  }
);

summary 데이터 조회

ID로 단일 Call을 가져오려면 getCall을, 여러 Call을 가져오려면 getCalls를 사용하세요. 어느 쪽이든 summary는 동일한 병합 딕셔너리입니다.

Python
TypeScript

import weave
client = weave.init("my-team/my-project")

# ID로 단일 Call을 가져옵니다.
call = client.get_call("[CALL-ID]")
weave_summary = (call.summary or {}).get("weave", {})

print(weave_summary.get("status"))       # TraceStatus 열거형: SUCCESS, ERROR, RUNNING 또는 DESCENDANT_ERROR.
print(weave_summary.get("latency_ms"))   # Call이 아직 실행 중이면 Null입니다.
print(weave_summary.get("costs"))        # 모델별 비용 내역.
print(call.summary.get("usage"))         # LLM 공급자가 반환한 원시 토큰 수.
print(call.summary.get("accuracy"))      # 사용자가 정의한 맞춤형 필드.

# 서버 측 필터링으로 여러 Call을 순회합니다.
for call in client.get_calls(filter={"op_names": ["weave:///my-team/my-project/op/my_op:*"]}):
    s = call.summary or {}
    weave_s = s.get("weave", {})
    print(call.id, weave_s.get("status"), weave_s.get("latency_ms"), s.get("accuracy"))

import * as weave from 'weave';
const client = await weave.init('my-team/my-project');

// ID로 단일 Call을 가져옵니다.
const call = await client.getCall('[CALL-ID]');
const weaveSummary = call.summary?.weave;

console.log(weaveSummary?.status);       // "success", "error", "running" 또는 "descendant_error".
console.log(weaveSummary?.latency_ms);   // Call이 아직 실행 중이면 Undefined입니다.
console.log(weaveSummary?.costs);        // 모델별 비용 내역.
console.log(call.summary?.usage);        // LLM 공급자가 반환한 원시 토큰 수.
console.log(call.summary?.accuracy);     // 사용자가 정의한 맞춤형 필드.

// 서버 측 필터링으로 여러 Call을 가져옵니다.
const calls = await client.getCalls({ filter: { op_names: ['weave:///my-team/my-project/op/my_op:*'] } });
for (const call of calls) {
  const weaveS = call.summary?.weave;
  console.log(call.id, weaveS?.status, weaveS?.latency_ms, call.summary?.accuracy);
}

​Call 속성

​속성 세부 정보

​Call summary 사용하기

​Call 실행 중에 쓰기

​summary 데이터 조회

Call 속성

속성 세부 정보

Call summary 사용하기

Call 실행 중에 쓰기

summary 데이터 조회