Chuyển tới nội dung chính

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:

  • Lõi — Một nhóm logic duy nhất gồm các công cụ liên quan (ví dụ: file gói `read_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ụ: tệp gói `debugging

, terminal và công cụ web)

  • Nền tảng — Cấu hình công cụ hoàn chỉnh cho bối cảnh triển khai cụ thể (ví dụ: Hermes-CLI là 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)

`YAML
toolsets:

  - Hermes-CLI          # default for CLI
  # - Hermes-Telegram   # override for Telegram gateway

`

### Quản lý tương tác

``` bash
Hermes tools                            # curses UI to enable/disable per platform

`
``Hoặc trong phiên:

`
/tools list
/tools disable browser
/tools enable homeassistant

`

## Bộ công cụ cốt lõi| Bộ công cụ | Công cụ | Mục đích |
|----------|-------|---------|
| 
`browser
` | 
`browser_back

, 
`browser_cdp

, 
`browser_CLIck

, 
`browser_console

, 
`browser_dialog

, 
`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 cốt lõi. Bao gồm 
`web_search
` làm dự phòng để tra cứu nhanh chóng. 
`browser_cdp
` và 
`browser_dialog
` được kiểm soát trong thời gian chạy — chỉ được đăng ký khi có thể truy cập điểm cuối CDP khi bắt đầu phiên (thông qua 

/browser connect

, cấu hình 
`browser.cdp_url

, Browserbase hoặc Camofox). 
`browser_dialog
` hoạt động cùng với các trường 
`pending_dialogs
` và 
`frame_tree
` mà 
`browser_snapshot
` thêm vào khi gắn trình giám sát CDP. |
| 
`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ỳ. |
| 
`debugging
` | hỗn hợp (
`file

 + 
`terminal

 + 
`web

) | Gói gỡ lỗi - tệp, quy trình/terminal, trích xuất/tìm kiếm web. |
| 
`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. |
| 
`Discord
` | 
`Discord
` | Hành động văn bản/nhúng/DM của Core Discord (chỉ dành cho cổng). Hoạt động trên bộ công cụ 
`Hermes-Discord

. |
| 
`Discord_admin
` | 
`Discord_admin
` | Kiểm duyệt Discord (cấm, thay đổi vai trò, quản lý kênh). Hoạt động trên bộ công cụ 
`Hermes-Discord

; yêu cầu bot phải có các quyền Discord liên quan. |
| 
`Feishu_doc
` | 
`Feishu_doc_read
` | Đọc nội dung tài liệu Feishu/Lark. Được sử dụng bởi trình xử lý trả lời thông minh nhận xét tài liệu Feishu. |
| 
`Feishu_drive
` | 
`Feishu_drive_add_comment

, 
`Feishu_drive_list_comments

, 
`Feishu_drive_list_comment_replies

, 
`Feishu_drive_reply_comment
` | Hoạt động nhận xét ổ đĩa Feishu/Lark. Phạm vi cho tác nhân bình luận; không được hiển thị trên 
`Hermes-CLI
` hoặc các bộ công cụ nhắn tin khác. |
| 
`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. |
| 
`computer_use
` | 
`computer_use
` | Điều khiển máy tính để bàn macOS nền thông qua cua-driver - không lấy cắp con trỏ/tiêu điểm. Hoạt động với bất kỳ mô hình nào có khả năng sử dụng công cụ. chỉ macOS; yêu cầu 
`cua-driver
` trên 

$PATH

. |
| 
`image_gen
` | 
`image_generate
` | Tạo văn bản thành hình ảnh thông qua FAL.ai (với phần phụ trợ OpenAI / xAI chọn tham gia). |
| 
`video_gen
` | 
`video_generate
` | Chuyển văn bản thành video và chuyển hình ảnh thành video thông qua chương trình phụ trợ đã đăng ký plugin (xAI Grok-Imagine, FAL.ai Veo 3.1 / Pixverse v6 / Kling O3). Vượt qua 
`image_url
` để tạo hiệu ứng động cho hình ảnh; bỏ qua nó để chuyển văn bản thành video. |
| 
`kanban
` | 
`kanban_block

, 
`kanban_comment

, 
`kanban_complete

, 
`kanban_create

, 
`kanban_heartbeat

, 
`kanban_link

, 
`kanban_list

, 
`kanban_show

, 
`kanban_unblock
` | Công cụ phối hợp đa tác nhân. Đã đăng ký cho nhân viên tác vụ do người điều phối sinh ra (
`Hermes_KANBAN_TASK

) và cho các cấu hình kích hoạt rõ ràng bộ công cụ 
`kanban

. Công nhân đánh dấu các nhiệm vụ đã hoàn thành, chặn, nhịp tim, nhận xét và tạo/liên kết các nhiệm vụ tiếp theo; Ngoài ra, hồ sơ người điều phối còn nhận được các công cụ định tuyến bảng như danh sách/bỏ chặn. |
| 
`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ý. |
| 
`safe
` | 
`image_generate

, 
`vision_analyze

, 
`web_extract

, 
`web_search
` (thông qua 
`includes

) | Nghiên cứu chỉ đọc + tạo phương tiện truyền thông. Không ghi tập tin, không có terminal, không thực thi mã. |
| 
`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. |
| 
`spotify
` | 
`spotify_albums

, 
`spotify_devices

, 
`spotify_library

, 
`spotify_playback

, 
`spotify_playlists

, 
`spotify_queue

, 
`spotify_search
` | Kiểm soát Spotify gốc (phát lại, xếp hàng, tìm kiếm, danh sách phát, album, thư viện). Được đăng ký bởi plugin 
`spotify
` đi kèm. |
| 
`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. |
| 
`video
` | 
`video_analyze
` | Các công cụ phân tích và hiểu video (chọn tham gia, không có trong bộ công cụ mặc định - thêm rõ ràng qua 

`
--toolsets

). |
| 
`web
` | 
`web_extract

, 
`web_search
` | Tìm kiếm trên web và trích xuất nội dung trang. |
| 
`x_search
` | 
`x_search
` | Tìm kiếm các bài đăng và chủ đề X (Twitter) thông qua công cụ Phản hồi 
`x_search
` tích hợp sẵn của xAI. Tắt theo mặc định; chọn tham gia qua 
`Hermes tools

. Lược đồ chỉ được đăng ký khi thông tin đăng nhập xAI (SuperGrok OAuth hoặc 
`XAI_API_KEY

) được định cấu hình. |
| 
`yuanbao
` | 
`yb_query_group_info

, 
`yb_query_group_members

, 
`yb_search_sticker

, 
`yb_send_dm

, 
`yb_send_sticker
` | Yuanbao DM/hành động nhóm và tìm kiếm nhãn dán. Chỉ được đăng ký trên 
`Hermes-yuanbao

. |## Bộ công cụ nền tảng

Bộ 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 đủ — mặc định cho các phiên CLI tương tác. Bao gồm tệp, terminal, web, trình duyệt, bộ nhớ, kỹ năng, tầm nhìn, image_gen, todo, tts, ủy quyền, code_execution, cronjob, session_search, làm rõ và các gói 
`safe
` (chỉ đọc) cùng với các công cụ nhắn tin tiêu chuẩn. |
| 
`Hermes-ACP
` | Giảm 
`clarify

, 
`cronjob

, 
`image_generate

, 
`send_message

, 
`text_to_speech
` và tất cả bốn công cụ Trợ lý 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

. Giữ 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-cron
` | Tương tự như 
`Hermes-CLI

. |
| 
`Hermes-Telegram
` | Tương tự như 
`Hermes-CLI

. |
| 
`Hermes-Discord
` | Thêm 
`Discord
` và 
`Discord_admin
` trên 
`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-BlueBubbles
` | Tương tự như 
`Hermes-CLI

. |
| 
`Hermes-DingTalk
` | Tương tự như 
`Hermes-CLI

. |
| 
`Hermes-Feishu
` | Thêm năm công cụ 
`Feishu_doc_*
` / 
`Feishu_drive_*
` (chỉ được sử dụng bởi trình xử lý nhận xét tài liệu chứ không phải bộ điều hợp trò chuyện thông thường). |
| 
`Hermes-qqbot
` | Tương tự như 
`Hermes-CLI

. |
| 
`Hermes-WeCom
` | Tương tự như 
`Hermes-CLI

. |
| 
`Hermes-WeCom-callback
` | Tương tự như 
`Hermes-CLI

. |
| 
`Hermes-weixin
` | Tương tự như 
`Hermes-CLI

. |
| 
`Hermes-yuanbao
` | Thêm năm công cụ 
`yb_*
` (DM/nhóm/nhãn dán) lên trên 
`Hermes-CLI

. |
| 
`Hermes-homeassistant
` | Tương tự như 
`Hermes-CLI
` (các công cụ Trợ lý gia đình đã có sẵn theo mặc định và kích hoạt khi 
`HASS_TOKEN
` được đặt). |
| 
`Hermes-webhook
` | Tương tự như 
`Hermes-CLI

. |
| 
`Hermes-gateway
` | Bộ công cụ điều phối cổng nội bộ - sự kết hợp của mọi bộ công cụ 
`Hermes-<platform

; được sử dụng khi cổng cần chấp nhận bất kỳ nguồn tin nhắn nào. |

## 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ủ MCP 
`GitHub

, 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ị.

``` yaml

# config.yaml
MCP_servers:
  GitHub:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-GitHub"]

`
``Điều này tạo ra 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:

``` yaml
toolsets:

  - Hermes-CLI
custom_toolsets:
  data-science:
    - file
    - terminal
    - code_execution
    - web
    - vision

`

### Ký tự đại diện
- 
`all
` hoặ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à duy trì đế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](./tools-reference.md) để biết danh sách đầy đủ các công cụ riêng lẻ và thông số của chúng.