Tutorial: hermes-agent¶

hermes-agent 是一个多后端、可插拔的 AI 编码 Agent 框架。它把和大模型对话的"传输层"、跑命令的"执行环境"、搜索/抓网页/生图等"云能力"全部抽象成统一接口，再用声明式档案和插件注册表把具体厂商（Anthropic、OpenAI、Bedrock、Brave、Browserbase 等）挂载进来。

围绕主循环还配套了一整套护栏与治理机制：上下文引擎管 token 预算和压缩、记忆提供方管跨会话长期记忆、工具产物预算系统防止超大输出撑爆窗口、LSP 服务实时反馈代码诊断、速率限制治理跨会话同步避让 429、安全护栏拦截危险写入和 SSRF。整体设计让用户换厂商、换沙箱、换搜索引擎只改一行配置，主代码不动。

Source Repository: None

flowchart TD
    A0["Provider 传输层（Provider Transports）
"]
    A1["Provider 档案（Provider Profiles）
"]
    A2["上下文引擎（Context Engine）
"]
    A3["记忆提供方（Memory Provider）
"]
    A4["执行环境（Execution Environments）
"]
    A5["工具产物预算系统（Tool Result Budget）
"]
    A6["LSP 集成服务（LSP Service）
"]
    A7["云服务可插拔后端（Cloud Service Providers）
"]
    A8["速率限制与重试治理（Rate Limit Tracker & Guard）
"]
    A9["安全与同意护栏（Safety & Consent Guardrails）
"]
    A0 -- "读取配置驱动" --> A1
    A1 -- "声明 api_mode" --> A0
    A2 -- "消费 token 使用量" --> A0
    A3 -- "压缩前抽取记忆" --> A2
    A5 -- "写入沙箱临时文件" --> A4
    A6 -- "在工作区运行诊断" --> A4
    A7 -- "调用前校验 URL" --> A9
    A8 -- "解析响应头限流" --> A0
    A9 -- "拦截危险命令" --> A4
    A9 -- "阻断 SSRF 请求" --> A7
    A3 -- "受预算约束" --> A5
    A2 -- "感知配额状态" --> A8
    A6 -- "诊断输出截断" --> A5

Chapters¶

1. Provider 档案（Provider Profiles）
2. Provider 传输层（Provider Transports）
3. 上下文引擎（Context Engine）
4. 记忆提供方（Memory Provider）
5. 工具产物预算系统（Tool Result Budget）
6. 执行环境（Execution Environments）
7. LSP 集成服务（LSP Service）
8. 云服务可插拔后端（Cloud Service Providers）
9. 安全与同意护栏（Safety & Consent Guardrails）
10. 速率限制与重试治理（Rate Limit Tracker & Guard）

Generated by AI Codebase Knowledge Builder