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

# 하위 에이전트와 하위 세션: Agent가 작업을 병렬로 처리하게 하기

> 메인 Agent가 같은 세션 안에서 하위 에이전트를 시작해 병렬로 작업하고 모두 끝나면 자동으로 결과를 합치는 방법, Agent가 시작한 하위 세션이 세션과 사이드바에 표시되는 방식과 그 상태를 설명합니다.

복잡한 작업에서 메인 Agent는 병렬로 실행할 수 있는 부분을 다른 곳에 맡길 수 있습니다. AIHubMix Cloud는 두 가지 형태를 제공합니다.

* **하위 에이전트**: 메인 Agent가 **같은 세션 안에서** 시작하는 보조 에이전트입니다. 세션에는 진행 행이 하나만 추가되며, 오른쪽 패널의 하위 에이전트 탭에서 작업 내용을 읽기 전용으로 볼 수 있습니다.
* **하위 세션**: Agent가 시작하는 **별도의 세션**입니다. 각 하위 세션은 사이드바에서 상위 세션 아래에 중첩된 자체 행을 가지며, 따로 열어서 승인을 처리할 수 있습니다.

두 형태 모두 직접 만드는 **Fork** 와 다릅니다. 포크는 일반 세션입니다. [메시지 및 세션 작업](https://docs.aihubmix.com/ko/cloud/sessions/messages.md)을 참고하세요.

## 적용 범위

| 형태 | 지원 | 비고 |
| - | - | - |
| 데스크톱 앱 | 지원 | |
| 웹 앱 | 지원 | 데스크톱 앱과 같습니다 |
| 모바일 웹 | 지원 | 작업 요약 카드가 자동으로 열리지 않습니다. 상단 바 버튼에서 열 수 있습니다 |
| 분할 창 | 일부 지원 | 창에 오른쪽 패널과 작업 요약 카드가 없으며, 하위 에이전트 도형을 클릭할 수 없습니다 |

## 하위 에이전트

### 하위 에이전트의 이름과 도형

각 하위 에이전트에는 시작된 순서대로 이름(Coral, Lagoon, Iris, Lime, Amber, Sky. 6개를 넘으면 숫자가 붙음. 예: **Coral 2**)과 그에 맞는 색상 도형이 할당되며, 세션 안에서 고정됩니다. 실행 중인 하위 에이전트는 도형 주위에 얇은 호가 회전합니다.

도형은 세션의 하위 에이전트 행, 계획에서 해당 하위 에이전트가 맡은 단계, 작업 요약 카드, 패널 탭, **Changes** 의 파일 출처 표시에 나타납니다.

### 세션에 행 하나 추가

메인 Agent가 하위 에이전트를 시작하면 과정 영역에 행이 하나만 추가됩니다. 함께 시작된 여러 하위 에이전트는 한 행을 공유합니다.

| 상태 | 행에 표시되는 내용 |
| - | - |
| 하위 에이전트 실행 중 | **Started 4 subagents** + 하위 에이전트 도형 한 줄 + 개수. 예: **2 done · 2 running** |
| 모두 완료 | **4 subagents done** |
| 모두 종료, 일부 실패 또는 중지 | **4 subagents ended** + **1 failed · 1 stopped** |

도형에 마우스를 올리면 "이름 · 작업"이 표시되고, 클릭하면 오른쪽 패널에 해당 하위 에이전트의 탭이 열립니다.

### 하위 에이전트는 백그라운드에서 실행됨

하위 에이전트를 시작한 후 메인 Agent는 기다리지 않고 자신의 부분을 계속 진행할 수 있습니다.

* 하위 에이전트가 아직 실행 중일 때 메인 Agent의 턴이 끝나면 타이머 행에 **Worked for Ns** 가 표시되지만, 과정은 **펼쳐진 상태로 유지**되고 하위 에이전트 행이 계속 업데이트됩니다.
* 이때 하위 에이전트를 기다리지 않고 계속 메시지를 보낼 수 있습니다.
* 모든 하위 에이전트가 종료되면 플랫폼이 자동으로 메인 Agent가 새 턴을 시작해 결과를 합치게 합니다. 작업 요약 카드가 닫혀 있으면 상단 바 버튼에 초록색 점이 나타납니다.

### 하위 에이전트 탭

하위 에이전트 도형을 클릭하거나 패널의 **+** 메뉴에서 선택하면 오른쪽 패널에 해당 하위 에이전트의 탭이 열립니다. 탭에는 위에서 아래로 다음이 표시됩니다.

1. 이름, 작업, 상태(Queued / Running / Done / Stopped / Failed).
2. 사용한 모델과 추론 강도, 소요 시간.
3. 메인 채팅이 전달한 전체 작업 설명.
4. **Activity**: 수행한 각 단계. 실패한 단계에는 경고 아이콘이 사용됩니다.
5. **Its changes**: 변경한 파일과 추가 및 삭제된 줄 수. 파일을 클릭하면 **Files** 에서 열립니다.
6. **결과**(종료 후): 메인 채팅에 전달한 결론, 또는 중지되거나 실패한 이유의 세부 정보.
7. 아래쪽의 **Stop** 과 **Show in chat**.

| 버튼 | 동작 |
| - | - |
| Stop | 하위 에이전트가 실행 중일 때 표시됩니다(내 컴퓨터에서 실행되는 세션에서는 사용할 수 없음). 이 하위 에이전트만 중지합니다. 완료된 변경은 유지되며 다른 하위 에이전트는 영향을 받지 않습니다 |
| Show in chat | 세션에서 이 하위 에이전트를 시작한 행으로 이동해 잠시 강조 표시합니다 |

* 하위 에이전트 탭은 읽기 전용이며, 여기서 메시지를 보낼 수 없습니다. 작업을 조정하려면 메인 채팅에서 Agent에게 요청하세요.

### 작업 요약 카드와 Changes에서 보기

* **작업 요약 카드**의 **Subagents** 섹션에는 모든 하위 에이전트와 진행 상황이 표시됩니다. **Plan** 섹션에서는 각 단계 오른쪽에 그 단계를 맡은 하위 에이전트가 표시됩니다. 카드 전체 설명은 [에이전트 출력 읽기](https://docs.aihubmix.com/ko/cloud/sessions/agent-output.md#task-summary-card)를 참고하세요.
* **Changes** 탭에서는 각 파일에 마지막으로 그 파일을 변경한 하위 에이전트 또는 메인 Agent가 표시됩니다.

## 하위 세션

**하위 세션**은 Agent가 시작한 별도의 세션입니다. 사이드바에 자체 행이 있으며, 따로 열어서 승인을 처리하고 중지할 수 있습니다. 하위 세션도 자신의 하위 세션을 시작할 수 있습니다.

### 상위 세션의 시작 카드

Agent가 하위 세션을 시작하면 상위 세션에 **Spawned N sub-sessions** 카드가 나타나며, 하위 세션마다 한 행이 표시됩니다. 행을 클릭하면 해당 하위 세션이 열립니다. 이 카드는 실행이 접힌 후에도 계속 표시됩니다.

| 하위 세션 상태 | 행 끝에 표시되는 내용 |
| - | - |
| 대기열, 시작 중 또는 실행 중 | **Running** |
| 입력 대기 중 | **Needs approval** |
| 마지막 턴 실패 | **Failed** |
| 마지막 턴 중지 또는 중단 | **Stopped** |
| 완료, 유휴 | **Done** |
| 삭제됨 | **Sub-session deleted**, 클릭할 수 없음 |

하위 세션의 각 턴이 끝나면 상위 세션에 안내가 나타납니다. 예: **“Check Web settings page regression” finished: 28 checks passed, reported back**, 또는 중지됨, 실패함, 입력 필요 등.

### 사이드바의 두 단계

* 하위 세션은 상위 세션 아래에 중첩됩니다. 상위 세션 행 끝의 개수를 클릭하면 펼치거나 접습니다.
* **최대 2단계까지 표시됩니다**: 상위 세션 → 하위 세션 → 손자 세션.
* 펼치면 실행 중이거나 입력을 기다리는 등 아직 종료되지 않은 하위 세션은 바로 나열됩니다. 종료된 하위 세션은 **N completed** 한 행으로 접히며, 클릭하면 펼쳐집니다.
* **Pinned** 그룹은 하위 세션을 접지 않습니다. 행 끝의 상태 규칙은 일반 세션과 같습니다. [사이드바](https://docs.aihubmix.com/ko/cloud/interface/sidebar.md)를 참고하세요.

### 하위 세션에 시작한 세션 표시

하위 세션을 열면 상단 바의 제목 옆에 **Spawned from “parent session title”** 이 나타납니다. 클릭하면 상위 세션으로 돌아갑니다. 명령 메뉴(`⇧⌘P`)의 **Go to parent chat** 을 사용할 수도 있습니다. 상위 세션이 삭제된 경우 **Spawned from another chat** 이 표시됩니다.

### 이동과 승인

* 상위 세션을 프로젝트로 이동하면 하위 세션도 함께 이동합니다. 하위 세션만 따로 이동할 수 없습니다.
* 하위 세션의 승인은 일반 세션과 같은 방식으로 동작합니다. [입력 필요](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)를 참고하세요.

## 자주 묻는 질문

### 하위 에이전트가 실행되는 동안 계속 채팅할 수 있나요?

할 수 있습니다. 메인 Agent의 턴이 끝나면 계속 메시지를 보낼 수 있습니다. 모든 하위 에이전트가 종료되면 메인 Agent가 자동으로 새 턴을 시작해 결과를 합칩니다.

### 하위 에이전트에게 직접 지시할 수 있나요?

할 수 없습니다. 하위 에이전트 탭은 읽기 전용이므로 메인 채팅에서 Agent에게 전달하세요. 하위 에이전트를 중지하려면 탭 아래쪽의 **Stop** 을 클릭합니다. 완료된 변경은 유지됩니다.

### 하위 에이전트와 하위 세션은 어떻게 다른가요?

하위 에이전트는 같은 세션 안에서 실행되며, 작업 내용을 읽기 전용으로 봅니다. 하위 세션은 사이드바에 자체 행이 있는 별도의 세션이며, 따로 열어서 승인을 처리할 수 있습니다.

### 사이드바에 하위 세션이 왜 보이지 않나요?

상위 세션은 기본적으로 하위 세션을 접어 둡니다. 상위 세션 행 끝의 개수를 클릭해 펼치세요. 종료된 하위 세션은 **N completed** 행으로 한 번 더 접혀 있습니다.

## 관련 문서

* [에이전트 출력 읽기](https://docs.aihubmix.com/ko/cloud/sessions/agent-output.md)
* [메시지 및 세션 작업](https://docs.aihubmix.com/ko/cloud/sessions/messages.md)
* [오른쪽 패널](https://docs.aihubmix.com/ko/cloud/interface/right-drawer.md)
* [사이드바](https://docs.aihubmix.com/ko/cloud/interface/sidebar.md)
* [입력 필요](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)
* [활동](https://docs.aihubmix.com/ko/cloud/sessions/activity-log.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.