메인 콘텐츠로 건너뛰기
weave / Tool 도구 호출입니다. 도구 이름, JSON으로 인코딩된 인수, 도구 호출 ID, 결과를 포함하는 execute_tool span을 생성합니다. weave.startTool()(또는 turn.startTool(), 또는 llm.startTool())로 생성되며 end()로 종료됩니다. span에 도구의 출력을 기록하려면 end()를 호출하기 전에 result에 값을 부여하세요. 예시
const  = weave.startTool({
  : tc.function.name,
  : tc.function.arguments,
  : tc.id,
});
try {
  .result = await wikipediaSearch(.(tc.function.arguments));
} finally {
  .end();
}

계층 구조

  • SpanBase Tool

목차

속성

방법

속성

args

Readonly args: string

정의 위치

src/genai/tool.ts:52

name

Readonly name: string

정의 위치

src/genai/tool.ts:51

result

선택 result: string 도구의 출력을 string으로 나타낸 값입니다. end()에서 gen_ai.tool.call.result에 기록됩니다.

정의 위치

src/genai/tool.ts:47

toolCallId

Readonly toolCallId: string

정의 위치

src/genai/tool.ts:53

방법

addEvent

addEvent(name, attributes?, startTime?): this span에 이름이 지정된 event를 추가합니다. 컨텍스트 압축, 도구 루프 감지, 또는 가드레일 트리거처럼 span이 아닌 시점을 표시할 때 유용합니다. end() 이후에는 경고를 표시하고 no-op으로 처리됩니다. OTel Span.addEvent와 동일하게 동작합니다.

매개변수

이름유형
namestring
attributes?Attributes
startTime?TimeInput

반환값

this 예시
span.addEvent('context_compacted', {: 12});

상속됨

SpanBase.addEvent

정의 위치

src/genai/spanBase.ts:77

end

end(opts?): void result를 span에 플러시한 후 닫습니다. 멱등성을 가집니다. span을 실패로 표시하려면 error를 전달하세요. 닫는 시점을 과거로 소급하려면 endTime을 전달하세요.

매개변수

이름유형
opts?SpanEndOptions

반환값

void

정의 위치

src/genai/tool.ts:87

setAttributes

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

매개변수

이름유형
attributesAttributes

반환값

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

상속됨

SpanBase.setAttributes

정의 위치

src/genai/spanBase.ts:63

create

create(opts): Tool

매개변수

이름유형
optsToolInit & ChildSpanContext

반환값

Tool

정의 위치

src/genai/tool.ts:58