Skip to main content
LLM Call。gen_ai.* 属性を含む chat span を生成します。 weave.startLLM() (または turn.startLLM()) で作成し、end() で終了します。非同期コンテキストでは、一度にアクティブにできる LLM は 1 つのみです。startTool / startSubagent を使用して、その配下に tool/subagent Call をネストします。 inputMessages / outputMessages / usage / reasoning は直接設定するか、ヘルパー関数 (outputthinkattachMediarecord) を使用して設定します。 記録されたすべてのデータは、end() 時に span にフラッシュされます。 定義元: src/genai/llm.ts:86

継承元

  • SpanBase

プロパティ

inputMessages

inputMessages: Message[] = []
モデルに送信される入力メッセージです。end() の呼び出し時に gen_ai.input.messages にフラッシュされます。 定義元: src/genai/llm.ts:93

モデル

readonly モデル: string
定義元: src/genai/llm.ts:117

outputMessages

outputMessages: Message[] = []
モデルが返すアシスタント メッセージ。end() 時に gen_ai.output.messages にフラッシュされます。 定義元: src/genai/llm.ts:98

providerName

readonly providerName: string
定義元: src/genai/llm.ts:118

推論

optional 推論: Reasoning
思考の連鎖の内容です。シリアル化時に、最後のアシスタント メッセージに ReasoningPart として組み込まれます。 定義元: src/genai/llm.ts:105

usage

usage: Usage = {}
トークン数とキャッシュ統計です。end() 時に gen_ai.usage.* へフラッシュされます。 定義元: src/genai/llm.ts:100

メソッド

addEvent()

非推奨。 代わりに setAttributes を使用してこのデータを記録してください。 OpenTelemetry は Span Event API (Span.addEvent) を段階的に廃止しています。この メソッドは引き続き使用でき、既存の span event データも有効です。 https://opentelemetry.io/blog/2026/deprecating-span-events/ を参照してください。
addEvent(name, attributes?, startTime?): this
名前付きイベントを span に追加します。コンテキストの圧縮、tool ループの検出、guardrail の発動など、 span 以外の時点をマークする場合に役立ちます。end() の後に呼び出すと警告が表示され、 何も実行されません。OTel の Span.addEvent に対応します。 定義元: src/genai/spanBase.ts:82

パラメーター

string
属性?
Attributes
startTime?
TimeInput

戻り値

this

継承元

SpanBase.addEvent

attachMedia()

attachMedia(opts): this
LLM Call に添付するメディアを準備します。 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(opts?): void
蓄積された状態をフラッシュして span を閉じます。冪等です。失敗としてマークするには error を渡し、終了時刻を過去に設定するには endTime を渡します。 定義元: src/genai/llm.ts:274

パラメーター

opts?
SpanEndOptions

戻り値

void

output()

output(content): this
レスポンスにアシスタント メッセージを追加します。 定義元: src/genai/llm.ts:155

パラメーター

content
string

戻り値

this

record()

record(opts): this
変更可能なフィールドの任意のサブセットを一括で設定します。マージではなく置換されます。 provider 呼び出しの結果が返された後に、すべてを一度に割り当てる場合に便利です。 定義元: src/genai/llm.ts:203

パラメーター

opts
終了理由?
string[]
inputMessages?
Message[]
mediaAttachments?
AttachMediaOpts[]
outputMessages?
Message[]
outputType?
string
推論?
Reasoning
responseId?
string
responseModel?
string
使用方法
Usage

戻り値

this

setAttributes()

setAttributes(attributes): this
span に複数の属性をまとめて設定します。end() の呼び出し後は警告を出力し、 何も実行しません。OTel の Span.setAttributes (および Python SDK の set_attributes) と同様です。 定義元: src/genai/spanBase.ts:63

パラメーター

属性
Attributes

戻り値

this

継承元

SpanBase.setAttributes

startSubagent()

startSubagent(opts): SubAgent
この LLM 内にネストされた子 SubAgent の span を開始します。 定義元: src/genai/llm.ts:261

パラメーター

opts
SubAgentInit

戻り値

SubAgent

startTool()

startTool(opts): Tool
この LLM 内にネストされた子 Tool span を開始します。 定義元: src/genai/llm.ts:252

パラメーター

opts
ToolInit

戻り値

Tool

think()

think(content): this
モデルの推論/chain-of-thought コンテンツを設定または追加します。内容は this.reasoning.content に蓄積されます。シリアル化時には ReasoningPart として最後のアシスタント メッセージに 組み込まれ、Python SDK のオンザワイヤ形式に一致します。 定義元: src/genai/llm.ts:167

パラメーター

content
string

戻り値

this