산출물 모드 — 결과물 중심 | Easy Understand Hermes Agent

배달 음식을 시켰는데, 레시피 카드랑 생재료 봉투를 받는 대신 셰프가 직접 나와서 완성된 요리를 딱 내밀어 준다고 상상해 보세요. Hermes Agent의 **딜리버러블 모드(Deliverable Mode)**가 바로 그런 개념입니다. 에이전트가 차트, PDF, 스프레드시트 같은 파일을 만들 때, 단순히 파일 경로만 알려주고 끝내는 게 아니라 완성된 결과물을 채팅 창에 바로 건네줍니다.

실제로 하는 일

Hermes Agent가 채팅 플랫폼(Slack, Discord, Telegram 등)에서 실행되면, 생성하는 모든 파일이 자동으로 응답에 첨부됩니다. 예를 들어:

차트 → 이미지로 바로 표시
PDF 보고서 → 다운로드 가능한 파일로 표시
표 → .xlsx 파일로 업로드

특별히 뭔가 설정할 필요 없습니다. 에이전트가 응답에 파일의 절대 경로(예: /tmp/q3-revenue.png)를 언급하기만 하면, 게이트웨이가 이를 감지해서 파일을 추출한 뒤 사용자에게 전송합니다.

3단계 동작 방식

에이전트가 도구를 사용해 파일을 생성합니다. 예를 들어 execute_code로 matplotlib 차트를 만들거나, docx 스킬로 Word 문서를 작성하거나, xlsx 스킬로 스프레드시트를 만들거나, pdf 스킬로 보고서를 생성할 수 있습니다.
게이트웨이가 응답에서 파일 경로를 스캔합니다. /tmp/... 또는 ~/...로 시작하고 지원되는 파일 확장자로 끝나는 경로를 찾습니다. 코드 블록 안의 경로는 무시되므로 코드 예시는 깔끔하게 유지됩니다.
게이트웨이가 파일 유형에 따라 전송 방식을 결정합니다:
- 이미지 → 채팅에 직접 삽입
- 비디오 → 재생 가능하도록 삽입(플랫폼이 지원하는 경우)
- 오디오 → 음성 또는 오디오 첨부 파일로 전송
- 기타 모든 파일 → 일반 파일로 업로드

지원되는 파일 형식

카테고리	예시	전송 방식
이미지	`.png .jpg .gif .svg`	인라인 표시
비디오	`.mp4 .mov .mkv`	삽입 재생
오디오	`.mp3 .wav .m4a`	음성 첨부
문서	`.pdf .docx .txt .md`	파일 업로드
데이터	`.xlsx .csv .json`	파일 업로드
프레젠테이션	`.pptx .ppt`	파일 업로드
압축 파일	`.zip .rar .7z`	파일 업로드

참고: .py나 .log 같은 소스 파일은 자동 전송되지 않습니다. 의도적인 설계로, 에이전트가 코드 파일을 마구 보내는 걸 방지합니다. 코드를 공유하고 싶다면 코드 블록을 사용하세요.

에이전트가 파일을 생성하게 하는 방법

에이전트는 기본적으로 파일을 자동 생성하지 않습니다. 사용자가 요청해야 합니다.

방법 1: 대화에서 직접 요청하기

“결과를 비교하는 차트를 만들어서 보내줘” “데이터를 CSV로 내보내줘”

방법 2: 프로젝트 수준 기본 설정 지정하기 프로젝트의 AGENTS.md, CLAUDE.md, 또는 .cursorrules 파일에 선호 사항을 추가하세요. 또는 전역 설정 파일인 ~/.hermes/SOUL.md에 규칙을 추가할 수도 있습니다. ~/.hermes/config.yaml에 “페르소나 프리셋”을 정의하고 언제든지 전환하는 것도 가능합니다.

핵심 메커니즘 한 문장 요약

에이전트가 파일을 절대 경로(예: /tmp/q3-revenue.png)에 저장하고, 응답에 해당 경로를 일반 텍스트로 언급하면, 게이트웨이가 나머지를 처리합니다. 그게 전부입니다.

요약하자면: 딜리버러블 모드는 AI의 역할을 “파일이 어디 있는지 알려주는 것”에서 “파일을 직접 건네주는 것”으로 바꿔줍니다. 더 이상 폴더를 뒤질 필요가 없어요. 실용 팁: 다음에 에이전트에게 데이터 분석을 요청할 때, “결과를 차트로 만들어서 보내줘”라고 말해 보세요. 이미지를 생성해서 즉시 전달해 줄 겁니다. 한 번 써보면 예전으로 돌아갈 수 없을 거예요.