阿源的知识库

切换日光/暗黑模式

Agent 开发 ​

这是一套按认知依赖组织的 Agent 工程课程，共 11 章、89 篇正文与导航。基础正文和示例以 Python 为主，不重复 Java、Python 或 TypeScript 通用语言基础；先理解协议、状态和可靠性，再阅读框架源码。第一章是可随时查阅的资源导航，第 02 章开始按顺序连续学习。

路线会覆盖 MCP、Agent Skills、RAG、Evals，以及作为对照资料的 LangChain / LangGraph；这些关键词在后续章节按依赖关系拆开，不代表要先学习某个框架。

课程路线 ​

顺序章节学习目标前置关系
01项目与知识库导航（7 篇）按问题、阶段和深度选择官方项目、文档、课程与论文Python 基础；可选入口
02Agent 基础（8 篇）从 Agent、系统组成到可停止的 Loop，建立 Model、Instructions、Tools、State、Context 和停止边界Python 基础
03模型与消息（9 篇）从 Provider/Adapter、消息和内容块到 Token、生成参数、结构化输出、流式与可靠性02 按顺序
04Tool Calling 与 Agent Loop（9 篇）从 Function Calling 与 schema 推进到选择、校验、执行、回填、并行、重试、幂等、审批与可观测 Loop02–03
05State、Context、Session 与 Memory（9 篇）区分状态所有权、会话、检查点、压缩、短期/长期记忆和隔离02–04
06MCP（12 篇）按 MCP 2026-07-28 理解 JSON-RPC、无协议 Session、每请求元数据、发现、能力、传输、扩展和授权02–05、JSON-RPC
07Skills、Plugin 与 Hook（9 篇）区分工作方法、动作接口、协议和插件生命周期、依赖注入、Hook 与安全隔离02–06
08RAG 与 Context Engineering（7 篇）实现摄取、切块、检索、重排、引用和分层评测02–07
09Workflow、Planning 与 Multi-Agent（6 篇）先做单 Agent 状态机，再判断是否需要多 Agent02–08
10Evals、Tracing、Guardrails 与安全（7 篇）连接轨迹、回归评测、权限、注入防护和 Sandbox02–09
11源码精读（6 篇）对照五个项目的 Loop、State、扩展与可靠性设计02–10、Git 阅读能力

依赖关系 ​

01 资源导航（可选入口）
        ↓
02 Agent 基础 → 03 模型与消息 → 04 Tool Calling
                                      ↓
                   05 State/Context/Session/Memory → 06 MCP
                                      ↓                         ↓
                         07 Skills/Plugin/Hook → 08 RAG
                                                        ↓
                                  09 Workflow/Multi-Agent → 10 Evals/安全
                                                                  ↓
                                                           11 源码精读

每篇文章都在开头标注前置知识、目标和边界；可本地运行的示例明确给出输入、状态变化和输出契约，不把模型生成的候选动作冒充成已经发生的副作用。

五个源码主线 ​

五个项目固定按以下顺序精读，DeepSeek Harness 排在最后。项目名称、官方链接和独立源码导读在第一章导航中保持一致。

  1. smolagents：最小 Agent Loop、Tool、Code Agent、停止与执行。
  2. OpenAI Agents SDK：Agent、Runner、Handoff、Guardrail、Session 与 Tracing。
  3. MCP TypeScript SDK：Client、Server、Transport、Capability 和协议错误。
  4. LangGraph：State、Node、Edge、Checkpoint、Interrupt 与 Durable Execution。
  5. DeepSeek Harness：Agent Driver、Plugin、Session、Skill、Hook、事件系统和 Cordis。

如何使用 ​

  • 想快速查一个边界：从侧栏进入对应章节，按 H3 标题定位；第一章外部资源注明推荐目录和阅读深度。
  • 想连续学习：从第 02 章第一篇开始按上一篇/下一篇顺序阅读，不跳过前置文章。
  • 想读源码：完成第 02–10 章后按五个项目的顺序进入第 11 章；TypeScript 只在 MCP SDK 和 DeepSeek Harness 导读中为理解当前抽象保留必要片段。
  • 涉及真实模型、密钥、文件、Shell、浏览器或网络时，先阅读权限边界和失败提示；可本地演示的状态机、检索、解析、校验与评测优先不依赖外部服务。