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()
addEvent(span에 이름이 있는 이벤트를 추가합니다. 컨텍스트 압축, 도구 루프 감지 또는 가드레일 위반과 같이 span이 아닌 시점을 표시하는 데 유용합니다.name,attributes?,startTime?):this
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()
setAttribute(key,value):this
매개변수
string
필수
AttributeValue
필수
반환값
this
setAttributes()
setAttributes(span에 여러 속성을 한 번에 설정합니다.attributes):this
end() 호출 후에는 경고를 표시하고
아무 작업도 수행하지 않습니다. OTel Span.setAttributes(및 Python SDK의
set_attributes)와 동일하게 작동합니다.
매개변수
Attributes
필수
반환값
this
예시
상속됨
SpanBase.setAttributes
startLLM()
startLLM(이 Turn 내에서 하위 LLM span을 시작합니다.opts):LLM
매개변수
반환값
LLM
startSubagent()
startSubagent(이 Turn 내에서 하위 SubAgent span을 시작합니다.opts):SubAgent
매개변수
SubAgentInit
필수
SubAgentInit를 참조하세요.반환값
SubAgent
startTool()
startTool(이 Turn 내에서 하위 도구 span을 시작합니다.opts):Tool
매개변수
반환값
Tool