gen_ai.* 属性を含む chat span を生成します。
weave.startLLM() (または turn.startLLM()) で作成し、end() で終了します。非同期コンテキストでは、一度にアクティブにできる LLM は 1 つのみです。startTool / startSubagent を使用して、その配下に tool/subagent Call をネストします。
inputMessages / outputMessages / usage / reasoning は直接設定するか、ヘルパー関数 (output、think、attachMedia、record) を使用して設定します。
記録されたすべてのデータは、end() 時に span にフラッシュされます。
定義元: src/genai/llm.ts:86
例
継承元
SpanBase
プロパティ
inputMessages
inputMessages:モデルに送信される入力メッセージです。Message[] =[]
end() の呼び出し時に gen_ai.input.messages にフラッシュされます。
定義元: src/genai/llm.ts:93
モデル
定義元: src/genai/llm.ts:117readonlyモデル:string
outputMessages
outputMessages:モデルが返すアシスタント メッセージ。Message[] =[]
end() 時に
gen_ai.output.messages にフラッシュされます。
定義元: src/genai/llm.ts:98
providerName
定義元: src/genai/llm.ts:118readonlyproviderName:string
推論
思考の連鎖の内容です。シリアル化時に、最後のアシスタント メッセージに ReasoningPart として組み込まれます。 定義元: src/genai/llm.ts:105optional推論:Reasoning
usage
usage:トークン数とキャッシュ統計です。Usage={}
end() 時に gen_ai.usage.* へフラッシュされます。
定義元: src/genai/llm.ts:100
メソッド
addEvent()
addEvent(名前付きイベントを span に追加します。コンテキストの圧縮、tool ループの検出、guardrail の発動など、 span 以外の時点をマークする場合に役立ちます。name,attributes?,startTime?):this
end() の後に呼び出すと警告が表示され、
何も実行されません。OTel の Span.addEvent に対応します。
定義元: src/genai/spanBase.ts:82
パラメーター
名
string
属性?
Attributes
startTime?
TimeInput
戻り値
this
例
継承元
SpanBase.addEvent
attachMedia()
attachMedia(LLM Call に添付するメディアを準備します。opts):this
content (インライン base64 バイト) 、uri (URI 参照) 、または fileId
(事前にアップロードされた file ID) のいずれか 1 つだけを指定します。添付は end() 時に
inputMessages 内の最後のユーザーメッセージに追加されます。
定義元: src/genai/llm.ts:183
パラメーター
opts
AttachMediaOpts
戻り値
this
attachMediaUrl()
attachMediaUrl(url,opts):this
attachMedia({uri, modality}) の簡易版です。
定義元: src/genai/llm.ts:192
パラメーター
url
string
opts
モダリティ
Modality
戻り値
this
end()
end(蓄積された状態をフラッシュして span を閉じます。冪等です。失敗としてマークするにはopts?):void
error を渡し、終了時刻を過去に設定するには endTime を渡します。
定義元: src/genai/llm.ts:274
パラメーター
opts?
SpanEndOptions
戻り値
void
output()
output(レスポンスにアシスタント メッセージを追加します。 定義元: src/genai/llm.ts:155content):this
パラメーター
content
string
戻り値
this
record()
record(変更可能なフィールドの任意のサブセットを一括で設定します。マージではなく置換されます。 provider 呼び出しの結果が返された後に、すべてを一度に割り当てる場合に便利です。 定義元: src/genai/llm.ts:203opts):this
パラメーター
opts
終了理由?
string[]
inputMessages?
Message[]
mediaAttachments?
AttachMediaOpts[]
outputMessages?
Message[]
outputType?
string
推論?
Reasoning
responseId?
string
responseModel?
string
使用方法
Usage
戻り値
this
setAttributes()
setAttributes(span に複数の属性をまとめて設定します。attributes):this
end() の呼び出し後は警告を出力し、
何も実行しません。OTel の Span.setAttributes (および Python SDK の
set_attributes) と同様です。
定義元: src/genai/spanBase.ts:63
パラメーター
属性
Attributes
戻り値
this
例
継承元
SpanBase.setAttributes
startSubagent()
startSubagent(この LLM 内にネストされた子 SubAgent の span を開始します。 定義元: src/genai/llm.ts:261opts):SubAgent
パラメーター
opts
SubAgentInit
戻り値
SubAgent
startTool()
startTool(この LLM 内にネストされた子 Tool span を開始します。 定義元: src/genai/llm.ts:252opts):Tool
パラメーター
opts
ToolInit
戻り値
Tool
think()
think(モデルの推論/chain-of-thought コンテンツを設定または追加します。内容はcontent):this
this.reasoning.content に蓄積されます。シリアル化時には ReasoningPart として最後のアシスタント メッセージに
組み込まれ、Python SDK のオンザワイヤ形式に一致します。
定義元: src/genai/llm.ts:167
パラメーター
content
string
戻り値
this