LLM

LLM Call입니다. gen_ai.* 속성이 포함된 chat span을 내보냅니다. tracing.startLLM()(또는 turn.startLLM(), subagent.startLLM())으로 생성하고 end()로 종료합니다. 가장 최근에 시작된 LLM이 현재 LLM이 됩니다(getCurrentLLM, tracing.startTool). 다른 LLM이 활성 상태일 때 SubAgent 아래에서 LLM을 시작하면 LIFO 방식으로 중첩됩니다. 즉, 새 LLM은 종료될 때까지 현재 LLM이 되고, 종료되면 이를 감싸는 LLM이 다시 현재 LLM이 됩니다. 도구/서브에이전트 Call을 LLM 아래에 중첩하려면 startTool / startSubagent를 사용하세요. inputMessages / outputMessages / usage / reasoning을 직접 채우거나, 헬퍼 함수(output, think, attachMedia, record)를 사용해 채우세요. 기록된 모든 데이터는 end() 시점에 span으로 플러시됩니다.

예시

const llm = tracing.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 = tracing.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();
}

속성

Message[]

유형: Message[]모델에 전송된 입력 메시지입니다. end() 호출 시 gen_ai.input.messages에 플러시됩니다.

string

읽기 전용입니다.

Message[]

유형: Message[]모델이 반환한 assistant 메시지입니다. end() 호출 시 gen_ai.output.messages에 플러시됩니다.

string

읽기 전용입니다.

Reasoning

유형: Reasoning사고 과정(chain-of-thought) 콘텐츠입니다. 직렬화 시 마지막 assistant 메시지에 ReasoningPart로 병합됩니다.

Usage

유형: Usage토큰 수 및 캐시 통계입니다. end() 호출 시 gen_ai.usage.*에 플러시됩니다.

메서드

`attachMedia()`

attachMedia(opts: AttachMediaOpts): this

LLM Call에 사용할 미디어 첨부 파일을 준비합니다. content(인라인 base64 바이트), uri(URI 참조), fileId(미리 업로드한 파일 ID) 중 하나만 지정하세요. 첨부 파일은 end()가 호출될 때 inputMessages의 마지막 사용자 메시지에 추가됩니다.

매개변수

AttachMediaOpts

필수

반환값

this

`attachMediaUrl()`

attachMediaUrl(url: string, opts: {modality: Modality}): this

attachMedia({uri, modality})를 간편하게 호출하는 메서드입니다.

매개변수

string

필수

object

필수

표시 속성

Modality

필수

유형: Modality

반환값

this

`end()`

end(opts?: SpanEndOptions): void

누적된 상태를 플러시하고 span을 닫습니다. 멱등성이 보장됩니다. 실패로 표시하려면 error를 전달하고, 종료 시각을 과거로 지정하려면 endTime을 전달하세요.

매개변수

SpanEndOptions

`output()`

output(content: string): this

응답에 assistant 메시지를 추가합니다.

매개변수

string

필수

반환값

this

`record()`

record(
  opts: {
    inputMessages?: Message[];
    outputMessages?: Message[];
    usage?: Usage;
    reasoning?: Reasoning;
    responseId?: string;
    responseModel?: string;
    finishReasons?: string[];
    outputType?: string;
    mediaAttachments?: AttachMediaOpts[];
  },
): this

변경 가능한 필드 중 원하는 일부를 한 번에 설정합니다. 기존 값과 병합하지 않고 대체합니다. provider 호출이 반환된 후 모든 값을 한 번에 할당할 때 유용합니다.

매개변수

object

필수

표시 속성

Message[]

유형: Message[]

Message[]

유형: Message[]

Usage

유형: Usage

Reasoning

유형: Reasoning

string

string[]

string

AttachMediaOpts[]

반환값

this

`setAttributes()`

setAttributes(attributes: Attributes): this

span에 여러 속성을 한 번에 설정합니다. end() 이후에 호출하면 경고를 출력하고 아무 작업도 수행하지 않습니다. OTel Span.setAttributes(및 Python SDK의 set_attributes)와 동일하게 동작합니다.

매개변수

Attributes

필수

반환값

this

예시

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

`startSubagent()`

startSubagent(opts: SubAgentInit): SubAgent

이 LLM 하위에 중첩되는 자식 SubAgent span을 시작합니다.

매개변수

SubAgentInit

필수

유형: SubAgentInit

반환값

SubAgent

`startTool()`

startTool(opts: ToolInit): Tool

이 LLM span 아래에 중첩되는 하위 도구 span을 시작합니다.

매개변수

ToolInit

필수

유형: ToolInit

반환값

Tool

`think()`

think(content: string): this

모델의 추론(사고 과정) 콘텐츠를 설정하거나 확장합니다. 콘텐츠는 this.reasoning.content에 누적됩니다. 직렬화 시점에 ReasoningPart로서 마지막 assistant 메시지에 병합되며, 이는 Python SDK의 전송 형식과 동일합니다.

매개변수

string

필수

반환값

this

Agent Lens

가이드

인테그레이션

레퍼런스

예시

속성

메서드

`attachMedia()`

매개변수

반환값

`attachMediaUrl()`

매개변수

반환값

`end()`

매개변수

`output()`

매개변수

반환값

`record()`

매개변수

반환값

`setAttributes()`

매개변수

반환값

예시

`startSubagent()`

매개변수

반환값

`startTool()`

매개변수

반환값

`think()`

매개변수

반환값

​예시

​속성

​메서드

​attachMedia()

​매개변수

​반환값

​attachMediaUrl()

​매개변수

​반환값

​end()

​매개변수

​output()

​매개변수

​반환값

​record()

​매개변수

​반환값

​setAttributes()

​매개변수

​반환값

​예시

​startSubagent()

​매개변수

​반환값

​startTool()

​매개변수

​반환값

​think()

​매개변수

​반환값

예시

속성

메서드

`attachMedia()`

매개변수

반환값

`attachMediaUrl()`

매개변수

반환값

`end()`

매개변수

`output()`

매개변수

반환값

`record()`

매개변수

반환값

`setAttributes()`

매개변수

반환값

예시

`startSubagent()`

매개변수

반환값

`startTool()`

매개변수

반환값

`think()`

매개변수

반환값