메인 콘텐츠로 건너뛰기
weave / SubAgent 중첩된 에이전트 호출입니다. 현재 에이전트가 작업을 이름이 지정된 다른 에이전트에 넘길 때 사용됩니다 (예: planner가 researcher에게 작업을 넘기는 경우). 하위 에이전트의 이름과 (선택적으로) 모델이 태그된 invoke_agent span을 생성합니다. weave.startSubagent()(또는 turn.startAgent(), 또는 llm.startAgent())로 생성되며, end()로 종료됩니다. 예시 
const  = weave.startSubagent({: 'researcher', : 'gpt-4o'});
try {
  // ... 서브 에이전트의 LLM/Tool Call을 조율합니다 ...
} finally {
  .end();
}

​
계층 구조

  • SpanBase ↳ SubAgent

​
목차

​
속성

​
방법

​
속성

​
모델

• Readonly 모델: string

​
정의 위치

src/genai/subagent.ts:41

​
이름

• Readonly 이름: string

​
정의 위치

src/genai/subagent.ts:40

​
방법

​
addEvent

▸ addEvent(name, attributes?, startTime?): this 이름이 지정된 이벤트를 span에 추가합니다. 컨텍스트 압축, 도구 루프 감지, 또는 가드레일 트리거와 같이 span이 아닌 시점을 표시할 때 유용합니다. end() 이후에 호출하면 경고를 표시하고 아무 작업도 수행하지 않습니다. OTel Span.addEvent와 동일하게 동작합니다.

​
매개변수

이름유형
namestring
attributes?Attributes
startTime?TimeInput

​
반환값

this 예시 
span.addEvent('context_compacted', {: 12});

​
상속됨

SpanBase.addEvent

​
정의 위치

src/genai/spanBase.ts:77

​
end

▸ end(opts?): void SubAgent span을 종료합니다. 멱등성을 가집니다. 실패로 표시하려면 error를 전달하세요; 종료 시점을 이전으로 소급하려면 endTime을 전달하세요.

​
매개변수

이름유형
opts?SpanEndOptions

​
반환값

void

​
정의 위치

src/genai/subagent.ts:72

​
setAttributes

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

​
매개변수

이름유형
attributesAttributes

​
반환값

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

​
상속됨

SpanBase.setAttributes

​
정의 위치

src/genai/spanBase.ts:63

​
create

▸ create(opts): SubAgent

​
매개변수

이름유형
optsSubAgentInit & ChildSpanContext

​
반환값

SubAgent

​
정의 위치

src/genai/subagent.ts:46