메인 콘텐츠로 건너뛰기
서브에이전트는 부모 에이전트가 독립적인 하위 작업을 처리하도록 호출하는 자식 에이전트입니다. 자식은 자체 컨텍스트 윈도우와 연결된 자체 도구로 실행된 후, 간결한 결과를 부모에게 반환합니다. 부모는 자식의 중간 단계는 볼 수 없고 최종 답변만 받습니다. 부모 에이전트가 핵심 작업에 집중하도록 하려면 서브에이전트를 사용하십시오. 긴 조사 과정, 도구를 많이 사용하는 탐색, 전문적인 검토 단계는 토큰을 많이 소모하는 중간 상태가 부모의 컨텍스트에 남지 않을 때 더 효과적입니다.

서브에이전트 활성화

Agent Builder에서 고급 설정을 열고 서브에이전트를 켜세요. 그러면 옵션 2개가 더 나타납니다.
  • 자체 복제 허용 - 켜면 에이전트가 병렬 작업을 위해 자신의 사본을 생성할 수 있습니다. 팬아웃 패턴(부모 에이전트 1개, 동일한 워커 여러 개)에 유용합니다.
  • 추가 서브에이전트 - 이 부모 에이전트가 위임할 수 있도록 허용할 다른 특정 에이전트를 선택합니다. 부모 에이전트는 작업에 따라 어떤 서브에이전트(있는 경우)를 호출할지 런타임에 결정합니다.
저장하세요. 에이전트가 실행되면 서브에이전트를 호출하는 새 도구를 사용할 수 있습니다.

서브에이전트가 도움이 되는 경우

  • 리서치 하위 작업 - 부모 에이전트가 복잡한 질문을 분해하고, 그중 일부를 해당 영역에 특화된 서브에이전트에 맡긴 뒤, 응답을 종합합니다.
  • 도구 사용량이 많은 처리 단계 - 코드 인터프리터 세션, 여러 단계의 웹 검색 루프, 또는 중간 도구 출력 때문에 부모 에이전트의 컨텍스트를 크게 소모하는 작업입니다.
  • 전문적인 검토 - 한 에이전트가 생성하고 다른 에이전트가 검토하며, 검토자의 전체 추론은 자체 컨텍스트 윈도우에 유지됩니다.
사소한 호출에는 서브에이전트를 사용하지 마십시오. 인계 과정에서 지연 시간과 토큰이 추가됩니다.

서브에이전트 vs. 에이전트 체인

서브에이전트는 런타임 위임 메커니즘으로, 부모 에이전트가 실행 중에 필요에 따라 결정합니다. 에이전트 체인은 고정된 순서로 실행되는 에이전트들로 구성된 사전 정의 그래프입니다. 라우팅이 동적이면 서브에이전트를 사용하고, 라우팅이 고정되어 있으면 체인을 사용하십시오.

제한 사항

  • 부모 에이전트당 나열할 수 있는 서브에이전트는 최대 10개입니다.
  • 루트 에이전트로부터 최대 5홉 깊이까지 지원됩니다.
  • 단일 실행에서 로드할 수 있는 고유한 서브에이전트 대상은 최대 50개입니다.
  • 요청당 확장된 서브에이전트 구성은 최대 100개입니다.
참조하는 서브에이전트는 부모 에이전트를 실행하는 사용자에게 보여야 합니다. 참조가 접근할 수 없거나 삭제된 에이전트로 확인되면 자동으로 건너뛰므로, 하위 에이전트가 없어도 정상적으로 처리할 수 있도록 부모 에이전트를 설계하십시오.
마지막 수정일 2026년 6월 12일