《图解 Agent 系统》：用图和例子学 AI，把方法用到学习与工作中
一本免费中文图解教程，面向学生、老师、AI 工具使用者与感兴趣的读者。用图和具体任务讲清工具、上下文、记忆与执行，再按兴趣深入 Pi、Codex、Hermes 等项目的关键代码。
《图解 Agent 系统》是一本免费中文图解教程：跟着图和例子学习 AI 助手怎样完成任务，再把说清目标、选择资料和核对结果的方法用到自己的学习与工作中。
学生可以用它整理知识，老师可以借图组织讨论，AI 工具使用者可以尝试改进日常任务。对 AI 感兴趣、想探索新的能力方向的人，也可以先从一个小作品开始。先看图、读例子，愿意深入时再看代码。 阅读图文和随书入门材料不需要编程基础。
开始在线阅读 · 选择学习路线 · 浏览 PDF · 下载 Markdown 阅读包
这本书里有什么
同一项任务会用到模型、工具、资料和执行环境。书中把这些环节拆成图，用具体情境解释，再给想深入的读者提供项目源码入口。
| 主题 | 用图和例子讲清什么 |
|---|---|
| Agent 怎样完成任务 | 从读资料、决定下一步、调用工具，到拿到结果、检查回答；也介绍工作流与多 Agent 协作。 |
| 工具、MCP、Skill 与 Harness | 谁提供做事方法，谁连接能力，谁真正执行工具；常见词各自负责哪一段。 |
| 上下文与记忆 | 哪些资料进入这次回答，历史怎样压缩，保存的内容怎样找回来。 |
| 沙箱、权限与恢复 | 代码在哪运行、能访问哪些文件和网络；中断或超时后怎样继续。 |
| Browser Use 与 Computer Use | 助手怎样观察网页或桌面、操作界面，再读取操作后的结果。 |
| 真实项目与架构对照 | 沿 Pi、Codex、OpenCode、Hermes、Browser Use、LangGraph 等项目的一条关键路径，理解不同设计的取舍。 |
系统篇会注明研究的版本、关键代码和来源，讲的是对应版本中的具体路径。你可以先挑熟悉的工具读，也可以按全书目录由浅入深。系统索引列出了每篇的范围。
这张图配合上下文与记忆一章，解释“保存了什么”和“这次用到什么”之间的关系。点图可看原尺寸 SVG。
先选一件你想做的事
- 学生可以用一组资料整理学习卡片，写下自己的解释和待查问题。
- 老师可以把图和例子变成一次讨论，让读者区分原文事实与补充建议。
- AI 工具使用者可以形成一份短简报，说清目标、资料、结果和需要继续确认的事情。
- 想探索 AI 相关方向的人，可以留下一个小作品与修改过程，再选择需要继续学的能力；本书不承诺职位或收入。
这些入口共用学习与应用导读里的虚构资料，不要求账号、代码或额外付费。你可以先完成一张学习卡片或一页简报，再带着实际遇到的问题继续读。下面这个例子，是书中用来解释运行过程的一小段。
看一段书里的例子：查报名时间
假设你请一个资料助手：“看一下读书会材料，告诉我报名什么时候截止，并给出出处。”这是一个教学例子，不是产品运行记录。
模型先判断还缺资料，提出读取报名说明的工具调用。提出调用并不会自动读取文件：宿主运行器接到提案，检查参数和范围，执行工具，把实际结果放回下一轮输入。模型看到正文里的日期后，才能据此回答并指出来源。
把这条接力画出来，比把所有角色都叫作“Agent 插件”更容易理解。
图来自《图解 Agent 系统》，原创文字与图按 CC BY 4.0 提供。放大图并阅读完整说明。这是概念循环，不声称所有产品采用同一套实现。
想继续理解工具时，再区分这些角色
| 角色 | 在这个任务里做什么 |
|---|---|
| 模型 | 根据本轮实际收到的材料，提出下一步或生成回答。 |
| Harness（宿主运行器） | 组织循环、上下文、工具执行与结果；具体实现还可能管理取消、会话与许可策略。 |
| CLI | 让用户输入请求、看输出的命令行入口。 |
| MCP | 规定 Host/Client 与 Server 交换能力、调用和结果的方式；本次调用的许可由具体系统决定。 |
| Skill | 提供可以按需读取的做事方法和配套资源；工具执行与权限配置要看具体产品。 |
本地读文件工具也可以直接由宿主提供，MCP 是连接工具能力的一种方式。Skill 可以用于代码之外的任务：“先找到原文，再引用出处”就是一种工作方法。辨认这些角色时，沿着方法、能力连接、实际执行这条线看，往往更清楚。
接着读，可以看这三条路径
想弄清一项任务怎样继续，读Agent 运行循环，看工具结果怎样成为下一轮的输入。
想让助手用好资料，读上下文与记忆，了解保存、检索和选择本轮输入这几个步骤。
想让助手操作文件或网页，读Skill、MCP 与工具权限的接力，再看沙箱和Computer／Browser Use。先看一次正常任务怎样完成，再了解权限与故障处理。
我为什么整理这本图解书
我希望读者能跟着图看懂过程，再用例子试一试。图讲清关系，例子帮助你动手，源码供想深入的人核对实现。 读完之后，换一组自己的材料做张学习卡片或一页简报，看看这些方法能否用得上。
你可以只沿图与解释读；也可以从 Pi、Codex、Hermes 等项目的指定版本代码深入。项目篇围绕具体机制比较做法，例如怎样执行工具、保存经验或继续长任务。
读的时候也可以请 AI 帮你拆开一句话，听你复述，再换个例子追问。先把相关材料给它，要求指出原文位置；它的流畅解释不替代源码，也不证明你已学会。阅读指南有可直接尝试的方法。
书稿目前是持续校稿的免费中文公开预览版。各篇会列出研究范围和未验证部分；图文清晰度与内容准确性会继续根据具体反馈改善。
从这里开始
- 把所学用起来：用三份虚构资料尝试学习卡片、讨论活动或工作简报。
- 选择阅读路线：从图文入门、应用练习或项目机制中选一条适合自己的路线。
- 先读一张行动闭环图：适合第一次接触 Agent。
- 浏览全书目录：按问题、机制或项目进入。
- PDF、Markdown 与 Obsidian 阅读说明：按自己的习惯离线读。
- GitHub 原文与可编辑图源：核对来源或参与修正。
如果某条箭头、某个例子或一段代码解释突然看不懂，欢迎通过阅读反馈指出具体位置，也欢迎分享你怎样把书中的方法用到了自己的任务里。作者邮箱：ghr7719@gmail.com。
本文图稿来自《图解 Agent 系统》。本书原创文字与图采用 CC BY 4.0，构建脚本采用 MIT；上游项目、商标和第三方素材遵守各自许可。
讨论
继续讨论这篇笔记
有问题、补充案例或不同观点，可以通过 GitHub Discussions 继续交流。