可采用四种方式自动化调用Hermes Agent执行本地工具：一、用Python SDK直接实例化AIAgent并传入自定义工具；二、调用其REST API并注册本地工具插件；三、通过Unix Domain Socket使用ACP协议通信；四、以CLI子进程方式调用并解析stdout输出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 Python 脚本中自动化调用 Hermes Agent 并执行本地工具操作（例如文件读写、系统命令、自定义技能等），需绕过 CLI 交互层，直接对接其运行时核心接口。以下是实现此目标的多种可行路径：
一、通过 Hermes Agent 的 Python SDK 直接实例化 AIAgent
该方式适用于脚本内完全控制 agent 生命周期，支持传入自定义工具集、上下文与 session 状态，无需启动独立服务进程。
1、确保已安装 Hermes Agent 及其 Python 包：pip install hermes-agent
2、在 Python 脚本中导入核心类并初始化 agent：
立即学习“Python免费学习笔记（深入）”；
3、构建包含本地工具调用能力的工具列表，例如使用 subprocess 运行 shell 命令：
4、调用 run_conversation 方法，传入含 tool_calls 意图的用户消息，如“列出当前目录下所有 .py 文件”
5、捕获返回结果中的 tool_result 字段，解析工具执行输出
二、调用 Hermes Agent 内置 REST API 服务并注入本地工具插件
该方式将 Hermes Agent 启动为 HTTP 服务，并通过 /v1/chat/completions 接口提交请求；需提前注册本地工具为插件模块，使其被 runtime_provider 加载。
1、将本地工具脚本（如 file_tools.py）置于 ~/.hermes/tools/ 目录下
2、在该脚本中定义符合 ToolSpec 格式的函数，标注 @tool 装饰器，并声明参数类型与 description
3、启动 API 服务时启用插件扫描：hermes api serve --host 0.0.0.0 --port 8000 --enable-plugins
4、使用 requests 发送 POST 请求，body 中 messages 包含触发工具调用的自然语言指令
5、检查响应 JSON 中是否包含 "tool_calls" 字段，确认工具已被识别并调度
三、通过 Unix Domain Socket 使用 ACP 协议调用已注册的本地工具
该方式面向高性能、零网络延迟的本地集成场景，适用于嵌入到 CI/CD 流水线或定时任务中，要求 Hermes Agent 进程已加载对应工具模块。
1、确认 Hermes Agent 正在运行且启用了 ACP 支持：hermes run --mode acp
2、查看日志中输出的 socket 路径，通常为 /tmp/hermes-acp.sock
3、在 Python 脚本中使用 socket 模块连接该路径，并发送二进制协议帧
4、构造 ACP 消息头，type 设置为 "tool_invoke"，payload 包含 tool_name、arguments 和 session_id
5、接收响应帧，解析 status 字段为 "success" 或 "error"，并提取 result 字段内容
四、利用 Hermes Agent 的 CLI 子进程调用并解析标准输出
该方式最轻量，不依赖 SDK 或服务进程，适合一次性、低耦合的自动化任务，但无法实时流式获取工具执行中间状态。
1、编写一个临时 YAML 配置片段，指定 model.provider 为 ollama，model.name 为本地已部署模型（如 qwen2.5:7b）
2、将该配置保存为 temp_config.yaml，并通过环境变量指向：HERMES_CONFIG_PATH=./temp_config.yaml
3、构造一条命令行调用：hermes chat --session-id auto --message "执行命令：df -h"
4、使用 subprocess.run 捕获 stdout 输出，设置 capture_output=True 和 text=True
5、对输出文本进行正则匹配，提取以 TOOL_RESULT: 开头的行作为本地工具执行结果
