Công cụ & Bộ công cụ
Công cụ là các chức năng mở rộng khả năng của tác nhân. Chúng được sắp xếp thành bộ công cụ logic có thể được bật hoặc tắt trên mỗi nền tảng.
Công cụ có sẵn
Hermes cung cấp sổ đăng ký công cụ tích hợp rộng rãi bao gồm tìm kiếm trên web, tự động hóa trình duyệt, thực thi terminal, chỉnh sửa tệp, bộ nhớ, ủy quyền, đào tạo RL, gửi tin nhắn, Trợ lý gia đình, v.v.
Bộ nhớ phiên chéo Honcho có sẵn dưới dạng plugin nhà cung cấp bộ nhớ ( plugins/memory/honcho/ ), không phải dưới dạng bộ công cụ tích hợp sẵn. Xem Plugins để cài đặt.
Danh mục cấp cao:
| Danh mục | Ví dụ | Mô tả |
|---|---|---|
| Web | web_search , web_extract | Tìm kiếm trên web và trích xuất nội dung trang. |
| Thiết bị đầu cuối & tập tin | terminal , process , read_file , patch | Thực thi các lệnh và thao tác với tập tin. |
| Trình duyệt | browser_navigate , browser_snapshot , browser_vision | Tự động hóa trình duyệt tương tác với hỗ trợ văn bản và hình ảnh. |
| Truyền thông | vision_analyze , image_generate , text_to_speech | Phân tích và tạo đa phương thức. |
| Điều phối đại lý | todo , clarify , execute_code , delegate_task | Lập kế hoạch, làm rõ, thực thi mã và ủy quyền cho đại lý phụ. |
| Bộ nhớ và thu hồi | memory , session_search | Bộ nhớ liên tục và tìm kiếm phiên. |
| Tự động hóa và giao hàng | cronjob , send_message | Các tác vụ đã lên lịch với các hành động tạo/danh sách/cập nhật/tạm dừng/tiếp tục/chạy/xóa, cùng với việc gửi tin nhắn đi. |
| Tích hợp | ha_* , công cụ máy chủ MCP, rl_* | Trợ lý tại nhà, đào tạo MCP, RL và các tích hợp khác. |
Để biết sổ đăng ký có nguồn gốc từ mã có thẩm quyền, hãy xem Tham khảo công cụ tích hợp và Tham khảo bộ công cụ.
Sử dụng bộ công cụ
# Use specific toolsets
hermes chat --toolsets "web,terminal"
# See all available tools
hermes tools
# Configure tools per platform (interactive)
hermes tools
Các bộ công cụ phổ biến bao gồm web , terminal , file , browser , vision , image_gen , moa , skills , tts , todo , memory , session_search , cronjob , code_execution , delegation , clarify , homeassistant và rl .
Xem Tham khảo bộ công cụ để biết bộ đầy đủ, bao gồm các cài đặt trước nền tảng như hermes-cli , hermes-telegram và các bộ công cụ MCP động như mcp-<server> .
Phần cuối của terminal
Công cụ đầu cuối có thể thực thi các lệnh trong các môi trường khác nhau:
| Phần cuối | Mô tả | Trường hợp sử dụng |
|---|---|---|
local | Chạy trên máy của bạn (mặc định) | Phát triển, nhiệm vụ đáng tin cậy |
docker | Thùng chứa biệt lập | Bảo mật, khả năng tái tạo |
ssh | Máy chủ từ xa | Sandboxing, giữ cho đại lý tránh xa mã của chính nó |
singularity | Thùng chứa HPC | Điện toán cụm, không cần root |
modal | Thực thi đám mây | Không có máy chủ, quy mô |
daytona | Không gian làm việc hộp cát trên đám mây | Môi trường phát triển từ xa liên tục |
Cấu hình
# In ~/.hermes/config.yaml
terminal:
backend: local
# or: docker, ssh, singularity, modal, daytona
cwd: "."
# Working directory
timeout: 180
# Command timeout in seconds
Phần cuối của Docker
terminal:
backend: docker
docker_image: python:3.11-slim
Phần cuối SSHĐược khuyến nghị để bảo mật - tác nhân không thể sửa đổi mã của chính mình:
terminal:
backend: ssh
# Set credentials in ~/.hermes/.env
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa
Đơn lẻ/Người ứng dụng
# Pre-build SIF for parallel workers
apptainer build ~/python.sif docker://python:3.11-slim
# Configure
hermes config set terminal.backend singularity
hermes config set terminal.singularity_image ~/python.sif
Phương thức (Đám mây không có máy chủ)
uv pip install modal
modal setup
hermes config set terminal.backend modal
Tài nguyên vùng chứa
Định cấu hình CPU, bộ nhớ, đĩa và tính bền vững cho tất cả các chương trình phụ trợ vùng chứa:
terminal:
backend: docker
# or singularity, modal, daytona
container_cpu: 1
# CPU cores (default: 1)
container_memory: 5120
# Memory in MB (default: 5GB)
container_disk: 51200
# Disk in MB (default: 50GB)
container_persistent: true
# Persist filesystem across sessions (default: true)
Khi container_persistent: true , các gói, tệp và cấu hình đã cài đặt tồn tại qua các phiên.
Bảo mật vùng chứa
Tất cả các chương trình phụ trợ vùng chứa đều chạy với mức độ tăng cường bảo mật:
- Hệ thống tập tin gốc chỉ đọc (Docker)
- Tất cả các khả năng của Linux đều bị loại bỏ
- Không leo thang đặc quyền
- Giới hạn PID (256 quy trình)
- Cách ly không gian tên đầy đủ
- Không gian làm việc liên tục thông qua các khối, lớp gốc không thể ghi
Docker có thể tùy ý nhận danh sách cho phép env rõ ràng thông qua terminal.docker_forward_env , nhưng các biến được chuyển tiếp sẽ hiển thị với các lệnh bên trong vùng chứa và phải được coi là được hiển thị trong phiên đó.
Quản lý quy trình nền
Bắt đầu các tiến trình nền và quản lý chúng:
terminal(command="pytest -v tests/", background=true)
# Returns: {"session_id": "proc_abc123", "pid": 12345}
# Then manage with the process tool:
process(action="list")
# Show all running processes
process(action="poll", session_id="proc_abc123")
# Check status
process(action="wait", session_id="proc_abc123")
# Block until done
process(action="log", session_id="proc_abc123")
# Full output
process(action="kill", session_id="proc_abc123")
# Terminate
process(action="write", session_id="proc_abc123", data="y")
# Send input
Chế độ PTY ( pty=true ) cho phép các công cụ CLI tương tác như Codex và Claude Code.
Hỗ trợ Sudo
Nếu một lệnh cần sudo, bạn sẽ được nhắc nhập mật khẩu (được lưu trong bộ đệm cho phiên). Hoặc đặt SUDO_PASSWORD trong ~/.hermes/.env .
Trên nền tảng nhắn tin, nếu sudo không thành công, đầu ra sẽ bao gồm mẹo thêm SUDO_PASSWORD vào ~/.hermes/.env .