Tool

ツールの invocation です。ツール名、引数、ツール-call id、結果を含む execute_tool span を出力します。string 型の引数と結果はそのまま記録され、それ以外の JSON 値はシリアライズされます。 weave.startTool() (または turn.startTool()、llm.startTool()) で作成し、end() で終了します。end() は結果とオプションの error metadata を受け入れます。

例

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

名

readonly 名: string

result

非推奨。 代わりに end() に result を渡してください。

optional result: string

ツールの出力を文字列として表します。end() に result を渡す方法を推奨します。

toolCallId

readonly toolCallId: string

メソッド

addEvent()

非推奨。 このデータは代わりに setAttributes で記録してください。 OpenTelemetry では Span Event API (Span.addEvent) の段階的な廃止が進められています。このメソッドは引き続き動作し、既存の span イベントデータも引き続き有効です。 https://opentelemetry.io/blog/2026/deprecating-span-events/ を参照してください。

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

名前付きイベントを span に追加します。コンテキストの圧縮、ツールループの検出、guardrail のトリガーなど、 span 以外のタイミングを記録する場合に便利です。end() の後に呼び出すと警告が出力され、何も実行されません。OTel の Span.addEvent と同様の動作です。

パラメーター

string

必須

Attributes

TimeInput

戻り値

this

例

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

継承元

SpanBase.addEvent

end()

end(opts?): void

任意の結果と error のタイプを記録し、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

名

result

toolCallId

メソッド

addEvent()

パラメーター

戻り値

例

継承元

end()

パラメーター

戻り値

setAttributes()

パラメーター

戻り値

例

継承元

​例

​継承

​プロパティ

​args

​名

​result

​toolCallId

​メソッド

​addEvent()

​パラメーター

​戻り値

​例

​継承元

​end()

​パラメーター

​戻り値

​setAttributes()

​パラメーター

​戻り値

​例

​継承元

例

継承

プロパティ

args

名

result

toolCallId

メソッド

addEvent()

パラメーター

戻り値

例

継承元

end()

パラメーター

戻り値

setAttributes()

パラメーター

戻り値

例

継承元