词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"代码执行"
代码执行（程序化工具调用）
execute_code 工具允许 agent 编写调用 Hermes 工具的 Python 脚本，将多步骤工作流压缩至单次 LLM 对话轮次。脚本在 agent 宿主机的子进程中运行，通过 Unix 域套接字 RPC 与 Hermes 通信。工作原理
1.
from hermes_tools import ... 的 Python 脚本2.
hermes_tools.py 存根模块3.
4.
5.
print() 输出会返回给 LLM；中间工具结果不会进入上下文窗口web_search、web_extract、read_file、write_file、search_files、patch、terminal（仅前台模式）。Agent 何时使用此功能
execute_code：print() 输出会返回，大幅降低 token 用量。实际示例
数据处理流水线
多步骤网络调研
批量文件重构
构建与测试流水线
执行模式
execute_code 有两种执行模式，通过 ~/.hermes/config.yaml 中的 code_execution.mode 控制：| 模式 | 工作目录 | Python 解释器 |
|---|---|---|
project（默认） | 会话的工作目录（与 terminal() 相同） | 活跃的 VIRTUAL_ENV / CONDA_PREFIX python，回退至 Hermes 自身的 python |
strict | 与用户项目隔离的临时暂存目录 | sys.executable（Hermes 自身的 python） |
project 模式： 当你希望 import pandas、from my_project import foo 或 open(".env") 等相对路径与 terminal() 中的行为一致时。这几乎是你始终想要的模式。strict 模式： 当你需要最大可复现性时——希望无论用户激活哪个 venv，每次会话都使用相同的解释器，并且希望脚本与项目目录隔离（避免通过相对路径意外读取项目文件）。project 模式的回退行为：若 VIRTUAL_ENV / CONDA_PREFIX 未设置、已损坏或指向低于 3.8 的 Python，解析器会干净地回退至 sys.executable——agent 始终有可用的解释器。execute_code、delegate_task 或 MCP 工具）资源限制
| 资源 | 限制 | 说明 |
|---|---|---|
| 超时 | 5 分钟（300 秒） | 脚本先收到 SIGTERM，5 秒宽限期后收到 SIGKILL |
| Stdout | 50 KB | 输出截断并附加 [output truncated at 50KB] 提示 |
| Stderr | 10 KB | 非零退出时包含在输出中，用于调试 |
| 工具调用 | 每次执行 50 次 | 达到上限时返回错误 |
config.yaml 配置：脚本内工具调用的工作方式
web_search("query") 等函数时：1.
2.
handle_function_call 处理器进行分发3.
4.
terminal() 仅支持前台模式（不支持 background 或 pty 参数）。错误处理
"Script timed out after 300s and was killed."[execution interrupted — user sent a new message]status（success/error/timeout/interrupted）、output、tool_calls_made 和 duration_seconds。安全性
安全模型
KEY、TOKEN、SECRET、PASSWORD、CREDENTIAL、PASSWD 或 AUTH 的环境变量会被排除。只有安全的系统变量（PATH、HOME、LANG、SHELL、PYTHONPATH、VIRTUAL_ENV 等）会被传递。Skill 环境变量透传
required_environment_variables 时，这些变量会在 skill 加载后自动透传至 execute_code 和 terminal 子进程。这使 skill 可以使用其声明的 API key，而不会削弱任意代码的安全态势。config.yaml 中显式添加变量白名单：hermes_tools.py RPC 存根写入临时暂存目录，执行完成后清理。在 strict 模式下，脚本也在该目录中运行；在 project 模式下，脚本在会话的工作目录中运行（暂存目录保留在 PYTHONPATH 中以确保导入正常解析）。子进程在独立的进程组中运行，以便在超时或中断时干净地终止。execute_code 与 terminal 对比
| 使用场景 | execute_code | terminal |
|---|---|---|
| 调用之间含逻辑的多步骤工作流 | ✅ | ❌ |
| 简单 shell 命令 | ❌ | ✅ |
| 过滤/处理大量工具输出 | ✅ | ❌ |
| 运行构建或测试套件 | ❌ | ✅ |
| 对搜索结果进行循环处理 | ✅ | ❌ |
| 交互式/后台进程 | ❌ | ✅ |
| 需要环境变量中的 API key | ⚠️ 仅通过透传 | ✅（大多数可透传） |
execute_code。运行 shell 命令、构建和进程时，使用 terminal。