跳到主要内容

工具与工具集

工具是扩展 Agent 能力的函数。它们被组织为逻辑 工具集(Toolset),可按平台启用或禁用。

可用工具

Hermes 内置了覆盖广泛的工具注册表,涵盖网络搜索、浏览器自动化、终端执行、文件编辑、记忆、任务委派、RL 训练、消息投递、Home Assistant 等。

备注

Honcho 跨会话记忆 作为记忆提供商插件(plugins/memory/honcho/)提供,而非内置工具集。参见插件了解安装方式。

高层级分类:

类别示例描述
Webweb_searchweb_extract搜索网页并提取页面内容。
终端与文件terminalprocessread_filepatch执行命令和操作文件。
浏览器browser_navigatebrowser_snapshotbrowser_vision支持文本和视觉的交互式浏览器自动化。
媒体vision_analyzeimage_generatetext_to_speech多模态分析和生成。
Agent 编排todoclarifyexecute_codedelegate_task规划、澄清、代码执行和子 Agent 委派。
记忆与召回memorysession_search持久化记忆和会话搜索。
自动化与投递cronjobsend_message定时任务(支持创建/列表/更新/暂停/恢复/运行/删除操作)以及外发消息投递。
集成ha_*、MCP 服务器工具、rl_*Home Assistant、MCP、RL 训练和其他集成。

关于基于代码的权威注册表,参见内置工具参考工具集参考

Nous Tool Gateway

付费 Nous Portal 订阅用户可以通过 Tool Gateway 使用网络搜索、图片生成、TTS 和浏览器自动化 — 无需单独的 API 密钥。运行 hermes model 来启用,或通过 hermes tools 配置单个工具。

使用工具集

# 使用指定的工具集
hermes chat --toolsets "web,terminal"

# 查看所有可用工具
hermes tools

# 按平台配置工具(交互式)
hermes tools

常用工具集包括 webterminalfilebrowservisionimage_genmoaskillsttstodomemorysession_searchcronjobcode_executiondelegationclarifyhomeassistantrl

参见工具集参考了解完整列表,包括平台预设如 hermes-clihermes-telegram 以及动态 MCP 工具集如 mcp-<server>

终端后端

终端工具可以在不同环境中执行命令:

后端描述用途
local在本机运行(默认)开发、可信任务
docker隔离容器安全性、可复现性
ssh远程服务器沙箱化,使 Agent 远离自身代码
singularityHPC 容器集群计算、无 root 运行
modal云端执行无服务器、弹性伸缩
daytona云端沙箱工作区持久化远程开发环境

配置

# 在 ~/.hermes/config.yaml 中
terminal:
backend: local # 或:docker, ssh, singularity, modal, daytona
cwd: "." # 工作目录
timeout: 180 # 命令超时(秒)

Docker 后端

terminal:
backend: docker
docker_image: python:3.11-slim

SSH 后端

出于安全考虑推荐使用 — Agent 无法修改自身代码:

terminal:
backend: ssh
# 在 ~/.hermes/.env 中设置凭证
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

Singularity/Apptainer

# 为并行工作器预构建 SIF
apptainer build ~/python.sif docker://python:3.11-slim

# 配置
hermes config set terminal.backend singularity
hermes config set terminal.singularity_image ~/python.sif

Modal(无服务器云端)

uv pip install modal
modal setup
hermes config set terminal.backend modal

容器资源

为所有容器后端配置 CPU、内存、磁盘和持久化:

terminal:
backend: docker # 或 singularity, modal, daytona
container_cpu: 1 # CPU 核心数(默认:1)
container_memory: 5120 # 内存 MB(默认:5GB)
container_disk: 51200 # 磁盘 MB(默认:50GB)
container_persistent: true # 跨会话持久化文件系统(默认:true)

container_persistent: true 时,安装的包、文件和配置在会话间保持不变。

容器安全

所有容器后端都启用了安全加固:

  • 只读根文件系统(Docker)
  • 丢弃所有 Linux capabilities
  • 禁止权限提升
  • PID 限制(256 个进程)
  • 完整的命名空间隔离
  • 通过卷实现持久化工作区,而非可写的根层

Docker 可以通过 terminal.docker_forward_env 选择性地接收显式的环境变量白名单,但转发的变量对容器内的命令可见,应视为对该会话已暴露。

后台进程管理

启动后台进程并进行管理:

terminal(command="pytest -v tests/", background=true)
# 返回: {"session_id": "proc_abc123", "pid": 12345}

# 然后使用 process 工具管理:
process(action="list") # 显示所有运行中的进程
process(action="poll", session_id="proc_abc123") # 检查状态
process(action="wait", session_id="proc_abc123") # 阻塞直到完成
process(action="log", session_id="proc_abc123") # 完整输出
process(action="kill", session_id="proc_abc123") # 终止
process(action="write", session_id="proc_abc123", data="y") # 发送输入

PTY 模式(pty=true)支持交互式 CLI 工具如 Codex 和 Claude Code。

Sudo 支持

如果命令需要 sudo,你会被提示输入密码(在会话期间缓存)。或者在 ~/.hermes/.env 中设置 SUDO_PASSWORD

注意

在消息平台上,如果 sudo 失败,输出中会包含一条提示,建议将 SUDO_PASSWORD 添加到 ~/.hermes/.env


📝 本文由 AI 翻译,如有疑问请参考英文原版