LLM - Weights & Biases Documentation

weave / LLM LLM Call です。gen_ai.* 属性を持つ chat span を生成します。 weave.startLLM() (または turn.startLLM()) で作成され、 end() で終了します。async コンテキストごとに一度にアクティブにできる LLM は 1 つだけです。startTool / startSubagent を使用して、その配下に tool/subagent の Call をネストしてください。 inputMessages / outputMessages / usage / reasoning には、値を直接設定するか、ヘルパー関数 (output、think、attachMedia、record) を使用して設定します。記録されたすべてのデータは、end() 時に span にフラッシュされます。 例

const llm = weave.startLLM({model: 'gpt-4o-mini', providerName: 'openai'});

try {
  llm.inputMessages = [{role: 'user', content: prompt}];
  const resp = await openai.chat.completions.create({...});
  llm.output(resp.choices[0].message.content ?? '');
  llm.record({usage: {inputTokens: resp.usage?.prompt_tokens}});
} finally {
  llm.end();
}

例

const llm = weave.startLLM({
  model: 'gpt-4o-mini',
  providerName: 'openai',
  systemInstructions: ['You are a helpful weather bot.'],
  startTime: new Date('2026-05-29T10:00:00.000Z'),
});

try {
  // ... LLM を呼び出し、llm.outputMessages / usage を設定する ...
} finally {
  llm.end();
}

階層

SpanBase ↳ LLM

プロパティ

inputMessages

• inputMessages: Message[] = [] モデルに送信される入力メッセージです。end() の際に gen_ai.input.messages に書き出されます。

定義元

src/genai/llm.ts:93

model

• Readonly model: 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

reasoning

• Optional reasoning: Reasoning 推論の内容です。シリアル化時に、ReasoningPart として最後の assistant メッセージに組み込まれます。

定義元

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/例

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

▸ addEvent(name, attributes?, startTime?): this 名前付きのイベントを span に追加します。コンテキストの圧縮、 tool ループの検出、guardrail のトリガーなど、span 以外の時点を記録するのに便利です。end() の後に呼び出すと警告が表示され、 no-op になります。OTel の Span.addEvent に対応しています。

パラメーター

名	タイプ
`name`	`string`
`attributes?`	`Attributes`
`startTime?`	`TimeInput`

戻り値

this

継承元

SpanBase.addEvent

定義元

src/genai/spanBase.ts:82

attachMedia

▸ attachMedia(opts): this LLM Call 用のメディア添付をステージします。content (インラインの base64 エンコード済みバイト列) 、uri (URI reference) 、または fileId (事前にアップロードされた file ID) のうち、指定できるのは 1 つだけです。添付は end() 時に inputMessages 内の最後のユーザーメッセージに追加されます。

パラメーター

名	タイプ
`opts`	`AttachMediaOpts`

戻り値

this

定義元

src/genai/llm.ts:183

attachMediaUrl

▸ attachMediaUrl(url, opts): this attachMedia({uri, modality}) の便利なショートカットです。

パラメーター

名	タイプ
`url`	`string`
`opts`	`Object`
`opts.modality`	`Modality`

戻り値

this

定義元

src/genai/llm.ts:192

end

▸ end(opts?): void 蓄積された状態をフラッシュして span を閉じます。冪等です。span を失敗としてマークするには、error を渡します。終了時刻を過去にさかのぼって設定するには、endTime を渡します。

パラメーター

名	タイプ
`opts?`	`SpanEndOptions`

戻り値

void

定義元

src/genai/llm.ts:274

output

▸ output(content): this レスポンスにアシスタントメッセージを追加します。

パラメーター

名	タイプ
`content`	`string`

戻り値

this

定義元

src/genai/llm.ts:155

record

▸ record(opts): this 変更可能なフィールドの任意の部分集合を一括で設定します。マージではなく、置き換えです。プロバイダの呼び出し結果が返された後に、すべてをまとめて設定する場合に便利です。

パラメーター

名	タイプ
`opts`	`Object`
`opts.finishReasons?`	`string`[]
`opts.inputMessages?`	`Message`[]
`opts.mediaAttachments?`	`AttachMediaOpts`[]
`opts.outputMessages?`	`Message`[]
`opts.outputType?`	`string`
`opts.reasoning?`	`Reasoning`
`opts.responseId?`	`string`
`opts.responseModel?`	`string`
`opts.usage?`	`Usage`

戻り値

this

定義元

src/genai/llm.ts:203

setAttributes

▸ setAttributes(attributes): this spanに複数の属性をまとめて設定します。end() の後に呼び出すと、警告が表示され、何も行われません。 OTel の Span.setAttributes (および Python SDK の set_attributes) に対応しています。

パラメーター

名	タイプ
`attributes`	`Attributes`

戻り値

this 例

span.setAttributes({'weave.tag': 'prod', 'gen_ai.response.id': id});

継承元

SpanBase.setAttributes

定義元

src/genai/spanBase.ts:63

startSubagent

▸ startSubagent(opts): SubAgent この LLM の配下にネストされた子 SubAgent spanを開始します。

パラメーター

名	タイプ
`opts`	`SubAgentInit`

戻り値

SubAgent

定義元

src/genai/llm.ts:261

startTool

▸ startTool(opts): Tool この LLM の子としてネストされた Tool span を開始します。

パラメーター

名	タイプ
`opts`	`ToolInit`

戻り値

Tool

定義元

src/genai/llm.ts:252

think

▸ think(content): this モデルの推論/chain-of-thought の内容を設定または追加します。内容は this.reasoning.content に蓄積され、シリアル化時に ReasoningPart として最後のアシスタントメッセージに組み込まれます。これは Python SDK の on-the-wire 形式と一致します。

パラメーター

名	タイプ
`content`	`string`

戻り値

this

定義元

src/genai/llm.ts:167

create

▸ create(opts): LLM

パラメーター

名	タイプ
`opts`	`LLMInit` & `ChildSpanContext`

戻り値

LLM

定義元

src/genai/llm.ts:124

​階層

​目次

​プロパティ

​メソッド

​プロパティ

​inputMessages

​定義元

​model

​定義元

​outputMessages

​定義元

​providerName

​定義元

​reasoning

​定義元

​usage

​定義元

​メソッド

​addEvent

​パラメーター

​戻り値

​継承元

​定義元

​attachMedia

​パラメーター

​戻り値

​定義元

​attachMediaUrl

​パラメーター

​戻り値

​定義元

​end

​パラメーター

​戻り値

​定義元

​output

​パラメーター

​戻り値

​定義元

​record

​パラメーター

​戻り値

​定義元

​setAttributes

​パラメーター

​戻り値

​継承元

​定義元

​startSubagent

​パラメーター

​戻り値

​定義元

​startTool

​パラメーター

​戻り値

​定義元

​think

​パラメーター

​戻り値

​定義元

​create

​パラメーター

​戻り値

​定義元

階層

目次

プロパティ

メソッド

プロパティ

inputMessages

定義元

model

定義元

outputMessages

定義元

providerName

定義元

reasoning

定義元

usage

定義元

メソッド

addEvent

パラメーター

戻り値

継承元

定義元

attachMedia

パラメーター

戻り値

定義元

attachMediaUrl

パラメーター

戻り値

定義元

end

パラメーター

戻り値

定義元

output

パラメーター

戻り値

定義元

record

パラメーター

戻り値

定義元

setAttributes

パラメーター

戻り値

継承元

定義元

startSubagent

パラメーター

戻り値

定義元

startTool

パラメーター

戻り値

定義元

think

パラメーター

戻り値

定義元

create

パラメーター

戻り値

定義元