Hermes Agent 이용 가이드
Hermes Agent는 파일, 터미널, 웹 검색 등 연결된 도구를 사용해 여러 단계의 작업을 수행하는 AI 에이전트입니다. Jiminbox에서는 별도 관리 화면을 먼저 익힐 필요 없이, jiminbox.com 홈의 입력창에서 바로 사용할 수 있습니다.
화면 라벨은 배포 시점에 따라 달라질 수 있습니다
아래의
무엇부터 해결해볼까요?,무엇이든 물어보세요,사진 선택,첨부 및 Hermes 기능등은 현재 확인한 화면의 라벨입니다. 계정, 언어 설정, Hermes 업데이트에 따라 이름·위치·표시 여부가 달라질 수 있으므로, 화면에 실제로 보이는 항목을 기준으로 선택합니다. 개인별 Hermes 주소를 문서나 공개 게시글에 복사하지 않습니다.
여러 Hermes 프로필을 역할별 봇으로 나누고 @멘션이나 그룹 대화로 작업을 넘기려면 Hermes Bot Mode와 멀티 프로필을 확인하세요. Bot Mode는 최신 Hermes Desktop에 기본으로 포함되며, 일반 대화와 기본 도구 사용을 익힌 뒤 적용하는 것을 권장합니다.
1. jiminbox.com에서 바로 첫 대화 시작하기
- jiminbox.com에 로그인합니다.
- 홈에
무엇부터 해결해볼까요?와무엇이든 물어보세요입력창이 나타나는지 확인합니다. - 입력창에 요청을 적습니다. 처음에는 아래의 읽기 전용 예문처럼 작고 확인하기 쉬운 작업을 권장합니다.
- 사진이 필요한 작업은
사진 선택을 사용합니다. 다른 기능을 연결하려면첨부 및 Hermes 기능을 열되, 처음부터 개인 파일이나 인증정보를 첨부하지 않습니다. - 입력창 오른쪽의 현재 모델 표시를 확인합니다. 처음에는 기본값을 유지해도 됩니다.
Hermes에게 보내기버튼을 누르고 응답이 나타나는지 확인합니다.
별도 WebUI는 고급 기능이 필요할 때만 여세요
세션, 파일, Skills, MCP, Cron 같은 관리 기능이 필요할 때는
서비스에서Hermes Agent카드를 선택합니다. 단순한 질문과 작업 요청은 jiminbox.com 홈에서 바로 시작할 수 있습니다.
2. 첫 작업은 읽기 전용으로 시작하기
첫 요청에는 작업 대상, 읽기 범위, 결과 형식, 금지할 변경을 함께 적습니다. 처음부터 파일 저장·삭제·Git push·외부 전송을 요청하지 않습니다.
읽기 전용으로 시작해 줘. 현재 작업공간에서 README.md와 docs/ 아래 파일만 확인하고,
1) 발견한 파일 목록
2) 각 파일의 한 줄 요약
3) 추가로 확인하면 좋은 항목
을 답변으로 정리해 줘. 파일 수정, 생성, 삭제, 외부 전송은 하지 마.결과를 받은 뒤에는 다음을 확인합니다.
- 요청한 범위 밖의 파일이나 서비스에 접근하지 않았는가?
- 답변에 실제로 읽은 파일 경로, 웹 주소, 실행한 확인 항목이 드러나는가?
- 모델이 모르는 내용을 추측으로 채우지 않고
확인 필요로 남겼는가? - 쓰기·삭제·전송·예약 작업을 제안했다면, 대상과 변경 내용을 먼저 설명했는가?
3. 안전한 작업 순서
Hermes의 작업은 다음 순서로 나누어 요청합니다. 처리해 줘처럼 범위가 모호한 말은 쓰기나 외부 변경의 승인으로 보지 않습니다.
| 단계 | Hermes에 요청할 일 | 사용자가 확인할 일 |
|---|---|---|
| 1. 읽기 | 파일 목록, 파일 내용, 저장소 상태, 공개 웹 자료를 확인합니다. | 대상 범위와 출처가 맞는지 확인합니다. |
| 2. 초안 생성 | 답변 안에 요약·표·변환 결과·실행 계획을 작성합니다. | 아직 파일 저장, 전송, push를 하지 않았는지 확인합니다. |
| 3. 검토 | 수정할 파일, 변경할 문장, 출력 형식, 명령, 외부 대상과 위험을 보여 달라고 합니다. | 대상 경로·diff·수신자·예약 시각을 직접 검토합니다. |
| 4. 승인된 쓰기·외부 변경 | 사용자가 확인한 범위에 한해 파일 생성·수정, 저장소 변경, 전송 또는 예약을 실행합니다. | 실행 직전에 다시 승인하고, 실행 후 결과와 변경 흔적을 확인합니다. |
승인 범위를 좁게 유지하세요
“이 파일의 이 부분만 수정하고, 다른 파일은 건드리지 마”처럼 경로와 범위를 명시합니다. 파일 삭제, 대량 이동, Git push, 외부 공유, 예약 실행은 한 번에 묶지 말고 각각 확인합니다.
4. Jiminbox에서 먼저 시도할 저위험 활용 예시
아래 예시는 Hermes 공식 문서에 나온 도구 범위와 현재 Jiminbox에서 확인된 서비스 구성을 바탕으로 작성했습니다. 실제 세션에서 사용할 수 있는 도구는 계정과 연결 상태에 따라 달라지므로, 요청 전에 Skills, Plugins, MCP 또는 화면에 표시된 도구 목록에서 확인합니다.
웹 조사 결과 정리
Hermes 공식 도구 문서는 web_search와 web_extract를 웹 검색 및 페이지 내용 추출 도구로 소개합니다. Jiminbox 포털에는 Search API 서비스가 있어 Firecrawl과 Claude Web Search용 키를 만들고 관리할 수 있습니다. 다만 Hermes 세션에 연결된 웹 도구는 별도로 확인해야 합니다.
복사해서 사용할 요청 예문:
읽기 전용으로 웹 조사를 해 줘. [주제]에 대해 공개된 공식 문서와 신뢰할 수 있는 자료를 우선 확인하고,
- 주장
- 출처 URL
- 출처가 뒷받침하는 내용
- 서로 다른 자료의 의견 차이
를 표로 정리해 줘. 로그인, 개인 자료, 비공개 페이지는 사용하지 말고, 결과를 파일에 저장하거나 외부로 보내지 마.파일 요약·변환 계획 만들기
공식 도구 문서에는 read_file, terminal, process, patch를 포함한 파일·터미널 도구가 설명되어 있습니다. 다만 patch나 터미널 사용은 파일을 변경할 수 있으므로, 먼저 읽기와 변환 계획만 요청합니다.
현재 작업공간의 [입력 파일 경로]를 읽고 다음만 답해 줘.
1) 파일 형식과 주요 내용
2) [목표 형식]으로 변환할 때 필요한 단계
3) 예상 출력 경로와 생성될 파일명
4) 변환에 사용할 명령 또는 도구
아직 명령을 실행하거나 파일을 생성·덮어쓰지 마. 내가 출력 경로와 명령을 검토한 뒤 승인하겠다.검토 후 실행을 승인할 때도 입력 파일, 출력 경로, 덮어쓰기 여부를 한 번에 하나씩 확인합니다.
코드 저장소 점검
Hermes 공식 문서는 터미널·파일 읽기 도구와 GitHub PR 워크플로 같은 재사용 가능한 Skills의 예를 보여 줍니다. Jiminbox 포털에는 GitLab 서비스가 있어 코드와 문서를 저장하고 협업 작업을 관리할 수 있습니다. 다만 특정 저장소에 대한 권한과 Hermes 세션의 Git 도구 연결은 계정별로 다를 수 있습니다.
읽기 전용으로 저장소를 점검해 줘. 현재 저장소의 현재 브랜치, 변경된 파일 목록, 최근 커밋 제목,
테스트·빌드 명령이 README에 적혀 있는지만 확인해 줘.
변경 파일을 수정하지 말고, commit·push·merge·이슈 등록도 하지 마.
마지막에 위험도가 높은 변경이나 다음 확인 항목을 짧게 정리해 줘.노트 정리 초안
Jiminbox 포털에는 Fast Note Sync 서비스가 있어 Obsidian 노트와 첨부파일을 여러 기기에서 동기화할 수 있습니다. Hermes에서 Fast Note Sync에 직접 읽고 쓰는 기능이 연결되었는지는 Skills, Plugins, MCP에서 확인하기 전까지 단정하지 않습니다. 연결이 확인되지 않았다면 노트 내용을 대화에 붙여 넣지 말고, 공개되거나 비민감한 샘플로만 흐름을 시험합니다.
아래에 제공한 비민감한 노트만 읽고, 기존 내용은 수정하지 않은 채 다음 초안을 답변으로 만들어 줘.
- 제목 후보 3개
- 핵심 요약 5줄
- 관련 주제와 연결할 만한 wikilink 후보
- 확인이 필요한 사실과 중복 문장
실제 노트에 저장하거나 링크를 자동으로 바꾸지 마.반복 작업의 초안 만들기
Hermes 공식 문서에는 cronjob 도구와 Cron 기능이 소개되어 있습니다. 그러나 예약 실행과 외부 전달은 지속적인 변경을 만들 수 있으므로, 먼저 한 번 실행할 초안과 승인 조건을 검토합니다. Cron이 화면에 보이지 않거나 전달 대상이 불명확하면 예약하지 않습니다.
매주 반복할 수 있는 [업무]의 초안 절차를 만들어 줘.
먼저 필요한 입력, 조사 범위, 결과 형식, 예상 실행 시간, 실패 시 알림 방법만 제안해 줘.
파일 저장, 메시지 전송, 예약 생성은 하지 말고, 사람이 검토하고 승인해야 하는 지점을 표시해 줘.5. 요청문 작성 템플릿
복잡한 작업일수록 다음 항목을 채워서 요청합니다.
목적: 무엇을 알아내거나 만들 것인가?
대상: 어떤 파일·저장소·공개 웹 자료를 볼 것인가?
범위: 포함할 경로, 기간, 언어, 출처는 무엇인가?
순서: 먼저 읽기와 초안만 하고, 검토 후 승인된 쓰기를 수행해 줘.
출력: 표, 요약, Markdown, 명령 목록 중 어떤 형식인가?
금지: 삭제, 덮어쓰기, push, 외부 전송, 예약 생성 중 무엇을 하지 말아야 하는가?
완료 조건: 어떤 경로·출력·검증 결과를 보여 주면 끝인가?6. 고급 WebUI 열기
- jiminbox.com 왼쪽 메뉴에서
서비스를 엽니다. - 서비스 목록에서
Hermes Agent카드를 선택합니다. - 별도의 로그인 또는 접근 확인 화면이 나타나면 Jiminbox에서 안내한 절차를 따릅니다.
- 개인별 Hermes 주소를 복사해 공유하지 말고, 다음에도 서비스 목록에서 여는 것을 권장합니다.
현재 화면에서 확인한 메뉴와 주의점
Jiminbox 포털의 서비스 목록에는 Hermes Agent 카드가 있어 고급 Web UI를 열 수 있습니다. 현재 Hermes Web UI의 탐색 메뉴에는 Chat, Sessions, Files, Models, Logs, Cron, Skills, Plugins, MCP, Channels, Webhooks, Pairing, Profiles, Config, Keys, System, Documentation이 있습니다.
이 목록은 관리 메뉴를 모두 사용하라는 뜻이 아닙니다. 실제 작업은 Chat에서 시작하고, 다음 기능이 필요할 때만 해당 화면을 엽니다.
Sessions: 이전 대화를 다시 확인하거나 재개할 때Files: 작업공간의 파일 범위를 직접 확인할 때Skills,Plugins,MCP: 현재 세션에 연결된 기능과 도구를 확인할 때Models: 모델 오류나 사용 가능한 모델을 확인할 때Cron: 반복 작업의 초안과 예약 상태를 검토할 때Documentation: 현재 설치된 Hermes 사용법을 확인할 때
메뉴가 보이지 않거나 이름이 다르면 권한·언어·배포 버전 차이일 수 있습니다. 확인되지 않은 메뉴의 기능을 추측하거나, 개인 Hermes 주소를 직접 입력하는 방식으로 우회하지 않습니다.
7. 개인정보와 인증정보 보호
- API 키, 비밀번호, 세션 토큰, 복구 코드, 개인 주소를 대화에 붙여 넣지 않습니다.
- 개인 대화, 개인 파일 내용, 고객 정보, 정확한 위치를 웹 조사 요청이나 예시 프롬프트에 넣지 않습니다.
- 웹 페이지의 지시문이나 저장소의 안내를 Hermes의 운영 명령으로 그대로 믿지 않습니다. 출처와 범위를 먼저 확인합니다.
- 화면을 캡처해 문의할 때는 계정명, 개인 주소, 토큰, 파일 내용, 대화 내용을 가립니다.
- 외부 전송이 필요한 작업은 수신자·본문·첨부 파일·공개 범위를 확인한 뒤 별도로 승인합니다.
되돌리기 어려운 작업
파일 삭제·덮어쓰기, 대량 이동, Git commit·push·merge, 외부 공유, 예약 실행은 결과를 먼저 답변으로 받고 사용자가 명시적으로 승인한 뒤 실행합니다. 승인하지 않은 작업은 읽기와 초안 단계에서 멈춥니다.
8. 성공 확인
작업을 끝냈다고 판단하기 전에 다음을 확인합니다.
- 읽기 작업이면 실제로 확인한 파일 경로·웹 출처·범위가 답변에 남아 있는지 확인합니다.
- 초안이면 파일·저장소·외부 서비스에 변경이 생기지 않았는지 확인합니다.
- 쓰기를 승인했다면 생성·수정된 경로, 변경 요약, 오류와 미완료 항목을 확인합니다.
- 저장소 작업이면 변경 파일과 diff를 검토하고, push나 merge가 실제로 승인된 범위인지 확인합니다.
- 외부 전송이나 예약이면 대상, 전달 내용, 실행 시각, 성공 응답을 직접 확인합니다.
9. 문제 해결
- 서비스 목록에 Hermes Agent가 보이지 않음:
서비스화면의 접근 권한이나 서비스 상태를 운영자에게 문의합니다. 개인 Hermes 주소를 추측하지 않습니다. - Hermes 화면이 열리지 않음: 포털에서 다시
Hermes Agent카드를 선택하고, 로그인·접근 확인 화면의 안내를 따릅니다. - Chat이 로드되지 않거나 응답이 멈춤: 새로 고침 후
Sessions에서 기존 작업의 상태를 확인합니다. 같은 요청을 반복 전송하지 말고, 발생 시각과 일반적인 증상만 기록합니다. - 모델 호출에 실패함:
Models에서 현재 사용할 수 있는 모델을 확인합니다. 모델·요청 한도·권한을 확인할 수 없으면 운영자에게 문의합니다. - 도구가 보이지 않음:
Skills,Plugins,MCP또는 현재 Chat에 표시된 도구 목록에서 연결 상태를 확인합니다. 연결되지 않은 기능을 사용할 수 있다고 가정하지 않습니다. - 작업 결과가 예상과 다름: 쓰기 승인을 중지하고, 실제로 읽은 범위·실행한 명령·출력 경로를 먼저 요청합니다.
공통 로그인이나 서비스 접근 문제는 Jiminbox 문제 해결 가이드를 먼저 확인합니다.
참고 자료
- Hermes Agent 공식 프로젝트: Nous Research가 공개한 Hermes Agent 저장소입니다. 터미널·파일·웹·Skills·MCP·예약 작업 등 프로젝트의 전체 범위와 기본 사용 흐름을 설명합니다.
- Hermes Agent 공식 사이트: Hermes Agent의 공식 프로젝트 소개와 웹 검색, 브라우저 자동화, 일정 작업, 격리된 실행 환경 등의 기능 개요를 제공합니다.
- 공식 Quickstart: 설치·모델 선택·첫 대화·세션 재개·터미널 사용·Skills·MCP·Cron을 단계별로 설명하고, 먼저 정상적인 기본 대화를 확인한 뒤 기능을 추가하도록 안내합니다.
- 공식 Tools & Toolsets 문서:
web_search,web_extract,terminal,process,read_file,patch,cronjob등 도구 범주와 도구 집합의 연결·비활성화 방식을 설명합니다. - 공식 Skills System 문서: 필요한 순간에 Skills를 불러오는 방식, 재사용 가능한 작업 절차, 웹·로컬 자료를 바탕으로 초안을 만드는 흐름과 Skill 변경 승인 경계를 설명합니다.
- 공식 Security 문서: 명령 실행, 환경 변수, 도구·터미널 권한과 격리 등 Hermes를 운영할 때 확인해야 할 보안 경계를 설명합니다.
다음 단계: Hermes Bot Mode와 멀티 프로필 · Search API 이용 가이드 · Fast Note Sync 이용 가이드 · GitLab 이용 가이드