Skip to main content
agent invocation です。通常は、単一のユーザーメッセージに応答するための処理をラップします。invoke_agent span を発行し、そのターンにおける trace のルートとして機能します。常に ROOT_CONTEXT の下で開始されるため、OTel でインストルメントされた他のライブラリから誤って親を継承することはありません。 weave.startTurn() (または conversation.startTurn()) によって作成され、end() で終了します。1 つの非同期チェーン内で実行中にできるターンは 1 つだけです。子 (LLM、Tool、SubAgent) は startLLMstartToolstartSubagent の各 method を通じて attach されます。

継承元

  • SpanBase

アクセサー

エージェント名

Get Signature

get agentName(): string
戻り値
string

モデル

Get Signature

get model(): string
戻り値
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 に追加します。コンテキストの圧縮、ツールループの検出、guardrail のトリガーなど、 span 以外の時点を記録する際に便利です。end() の後は警告を出し、 何も行いません。OTel の Span.addEvent と同様の動作をします。

パラメーター

string
必須
Attributes
TimeInput

戻り値

this

継承元

SpanBase.addEvent

end()

end(opts?): void
現在のフィールド値を読み取り (start以降にrecord()で行った変更を反映) 、span を終了します。冪等です。失敗としてマークするにはerrorを渡します。終了時刻を過去に設定するにはendTimeを渡します。

パラメーター

object

戻り値

void

record()

record(opts): this
変更可能なフィールドの任意のサブセットを一括で設定します。マージではなく置換されます。 provider 呼び出しの戻り値を受け取った後に、すべてを一度に割り当てる場合に便利です。

パラメーター

object
必須

戻り値

this

setAttribute()

非推奨。 代わりに、Python SDK の set_attributes および OTel の Span.setAttributes に対応する setAttributes を使用してください。既存の単一属性の呼び出し元が引き続き動作するよう、薄い alias として残されています。これを備えているのは ターン のみで、ほかの emitter に単数形はありません。
setAttribute(key, value): this

パラメーター

string
必須
AttributeValue
必須

戻り値

this

setAttributes()

setAttributes(attributes): this
span に複数の属性を一度に設定します。end() の後に呼び出すと警告が表示され、何も実行されません。OTel の Span.setAttributes (および Python SDK の set_attributes) と同様です。

パラメーター

Attributes
必須

戻り値

this

継承元

SpanBase.setAttributes

startLLM()

startLLM(opts): LLM
この ターン 内で子 LLM span を開始します。

パラメーター

LLMInit
必須
LLMInit を参照してください。

戻り値

LLM

startSubagent()

startSubagent(opts): SubAgent
この ターン 内で子 SubAgent の span を開始します。

パラメーター

SubAgentInit
必須
SubAgentInit を参照してください。

戻り値

SubAgent

startTool()

startTool(opts): Tool
この ターン 内で子 Tool span を開始します。

パラメーター

ToolInit
必須
ToolInit を参照してください。

戻り値

Tool