Toolsets 참조
Toolsets는 에이전트가 할 수있는 것을 제어하는 도구의 번들이라고합니다. 그들은 플랫폼 당 도구 가용성을 구성하기위한 기본 메커니즘, 세션 당, 또는 작업 당.
도구 작업
모든 도구는 정확히 하나의 도구에 속합니다. 툴킷을 사용할 때, 묶음의 모든 도구는 에이전트에 사용할 수 있습니다. 연장통은 3개의 종류에서 옵니다:
- Core — 관련 도구의 단일 논리 그룹 (예,
file번들read_file,write_file,patch,search_files) - Composite — 공통 시나리오에 대한 여러 코어 도구 모음 (예,
debugging번들 파일, 터미널 및 웹 도구) - Platform - 특정 배포 상황에 대한 완벽한 도구 구성 (예,
hermes-cli는 대화형 CLI 세션의 기본입니다)
Toolsets 구성
제한 (CLI)
hermes chat --toolsets web,file,terminal
hermes chat --toolsets debugging # composite — expands to file + terminal + web
hermes chat --toolsets all # everything
퍼플랫폼 (config.yaml)
toolsets:
- hermes-cli # default for CLI
# - hermes-telegram # override for Telegram gateway
Interactive 관리
hermes tools # curses UI to enable/disable per platform
또는 소유권:
/tools list
/tools disable browser
/tools enable homeassistant
핵심 도구
| 회사 소개 | 설명 | 설명 |
|---|---|---|
browser | browser_back, browser_cdp, browser_click, browser_console, browser_dialog, browser_get_images, browser_navigate, browser_press, ..., ... | 핵심 브라우저 자동화. web_search 을 빠른 검색에 대 한 fallback 포함 합니다. browser_cdp와 browser_dialog는 CDP 엔드포인트가 세션 시작될 때만 등록됩니다(/browser connect를 통해) browser.cdp_url 구성, 브라우저베이스, 또는 Camofox). browser_dialog는 pending_dialogs와 frame_tree 필드와 함께 작동합니다. browser_snapshot는 CDP 감독자가 붙어있을 때 추가합니다. |
clarify | clarify | 에이전트가 명확하게 할 때 사용자에게 질문을하세요. |
code_execution | execute_code | Hermes 도구 프로그래밍을 호출하는 Python 스크립트를 실행합니다. |
cronjob | cronjob | 일정 및 재발급 작업 관리. |
debugging | 복합 (file + terminal + web) | 디버그 번들 - 파일, 프로세스 / 종료, 웹 추출 / 연구. |
delegation | delegate_task | Spawn는 평행한 일을 위한 시약 인스턴스를 격리했습니다. |
discord | discord | 핵심 Discord 원본/embed/DM 활동 (gateway 전용). hermes-discord 툴렛에서 동작합니다. |
discord_admin | discord_admin | Discord Moderation (bans, 역할 변경, 채널 관리). hermes-discord 툴렛에 능동적, 관련 Discord 권한을 보유하려면 봇이 필요합니다. |
feishu_doc | feishu_doc_read | Feishu/Lark 문서 내용을 읽으십시오. Feishu Document-comment Intelligent-reply 핸들러에 의해 사용하는. |
feishu_drive | feishu_drive_add_comment, feishu_drive_list_comments, feishu_drive_list_comment_replies, feishu_drive_reply_comment | Feishu/Lark 드라이브 의견 가동. 코멘트 에이전트에 스코프; hermes-cli 또는 기타 메시징 도구에 노출되지 않습니다. |
file | patch, read_file, search_files, write_file | 파일 읽기, 쓰기, 검색 및 편집. |
homeassistant | ha_call_service, ha_get_state, ha_list_entities, ha_list_services | Home Assistant를 통한 스마트 홈 컨트롤. HASS_TOKEN가 설정될 때만 사용할 수 있습니다. |
computer_use | computer_use | cua-driver를 통해 배경 macOS 데스크탑 컨트롤 - 커서 / 초점을 훔치지 않습니다. 모든 도구 캡블 모델과 함께 작동합니다. macOS 만; cua-driver을 $PATH에 요구합니다. |
image_gen | image_generate | FAL.ai를 통해 텍스트 이미지 생성 (OpenAI / XAI 백엔드에서 선택). |
video_gen | video_generate | text-to-video and image-to-video via plugin-registered backends (xAI Grok-Imagine, FAL.ai Veo 3.1 / Pixverse v6 / Kling O3). image_url를 이미지에 전달; text-to-video를 위해 그것을 이동. |
kanban | kanban_block, kanban_comment, kanban_complete, kanban_create, kanban_heartbeat, kanban_link | 다중 시약 조정 도구 - 에이전트가 Kanban 파견자 (HERMES_KANBAN_TASK env 세트)에 의해 스팸 될 때만 등록됩니다. 작업자가 구조화 손전등과 함께 수행 할 수 있도록, 인간의 입력 블록, 긴 ops 동안 심장 박동, 스레드에 대한 의견, (오케스트라 터) 아이 작업에 팬. |
memory | memory | Persistent 횡단 기억 관리. |
messaging | send_message | 세션 내에서 다른 플랫폼(Telegram, Discord 등)에 메시지를 보냅니다. |
moa | mixture_of_agents | Agents의 Mixture를 통해 멀티 모델 컨센서스. |
safe | image_generate, vision_analyze, web_extract, web_search (를 통해 includes) | 읽기 전용 연구 + 미디어 생성. 파일 쓰기 없음, 터미널 없음, 코드 실행 없음. |
search | web_search | 웹 검색 만 ( 추출물없이). |
session_search | session_search | 과거 대화 세션 검색. |
skills | skill_manage, skill_view, skills_list | 기술 CRUD 및 탐색. |
spotify | spotify_albums, spotify_devices, spotify_library, spotify_playback, spotify_playlists, spotify_queue | Native Spotify 제어 (플레이백, 큐, 검색, 재생 목록, 앨범, 라이브러리). 번들 spotify 플러그인에 의해 등록. |
terminal | process, terminal | Shell 명령 실행 및 배경 프로세스 관리. |
todo | todo | 세션 내에서 작업 목록 관리. |
tts | text_to_speech | Text-to-speech 오디오 생성. |
vision | vision_analyze | Vision-capable 모델을 통한 이미지 분석. |
video | video_analyze | 비디오 분석 및 이해 도구 (opt-in, 기본 도구에서 아닙니다 - --toolsets를 통해 명시적으로 추가하세요). |
web | web_extract, web_search | 웹 검색 및 페이지 콘텐츠 추출. |
yuanbao | yb_query_group_info, yb_query_group_members, yb_search_sticker, yb_send_dm, yb_send_sticker | Yuanbao DM / 그룹 작업 및 스티커 검색. hermes-yuanbao에서만 등록하세요. |
플랫폼 Toolsets
Platform toolsets는 배포 대상을위한 완벽한 도구 구성을 정의합니다. 대부분의 메시징 플랫폼은 hermes-cli와 동일한 세트를 사용합니다
| 회사 소개 | hermes-cli의 차이점 |
|---|---|
hermes-cli | Full toolet - 대화형 CLI 세션의 기본입니다. 파일, 터미널, 웹, 브라우저, 메모리, 기술, 비전, image_gen, todo, tts, delegation, code_execution, cronjob, session_search, clarify 및 safe (read-only) 번들 및 표준 메시징 도구를 포함합니다. |
hermes-acp | 드롭 clarify, cronjob, image_generate, send_message, text_to_speech 및 모든 네 개의 홈 보조 도구. IDE 컨텍스트에서 코딩 작업에 집중했습니다. |
hermes-api-server | 하락 clarify, send_message, text_to_speech. 다른 모든 것을 유지 - 사용자의 상호 작용이 불가능한 programmatic 액세스를 위해 적합합니다. |
hermes-cron | hermes-cli와 동일합니다. |
hermes-telegram | hermes-cli와 동일합니다. |
hermes-discord | discord 및 discord_admin의 상단에 hermes-cli를 추가합니다. |
hermes-slack | hermes-cli와 동일합니다. |
hermes-whatsapp | hermes-cli와 동일합니다. |
hermes-signal | hermes-cli와 동일합니다. |
hermes-matrix | hermes-cli와 동일합니다. |
hermes-mattermost | hermes-cli와 동일합니다. |
hermes-email | hermes-cli와 동일합니다. |
hermes-sms | hermes-cli와 동일합니다. |
hermes-bluebubbles | hermes-cli와 동일합니다. |
hermes-dingtalk | hermes-cli와 동일합니다. |
hermes-feishu | 5개의 feishu_doc_* / feishu_drive_* 도구를 추가합니다. (문서 구성 핸들러에서만 사용되며, 일반 채팅 어댑터가 아닙니다.). |
hermes-qqbot | hermes-cli와 동일합니다. |
hermes-wecom | hermes-cli와 동일합니다. |
hermes-wecom-callback | hermes-cli와 동일합니다. |
hermes-weixin | hermes-cli와 동일합니다. |
hermes-yuanbao | hermes-cli의 상단에 5개의 ... 도구(DM/group/sticker)를 추가합니다. |
hermes-homeassistant | hermes-cli와 동일 (홈 어시스턴트 도구는 기본적으로 존재하며 HASS_TOKEN가 설정될 때 활성화됩니다). |
hermes-webhook | hermes-cli와 동일합니다. |
hermes-gateway | 내부 게이트웨이 오케스트라 도구 모음 - 모든 hermes-<platform> 도구 모음의 조합; 게이트웨이가 모든 메시지 소스를 수용 할 때 사용. |
동적 도구
MCP 서버 도구
각 구성 MCP 서버는 실행시에 mcp-<server> 툴릿을 생성합니다. 예를 들어, github MCP 서버를 구성하면 mcp-github 툴릿은 서버가 노출되는 모든 도구를 포함하고 있습니다.
# config.yaml
mcp_servers:
github:
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
이것은 mcp-github 도구 모음을 만듭니다. --toolsets 또는 플랫폼 구성.
플러그인 도구
플러그인은 플러그인 초기화 중에 ctx.register_tool()를 통해 자신의 툴킷을 등록할 수 있습니다. 이들은 내장 도구와 함께 나타나고 같은 방법을 활성화 / 비활성화 할 수 있습니다.
사용자 정의 도구
config.yaml의 사용자 정의 도구 정의를 정의하여 프로젝트 별 번들을 만듭니다
toolsets:
- hermes-cli
custom_toolsets:
data-science:
- file
- terminal
- code_execution
- web
- vision
와일드카드
all또는*- 모든 등록 도구로 확장 (붙박이 + 동적 + 플러그인)
hermes tools에 관계
hermes tools 명령은 플랫폼 당 개별 도구에 대한 커즈 기반 UI를 제공합니다. 이것은 도구 수준에서 작동 (툴보다 핀) 과 persists에 config.yaml. 도구가 활성화된 경우에도 제거됩니다.
참조: 도구 참조 개인 도구 및 매개 변수의 전체 목록.