Tool

도구 호출입니다. 도구 이름, 인수, 도구 호출 id, 결과를 담은 execute_tool span을 생성합니다. string 인수와 결과는 그대로 기록되며, 그 외의 JSON 값은 직렬화됩니다. weave.startTool()(또는 turn.startTool(), llm.startTool())로 생성되며, 결과와 선택적 오류 메타데이터를 받는 end()로 종료됩니다.

예시

const tool = weave.startTool({name: 'get_weather', args: {city: 'Tokyo'}});
try {
  const result = await getWeather('Tokyo');
  tool.end({result});
} catch (error) {
  tool.end({error: error as Error, errorType: 'weather_error'});
  throw error;
}

상속

SpanBase

속성

args

readonly args: string

name

readonly name: string

result

사용 중단. 대신 result를 end()에 전달하세요.

선택 result: string

string 형식의 도구 출력입니다. result는 end()에 전달하는 방식을 사용하세요.

toolCallId

readonly toolCallId: string

메서드

addEvent()

사용 중단. 대신 setAttributes로 이 데이터를 기록하세요. OpenTelemetry는 Span Event API(Span.addEvent)를 단계적으로 폐지하고 있습니다. 이 방법은 계속 작동하며 기존 span-event 데이터도 유효합니다. https://opentelemetry.io/blog/2026/deprecating-span-events/를 참조하세요.

addEvent(name, attributes?, startTime?): this

span에 이름이 지정된 이벤트를 추가합니다. 컨텍스트 압축, 도구 루프 감지 또는 가드레일 위반과 같이 span이 아닌 시점을 표시할 때 유용합니다. end() 호출 후에는 경고를 표시하고 아무 작업도 수행하지 않습니다. OTel Span.addEvent와 동일하게 동작합니다.

매개변수

string

필수

Attributes

TimeInput

반환값

this

예시

span.addEvent('context_compacted', {removedMessages: 12});

상속됨

SpanBase.addEvent

end()

end(opts?): void

선택적으로 결과와 오류 유형을 기록한 뒤 span을 종료합니다. 여러 번 호출해도 동일하게 동작합니다. span을 실패로 표시하려면 error를, 종료 시점을 과거로 설정하려면 endTime을 전달하세요.

매개변수

ToolEndOptions

ToolEndOptions를 참조하세요.

반환값

void

setAttributes()

setAttributes(attributes): this

span에 여러 속성을 한 번에 설정합니다. end() 호출 후에는 경고를 표시하고 아무 작업도 수행하지 않습니다. OTel Span.setAttributes 및 Python SDK의 set_attributes와 동일하게 동작합니다.

매개변수

Attributes

필수

반환값

this

예시

span.setAttributes({'weave.tag': 'prod', 'gen_ai.response.id': id});

상속됨

SpanBase.setAttributes

W&B Models

W&B Weave

Serverless Inference

Serverless Training

예시

상속

속성

args

name

result

toolCallId

메서드

addEvent()

매개변수

반환값

예시

상속됨

end()

매개변수

반환값

setAttributes()

매개변수

반환값

예시

상속됨

​예시

​상속

​속성

​args

​name

​result

​toolCallId

​메서드

​addEvent()

​매개변수

​반환값

​예시

​상속됨

​end()

​매개변수

​반환값

​setAttributes()

​매개변수

​반환값

​예시

​상속됨

예시

상속

속성

args

name

result

toolCallId

메서드

addEvent()

매개변수

반환값

예시

상속됨

end()

매개변수

반환값

setAttributes()

매개변수

반환값

예시

상속됨