execute_tool span을 생성합니다.
weave.startTool()(또는 turn.startTool(), 또는
llm.startTool())로 생성되며 end()로 종료됩니다. span에 도구의 출력을 기록하려면
end()를 호출하기 전에 result에 값을 부여하세요.
예시
계층 구조
-
SpanBase↳Tool
목차
속성
방법
속성
args
Readonly args: string
정의 위치
name
Readonly name: string
정의 위치
result
선택 result: string
도구의 출력을 string으로 나타낸 값입니다. end()에서 gen_ai.tool.call.result에 기록됩니다.
정의 위치
toolCallId
Readonly toolCallId: string
정의 위치
방법
addEvent
name, attributes?, startTime?): this
span에 이름이 지정된 event를 추가합니다. 컨텍스트 압축, 도구 루프 감지,
또는 가드레일 트리거처럼 span이 아닌 시점을 표시할 때 유용합니다. end() 이후에는 경고를
표시하고 no-op으로 처리됩니다. OTel Span.addEvent와 동일하게 동작합니다.
매개변수
| 이름 | 유형 |
|---|---|
name | string |
attributes? | Attributes |
startTime? | TimeInput |
반환값
this
예시
상속됨
정의 위치
end
opts?): void
result를 span에 플러시한 후 닫습니다. 멱등성을 가집니다. span을 실패로 표시하려면
error를 전달하세요. 닫는 시점을 과거로 소급하려면 endTime을 전달하세요.
매개변수
| 이름 | 유형 |
|---|---|
opts? | SpanEndOptions |
반환값
void
정의 위치
setAttributes
attributes): this
span에 여러 속성을 한 번에 설정합니다. end() 호출 후에는 경고를 표시하고 아무 작업도 수행하지 않습니다.
OTel Span.setAttributes(및 Python SDK의
set_attributes)와 동일하게 동작합니다.
매개변수
| 이름 | 유형 |
|---|---|
attributes | Attributes |
반환값
this
예시
상속됨
정의 위치
create
opts): Tool
매개변수
| 이름 | 유형 |
|---|---|
opts | ToolInit & ChildSpanContext |
반환값
Tool