커스텀에이전트 - 서브에이전트와 Task 도구
목차
복잡한 작업을 혼자 다 처리하려면 버거울 때가 있습니다.
이럴 때 서브에이전트를 활용하면 작업을 분산하고 병렬로 처리할 수 있습니다.
이 글에서는 커스텀 서브에이전트를 만들고 활용하는 방법을 알아봅니다.
서브에이전트란?
서브에이전트가 뭔가요?
팀 프로젝트를 생각해봐. 팀장이 모든 일을 직접 하면 힘들잖아? 그래서 팀원에게 업무를 분담하지. 서브에이전트가 바로 그 팀원이야.
그럼 메인 에이전트가 팀장이고, 서브에이전트가 팀원인 거네요?
정확해! 메인 에이전트가 전체를 조율하고, 서브에이전트들이 각자 맡은 작업을 처리해서 결과를 돌려주는 거야.
메인 에이전트 = 전체 작업 조율 (팀장)
서브에이전트 = 특정 작업 전담 (팀원)
결과: 복잡한 작업 분산 + 병렬 처리 가능
언제 서브에이전트를 쓸까?
💡 서브에이전트가 유용한 경우
- 여러 파일 분석 - 각 파일을 서브에이전트가 병렬 분석
- 다양한 관점 필요 - 각 관점별 서브에이전트 배치
- 독립적인 작업들 - 서로 의존하지 않는 작업 동시 처리
- 긴 작업 분할 - 큰 작업을 작은 단위로 나눠 처리
예시: 코드 리뷰
- 서브에이전트 A: 보안 검토
- 서브에이전트 B: 성능 검토
- 서브에이전트 C: 코드 스타일 검토
→ 병렬로 동시 실행 → 결과 종합
Task 도구 이해
서브에이전트는 Task 도구로 생성합니다.
description = 작업 설명 (3-5단어)
prompt = 서브에이전트에게 주는 지시
subagent_type = 에이전트 유형 (기본: general-purpose)
기본 서브에이전트 유형
| 유형 | 특화 분야 | 사용 도구 |
|---|---|---|
| general-purpose | 범용 작업 | 모든 도구 |
| Explore | 코드베이스 탐색 | Glob, Grep, Read |
| Bash | 명령 실행 | Bash만 |
| Plan | 설계/계획 | 읽기 전용 도구 |
커스텀 서브에이전트 만들기
settings.json에서 나만의 서브에이전트를 정의할 수 있습니다.
설정 예시
{
"customAgents": {
"security-reviewer": {
"description": "보안 취약점 전문 검토 에이전트",
"tools": ["Read", "Grep", "Glob"],
"systemPrompt": "당신은 보안 전문가입니다. OWASP Top 10 기준으로 코드를 검토합니다."
},
"performance-analyzer": {
"description": "성능 분석 전문 에이전트",
"tools": ["Read", "Grep", "Bash"],
"systemPrompt": "당신은 성능 최적화 전문가입니다. 병목 지점을 찾고 개선안을 제시합니다."
}
}
}tools를 왜 제한해요?
두 가지 이유야.
① 보안 - 불필요한 권한 제거
② 집중 - 맡은 작업에만 집중하도록
병렬 실행
여러 서브에이전트를 동시에 실행할 수 있습니다.
병렬 실행 = 여러 Task를 한 번에 호출
독립적인 작업들은 순차가 아닌 동시 실행으로 시간 절약!
💡 병렬 실행 시나리오
목표: 코드 종합 리뷰
- Task 1 (security-reviewer): 보안 검토
- Task 2 (performance-analyzer): 성능 검토
- Task 3 (Explore): 코드 구조 분석
→ 3개 동시 실행 → 결과 종합
병렬 실행은 독립적인 작업에만 사용하세요. 작업 간 의존성이 있으면 순차 실행해야 합니다!
서브에이전트 = 특정 작업 전담 처리자
Task 도구 = 서브에이전트 생성 도구
커스텀 에이전트 = settings.json에서 정의
병렬 실행 = 독립 작업 동시 처리
tools 제한 = 보안과 집중력 향상
👉 에이전트 팀즈 : 여러 에이전트가 협업하는 고급 패턴
서브에이전트로 복잡한 작업도 효율적으로 처리하세요!
혼자 하지 말고, 팀으로 일하세요! 👥
댓글
댓글 쓰기