헤르메스 delegate_task 병렬 위임 가이드
분석가 Ada에게 경쟁사 가격 조사를 맡기는데, 살펴볼 가격대가 저가·중가·프리미엄 세 갈래입니다. 한 명이 하나씩 처리하면 느리고, 갈래마다 정직원(프로필)을 새로 뽑을 필요도 없죠. 이럴 때 쓰는 게 delegate_task: 잠깐 띄웠다 결과만 받고 사라지는 **임시 알바(서브에이전트)**입니다. 이 가이드에서는 Ada가 임시 알바 셋을 병렬로 띄워 가격을 모으고, 그 결과를 종합해 빈 가격대를 찾은 뒤, Google Docs 보고서까지 올립니다.
💡 사전 요구사항
- 헤르메스 MCP 가이드 (Bright Data 연결). 이번엔 같은 Bright Data를 MCP가 아닌 CLI로 씁니다.
- 헤르메스 데스크톱 앱 설치·연결 가이드. 병렬 동작을 눈으로 보기 위해 데스크톱 앱으로 시연합니다.
- 헤르메스 구글 워크스페이스 연결 가이드 (gws). 마지막 Google Docs 업로드에 씁니다.
1. 임시 알바(delegate_task)란
지난 시간에는 디자이너 Mia에게 목표를 통째로 맡겨 자율로 끝까지 굴러가게 했습니다. 그런데 그건 한 줄기로 순차 진행됐죠. 일이 늘 그렇게 한 줄기로만 오지는 않습니다. 동시에 여러 갈래를 알아봐야 할 때가 있어요.
- 모든 일에 정직원(프로필)을 새로 뽑을 필요는 없습니다.
- 잠깐 조사만 시키고 결과만 받으면 되는 일은 임시 알바, 즉
delegate_task로 처리합니다.
2. 임시 알바의 네 가지 특징
1. 익명: 이름이 없습니다. 프로필을 만들지 않아요.
2. 일시: 일이 끝나면 사라집니다. 알바가 자기 일 하고 집에 가면 끝인 것처럼요.
3. 격리: 회사 사정을 모릅니다. 시스템 전체의 맥락도, 지금 이 대화의 맥락도 전혀 모르는 채로 받은 일만 시작합니다.
4. 요약만: 중간 과정은 빼고 정리된 결과만 가져옵니다.
기술적으로 보면 delegate_task는 함수를 한 번 호출하는 것입니다. 일을 던지고, 결과를 받고, 끝. 요청하고 응답받는 한 번의 왕복이라 짧고 간결하죠.
💡 다음 시간에 볼 칸반(kanban)은 이것과 정반대입니다. 보드에 계속 남죠. 그 비교는 다음 시간에 다룹니다.
3. 일 잘 맡기는 세 가지 요령
delegate_task는 따로 치는 슬래시 명령이 없습니다. 자연어로 부탁하면 직원(프로필)이 알아서 보조 일꾼을 나눠 띄웁니다. 그래서 프롬프트를 어떻게 쓰느냐가 결과를 좌우합니다.
- 통째로 받아 적게: 보조 일꾼은 우리 대화를 하나도 모릅니다. "아까 그거", "우리 브랜드"라고 하면 못 알아들어요. 그 문장 하나만 읽고도 일이 되도록 무엇을 조사할지 다 담아주세요.
- 안 겹치게 쪼개기: 병렬로 동시에 돌리니, 한 일꾼의 결과를 다른 일꾼이 받아써야 하는 구조면 안 됩니다. 각자 따로 떼어내도 굴러가는 독립 덩어리로 나눠야 해요. 오늘의 저가·중가·프리미엄 세 구간이 딱 그렇습니다.
- 한국어로 받기: 끝에 "한국어로 요약해줘"를 붙이세요. 안 붙이면 보조 일꾼이 영어로 답을 가져와 최종 보고까지 영어가 섞입니다.
⚠️ 요약은 자기 보고입니다. 보조 일꾼이 "다 했습니다" 하고 가져온 요약은 중간에 막혔어도 그럴듯하게 정리해 올 수 있어요. 바깥에 올리거나 저장하는 일이면 결과 주소·파일 경로를 같이 받아 직접 확인하세요. 지난 시간 Judge가 증거를 요구하던 것과 같은 맥락입니다.
4. 서브에이저트가 쓸 수 있는 도구 (MCP는 못 물려받습니다)
임시 알바를 띄우기 전에 꼭 알아야 할 게 있습니다. 서브에이전트가 쓸 수 있는 도구가 정해져 있어요.
- ✅ 물려받음: 호출한 메인 에이전트(여기서는 Ada)의 **스킬과 터미널(기본 도구)**은 그대로 상속합니다.
- ❌ 못 가져감: 메인 에이전트의 MCP 도구는 쓸 수 없습니다. 또 재위임(다른 알바 부르기), 되묻기(중간에 다시 질문), 공용 메모리 쓰기도 막혀 있습니다.
⚠️ 서브에이전트는 한 번 시작하면 끝날 때까지 진행합니다. 중간에 되물을 수 없으니, 질문 없이 끝까지 실행되도록 프롬프트에 정보를 다 담아야 합니다.
그래서 이번엔 조사 방법을 바꿉니다. 지난 시간엔 Bright Data를 MCP로 붙여 썼지만, 임시 알바는 MCP를 못 받습니다. 대신 Bright Data의 CLI 도구(터미널에서 도는 프로그램)를 씁니다. 터미널과 스킬은 상속되니, brightdata-guide 스킬 + bdata CLI 조합으로 같은 Bright Data를 그대로 쓸 수 있습니다.
5. Ada에게 능력 장착 — 스킬 두 개 설치
오늘 쓸 스킬은 두 개입니다. 둘 다 dandacompany/dante-skills 저장소에 있고, 수업 자료 프로젝트 파일에도 올라가 있습니다.
- brightdata-guide: Bright Data를 MCP·CLI로 쓰는 방법 가이드
- price-positioning: 모은 가격으로 포지셔닝 맵을 만들고 빈 가격대를 찾아주는 스킬
터미널에서 한 줄씩(또는 두 줄을 한 번에 복붙) 설치합니다.
hermes -p ada skills install dandacompany/dante-skills/brightdata-guide --yes
hermes -p ada skills install dandacompany/dante-skills/price-positioning --yes
> 💡 설치할 때 **보안 스캔(Security Scan)**이 돌고, 최종 결정이 Allowed로 나오면 안전하게 설치된 것입니다.
6. Bright Data CLI 설치 + 로그인
가격을 실제로 긁어올 bdata 수집 도구(Bright Data CLI)를 설치합니다. 공식 설치 스크립트 한 줄이면 됩니다.
curl -fsSL https://cli.brightdata.com/install.sh | bash
설치 마법사가 작동하고, 브라우저가 자동으로 떠서 바로 로그인할 수 있습니다. 본인 Bright Data 계정으로 로그인하면 bdata 명령을 쓸 수 있게 됩니다.
---
7. (Windows·WSL만) 프로필을 default로 두고 대시보드 열기
데스크톱 앱으로 실습할 때는 머신 게이트웨이 프로필을 default로 둡니다. 그래야 우리가 만든 프로필들의 게이트웨이와 충돌하지 않아요. 데스크톱 앱 안에서는 어차피 프로필을 스위치해서 씁니다.
hermes profile use default
WSL처럼 원격으로 데스크톱 앱을 붙일 때만 대시보드를 엽니다.
hermes dashboard --host 0.0.0.0 --port 9119
💡 Mac 유저는 이 7단계를 건너뛰세요. 대시보드를 따로 열 필요 없이 데스크톱 앱을 바로 실행하면 됩니다.
8. ⭐ 서브에이전트가 Bright Data 인증을 쓰게 만들기 (.env + 통과 허용)
여기가 이번 실습의 핵심 설정입니다. 부모인 Ada는 방금 bdata login으로 인증됐지만, 임시 알바(서브에이전트)는 그 로그인을 못 봅니다. 서브에이전트가 쓰려면 API 키 방식으로 인증 정보를 넘겨줘야 합니다.
8-1. Ada 프로필 .env에 두 줄 추가
파일 브라우저로 Ada 프로필의 .env 파일을 열어 아래 두 줄을 넣습니다. Unlocker Zone은 기본값 cli_unlocker를 쓰면 되고, API 키는 Bright Data 홈페이지 설정에서 찾을 수 있습니다.
BRIGHTDATA_API_KEY=본인_API_키
BRIGHTDATA_UNLOCKER_ZONE=cli_unlocker
8-2. 환경 변수 통과 허용 (passthrough)
기본적으로 헤르메스는 보안상 환경 변수를 서브에이전트에게 넘기지 않습니다. 그래서 위 두 변수를 통과 허용 목록에 넣어줘야 서브에이전트가 쓸 수 있어요. 터미널에서 한 줄로 설정합니다.
hermes -p ada config set terminal.env_passthrough '["BRIGHTDATA_API_KEY","BRIGHTDATA_UNLOCKER_ZONE"]'
💡 웹 대시보드에서도 됩니다. 프로필을 Ada로 맞춘 뒤 Config에서
env-path까지만 입력하면 검색되고, 거기서 변수명을 콤마로 구분해 저장하면 됩니다. ⚠️ 단, 반드시 Ada 프로필을 선택한 상태로 저장하세요. 그냥 저장하면 글로벌 설정으로 들어가 Ada에는 적용되지 않습니다.
8-3. 게이트웨이 재시작
설정을 반영하려면 Ada의 게이트웨이를 재시작합니다.
hermes -p ada gateway restart
⚠️ API 키만 넣고 통과 허용을 안 하면 서브에이전트가 키를 못 받아 실패합니다. 두 단계(
.env+env_passthrough)가 한 쌍입니다.
9. 데스크톱 앱에서 병렬 위임 실행
게이트웨이가 재시작됐으면 데스크톱 앱을 껐다 다시 켭니다. 게이트웨이 상태가 Ready가 될 때까지 기다린 뒤, 프로필 레일에서 Ada를 선택하고 New Session으로 채팅을 엽니다.
💡 데스크톱 앱으로 시연하는 이유는, 이 앱이
delegate_task의 병렬 동작을 눈으로 볼 수 있게 보여주기 때문입니다.
아래 프롬프트를 입력합니다. 핵심은 ① 병렬 처리를 명시하고 ② 세 구간을 안 겹치게 나누고 ③ MCP 없이 brightdata-guide 스킬 + bdata CLI로 수집하라고 못박고 ④ 독립·한국어 ⑤ 끝나면 price-positioning으로 종합하게 하는 것입니다.
보조 일꾼 셋을 병렬로 띄워서 3040 남성 패션 시장의 가격대를 세 구간으로 나눠 동시에 조사하게 해줘.
한 명은 저가(5만 원 이하), 한 명은 중가(5~15만 원), 한 명은 프리미엄(15만 원 이상)을 맡아.
너희는 MCP 도구가 없으니, 설치된 brightdata-guide 스킬이 안내하는 대로 터미널의 bdata CLI로 수집해.
bdata search로 한국 쇼핑 검색을 하거나, 안 되면 bdata scrape로 상품 페이지의 실제 판매가를 가져와.
에이전트 내장 웹검색은 쓰지 마.
각 일꾼은 한 품목당 한 줄로 브랜드·품목·가격(숫자만)·통화(KRW)·출처 링크·관측일을 채워 돌려줘.
가격이 확인 안 되는 건 빼. 세 구간은 서로 안 겹치게 독립으로, 정리는 한국어로.
세 일꾼이 끝나면 네가 결과를 합쳐 price-positioning 분석기로 가격 포지셔닝과 빈 가격대를 근거와 함께 한국어로 보고해줘.
💡 이렇게 세세하게 적어주는 이유는 서브에이전트가 대화 맥락을 모르기 때문입니다. 안 적으면 제한된 정보만으로 일해서 품질이 떨어집니다.
10. Spawn Tree — 임시 알바 셋이 동시에 일합니다
Send를 누르면 Ada가 스킬을 확인하고, 날짜를 확인하고, bdata CLI를 준비한 뒤 일을 나눠 디스패치합니다. 화면 아래 상태바가 바뀌고, 눌러보면 Spawn Tree 팝업이 뜹니다.
DELEGATION 1 · 3 WORKERS · 3 ACTIVE. 각 가격대별로 임무가 나뉘어 세 일꾼이 동시에 bdata 명령을 실행하는 걸 한눈에 볼 수 있습니다. 각자 다른 브랜드를 조사하죠.
⚠️ 진행 중 한 일꾼이 도구 실패·에러로 중단되면, 그 일꾼은 실패 내용을 그대로 보고합니다. 그럴 땐 Ada에게 "실패한 구간을 해결해서 다시 디스패치해줘"라고 요청하세요.
💡 MCP는 서브에이전트가 못 쓰지만 CLI는 됩니다. Bright Data 말고도 병렬 처리에 외부 도구가 필요하면, 같은 방식, 즉 CLI와 스킬과 환경 변수 통과 허용으로 열어주면
delegate_task로 돌릴 수 있습니다.
11. 종합 분석 — 비어 있던 가격대를 찾았다
중가·프리미엄이 먼저 완료(체크 표시)되고, 저가까지 끝나면 Ada가 다시 키를 잡습니다. 분석 실행을 Confirm 요청하면 승인해 주세요. Ada가 price-positioning 분석기(파이썬)를 돌려 세 구간을 합치고 보고서를 만듭니다.
조사 결과, 1차 권장 진입 가격대는 13만 9천 원~15만 9천 원으로 나왔습니다. 중가 상단과 프리미엄 초입 사이의 빈 가격대(화이트스페이스)죠. 브랜드 근거와 리스크까지 상세히 보고됩니다. Ada가 숫자로 자리를 찾아준 것입니다.
12. Google Docs로 보고서 올리기
이 보고 내용을 Google Docs로 올려봅니다. gws CLI가 공통 스킬로 설정돼 있어 바로 쓸 수 있습니다. 채팅에 "구글 독스로 이 보고 내용을 올려줘"라고 요청합니다.
⚠️ 인증 없음 오류가 날 수 있습니다. gws는 인증을 프로필별 격리 홈에 저장하는데, 다른 프로필(예: Sophie)에서 인증했더라도 각 프로필마다 인증이 따로 필요합니다. 매번 다시 로그인하지 말고, 이미 인증된 인증 파일을 프로필로 복사하면 됩니다.
먼저 터미널에서 현재 인증이 살아 있는지 확인합니다(달력 일정이 나오면 정상).
gws calendar +agenda
인증이 정상이면, 그 인증 폴더(~/.config/gws)를 Ada 프로필 홈으로 복사합니다.
mkdir -p ~/.hermes/profiles/ada/home/.config
cp -rp ~/.config/gws ~/.hermes/profiles/ada/home/.config/
💡 다른 프로필도 같은 방식으로 하나씩 복사하면 됩니다. 모든 프로필에 한꺼번에 적용하는 일괄 명령은 아래 치트시트에 정리해 두었습니다.
복사 후 Ada 게이트웨이를 재시작하고 데스크톱 앱에서 실패했던 부분부터 다시 실행하면, Google Docs 업로드가 완료됩니다.
> 💡 처음엔 보고서가 마크다운 기호 그대로(#, |) 올라갈 수 있어요. 그럴 땐 "마크다운 서식 말고 구글 문서 서식으로 다시 정리해줘"라고 재요청하면, 제목·표·문단이 제대로 된 Google Docs 문서로 정리됩니다. 이렇게 하면 다른 사람과 공유하기도 좋죠.
13. 언제 무엇을 쓰나 — 한 장 정리
| 도구 | 언제 쓰나 | 성격 |
| --- | --- | --- |
| delegate_task | 짧은 병렬 조사·검토, 긴 맥락 불필요 | 동기·익명·일시 (임시 알바) |
| 프로필(일반 요청) | 인격·페르소나로 전문 작업, 지속 맥락 | 영속·이름 있음 (정직원) |
| kanban (다음 시간) | 지속적이고 여러 페르소나가 협업 | 영속 보드 |
| cron | 정해진 시간 반복 | 스케줄러 |
14. 마무리
오늘 여러분은 직접 조사하지 않았습니다. 임시 일손을 여럿 띄워 결과만 받고, 그걸 종합해 빈 가격대를 찾고, 보고서까지 올렸죠. 이렇게 작은 업무에도 오케스트레이팅을 적용할 수 있습니다. 여러분은 손발이 아니라, 일손을 띄우고 결과를 받는 오케스트레이터입니다.
다음 시간에는 지속적이고 여러 페르소나가 협업하는 칸반(kanban) 보드를 다룹니다.
치트시트 (복붙용)
스킬 + CLI 설치
hermes -p ada skills install dandacompany/dante-skills/brightdata-guide --yes
hermes -p ada skills install dandacompany/dante-skills/price-positioning --yes
curl -fsSL https://cli.brightdata.com/install.sh | bash
서브에이전트 Bright Data 인증 (Ada 프로필 .env 두 줄 + 통과 허용 + 재시작)
BRIGHTDATA_API_KEY=본인_API_키
BRIGHTDATA_UNLOCKER_ZONE=cli_unlocker
hermes -p ada config set terminal.env_passthrough '["BRIGHTDATA_API_KEY","BRIGHTDATA_UNLOCKER_ZONE"]'
hermes -p ada gateway restart
gws 인증을 모든 프로필에 복사 (프로필명만 바꿔 한 줄씩)
mkdir -p ~/.hermes/profiles/ada/home/.config
cp -rp ~/.config/gws ~/.hermes/profiles/ada/home/.config/
mkdir -p ~/.hermes/profiles/oliver/home/.config
cp -rp ~/.config/gws ~/.hermes/profiles/oliver/home/.config/
게이트웨이 목록·재시작 (Mac · WSL 공통)
hermes gateway list
hermes -p ada gateway restart
자주 만나는 문제
⚠️ 서브에이전트가 "No API key found"로 실패해요.
.env에 키만 넣고 끝냈을 가능성이 큽니다.terminal.env_passthrough로 변수 통과를 허용하고 게이트웨이를 재시작했는지 확인하세요(8단계). 통과 허용을 웹 대시보드로 했다면 Ada 프로필을 선택한 상태였는지도 보세요.
⚠️ gws가 "인증 없음"이래요. gws 인증은 프로필별 격리 홈 기준이라, 다른 프로필에서 인증했어도 Ada에는 따로 있어야 합니다.
gws calendar +agenda로 원본 인증을 확인한 뒤 인증 폴더를 Ada 프로필 홈으로 복사하세요(12단계).
⚠️ 서브에이전트가 발동하지 않아요. 프롬프트에 "병렬로", "셋을 동시에" 같은 병렬 처리 의도가 명시돼야 메인 에이전트가
delegate_task를 꺼냅니다.
⚠️ Google Docs에 마크다운 기호가 그대로 보여요. "마크다운 서식 말고 구글 문서 서식으로 다시 정리해줘"라고 재요청하세요.