图解 Agent 系统

一本免费中文图解教程。跟着图和例子学习 Agent 怎样做事，再把这些方法用到学习和工作中。

在线阅读 · 学习与应用 · 选择阅读路线 · 按书序阅读 · PDF 电子校样

你可以先看一个资料助手怎样读完几份材料、写出带出处的回答，再了解它怎样调用工具、选择输入、保存记忆和检查结果。书中也有代码修改、网页操作等例子。第一次接触 Agent，用纸笔就能跟着理解；想读代码，再看 Pi、Codex 等项目的实现。

学生可以用随书材料整理学习卡片，老师可以据此组织讨论，AI 工具使用者可以练习说清任务、选择资料和核对回答。想探索 AI 相关工作，也可以先尝试资料研究、教学表达或编程中的一个小任务，看看自己愿意继续学哪一部分。

这是持续更新的公开预览稿。系统篇介绍指定版本中的一条实现路径，章末列出来源和研究范围。

翻几张图，看看书里怎么讲

每张图讲清一件事，正文用具体例子说明步骤，代码导读供愿意深入的读者选看。点缩略图可打开原尺寸 SVG；每组图都有可编辑 .excalidraw 和文字说明。

从目标到一份有出处的回答	一项任务中，谁负责什么
读 Agent loop	读一项任务里的分工
资料怎样进入这次回答	超时后，先查询原操作
读上下文与记忆	读审批、恢复与回执丢失实验
给代码安排合适的执行环境	Hermes 怎样保存和使用记忆
读沙箱与生命周期	读 Hermes 的知识维护路径

想看小字时，点图打开原尺寸 SVG。更多图和文字说明见图稿索引。

你可以怎样读

• 学生、老师与第一次接触 AI 的读者： 从学习与应用导读的三份虚构资料开始，看一份带出处的回答怎样形成，再读 Agent 循环。学生可以整理知识与问题，老师可以把同一例子改成讨论活动；不用先学习代码。
• 已经在用 AI，希望用得更好： 用学习与应用中的任务卡，练习说清目标、选择资料、区分事实与建议、核对结果。卡住时可选用AI 陪读，再读上下文与记忆。
• 想探索 AI 相关方向： 先选一个小任务，例如整理资料或解释一个概念，试着做一页简报或一张图。沿阅读路线继续学其中用到的方法。
• 想读懂一个项目： 从 Pi 的运行核心与外壳或Codex 的命令审批与执行开始。系统篇给出上游仓库、固定 commit、关键源码位置、正常/失败路径与未验证范围，不要求把整个仓库从头读完。
• 正在设计自己的系统： 按问题查机制、跨系统对照和术语表。可以先从工具权限、上下文预算或任务恢复中选一项，再比较不同项目怎样处理。

读到不熟悉的地方，可以选用AI 陪读：把当前段落或图交给常用助手，指出卡在哪里，请它解释。再回到书中核对，并试着用另一个例子说明同样的过程。

内容地图

章节类型	你会得到什么	从这里试看
学习与应用	用一组随书资料尝试回答、教学活动或工作简报，形成自己的任务卡与修改记录	把所学用起来 · 阅读路线 · AI 陪读
机制图解	一条任务怎样经过模型、工具、上下文、记忆、权限和恢复；图旁写明例子与反例	Agent loop · MCP、Skill 与工具 · 观察与评测
开源项目讲解	一个版本里的具体步骤，以及连接这些步骤的关键代码	Pi · OpenCode · LangGraph
横向对照	围绕同一个问题，比较不同做法和取舍	循环与停止 · 四种状态 · 权限与恢复
可选小实验	用随书脚本观察读取、输入选择、结果查询和错误处理	第一轮 Agent · 上下文预算 · 远端结果查询 · 本地 HTTP 回执

系统案例覆盖 Pi、DSH（DeepSeek Harness）、Codex、OpenCode、mini-SWE-agent、OpenHands、Browser Use、Qwen Code、Kimi Code、MiMo Code、Letta Code、Hermes Agent、Mem0、LangGraph、OpenClaw 与 GPT Researcher。它们包括编码助手、运行框架和记忆组件。每个项目选一条具体路径来讲，例如工具怎样执行、经验怎样保存、长任务怎样继续。逐篇范围见系统索引，后续选题见选题地图与扩写计划。

也介绍沙箱，说明怎样安排代码运行的文件、网络和资源；Computer／Browser Use用填表任务讲清观察页面、执行操作和读取结果。想进一步观察检查过程，可以选择资料与工具权限小实验。

选择顺手的阅读方式

入口	适合什么场景
在线阅读站	手机阅读、章节导航、搜索和反馈；公开站按人工发布批次更新。
GitHub 书序目录	直接看唯一的 Markdown 源稿、代码链接、图源和修订历史。
可携带 Markdown 阅读包	固定版本 ZIP，导入 Obsidian 或普通 Markdown 阅读器；相对链接、图与可选练习的代码随包保留。自行构建。
PDF 电子校样	固定页序浏览、批注和下载；它不是印刷母版，更新不由每周 Action 自动覆盖。

正文只维护一份。book/manifest.txt 决定 GitHub 目录、网站、PDF 和阅读包的书序；导出物不是第二份稿件。线上站与本地仓库可能处于不同发布批次，精确篇数、页数和验收缺口以当前状态为准。

证据、图源与参与

系统篇注明结论来自源码、官方文档、运行记录还是推断，未核对的部分也会列出；上游版本记录在来源台账。图的 .excalidraw、SVG、PNG 与文字说明成组维护，具体规则见图稿规范。书稿如何校对、哪些检查已经完成，可查看写作与校稿方法和出版验收单。

哪句话没读懂、哪张图不好看，或发现内容和源码对不上，都欢迎告诉我们。附上章节链接，说明具体位置即可：网站反馈入口 · 贡献指南。作者联系邮箱：ghr7719@gmail.com。

如果愿意帮我们检验“图和例子是否真的讲明白”，可以任选一篇做简短试读：看完换一个情况，用自己的话解释即可，不需要运行代码。

本书原创文字与图使用 CC BY 4.0，构建脚本使用 MIT；上游项目、商标和第三方素材遵守各自许可。本仓公开的是持续完善的预览稿，不表示完整源码审计、外部读者验收或正式出版已经完成。封面与书脊设计参考也不等同于印厂可直接使用的文件。