Agent Systems Handbook
一份面向生产的 AI Agent 系统手册，讲清工作流、记忆、上下文工程、MCP/A2A、评估与多智能体架构。
- Star 数
- ★ 314
- 最近更新
- 19 天前
- License
- NOASSERTION
- 主语言
- MDX
- FA 评分
- 51/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 准备转做 AI 应用开发的学生或新人，想先建立 Agent 系统的整体心智模型再动手写代码，可走 Explorer 路径。
- 不适合
- 想要开箱即用的现成 Agent 产品的团队
- 需要按 API 直接调用或集成到代码库的开发者
- 只接受有正式 OSI 许可证条款的法务或采购团队
- 源码审查
- 51/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Agent Systems Handbook 由 Prompthon Agentic Labs 维护，是一份关于生产级 AI Agent 的开源学习资料库，而非可执行的 Agent 程序。内容覆盖 Agent 基础概念、agentic workflow（规划、反思、工具调用、函数调用）、Agent 记忆与 agentic RAG、MCP 与 A2A 协议互操作、LangGraph 及各类 Agent 框架与低代码平台，以及多智能体编排、评估、可观测性、可靠性与安全。仓库按 Explorer、Practitioner、Builder、Contributor 四条并行阅读路径组织，分别对应广泛了解、日常应用、动手构建与参与贡献四类读者，并不要求按顺序阅读。正文分布在 foundations、patterns、systems、ecosystem、case-studies 等目录下，另有 radar 趋势笔记、skills 技能包、contributor-kit 参考资料与 publications 对外发布内容。仓库同时提供线上站点 labs.prompthon.io 作为主要阅读入口。
该仓库本身不运行 Agent，也不提供可调用的 API；它把构建生产级 Agent 所需的知识组织成可导航的文档站点。具体产出包括：foundations/、patterns/、systems/、ecosystem/、case-studies/ 下的 lab 文章；radar/ 下的趋势笔记；各 lane 的 examples/ 源码示例；skills/ 下的实践者技能包（含 skills/index.mdx 索引）；contributor-kit/reference-notes/ 下的精选参考笔记；以及在页面成熟后通过 publications/ 对外发布的扩展文章。阅读入口按意图分流：reading-paths/explorer.mdx、practitioner.mdx、builder.mdx、contributor.mdx 四份指南分别给出各自的推荐阅读顺序与产出预期。贡献流程由 CONTRIBUTING.md 与 contributor-kit/index.mdx 定义，规定了模板、评审标准与内容归位规则。README 还声明内容采用 AI 辅助起草、综合、迭代与人工审阅相结合的 AI-native 工作流产出。
- 准备转做 AI 应用开发的学生或新人，想先建立 Agent 系统的整体心智模型再动手写代码，可走 Explorer 路径。
- 日常已经在用 AI 工具提效的知识工作者，想学会挑选工作流、把 Agent 用在真实任务上，可走 Practitioner 路径。
- 正在选型 Agent 框架的工程师，需要横向对比 LangGraph、托管式构建器与低代码平台的取舍。
- 负责把 Agent 上线到生产的团队，需要参考评估、可观测性、可靠性与安全方面的做法。
- 想借开源贡献积累作品集的开发者，可按 Contributor 指南提交文章、radar 笔记或示例项目。
如何安装或部署这个 Agent？
本仓库是文档型资料库，不以软件包形式安装。唯一明确的官方入口是线上站点：
https://labs.prompthon.io/若要在本地阅读仓库内的 MDX 源文件（如 reading-paths/*.mdx、CONTRIBUTING.md、contributor-kit/），需要自行克隆仓库：
git clone https://github.com/Prompthon-IO/agent-systems-handbook.git注意：源材料未说明本地如何构建或预览该站点（未给出 Node 版本、包管理器、构建命令或开发服务器命令），这部分信息缺失，需到仓库内自行确认。
如何使用这个 Agent？
推荐直接从线上站点按阅读路径开始：打开 labs.prompthon.io，按目标选择 Explorer、Practitioner、Builder 或 Contributor 之一，跟随对应指南的推荐顺序阅读。
如果你已经克隆了仓库，可直接打开对应的 MDX 文件：
reading-paths/explorer.mdx
reading-paths/practitioner.mdx
reading-paths/builder.mdx
reading-paths/contributor.mdx打算贡献内容时，先读 CONTRIBUTING.md 与 contributor-kit/index.mdx，再按内容类型放到对应目录（foundations/、patterns/、systems/、ecosystem/、case-studies/、radar/、skills/、contributor-kit/reference-notes/ 或 publications/）。遇到问题可通过仓库 Issues 反馈，或加入 README 中列出的 Discord 社区。
这个 Agent 有哪些优点和局限？
- 按意图划分四条并行阅读路径（Explorer / Practitioner / Builder / Contributor），不同背景的读者不必读完全部内容即可拿到适合自己的路线。
- 覆盖面从 Agent 基础概念一直延伸到 MCP、A2A 协议互操作、LangGraph、多智能体编排、评估与可观测性，适合作为团队内部统一术语的参考。
- 提供 radar/ 趋势笔记，专门跟踪 Gemini Interactions API、托管式 Agent、新兴 Agent 运行时等变动较快的话题。
- 有明确的公开贡献流程：CONTRIBUTING.md 与 contributor-kit 定义了模板、评审标准与内容归位规则，外部贡献者有据可依。
- 以线上站点 labs.prompthon.io 为主要阅读形态，无需本地构建即可开始阅读。
- 仓库是文档资料库，不包含可直接运行的 Agent 实现，无法作为依赖库或服务集成进项目。
- 许可证标记为 NOASSERTION，GitHub 未能识别出标准许可证，企业采用前需自行核实使用条款。
- 本地如何构建或预览站点未在源材料中说明，缺少 Node 版本、包管理器与构建命令等信息。
- README 自述内容由 AI 辅助起草与迭代，需要读者自行核对具体技术细节的时效性。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Agent Systems Handbook 当前 | 51 · 缺口较多 | 网页应用免费 | ★ 314 | 19 天前 | MDX | — |
| Hello-Agents 智能体教程 | 54 · 缺口较多 | 网页应用免费 + 模型费 | ★ 86k | 22 天前 | Python | OpenAI API |
| AI Agent 工程学习手册 | 55 · 缺口较多 | 开发框架免费 | ★ 651 | 12 天前 | HTML | — |
| AI Agents 权威指南（配套代码库） | 45 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 2.9k | 3 个月前 | Jupyter Notebook | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
仓库是手册与示例集合，非可执行 Agent 产品。示例代码（如 CRM 技能）体现了审批哈希、高影响操作二次确认、dry-run 与审计日志，属于局部亮点；但工作流使用 secrets 与数据库 URL、Discord 公告脚本涉及外部副作用，缺少回滚说明；依赖仅以 npm install pg@8 与 openpyxl 等隐式引入，无锁定或安全审计；来源归属仅靠 README 品牌声明，无逐条引用。整体信任面偏薄，故多为 1，仅用户确认因示例测试明确验证高影响审批而给 2。
示例测试覆盖了错误码（FORMULA_INPUT、HIGH_IMPACT_APPROVAL_REQUIRED、DUPLICATE_CONTACT 等），失败信息具体，故 failure_messages 给 2；测试与文档描述基本自洽，self_consistency 给 2；但依赖可用性无锁定文件、无安装验证，仅隐式依赖，给 1。
README 明确划分 Explorer/Practitioner/Builder/Contributor 四类受众与场景，audience_and_scenarios 给 3；能力边界有概述但未逐项界定，给 2；触发精度（何时适用何种路径）描述较泛，给 1；环境适配提到多框架但无具体环境矩阵，给 2。
信息架构清晰（foundations/patterns/systems 等目录），给 2；安装说明缺失，仅示例内隐式依赖，给 1；命名稳定性无版本化约定，给 1；示例与 FAQ 有部分，给 2；已知局限几乎未声明，给 1；LICENSE 为 CC BY-NC-SA 4.0 全文，但元数据标 NOASSERTION，存在不一致，给 2；无 changelog/版本，给 0；维护责任仅 SECURITY.md 提及 best-effort，给 1。
手册对理解 Agent 系统有实用价值，output_usability 给 2；相对通用资料有边际价值但非独有，给 2；成本收益合理（阅读型资源），给 2。
声明多为叙述性，缺少逐条来源引用，claim_traceability 给 1；跨源佐证有限，给 1；事实与推断分离不明显，给 1。
- 该仓库是手册与示例集合，并非可直接部署的 Agent 产品；不要将其示例代码视为生产就绪。
- 工作流使用 secrets 与数据库连接，Discord 公告脚本有外部副作用，缺少回滚与失败恢复说明。
- LICENSE 文件为 CC BY-NC-SA 4.0，但元数据标为 NOASSERTION，商用前需自行核实许可。
- 依赖（pg、openpyxl 等）无锁定与安全审计，示例运行前应自行固定版本。
- 发布者身份未经 FollowAgents 验证，来源归属与维护责任仅凭 README 声明。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
<!-- Release notes generated using configuration in .github/release.yml at ee2f528ba5abd6852446561f9d14831851bea91c --> What's Changed Other Changes * [generalkim00] Add local Remotion promotion video skill by @generalkim00 in https://github.com/Prompthon-IO/agent-systems-handbook/pull/240 * [generalkim00] Add local Remotion promotion video skill (#240) by @dprat0821 in https://github.com/Prompthon-IO/agent-systems-handbook/pull/241 New Contributors * @generalkim00 made their first contribution in https://github.com/Prompthon-IO/agent-systems-handbook/pull/240 …在 GitHub 查看 ↗ -
发布说明摘录
<!-- Release notes generated using configuration in .github/release.yml at 4759cd0cb4edc578741cd6be75d83e2c6831e260 --> What's Changed Other Changes * foundations/when-not-to-use-agents.mdx by @onlywmo in https://github.com/Prompthon-IO/agent-systems-handbook/pull/216 * foundations/when-not-to-use-agents.mdx (#216) by @dprat0821 in https://github.com/Prompthon-IO/agent-systems-handbook/pull/238 New Contributors * @onlywmo made their first contribution in https://github.com/Prompthon-IO/agent-systems-handbook/pull/216 …在 GitHub 查看 ↗ -
发布说明摘录
<!-- Release notes generated using configuration in .github/release.yml at 40cef6d75d419ad86fb95c4c90132cb2b60ff9d5 --> What's Changed Other Changes * feat(ci): classify PRs from explicit contributor choices by @dprat0821 in https://github.com/Prompthon-IO/agent-systems-handbook/pull/235 * feat(skills): add knowledge capture learning examples by @Dongmei6661 in https://github.com/Prompthon-IO/agent-systems-handbook/pull/234 * Allow docs.json changes for all contributor tracks by @dprat0821 in https://github.com/Prompthon-IO/agent-systems-handbook/pull/236 …在 GitHub 查看 ↗