멀티 에이전트 시스템을 계측하세요

다중 에이전트 시스템에서 상위 에이전트는 작업을 하위 에이전트에게 위임합니다. AI SDK를 사용하여 부모에서 자식 에이전트를 생성하면 에이전트 분석이 위임을 기록합니다. 자식 에이전트는 [Agent] Parent Agent ID을 전달받으며 세션은 루트 에이전트와 체인 깊이를 기록합니다. 또한 공급자 래퍼는 위임된 호출 내에서 가짜 사용자 메시지 이벤트를 억제합니다. AI SDK는 사용자가 직접 소스를 설정하지 않는 한 위임된 사용자 메시지에 대해 [Agent] Message Source을(를) agent(으)로 설정합니다. 모든 에이전트의 이벤트는 하나의 [Agent] Session ID 아래에 유지됩니다.

모든 에이전트에게 사람이 읽을 수 있는 안정적인 ID를 부여하십시오. 이러한 ID는 시스템 전체에서 품질과 비용을 비교하기 위한 기본 차원이 됩니다.

하위 에이전트 선언 및 디스패치

.child()을(를) 사용하여 부모 요소의 자식을 선언한 다음, runAs()(Node) 또는 arun_as()(Python)을 사용하여 디스패치(dispatch)합니다:

typescript
const orchestrator = ai.agent('shopping-agent', { description: 'Orchestrates shopping requests' });
const recipeAgent = orchestrator.child('recipe-agent', { description: 'Finds recipes' });
await orchestrator.session({ userId }).run(async (s) => {
  s.trackUserMessage(userInput);
  const result = await s.runAs(recipeAgent, async (cs) => {
    cs.trackUserMessage(delegatedQuery);
    return openai.chat.completions.create({ model: 'gpt-4o', messages: [...] });
  });
});

하위 에이전트는 상위의 experiments을(를) 상속받으며, 하위 에이전트는 키로 항목을 추가하거나 재정의할 수 있습니다. runAs()와(과) arun_as()의 이벤트는 세션의 실험 정보도 포함합니다. 에이전트 분석에서 실험 변형 기록을 참조하십시오.

전체 위임 의미론(컨텍스트 상속, 스팬 래핑, 중첩된 자식, 팬 아웃)에 대해서는 SDK 참조에서 멀티 에이전트 아키텍처을(를) 참조하십시오.

다중 에이전트 세션 분석

각 [Agent] Session Record에는 [Agent] Root Agent Name 및 [Agent] Agent Chain Depth이(가) 포함됩니다. 깊이는 가장 긴 위임 경로에 있는 에이전트 수입니다. 1은 단일 에이전트, 2는 한 홉, 3 이상은 더 깊은 네스팅입니다. 부모가 여러 자식에게 팬아웃할 때, 깊이는 가장 깊은 브랜치를 따릅니다. 다중 에이전트 세션을 찾기 위해 체인 깊이가 1보다 큰 세션 레코드를 필터링합니다. Depth 2는 정확히 한 홉을 의미합니다. 에이전트를 비교하려면 차트를 [Agent] Agent ID(으)로 그룹화합니다. 데이터 계층을 참조하십시오.

스팬의 상위 스팬은 상위 에이전트가 아닙니다. OpenTelemetry에서 스팬 속성을 amplitude.parent.agent.id(으)로 설정합니다. 프로세스 전체에 걸쳐 기존 agent-id 헤더 옆x-amplitude-parent-agent-id에 전파하십시오. LangSmith 포워더는 구성된 에이전트 하나를 기록합니다: 중첩된 LangSmith 실행은 도구 호출이나 스팬으로 유지되며 하위 에이전트가 되지 않습니다.

이 내용이 도움이 되었나요?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

이 페이지에서