도구 - Weights & Biases Documentation

도구 호출입니다. 도구 이름, JSON으로 인코딩된 인수, 도구 호출 ID 및 결과를 포함하는 execute_tool span을 생성합니다. weave.startTool()(turn.startTool() 또는 llm.startTool())로 생성하고 end()로 종료합니다. span에 도구 출력을 기록하려면 end()를 호출하기 전에 result를 부여하세요. 정의 위치: src/genai/tool.ts:43

예시

const tool = weave.startTool({
  name: tc.function.name,
  args: tc.function.arguments,
  toolCallId: tc.id,
});
try {
  tool.result = await wikipediaSearch(JSON.parse(tc.function.arguments));
} finally {
  tool.end();
}

상속

SpanBase

속성

args

readonly args: string

정의 위치: src/genai/tool.ts:52

name

readonly name: string

정의 위치: src/genai/tool.ts:51

result

선택 result: string

문자열 형식의 도구 출력입니다. end() 호출 시 gen_ai.tool.call.result에 기록됩니다. 정의 위치: src/genai/tool.ts:47

toolCallId

readonly toolCallId: string

정의 위치: src/genai/tool.ts:53

메서드

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와 동일하게 동작합니다. 정의 위치: src/genai/spanBase.ts:82

매개변수

이름

string

속성?

Attributes

startTime?

TimeInput

반환값

this

예시

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

상속됨

SpanBase.addEvent

end()

end(opts?): void

result를 span에 플러시하고 종료합니다. 여러 번 호출해도 동일하게 동작합니다. span을 실패로 표시하려면 error를 전달하고, 종료 시점을 과거로 설정하려면 endTime을 전달하세요. 정의 위치: src/genai/tool.ts:87

매개변수

opts?

SpanEndOptions

반환값

void

setAttributes()

setAttributes(attributes): this

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

매개변수

속성

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()

매개변수

이름

속성?

startTime?

반환값

예시

상속됨

end()

매개변수

opts?

반환값

setAttributes()

매개변수

속성

반환값

예시

상속됨

​예시

​상속

​속성

​args

​name

​result

​toolCallId

​메서드

​addEvent()

​매개변수

이름

속성?

startTime?

​반환값

​예시

​상속됨

​end()

​매개변수

opts?

​반환값

​setAttributes()

​매개변수

속성

​반환값

​예시

​상속됨

예시

상속

속성

args

name

result

toolCallId

메서드

addEvent()

매개변수

반환값

예시

상속됨

end()

매개변수

반환값

setAttributes()

매개변수

반환값

예시

상속됨