Skip to main content
에이전트 호출입니다. 일반적으로 단일 사용자 메시지에 응답하는 작업을 감쌉니다. invoke_agent span을 생성하며, 해당 turn의 트레이스 루트 역할을 합니다. 항상 ROOT_CONTEXT 아래에서 시작되므로 OTel로 계측된 다른 라이브러리의 부모를 실수로 상속받는 일이 없습니다. weave.startTurn()(또는 conversation.startTurn())으로 생성하고 end()로 종료합니다. 하나의 비동기 체인에서는 하나의 Turn만 활성 상태일 수 있습니다. 하위 항목(LLM, Tool, SubAgent)은 startLLM, startTool, startSubagent 메서드를 통해 연결됩니다.

예시

상속

  • SpanBase

접근자

agentName

조회 시그니처

get agentName(): string
반환값
string

모델

조회 시그니처

get model(): string
반환값
string

메서드

addEvent()

사용 중단. 대신 setAttributes를 사용하여 이 데이터를 기록하세요. OpenTelemetry는 Span Event API(Span.addEvent)를 단계적으로 폐지하고 있습니다. 이 방법은 계속 작동하며 기존 span 이벤트 데이터도 유효하게 유지됩니다. https://opentelemetry.io/blog/2026/deprecating-span-events/을 참조하세요.
addEvent(name, attributes?, startTime?): this
span에 이름이 있는 이벤트를 추가합니다. 컨텍스트 압축, 도구 루프 감지 또는 가드레일 위반과 같이 span이 아닌 시점을 표시하는 데 유용합니다. end() 호출 후에는 경고를 표시하고 아무 작업도 수행하지 않습니다. OTel Span.addEvent와 동일하게 동작합니다.

매개변수

string
필수
Attributes
TimeInput

반환값

this

예시

상속됨

SpanBase.addEvent

end()

end(opts?): void
현재 필드 값을 조회하여(start 이후 record()를 통해 변경된 내용 반영) span을 종료합니다. 멱등적입니다. 실패로 표시하려면 error를 전달하고, 종료 시점을 과거로 설정하려면 endTime을 전달합니다.

매개변수

object

반환값

void

record()

record(opts): this
변경 가능한 필드 중 원하는 항목을 일괄 설정합니다. 병합하지 않고 덮어씁니다. 공급자 호출이 반환된 후 모든 항목을 한 번에 부여할 때 유용합니다.

매개변수

object
필수

반환값

this

setAttribute()

사용 중단. Python SDK의 set_attributes 및 OTel의 Span.setAttributes와 동일한 setAttributes를 대신 사용하세요. 기존의 단일 속성 호출이 계속 작동하도록 얇은 별칭으로 유지됩니다. 이 방법은 Turn에만 있으며, 다른 emitter에는 단수형이 제공된 적이 없습니다.
setAttribute(key, value): this

매개변수

string
필수
AttributeValue
필수

반환값

this

setAttributes()

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

매개변수

Attributes
필수

반환값

this

예시

상속됨

SpanBase.setAttributes

startLLM()

startLLM(opts): LLM
이 Turn 내에서 하위 LLM span을 시작합니다.

매개변수

LLMInit
필수
LLMInit을 참조하세요.

반환값

LLM

startSubagent()

startSubagent(opts): SubAgent
이 Turn 내에서 하위 SubAgent span을 시작합니다.

매개변수

SubAgentInit
필수
SubAgentInit를 참조하세요.

반환값

SubAgent

startTool()

startTool(opts): Tool
이 Turn 내에서 하위 도구 span을 시작합니다.

매개변수

ToolInit
필수
ToolInit을 참조하세요.

반환값

Tool