Hermes Agent 常见问题（深度 FAQ）
以下问题大多可在 Hermes 七天子站 找到交互验证入口：Tool Call Inspector（工具格式与失败链）、Persona Lab（角色漂移）、Code Sandbox（MCP 与沙箱）、课表锚点（按 Day 定位知识点）。
本文不是「一句话百科」，而是 15+ 个生产级 FAQ：每个含背景、机制、决策树、代码或配置片段、与子 站实验的对应关系。按主题分组，便于检索。
格式与协议
Q1：Hermes 格式与 OpenAI Functions 有什么本质区别？能否混用？
背景：OpenAI Functions 把工具定义成 JSON Schema，模型输出结构化 tool_calls 数组；Nous Hermes 系列模型常训练于 XML 风格标签 <tool_call> / <tool_response>，与 ChatML 交织。Claude 则偏 XML tool use。三者 语义相同（name + arguments），序列化不同。
| 维度 | OpenAI Functions | Hermes 标签 | Claude XML |
|---|---|---|---|
| 定义方式 | tools=[{type:function, function:{...}}] | System 内嵌工具说明 + 标签约定 | tools + XML block |
| 模型输出 | message.tool_calls[] | 文本内 <tool_call>{...}</tool_call> | <invoke name="..."> |
| SDK 支持 | 原生 | 需手写 parser 或模板 | Anthropic SDK |
| 适合模型 | GPT-4o、Qwen2.5（API 模式） | Hermes-2-Pro、部分开源 | Claude 3+ |
能 否混用？ 不能在同一轮解析路径混用。错误做法：用 OpenAI SDK 绑工具，却跑 Hermes-2-Pro 期望标签输出——会得到纯文本「假 JSON」，解析器 silent fail。
推荐决策：
与子站配合：在 Tool Call Inspector 左侧选格式，粘贴 model_raw，右侧看解析器是否提取 name/arguments。Day 1 Morning 所有对比实验都应在此完成。
实践建议：团队统一 Internal IR（中间表示）：无论外层格式，解析后都变成 ToolCall(name, args: dict)，再进网关。详见 快速开始 第二、三节双路径。
Q2：Claude XML 与 Hermes 标签谁更易维护？
长期看 OpenAI Functions / 厂商原生 tool_calls 最易维护（SDK 负责边界）。Hermes 标签优势在 开源本地部署 与 训练数据一致性——同一模型从预训练到 SFT 标签一致，函数调用准确率 often 更高。
维护成本对比：
| 格式 | Parser 复杂度 | 流式友好 | 多工具并行 |
|---|---|---|---|
| OpenAI | 低 | 是 | 是 |
| Hermes | 中（正则+JSON 修复） | 需缓冲 | 需约定 |
| Claude XML | 低（SDK） | 是 | 是 |
若 仅一只模型、一个环境，跟模型文档走；若多模型路由， invest in IR 层。
失败处理与可靠性
Q3：工具调用失败怎么办？Retry、Fallback、自我修正如何组合？
失败 taxonomy：
| 类型 | 示例 | 策略 |
|---|---|---|
| 可重试 | 429、503、timeout | 指数退避 Retry ≤3 |
| 参数错误 | 422 validation | 把 error 喂回模型 self-correct 1–2 次 |
| 逻辑错误 | 空结果 | Fallback Tool 或换 query |
| 权限错误 | 403 | 停止 + 用户提示，禁止 blind retry |
| 永久错误 | unknown tool | 开发 bug，告警 |
推荐状态机（Day 1 Evening / Day 4 Afternoon）：
async def invoke_with_recovery(tool_fn, args, *, max_retry=3):
for attempt in range(max_retry):
try:
return {"ok": True, "data": await tool_fn(**args)}
except TransientError as e:
await asyncio.sleep(2 ** attempt)
except ValidationError as e:
return {"ok": False, "code": "validation", "message": str(e)}
# Fallback 映射
alt = FALLBACK_MAP.get(tool_fn.__name__)
if alt:
return await invoke_with_recovery(alt, remap_args(args), max_retry=1)
return {"ok": False, "code": "exhausted"}
自我修正 Prompt 片段（Observation 回灌）：
工具 search_web 失败：HTTP 400，原因 query 超过 256 字符。
请缩短 query 或改用 read_file 读取用户已上传文档。不要重复相同参数。
反模式：无限 Retry；不向用户暴露最终失败原因；把 stack trace 直接 show 给用户。
子站验证：Code Sandbox 故意注入失败 API，观察 trace 中 Retry/Fallback 计数是否符合预期。
Q4：如何检测与打破 Agent 循环？
循环形态：(1) 同一 tool+args 重复；(2) A→B→A 振荡；(3) 「思考」无 tool 也不结束。
三层防护（见 最佳实践）：
max_iterations硬顶（12–20）- 状态哈希：最近 k 次调用 fingerprint 相同 → 熔断
- 无进展检测：连续 2 轮 observation 与上一轮相同 → 强制 summarizer 回复用户
熔断后 必须 输出人话解释 + 建议下一步，而非 silent stop。
角色与多 Agent
Q5：多 Agent 角色漂移怎么防？和「模型健忘」是一回事吗？
不完全是。健忘是 context 窗口物理限制；漂移是 Persona 约束被后续 token 稀释。
组合拳（Day 2 Morning）：
| 手段 | 机制 | 成本 |
|---|---|---|
| 角色提醒 | 每 5 轮注入 Identity+Constraints 摘要 | ~80 token/5轮 |
| 角色一致性检查器 | 小模型/规则打分 tone 是否偏离 | 额外 1 call |
| 记忆隔离 | 各角色 episodic 分库 | 存储 |
| Handoff 包 | 结构化传递，避免下游重问 | 设计成本 |
| 工具策略分角色 | DevOps 角色无 send_email | 最安全 |
在 Persona Lab 跑 20 轮同一话题，对比「无提醒 vs 有提醒」的 Constraints 违反次数。
Q6：多 Agent 何时该拆？何时一个 Agent + 多工具就够？
拆 Agent 的信号：
- System Prompt 超过 2k token 且多领域 Constraints 互相冲突
- 需要 不同工具 ACL（接待员不能 Git commit）
- 产品上要 不同人格品牌（客服 vs 技术专家）
- 并行 专家委员会 独立分析再综合
不拆的信号：
- 仅工具多，但角色一致 → 用 Tool Pack + 动态加载
- 线性 3 步链 → 单 Agent ReAct 更简单
- 团队无人维护 Handoff 协议 → 拆反而更乱
Day 2 心理咨询工作室是 必须拆 的教科书案例；Day 1 天气 Agent 是 必须不拆 的反例。
框架与生态
Q7：LangChain vs AutoGen vs 自研，怎么选？
| 维度 | LangChain | AutoGen | 自研 loop |
|---|---|---|---|
| Tool Binding | 成熟 | 成熟 | 完全自控 |
| 多 Agent 对话 | 需 LangGraph | 原生强 | 自建成本高 |
| 生态集成 | 最广 | 中等 | 自行对接 |
| 学习曲线 | 中 | 中高 | 低（若需求简单） |
| 可观测 | LangSmith 等 | 内置部分 | 自建 |
建议：
- 团队已 Python + 要快出 Demo → LangChain + 子站课表
- 研究型多 Agent 对话、人机混合 → AutoGen
- 生产极简、只要 OpenAI API → 自研 200 行 loop often 比框架更稳
Hermes 课程 不绑定 框架；Day 1 Afternoon 用 LangChain 教学是因为 bind_tools 最快建立心智模型。
Q8：如何接入 MCP（Model Context Protocol）？与手写 @tool 什么关系？
MCP 定位：把外部能力（文件系统、GitHub、DB）以 标准 Server 暴露，Agent 侧 Client 发现工具列表 → 转成统一 Schema。
接入步骤：
- 部署 MCP Server（或复用社区 server）
- Agent 启动时
list_tools()→ 注册到 Tool Registry - 调用时走 同一工具网关（认证、限流与手写工具一致）
- 与 @tool 并存：核心域工具手写，长尾能力 MCP
常见卡点：
- MCP tool 名与手写工具 重名 → 加前缀
mcp_github_* - MCP Server 无超时 → 拖死 Agent loop
- 把 MCP 返回 整段 塞进 context → token 爆炸，应摘要
子站实验：Code Sandbox 有 MCP 接入模板；Day 3 自定义工具可与 MCP 对比维护成本。
模型与工具设计
Q9：推荐哪些模型做 Hermes 风格 Agent？
没有「永远最佳」，只有 任务 × 部署 匹配：
| 场景 | 推荐 | 备注 |
|---|---|---|
| 本地隐私 | Hermes-2-Pro-Llama-3-8B/70B（Ollama） | 标签格式原生 |
| 中文工具描述 | Qwen2.5-72B-Instruct / Qwen2.5-Coder | function calling 稳 |
| 云端低延迟 | GPT-4o mini / Claude 3.5 Haiku | 成本可控 |
| 复杂规划 | GPT-4o / Claude 3.5 Sonnet | Plan-and-Execute |
| 多模态报销 | GPT-4o / Qwen-VL | Day 5 |
评估方式：固定 50 条 tool selection benchmark（子站可导出模板），测 选中率 + 参数合法率，勿只看 MMLU。
Q10：工具太多（>30）导致选型混乱怎么办？
症状：Inspector 里模型在 search/calc/read 间 oscillation；latency 上升。
解法优先级：
- 按角色/意图动态加载 子集（≤12 可见）
- Tool Pack 元工具：
devops_pack(action=...)内部分派 - 两阶段选型：小模型先选 category，再选具体 tool
- 合并重复描述工具
- RAG over tool descriptions（工具多时进阶）
Day 3 Morning 工具类型学 + 组合包是预防针；已爆炸用 最佳实践 工具层清单 T5/T6 治理。
Q11：中文工具描述是否比英文差？
不一定。Qwen、GLM、DeepSeek 对 中文 Active 描述 often 优于英文。关键是 结构化边界（何时用/何时不用），不是语言本身。
中文描述注意：
- 避免过长文言文修辞 → 浪费 token
- 参数
description与 enum 值 语言一致 - 混合中英工具名时统一
snake_case英文 name，description 可中文
在 A/B 中对比同工具中英描述，用 task_success_rate 说话（Day 7 Afternoon）。
安全、沙箱与合规
Q12：代码执行沙箱选 E2B、Docker 还是 gVisor？
| 方案 | 隔离强度 | 冷启动 | 成本 | 适用 |
|---|---|---|---|---|
| E2B 云沙箱 | 高 | 中 | 按秒 | Day 5 快速验证 |
| Docker 只读 | 中 | 低 | 自建 | 内网计算 |
| gVisor/Firecracker | 很高 | 中 | 运维高 | 生产 multi-tenant |
| 无沙箱 | ❌ | — | — | 禁止 |
清单：无 outbound 或域名白名 单；FS 只读 + tmp 配额；CPU/内存 limit；禁止 import os.system 类绕过（静态扫描 + seccomp）。
Q13：Prompt Injection 经工具参数怎么防？
见 最佳实践安全层。FAQ 补充：用户内容 never 进入 System；工具 observation 标记 untrusted；路径类参数 canonicalize；高风险工具 HITL。
红蓝演练用例应写入 CI：固定 injection payload 必须 403 或 sanitize。
成本、评估与生产
Q14：Agent 成本爆炸通常出在哪？如何设预算？
Top 5 成本黑洞：
- 多轮 tool loop 无上限
- 大 context 全历史 + 巨大 tool response 未摘要
- 大模型处理本可用小模型路由的简单意图
- 重复 search 无缓存
- 沙箱长时运行未 kill
预算策略：
per_session_budget_tokens = 80_000
per_user_daily_usd = 2.00
on_exceed → 降级小模型 + 禁止 research 类工具
Grafana 分解：llm_tokens / tool_api / sandbox_cpu（Day 7 Afternoon）。
Q15：有哪些可复用的 Agent 评估基准？
| 基准类型 | 测什么 | Hermes 课对应 |
|---|---|---|
| Tool selection set | 选对工具+参数 | Day 1/3 |
| Multi-turn persona | 漂移率 | Day 2 |
| Plan fidelity | 计划步骤覆盖 | Day 4 |
| Memory recall@k | 长期记忆 | Day 6 |
| Safety suite | 注入/越权 | Day 7 |
| End-to-end task | 业务成功率 | 每日 Evening |
不要只用 BLEU/ROUGE。Agent 评估要 可执行 success predicate（如「工单已创建且 ID 格式正确」）。
与子站配合：每 Day Evening 挑战的 验收标准 即 mini benchmark；毕业项目 Hermes Agent OS 是集成基准。
Q16：文档学习与 hermes.chenxiaoshivivid.top 子站实验如何配合？
推荐 双轨循环：
| 本站文档 | 子站模块 | 动作 |
|---|---|---|
| intro / getting-started | Day 1 | 跑通天气+文件 Agent |
| development | Day 2–3 | Persona + DevOps |
| best-practices | Day 4–7 | 对照 checklist |
| from-zero-to-one | #curriculum | 按 Morning/Afternoon/Evening |
| faq（本文） | 全局 | 卡点检索 |
一天最小闭环：Morning 读 doc 30min → Afternoon Sandbox 90min → Evening 验收 + Inspector 截图存档。
进阶与边界
Q17：Hermes Agent 与「AutoGPT/BabyAGI」类自主 Agent 有何不同？
Hermes 强调 工程化分层 + 可观测 + 权限，而非无限自主。AutoGPT 类适合探索；Hermes 路径适合 可上线、可审计、可计费 的产品。Day 4 自主研究 Agent 有 max_iterations + replan 边界，即刻意与「跑到天亮」划界。
Q18：能否只用 Prompt 不做工具，还称 Agent？
可以叫 Copilot 型助手，不是 Tool-Agent。若任务需要 实时数据、写系统、多步外部副作用，无工具则不是 Agent 工程讨论范畴。课表 Day 1 起默认 LLM-as-Tool-Caller 为核心。
Q19：OpenAI 新出的 parallel tool calls 要接吗？
要。同一轮多工具 可降 latency（如并行 search + read_file）。注意：网关需支持 partial failure；Inspector 里区分 sequential vs parallel span。
Q20：生产 incident：用户说 Agent 「删了库」怎么溯源？
查 工具网关审计：trace_id → tool_name=sql_write → args → approver_id。若无 HITL 记录，属 权限矩阵 bug，非模型「发狂」。Day 7 Morning 强调：Prompt 不能替代 ACL。
快速索引表
| 关键词 | 见 FAQ |
|---|---|
| Hermes vs OpenAI | Q1, Q2 |
| 失败/Retry | Q3, Q4 |
| 角色漂移 | Q5, Q6 |
| LangChain/AutoGen | Q7 |
| MCP | Q8 |
| 模型选型 | Q9 |
| 工具过多 | Q10 |
| 中文描述 | Q11 |
| 沙箱 | Q12 |
| 注入 | Q13 |
| 成本 | Q14 |
| 评估 | Q15 |
| 子站配合 | Q16 |
仍有卡点？带着 trace JSON 对照 开发指南 与 最佳实践，在 Hermes 子站 复现后再提 issue——可观测性优先于猜测。