> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 서브에이전트

> ClickHouse Agents에서 작업을 서브에이전트에 위임하기

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Beta feature. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

서브에이전트는 부모 에이전트가 독립적인 하위 작업을 처리하도록 호출하는 자식 에이전트입니다. 자식은 자체 컨텍스트 윈도우와 연결된 자체 도구로 실행된 후, 간결한 결과를 부모에게 반환합니다. 부모는 자식의 중간 단계는 볼 수 없고 최종 답변만 받습니다.

부모 에이전트가 핵심 작업에 집중하도록 하려면 서브에이전트를 사용하십시오. 긴 조사 과정, 도구를 많이 사용하는 탐색, 전문적인 검토 단계는 토큰을 많이 소모하는 중간 상태가 부모의 컨텍스트에 남지 않을 때 더 효과적입니다.

<div id="enable-subagents">
  ## 서브에이전트 활성화
</div>

Agent Builder에서 **고급 설정**을 열고 **서브에이전트**를 켜세요. 그러면 옵션 2개가 더 나타납니다.

* **자체 복제 허용** - 켜면 에이전트가 병렬 작업을 위해 자신의 사본을 생성할 수 있습니다. 팬아웃 패턴(부모 에이전트 1개, 동일한 워커 여러 개)에 유용합니다.
* **추가 서브에이전트** - 이 부모 에이전트가 위임할 수 있도록 허용할 다른 특정 에이전트를 선택합니다. 부모 에이전트는 작업에 따라 어떤 서브에이전트(있는 경우)를 호출할지 런타임에 결정합니다.

저장하세요. 에이전트가 실행되면 서브에이전트를 호출하는 새 도구를 사용할 수 있습니다.

<div id="when-a-subagent-helps">
  ## 서브에이전트가 도움이 되는 경우
</div>

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

사소한 호출에는 서브에이전트를 사용하지 마십시오. 인계 과정에서 지연 시간과 토큰이 추가됩니다.

<div id="subagents-vs-agent-chain">
  ## 서브에이전트 vs. 에이전트 체인
</div>

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

<div id="limits">
  ## 제한 사항
</div>

* 부모 에이전트당 나열할 수 있는 서브에이전트는 최대 **10개**입니다.
* 루트 에이전트로부터 최대 **5**홉 깊이까지 지원됩니다.
* 단일 실행에서 로드할 수 있는 고유한 서브에이전트 대상은 최대 **50개**입니다.
* 요청당 확장된 서브에이전트 구성은 최대 **100개**입니다.

참조하는 서브에이전트는 부모 에이전트를 실행하는 사용자에게 보여야 합니다. 참조가 접근할 수 없거나 삭제된 에이전트로 확인되면 자동으로 건너뛰므로, 하위 에이전트가 없어도 정상적으로 처리할 수 있도록 부모 에이전트를 설계하십시오.