invoke_agent span を発行し、そのターンにおける trace のルートとして機能します。常に ROOT_CONTEXT の下で開始されるため、OTel でインストルメントされた他のライブラリから誤って親を継承することはありません。
weave.startTurn() (または conversation.startTurn()) によって作成され、end() で終了します。1 つの非同期チェーン内で実行中にできるターンは 1 つだけです。子 (LLM、Tool、SubAgent) は startLLM、startTool、startSubagent の各 method を通じて attach されます。
例
継承元
SpanBase
アクセサー
エージェント名
Get Signature
get agentName(): string
戻り値
string
モデル
Get Signature
get model(): string
戻り値
string
メソッド
addEvent()
addEvent(名前付きイベントを span に追加します。コンテキストの圧縮、ツールループの検出、guardrail のトリガーなど、 span 以外の時点を記録する際に便利です。name,attributes?,startTime?):this
end() の後は警告を出し、
何も行いません。OTel の Span.addEvent と同様の動作をします。
パラメーター
string
必須
Attributes
TimeInput
戻り値
this
例
継承元
SpanBase.addEvent
end()
end(現在のフィールド値を読み取り (opts?):void
start以降にrecord()で行った変更を反映) 、span を終了します。冪等です。失敗としてマークするにはerrorを渡します。終了時刻を過去に設定するにはendTimeを渡します。
パラメーター
object
戻り値
void
record()
record(変更可能なフィールドの任意のサブセットを一括で設定します。マージではなく置換されます。 provider 呼び出しの戻り値を受け取った後に、すべてを一度に割り当てる場合に便利です。opts):this
パラメーター
object
必須
戻り値
this
setAttribute()
setAttribute(key,value):this
パラメーター
string
必須
AttributeValue
必須
戻り値
this
setAttributes()
setAttributes(span に複数の属性を一度に設定します。attributes):this
end() の後に呼び出すと警告が表示され、何も実行されません。OTel の Span.setAttributes (および Python SDK の
set_attributes) と同様です。
パラメーター
Attributes
必須
戻り値
this
例
継承元
SpanBase.setAttributes
startLLM()
startLLM(この ターン 内で子 LLM span を開始します。opts):LLM
パラメーター
戻り値
LLM
startSubagent()
startSubagent(この ターン 内で子 SubAgent の span を開始します。opts):SubAgent
パラメーター
SubAgentInit
必須
SubAgentInit を参照してください。戻り値
SubAgent
startTool()
startTool(この ターン 内で子 Tool span を開始します。opts):Tool
パラメーター
戻り値
Tool