서브에이전트¶
서브에이전트를 사용하면 Kiro가 여러 작업을 병렬로 실행하거나 해당 작업을 전문으로 하는 서브에이전트에 특정 작업을 위임할 수 있습니다. Kiro는 필요에 따라 자동으로 서브에이전트를 시작합니다. "Run subagents to..."와 같은 프롬프트를 통해 Kiro에 지시하여 수동으로 서브에이전트를 시작할 수도 있습니다.
Kiro에는 두 가지 내장 서브에이전트가 있습니다: 프로젝트를 탐색하고 관련 컨텍스트를 수집하는 데 사용되는 "컨텍스트 수집" 서브에이전트와 다른 모든 작업을 병렬 처리하는 데 사용되는 "범용" 서브에이전트입니다.
서브에이전트는 병렬로 실행됩니다. 그러나 메인 Kiro 에이전트는 모든 서브에이전트가 완료될 때까지 기다린 후 진행합니다. 각 서브에이전트에는 자체 컨텍스트 창이 있어 메인 에이전트 컨텍스트가 서브에이전트의 실행으로 오염되지 않습니다. 서브에이전트는 완료되면 자동으로 결과를 메인 에이전트에 반환합니다.
스티어링 파일 및 MCP 서버는 메인 에이전트에서와 마찬가지로 서브에이전트에서 정확히 동일하게 작동합니다. 그러나 서브에이전트는 Spec에 액세스할 수 없으며, 훅은 서브에이전트에서 트리거되지 않습니다.
서브에이전트를 활용하여 여러 작업을 동시에 수행함으로써 개발 속도를 크게 높일 수 있습니다. 다음 예에서는 서브에이전트를 사용하여 여러 티켓을 병렬로 가져오고 분석합니다. 티켓을 순차적으로 분석하는 것보다 빠를 뿐만 아니라 도구 호출 및 티켓 세부 정보가 각 서브에이전트 내에 유지되어 메인 에이전트의 컨텍스트를 오염시키지 않습니다.
커스텀 서브에이전트¶
~/.kiro/agents(전역) 또는 <workspace>/.kiro/agents(워크스페이스 범위)에 마크다운(.md) 파일을 생성하여 자체 커스텀 에이전트를 정의할 수 있습니다. 마크다운 파일의 본문에 커스텀 에이전트를 위한 프롬프트를 입력하고 YAML 프론트매터로 추가 속성을 정의합니다.
예를 들어 간단한 "코드 리뷰어" 커스텀 에이전트를 생성하려면 다음 내용으로 ~/kiro/agents/code-reviewer.md를 생성합니다:
markdown
--- name: code-reviewer description: Expert code review assistant. tools: ["read", "@context7"] model: claude-sonnet-4 --- You are a senior code reviewer. ## Your Responsibilities - Review code for correctness, performance, and security ...
호출¶
서브에이전트를 시작할 때 Kiro는 description 필드를 기반으로 각 서브에이전트에 적합한 커스텀 에이전트 구성을 자동으로 선택합니다. 특정 서브에이전트를 사용하도록 Kiro에 명시적으로 요청할 수도 있습니다. 예를 들어 "Use the code-reviewer subagent to find performance issues in my code"라고 할 수 있습니다. 서브에이전트는 슬래시 명령으로도 나타나므로 "/code-reviewer find performance issues in my code"를 사용할 수도 있습니다.
속성¶
다음은 프론트매터에서 사용할 수 있는 속성 목록입니다. name 속성은 필수이며, 다른 모든 속성은 선택 사항입니다.
| 속성 | 설명 | 예제 값 | 생략 시 기본값 |
|---|---|---|---|
| name | 에이전트의 이름 | code-reviewer | .md 파일의 이름 |
| description | 에이전트의 설명 | Expert code review assistant | 설명 없음 |
| tools | 에이전트가 액세스할 수 있는 도구 목록(배열) | ["@builtin", "@context7"] | 도구 없음 |
| model | 사용할 모델 | claude-sonnet-4 | 채팅에서 현재 선택된 LLM |
| includeMcpJson | true이면 모든 MCP 도구가 포함됨 | true | false |
| includePowers | true이면 Powers의 모든 MCP 도구가 포함됨 | true | false |
tools 필드에서 다음을 사용할 수 있습니다:
- read: 모든 내장 파일 읽기 도구
- write: 모든 내장 파일 쓰기 도구
- shell: 모든 내장 셸 명령 관련 도구
- web: 모든 내장 웹 도구
- spec: 모든 내장 spec 관련 도구 (Spec 모드에서만 유효)
- @builtin: 모든 내장 도구
- @
- @
와일드카드가 지원됩니다. 예를 들어 tools: ["*"]는 모든 내장 및 MCP 도구를 포함하고, tools: ["@figma/*"]는 figma MCP 서버의 모든 도구를 포함합니다.