Tham khảo bộ công cụ
Bộ công cụ được đặt tên là các gói công cụ kiểm soát những gì tác nhân có thể làm. Chúng là cơ chế chính để định cấu hình tính khả dụng của công cụ trên mỗi nền tảng, mỗi phiên hoặc mỗi tác vụ.
Cách hoạt động của bộ công cụ
Mỗi công cụ thuộc về chính xác một bộ công cụ. Khi bạn kích hoạt một bộ công cụ, tất cả các công cụ trong gói đó sẽ có sẵn cho tổng đài viên. Bộ công cụ có ba loại:
- Core — Một nhóm logic duy nhất gồm các công cụ liên quan (ví dụ:
filegóiread_file,write_file,patch,search_files) - Tổng hợp — Kết hợp nhiều bộ công cụ cốt lõi cho một kịch bản chung (ví dụ:
debugginggói tệp, terminal và công cụ web) - Nền tảng — Cấu hình công cụ hoàn chỉnh cho ngữ cảnh triển khai cụ thể (ví dụ:
hermes-clilà mặc định cho các phiên CLI tương tác)
Cấu hình bộ công cụ
Mỗi phiên (CLI)
hermes chat --toolsets web,file,terminal
hermes chat --toolsets debugging
# composite — expands to file + terminal + web
hermes chat --toolsets all
# everything
Trên mỗi nền tảng (config.yaml)
toolsets:
- hermes-cli
# default for CLI
# - hermes-telegram
# override for Telegram gateway
Quản lý tương tác
hermes tools
# curses UI to enable/disable per platform
Hoặc trong phiên:
/tools list
/tools disable browser
/tools enable rl
Bộ công cụ cốt lõi
| Bộ công cụ | Công cụ
| Mục đích |
|----------|-------|---------|
| browser | browser_back , browser_click , browser_console , browser_get_images , browser_navigate , browser_press , browser_scroll , browser_snapshot , browser_type , browser_vision , web_search | Tự động hóa trình duyệt hoàn toàn. Bao gồm web_search làm phương án dự phòng để tra cứu nhanh chóng. |
| clarify | clarify | Đặt câu hỏi cho người dùng khi nhân viên cần làm rõ. |
| code_execution | execute_code | Chạy các tập lệnh Python gọi công cụ Hermes theo chương trình. |
| cronjob | cronjob | Lên lịch và quản lý các nhiệm vụ định kỳ. |
| delegation | delegate_task | Tạo ra các phiên bản tác nhân phụ bị cô lập để thực hiện công việc song song. |
| file | patch , read_file , search_files , write_file | Đọc, ghi, tìm kiếm và chỉnh sửa tập tin. |
| homeassistant | ha_call_service , ha_get_state , ha_list_entities , ha_list_services | Điều khiển nhà thông minh thông qua Home Assistant. Chỉ khả dụng khi HASS_TOKEN được đặt. |
| image_gen | image_generate | Tạo văn bản thành hình ảnh thông qua FAL.ai. |
| memory | memory | Quản lý bộ nhớ phiên chéo liên tục. |
| messaging | send_message | Gửi tin nhắn đến các nền tảng khác (Telegram, Discord, v.v.) ngay trong một phiên. |
| moa | mixture_of_agents | Đồng thuận đa mô hình thông qua Hỗn hợp các đại lý. |
| rl | rl_check_status , rl_edit_config , rl_get_current_config , rl_get_results , rl_list_environments , rl_list_runs , rl_select_environment , rl_start_training , rl_stop_training , rl_test_inference | Quản lý môi trường đào tạo RL (Atropos). |
| search | web_search | Chỉ tìm kiếm trên web (không có trích xuất). |
| session_search | session_search | Tìm kiếm các phiên trò chuyện trong quá khứ. |
| skills | skill_manage , skill_view , skills_list | Kỹ năng CRUD và duyệt web. |
| terminal | process , terminal | Thực thi lệnh Shell và quản lý quy trình nền. |
| todo | todo | Quản lý danh sách nhiệm vụ trong một phiên. |
| tts | text_to_speech | Tạo âm thanh chuyển văn bản thành giọng nói. |
| vision | vision_analyze | Phân tích hình ảnh thông qua các mô hình có khả năng thị giác. |
| web | web_extract , web_search | Tìm kiếm trên web và trích xuất nội dung trang. |
Bộ công cụ tổng hợp
Chúng mở rộng sang nhiều bộ công cụ cốt lõi, cung cấp cách viết tắt thuận tiện cho các tình huống phổ biến:
| Bộ công cụ | Mở rộng sang | Trường hợp sử dụng |
|---|---|---|
debugging | patch , process , read_file , search_files , terminal , web_extract , web_search , write_file | Phiên gỡ lỗi - truy cập tệp, terminal và nghiên cứu web mà không cần chi phí trình duyệt hoặc ủy quyền. |
safe | image_generate , mixture_of_agents , vision_analyze , web_extract , web_search | Nghiên cứu chỉ đọc và tạo phương tiện truyền thông. Không ghi tập tin, không truy cập terminal, không thực thi mã. Tốt cho môi trường không đáng tin cậy hoặc bị hạn chế. |
Bộ công cụ nền tảngBộ công cụ nền tảng xác định cấu hình công cụ hoàn chỉnh cho mục tiêu triển khai. Hầu hết các nền tảng nhắn tin đều sử dụng cùng một bộ như hermes-cli :
| Bộ công cụ | Sự khác biệt so với hermes-cli |
|---|---|
hermes-cli | Bộ công cụ đầy đủ — tất cả 38 công cụ bao gồm clarify . Giá trị mặc định cho các phiên CLI tương tác. |
hermes-acp | Giọt clarify , cronjob , image_generate , mixture_of_agents , send_message , text_to_speech , công cụ hỗ trợ gia đình. Tập trung vào các nhiệm vụ mã hóa trong ngữ cảnh IDE. |
hermes-api-server | Giảm clarify , send_message và text_to_speech . Thêm mọi thứ khác — phù hợp để truy cập theo chương trình khi không thể tương tác với người dùng. |
hermes-telegram | Tương tự như hermes-cli . |
hermes-discord | Tương tự như hermes-cli . |
hermes-slack | Tương tự như hermes-cli . |
hermes-whatsapp | Tương tự như hermes-cli . |
hermes-signal | Tương tự như hermes-cli . |
hermes-matrix | Tương tự như hermes-cli . |
hermes-mattermost | Tương tự như hermes-cli . |
hermes-email | Tương tự như hermes-cli . |
hermes-sms | Tương tự như hermes-cli . |
hermes-dingtalk | Tương tự như hermes-cli . |
hermes-feishu | Tương tự như hermes-cli . |
hermes-wecom | Tương tự như hermes-cli . |
hermes-homeassistant | Tương tự như hermes-cli . |
hermes-webhook | Tương tự như hermes-cli . |
hermes-gateway | Liên minh tất cả các bộ công cụ nền tảng nhắn tin. Được sử dụng nội bộ khi cổng cần bộ công cụ rộng nhất có thể. |
Bộ công cụ động
Bộ công cụ máy chủ MCP
Mỗi máy chủ MCP được định cấu hình sẽ tạo ra bộ công cụ mcp-<server> khi chạy. Ví dụ: nếu bạn định cấu hình máy chủ github MCP, bộ công cụ mcp-github sẽ được tạo có chứa tất cả các công cụ mà máy chủ hiển thị.
# config.yaml
mcp:
servers:
github:
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
Điều này tạo ra một bộ công cụ mcp-github mà bạn có thể tham khảo trong --toolsets hoặc cấu hình nền tảng.
Bộ công cụ plugin
Các plugin có thể đăng ký bộ công cụ của riêng mình thông qua ctx.register_tool() trong quá trình khởi tạo plugin. Chúng xuất hiện cùng với các bộ công cụ tích hợp sẵn và có thể được bật/tắt theo cùng một cách.
Bộ công cụ tùy chỉnh
Xác định bộ công cụ tùy chỉnh trong config.yaml để tạo các gói dành riêng cho dự án:
toolsets:
- hermes-cli
custom_toolsets:
data-science:
- file
- terminal
- code_execution
- web
- vision
Ký tự đại diện
allhoặc*— mở rộng tới mọi bộ công cụ đã đăng ký (tích hợp + động + plugin)
Mối quan hệ với hermes tools
Lệnh hermes tools cung cấp giao diện người dùng dựa trên lời nguyền để bật hoặc tắt các công cụ riêng lẻ trên mỗi nền tảng. Điều này hoạt động ở cấp độ công cụ (tốt hơn bộ công cụ) và tồn tại đến config.yaml . Các công cụ bị vô hiệu hóa sẽ được lọc ra ngay cả khi bộ công cụ của chúng được bật.
Xem thêm: Tools Reference để biết danh sách đầy đủ các công cụ riêng lẻ và thông số của chúng.