从零理解如何构建 AI Agent

Appearance

agent-workshop ~ bash

AI Agent 实战手册 ​

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

开始学习实践环境准备

这里不是项目目录，而是整套 AI Agent 跟练课程的入口。第一次进入实践篇，推荐先在下面选一条路线；如果你还没准备好环境，再先看 实践环境准备。

30 秒选一条起步路线 ​

推荐起点P1

先跑通第一个 Agent

适合已经会调模型，但还没有完整 Agent 手感的人

先拿到一个真实可运行的闭环，再逐步补多轮、错误处理和推理链。

  • P1 跑通工具调用闭环
  • P4 给循环补上重试与失败收口
  • P10 把黑盒决策升级成可见推理链
你会顺路经过：P4P10
从 P1 开始 先看课程大纲
推荐起点P18

先补工程化能力

适合已经做过 Demo，开始关心成本、安全、可观测性的人

跳过“只是能跑”，优先补齐模型路由、安全边界和运行时观测。

  • P18 建立成本与路由判断
  • P19 补上安全与权限边界
  • P23 收口成可上线的生产清单
你会顺路经过：P19P20P23
从 P18 开始 先看课程大纲
推荐起点P22

先冲综合项目

适合目标很明确，想边做完整项目边回补前置的人

以 P22 为毕业设计目标，先确认最少前置，再回补多 Agent、推理和安全。

  • 先确认 P22 需要的最少前置
  • 补齐 P10、P15、P19 三个关键支点
  • 回到 P22 做完整 Code Review Agent
你会顺路经过：P10P15P19
从 P22 开始 先看课程大纲
当前位置

实践篇

你现在在全站的项目跟练入口。这里负责把OpenCode 拆解里抽象的 Agent 结构拆成可运行项目，并在完成基础闭环后把你送往中级专题。

推荐下一步

辅助入口

  • 回到发现中心如果你还没决定是先做项目还是先补理论，先回统一入口重新判断。
  • 查看学习路径按“先看源码 / 先做项目 / 先补工程判断”三条路线重新选起点。
  • 完成基础后去中级篇当你已经跑过基础项目并开始关心工程判断时，继续进入中级专题。
  • 回到阅读地图重新判断是否该先做项目，还是先回去补理论主链路。
Phase 14 个项目

Agent 基础

工具调用 / 多轮对话 / 流式输出 / 错误处理

先把最小 Agent 跑起来，建立对工具调用和基本对话循环的直觉。

Tool CallingMulti-turnStreamingError Handling
从该阶段推荐起点开始
P1入门45 min

最小 Agent

用最少代码跑通工具调用生命周期，拿到第一个真正可运行的 Agent 闭环。

P2入门30 min

多轮对话

把单次请求升级成可持续对话的会话骨架，并开始感受上下文预算约束。

P3入门30 min

流式输出

把“等全部生成完再显示”升级成边生成边展示，改善交互反馈和调试体验。

P4进阶45 min

错误处理与重试

让最小闭环开始具备工程韧性，知道失败时怎样重试、降级和收口。

Phase 25 个项目

记忆与知识

记忆系统 / 记忆增强检索 / RAG / GraphRAG

把短对话扩展成可长期积累、可检索、可引用知识的系统能力。

MemoryRAGGraphRAGHybrid Retrieval
从该阶段推荐起点开始
P5进阶45 min

记忆系统架构

从对话历史走向真正的短期、工作、长期记忆分层，建立记忆系统架构感。

P6进阶45 min

记忆增强检索

让记忆系统从“全量注入”走向“按需召回”，开始接近可扩展的真实实现。

P7进阶60 min

RAG 基础

从记忆系统进一步走向文档知识库，让 Agent 能基于外部知识回答问题。

P8高阶60 min

GraphRAG

在普通检索之外增加实体和关系视角，处理多跳推断类问题。

P9高阶60 min

混合检索

开始用组合检索和排序融合解决单一策略的盲区。

Phase 33 个项目

推理与规划

ReAct Loop / Planning / Reflection

把单步工具调用升级成显式推理、计划生成和自我反思闭环。

ReActPlanningReflection
从该阶段推荐起点开始
P10进阶60 min

ReAct Loop

把黑盒工具调用升级成可见、可调试、可复盘的显式推理循环。

P11高阶60 min

Planning

从单步循环走向任务分解与重规划，让 Agent 开始处理更长链路任务。

P12进阶45 min

Reflection

让 Agent 不只执行，还会评审自己的结果并根据反馈继续修正。

Phase 53 个项目

多 Agent 协作

编排模式 / 子 Agent / 通信协议

从单 Agent 迈向多角色协作、任务拆解和状态共享。

Multi-AgentSub-AgentCommunication
从该阶段推荐起点开始
P15高阶60 min

多 Agent 编排

从单 Agent 走向角色分工和并行执行，开始真正感受系统编排。

P16高阶60 min

子 Agent

把 worker 升级成真正有独立工具和循环的执行体，增强协作深度。

P17高阶60 min

Agent 通信与状态共享

聚焦多个 Agent 之间如何传递信息、共享状态和做 handoff。

Phase 64 个项目

生产化

模型路由 / 安全 / 可观测性 / 评估

把 Demo 打磨成真实系统需要的成本、安全、监控和评估能力。

RoutingSecurityObservabilityEvaluation
从该阶段推荐起点开始
P18进阶45 min

多模型路由

开始从“能跑”进入“跑得划算”，把模型选择和成本约束纳入系统设计。

P19高阶60 min

安全与防注入

把安全从附加项提升为设计约束，开始面对 Agent 在真实环境中的攻击面。

P20进阶45 min

可观测性与调试

让 Agent 从“会运行”变成“能被观察、能被诊断、能被追责”的系统。

P21进阶45 min

评估与基准测试

开始用成体系的方式判断 Agent 是否真的变好，而不是只凭感觉调系统。