> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Subagent(서브에이전트)

> 메인 Agent가 읽기 전용 서브에이전트를 자동으로 배정해 병렬로 정보를 탐색. 컨텍스트를 절약하고 로딩을 빠르게 하며 비용을 제어

SoloEnt는 **메인 Agent와 서브에이전트(Subagent)의 협업** 으로 작업을 완료할 수 있습니다. 메인 Agent는 작업 필요에 따라 서브에이전트를 자동으로 배정해 탐색 작업을 할당하고, 여러 서브에이전트가 **병렬** 로 완료하면 결과를 메인 Agent로 취합합니다. 이렇게 하면 넓은 범위를 탐색할 때 메인 Agent의 컨텍스트가 방대한 원자료로 가득 차는 것을 막을 수 있습니다.

## 적합한 상황

<Check>
  **적합**: 지식 탐색, 정보 수집, 분류 협업 등의 상황——메인 Agent가 서로 다른 탐색 작업을 각기 다른 서브에이전트에 할당해 병렬로 완료시키고 취합합니다.
</Check>

* 무기 자료, 세계관 지식, 캐릭터 비주얼 설계를 각각 수집
* 서로 다른 챕터를 각각 읽은 뒤 취합

<Warning>
  **부적합**:

  * **반복적인** 작업을 여러 서브에이전트에 동시에 할당——서로 다른 서브에이전트가 같은 컨텍스트를 반복해서 읽어 오히려 낭비가 됩니다
  * **생산·출력형** 작업——서브에이전트는 탐색·수집·정리가 주이며, **쓰기 도구가 없고** 출력을 담당하지 않습니다
</Warning>

## 켜는 위치

**Agent 설정** 에서 서브에이전트를 켜거나 끌 수 있습니다. 켜면 메인 Agent가 작업 요구에 따라 서브에이전트 협업을 자동으로 트리거합니다.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/subagent_1.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=8c706bf1bb75461f7ac4ae987b141491" alt="Agent 기능 설정의 서브에이전트 스위치. SoloEnt가 읽기 전용 리서치 서브에이전트를 병렬로 실행해 집필 프로젝트에서 근거를 수집한다고 설명됨" style={{ width: '70%' }} width="792" height="640" data-path="assets/images/subagent_1.png" />

예를 들어 넓은 범위의 지식 탐색을 할 때, 메인 Agent는 **읽기 전용 서브에이전트** 를 병렬로 실행하도록 위임하고 결과를 메인 Agent로 취합하여 컨텍스트 자원을 크게 절약할 수 있습니다.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/subagent_2.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=e43924b665dee6ecc6e452e94b5200f2" alt="메인 Agent가 서브에이전트 3개를 병렬로 실행해 앞 3개 챕터·캐릭터·개요를 분석하여 다음 챕터 집필을 지원하는 실행 화면" style={{ width: '70%' }} width="866" height="1138" data-path="assets/images/subagent_2.png" />

## 서브에이전트에 별도 모델 설정하기

서브에이전트는 주로 메인 작업에 필요한 정보를 탐색하므로 **메인 Agent와 다른 모델** 을 조합해 탐색하게 할 수 있습니다. 잘 배분할 때의 이점:

* 메인 Agent의 컨텍스트 절약
* 병렬 탐색으로 정보 로딩 속도 향상
* 더 저렴한 모델을 사용해 전체 비용 절감

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/subagent_3.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=be27c071a1098cc179447368d416fd0f" alt="Agent 설정의 API Configuration에 있는 SUBAGENT 구역. 서브에이전트 모델을 Same as main으로 두거나 별도로 지정할 수 있음" style={{ width: '70%' }} width="808" height="1488" data-path="assets/images/subagent_3.png" />

<CardGroup cols={2}>
  <Card title="컨텍스트 윈도우" icon="gauge" href="/ko/faq">
    컨텍스트가 어떻게 소비되는지, 언제 새 창을 열어야 하는지 알아보기
  </Card>

  <Card title="Skills(스킬)" icon="wand-magic-sparkles" href="/ko/tips/skills">
    재사용 가능한 탐색·정리 흐름을 Skill로 정착시켜 서브에이전트와 함께 사용하기
  </Card>
</CardGroup>
