Hermes + Codex + Telegram 환경 -> FiveMonkeys Agent 팀 생성 후기
송주환
2026.05.21

# [Hermes] FiveMonkeys 팀 생성
## 📝 한줄 요약
Hermes로 FiveMonkeys(총총/포포/공공/유유/강강) 팀을 생성, 텔레그램 단톡 응답 구조를 “다중 봇 응답”에서 “총총 단일 응답 + 내부 위임(delegate_task)”으로 전환
핵심은 역할을 명확히 분리, 모든 이슈를 로그 근거로 검증
**바쁘시면 이것만 읽어도 돼요:**
- 단톡 공개 창구는 총총 1개로 통일
- 내부는 포포/공공/유유/강강에게 역할별 위임
- `TELEGRAM_REQUIRE_MENTION=true` 유지 + 멘션 패턴 정밀화
- “총총아 잘하고있어” 무응답은 멘션 패턴 누락이 원인, 수정 후 정상화
- 원칙: 추측 금지, 근거 없으면 `확인 불가`
## 🎯 이런 분들께 도움돼요
- AI 멀티 에이전트를 실제 운영 가능한 팀 구조로 만들고 싶은 분
- 텔레그램 단톡에서 봇 응답 누락/혼선을 줄이고 싶은 분
- 역할 분업과 운영 자동화를 함께 가져가고 싶은 1인/소규모 팀
## 😫 문제 상황 (Before)
초기에는 FiveMonkeys 각 에이전트별로 gateway를 개별 구축
하지만 단톡 환경에서는 봇 간 직접 대화 제약과 멘션 처리 차이로 응답 일관성이 떨어짐
## 🛠️ 사용한 도구
- **도구**: Hermes Agent, Codex, Telegram
- **모델**: gpt-5.3-codex
## 🐵 FiveMonkeys 에이전트 역할
- **총총(chongchong) — 총괄 오케스트레이터**
- 단톡의 유일한 공식 응답 창구
- 사용자 요청을 해석해 하위 에이전트에 내부 위임
- 결과 취합/요약/최종 보고 및 운영 기준 책임
- **포포(popo) — 포스팅 담당**
- 게시글 초안 작성, 플랫폼 맞춤 문장 구성
- 실행 전 검토, 실행 후 결과(특히 공개 URL) 검증 중심
- 불확실 항목은 `확인 불가` 표기
- **공공(gonggong) — AX 리서처**
- AX 포지션 관점의 사이트/채용 공고 크롤링
- 공고별 요구 역량/역할/조건 요약
- 공고 묶음 트렌드 분석으로 준비 방향 인사이트 제공
- **유유(youyou) — 외주 유지보수 운영 에이전트**
- 외주 유지보수 백로그/우선순위/일정 관리
- 바이어 요청 접수·분류·진행보고 커뮤니케이션 자동화
- 반복 유지보수 업무를 표준 프로세스로 운영
- **강강(kangkang) — 강의 운영 자동화 에이전트**
- 강의 준비/진행/사후 운영 반복 업무 자동화
- 공지·자료 배포·일정·체크리스트 표준화
- 강의 품질 유지 + 운영 리소스 절감 루틴 구축
---
## 🔧 작업 과정
### 1) 단톡 응답 구조 전환: 다중 응답 → 단일 창구
```
기존 : 각각의 봇을 직접 호출하면 해당 봇이 응답
변경 : 총총(오케스트레이션) 만 응답 하는 구조, 총총이 내부적으로 다른 에이전트들의 응답을 전달하는 역할
```
겉으로는 총총 하나만 응답하고, 내부에서 필요한 역할(포포/공공/유유/강강)을 `delegate_task`로 호출하는 구조
---
### 2) 총총이가 그냥 내용만 전달하는 이슈, 응답 안받아옴
총총이가 send message로 해당 봇을 호출하고 전달만 하고, 전달완료 까지만 함
delegate_task로 전처리를 해당 봇을 호출 후에 응답받아오는 걸로 수정
봇의 응답을 총총이가 대신 대답해주는 구조로 변경
---
### 3) 무응답 이슈 실전 해결 (“총총아 잘하고있어”)
```
추측하지 말고 로그로 원인을 닫자.
```
- 증상: “총총아 잘하고있어” 입력 시 무응답
- 확인: 로그 추적 결과, 멘션 패턴에 해당 표현 누락
- 조치: 멘션 패턴에 `총총/총총아` 추가
- 결과: 재시작 후 패턴 로드 확인, 동일 표현 정상 처리
이 과정에서 운영 원칙을 명확히 고정
- 근거 없으면 단정하지 않기
- 확인 안 되면 `확인 불가` 명시
---
### 4) 역할 정의 문서화로 재발 방지
역할 혼선을 줄이기 위해 각 에이전트의 SOUL.md/AGENTS.md를 최신 역할 기준으로 정렬
- 총총: 총괄/라우팅/최종 품질 책임
- 포포: 포스팅/게시 검증
- 공공: AX 공고 리서치
- 유유: 외주 유지보수 운영 자동화
- 강강: 강의 운영 자동화
문서-실행-보고가 같은 구조를 보도록 맞춘 게 가장 큰 개선점
---
## ✅ 결과 (After)

### Before vs After
| 항목 | Before | After |
|------|--------|-------|
| 단톡 응답 구조 | 복수 봇 응답 시도 | 총총 단일 응답 + 내부 위임 |
| 역할 정의 | 일부 역할 혼선 | 역할/책임 문서화 완료 |
| 멘션 처리 | 실제 호출어 누락 가능 | 정책 유지 + 패턴 정밀화 |
| 이슈 대응 | 체감/추정 개입 가능 | 로그 근거 중심 검증 |
### 결과물
- FiveMonkeys 단톡 운영 구조 안정화
- 역할 정의(SOUL/AGENTS) 최신화
- 사례 게시글 템플릿 기반 운영 기록 정리
## 💬 이 과정에서 배운 AI 활용 팁
### 효과적이었던 것
1. 외부 응답 채널은 하나로 하는게 헷갈리지 않음
2. 정책 완화보다 정책 정밀화
3. 로그를 기준으로 원인을 닫으면 같은 문제가 반복
### 이렇게 하면 안 돼요
1. 역할 정의 없이 기능만 붙여 운영하기 (내가 누구랑 대화하고 있는지 모름)
2. 근거 없는 성공 보고 그대로 받아들이기 (할루시네이션)
## 🌍 다른 업무에 적용한다면?
이 구조를 통해 유유, 즉 외주 프로젝트 고객들에게 유지보수 봇을 설계할 때 적용 가능할 거라 생각함.
유유 하위에 조수를 하나 생성해서 실제 보고는 유유만, 업무는 하위 에이전트들이 수행
핵심은 “단일 창구 + 내부 역할 위임 + 증거 기반 보고”
## 🚀 앞으로의 계획
- SOUL.md, Agent.md, Memory.md 구체화, 고도화
- 포포 -> 공공 -> 강강 -> 유유 순으로 스킬 개발 및 할 일 배정
## 📋 재사용 가능한 프롬프트
### 프롬프트 1: 멀티 에이전트 운영 구조 재설계
> 우리 팀의 AI 에이전트 운영을 점검해줘.
> 외부는 단일 응답 창구, 내부는 역할별 위임 구조로 재설계하고 싶어.
> 아래 형식으로 제안해줘:
> 1) 현재 리스크
> 2) 제안 구조
> 3) 운영 정책(멘션/권한/승인)
> 4) 검증 시나리오
> [수정할 부분: 채널, 역할, 현재 문제]
### 프롬프트 2: 무응답 원인 분석(로그 기반)
> 다음 사례를 로그 기준으로 분석해줘: “[사용자 입력]”
> 추측하지 말고, 확인된 사실/확인 불가를 분리해서 작성해줘.
> 그리고 우선 점검 순서와 재현 테스트 문장을 같이 제시해줘.로그인하고 댓글을 남겨 주세요
윤스케어2026.05.27
다중 봇 응답 → 단일 창구(총총) + 내부 위임 구조 전환이 운영 관점에서 큰 진전이에요. 5개 에이전트의 역할 분리가 명확하고, "추측 금지, 근거 없으면 확인 불가" 원칙이 단단합니다. "총총아 잘하고있어" 무응답 케이스 해결 과정도 디버깅 사례로 좋아요.
저희가 주로 다루지는 않고 있어서 에이젼트 오픈한 다른 스터디 많이많이 청강도 하시구요 ㅎ




송주환님, FiveMonkeys 팀을 단순히 여러 에이전트를 많이 붙이는 방식이 아니라 “총총 단일 창구 + 내부 역할 위임” 구조로 정리하신 점이 아주 인상적이었습니다. 단톡에서는 여러 봇이 동시에 반응하면 사용자가 누구에게 말하고 있는지 헷갈리기 쉬운데, 외부 응답 창구를 하나로 줄이고 내부에서 포포, 공공, 유유, 강강으로 역할을 나눈 판단이 실제 운영에 잘 맞아 보였습니다. 특히 무응답 이슈를 감으로 넘기지 않고 로그로 원인을 닫은 부분이 좋았습니다. “총총아 잘하고있어”가 왜 응답되지 않았는지 멘션 패턴까지 확인하고,
TELEGRAM_REQUIRE_MENTION=true정책은 유지한 채 호출어를 정밀화한 흐름이 중요했습니다. 보안을 낮추거나 조건을 풀어서 해결한 것이 아니라, 정책은 유지하면서 실제 사용 패턴을 반영했다는 점에서 운영 감각이 잘 드러났습니다. 역할 정의를SOUL.md와AGENTS.md에 맞춰 정리한 것도 좋은 방향으로 보였습니다. 에이전트 팀은 기능만 많아지는 순간 오히려 혼란이 커지기 쉬운데, 총괄, 포스팅, 리서치, 유지보수, 강의 운영처럼 책임을 나눠두면 이후에 문제가 생겨도 어느 역할의 기준을 고쳐야 하는지 추적하기 쉬워집니다. 다음 단계에서는 지금 만든 구조를 유지한 채, 대표 요청 1개만 골라 “사용자 입력 → 총총의 판단 → 내부 위임 → 최종 응답 → 로그 근거”가 한 줄로 이어지는 테스트 기록을 남겨보시면 좋겠습니다. 그러면 FiveMonkeys가 단순한 다중 봇 구성이 아니라, 재현 가능한 운영 시스템으로 더 선명해질 것 같습니다.