从零构建 AI Coding Agent

Appearance

agent-workshop ~ bash

AI Agent 实战手册 ​

23 个项目 · 可跟打实现 · OpenAI SDK + TypeScript

开始前先看在线运行说明从 P1 开始课程大纲章节总表运行索引← 返回理论篇

第一次进入实践篇，建议先看 实践环境准备。如果你想先在浏览器侧填写 API Key / baseURL / model 试跑，再决定要不要搭本地环境，可以直接跳到 在线运行模式。当前实践篇已经覆盖 P1-P23 的仓库内示例文件，可直接按章节命令运行。

实践篇解决什么问题 ​

核心定位

实践篇不是把理论篇再讲一遍，而是把“看懂 OpenCode 怎样实现”切换成“如果你自己来做，一个最小可运行 Agent 应该怎么逐步搭出来”。

  • 刚读完理论篇 1-4 章：最适合从 P1-P4 开始，把工具调用、多轮对话、流式输出和错误处理亲手跑通。
  • 理解了抽象概念：如果你已经在理论篇里理解了会话、模型、工具和服务边界，实践篇就是把这些抽象概念改写成可执行 TypeScript 示例。
  • 准备进阶中级篇：实践篇里 P7-P9、P15-P17、P18-P21 会分别对应 RAG、多智能体协作和生产化专题。

课程阶段 ​

Phase 1
Agent 基础
工具调用 / 多轮对话 / 流式输出 / 错误处理
Phase 2
记忆与知识
记忆系统 / 记忆增强检索 / RAG / GraphRAG
Phase 3
推理与规划
ReAct Loop / Planning / Reflection
Phase 4
感知扩展
多模态智能体 / MCP 协议接入
Phase 5
多 Agent 协作
编排模式 / 子 Agent / 通信协议
Phase 6
生产化
模型路由 / 安全 / 可观测性 / 评估
Phase 7
综合实战
Code Review Agent 完整项目 / 部署清单

技术覆盖 ​

OpenAI SDKTool CallingStreamingMulti-turnMemory SystemRAGGraphRAGHybrid RetrievalReActPlanningReflectionMultimodalMCPMulti-AgentCost ControlSecurityObservabilityEvaluationProduction Deploy

运行索引 ​

如果你已经完成环境准备，可以直接从这里复制命令进入任意章节：

如果你当前走的是在线运行模式，建议先从 P1-P4、P10、P18 这类轻量章节开始；像 P14 这样的双进程章节，仍然优先使用本地运行模式。

先看依赖分组 ​

按当前仓库里的真实示例脚本，第三方依赖可以先这样理解：

依赖组章节范围需要安装
通用基础组P1-P23openai
MCP 扩展组P14@modelcontextprotocol/sdk

补充说明

  • 除 P14 外，其余章节当前都只依赖 openai 和 Node 内置模块。
  • P23 的健康检查示例使用的是 node:http，不需要额外安装 Web 框架。

章节状态总表 ​

如果你还在决定“先学哪章 / 这章会不会跳太快 / 需不需要额外装包”，可以先看这张表：

章节主题难度前置章节额外依赖入口脚本
P1最小 Agentbeginner无无p01-minimal-agent.ts
P2多轮对话beginnerP1无p02-multi-turn.ts
P3流式输出beginnerP1无p03-streaming.ts
P4错误处理与重试intermediateP1 P2无p04-error-handling.ts
P5记忆系统架构intermediateP1 P2无p05-memory-arch.ts
P6记忆增强检索intermediateP1 P5无p06-memory-retrieval.ts
P7RAG 基础intermediateP1 P5无p07-rag-basics.ts
P8GraphRAGadvancedP7无p08-graphrag.ts
P9混合检索advancedP7 P8无p09-hybrid-retrieval.ts
P10ReAct LoopintermediateP1 P4无p10-react-loop.ts
P11PlanningadvancedP10无p11-planning.ts
P12ReflectionintermediateP10无p12-reflection.ts
P13多模态intermediateP1无p13-multimodal.ts
P14MCP 协议接入advancedP1 P4@modelcontextprotocol/sdkp14-mcp.ts
P15多 Agent 编排advancedP1 P11无p15-multi-agent.ts
P16子 Agent 与任务分解advancedP1 P15无p16-subagent.ts
P17Agent 通信与状态共享advancedP15 P16无p17-agent-comm.ts
P18多模型路由与成本控制intermediateP1无p18-model-routing.ts
P19Agent 安全与防注入advancedP1 P4无p19-security.ts
P20可观测性与调试intermediateP1无p20-observability.ts
P21评估与基准测试intermediateP1 P12无p21-evaluation.ts
P22完整项目实战advancedP1 P10 P15 P19无p22-project.ts
P23生产部署清单intermediateP18 P19 P20无p23-production.ts

快速建议

  • 如果你是第一次动手，优先按 P1 -> P4 -> P10 -> P18 走一遍，再回头扩展记忆、MCP、多 Agent。
  • 如果你只想看综合项目，至少先跑通 P1、P10、P15、P19，再进 P22。
  • 如果你当前只是想体验生产化包装，P18、P19、P20 跑完后直接进 P23 会更顺。

阶段 1：Agent 基础
章节页面运行命令
P1最小 Agentbun run p01-minimal-agent.ts
P2多轮对话bun run p02-multi-turn.ts
P3流式输出bun run p03-streaming.ts
P4错误处理bun run p04-error-handling.ts
阶段 2：记忆与知识
章节页面运行命令
P5记忆架构bun run p05-memory-arch.ts
P6记忆检索bun run p06-memory-retrieval.ts
P7RAG 基础bun run p07-rag-basics.ts
P8GraphRAGbun run p08-graphrag.ts
P9混合检索bun run p09-hybrid-retrieval.ts
阶段 3：推理与规划
章节页面运行命令
P10ReAct Loopbun run p10-react-loop.ts
P11Planningbun run p11-planning.ts
P12Reflectionbun run p12-reflection.ts
阶段 4：感知扩展
章节页面运行命令
P13多模态bun run p13-multimodal.ts
P14MCP 协议接入bun run p14-mcp.ts
阶段 5：多 Agent 协作
章节页面运行命令
P15多 Agent 编排bun run p15-multi-agent.ts
P16Sub-Agentbun run p16-subagent.ts
P17Agent 通信bun run p17-agent-comm.ts
阶段 6：生产化
章节页面运行命令
P18模型路由bun run p18-model-routing.ts
P19安全防护bun run p19-security.ts
P20可观测性bun run p20-observability.ts
P21评估体系bun run p21-evaluation.ts
阶段 7：综合实战
章节页面运行命令
P22Code Review Agentbun run p22-project.ts
P23生产部署清单bun run p23-production.ts

补充说明

  • 全书统一使用 bun run pxx-*.ts 作为标准命令格式。
  • P14 章节除了 p14-mcp.ts 外，还需要 practice/p14-mcp-server.ts 配合运行，建议分两个终端分别执行：
    • bun run p14-mcp-server.ts
    • bun run p14-mcp.ts
  • 运行前仍建议先看 实践环境准备，重点确认依赖，以及 API Key / baseURL / model 是否已经准备好。