跳到主要内容

第 1.5 章 第一个 Agent：跑通 Mock-first 的最小闭环

课程元数据​

项目内容
学习时间55-85 分钟
难度入门到初级工程
适合人群准备从 AI 应用使用者转为 AI Agent 工程实践者的读者。
最终交付物一个 Mock-first 的最小 Agent 演示脚本，以及一张经典 Agent 范式选择表。
前置条件能使用浏览器、命令行和 Codex/Trae 等编程代理；不要求系统学过后端开发。

本模块解决什么​

本章解决的是：跑通 Mock-first 的最小闭环。重点不是背术语，而是把概念转成能实现、能检查、能展示的工程材料。

first-agent模块从输入契约推进到验收结果的整体工程工作台
模块总览：本模块沿“输入契约 → Agent 执行 → 状态与日志 → 验收结果”展开，先理解业务主线，再进入逐页实现。

阅读时先用第 1.5.1 节「先跑通最小可用 Agent 切片」确认起点；中间小节补齐字段契约、验收样例；到第 1.5.5 节「把第一个 Agent 整理成演示脚本和面试讲法」时，把前面的材料收束成可展示内容。

学完后，你应该能说清「第一个 Agent」在 Agent 项目中的作用，知道最容易出错的边界，并留下能放进作品集的表格、流程图或演示材料。

模块路线​

小节学习结果
第 1.5.1 节：先跑通最小可用 Agent 切片能说清最小可用 Agent 切片的处理顺序、关键检查点和失败处理。
第 1.5.2 节：把 Agent 的输入、输出和状态写成契约能把 Agent 的输入、输出和状态落成字段表、校验规则、错误处理和验收样例。
第 1.5.3 节：把 Prompt、能力清单和 Mock/真实双模式串起来能说清 Prompt、能力清单与双模式的处理顺序、关键检查点和失败处理。
第 1.5.4 节：用状态、日志和停止条件证明 Agent 可验收能写出状态、日志和停止条件的验收样例、通过/不通过标准、判断阈值和风险说明。
第 1.5.5 节：把第一个 Agent 整理成演示脚本和面试讲法能把第一个 Agent 收束成作品集页面、验收证据和面试回答。
第 1.5.6 节：用 ReAct、Plan-and-Solve 和 Reflection 选择 Agent 范式能说清 ReAct、Plan-and-Solve 和 Reflection 的处理顺序、关键检查点和失败处理。

学习建议​

先从第 1.5.1 节「先跑通最小可用 Agent 切片」进入，确认本章的起点和边界；后续小节负责补齐结构、契约和验收材料；到第 1.5.5 节「把第一个 Agent 整理成演示脚本和面试讲法」时，把前面的字段表、流程图和验收样例收束成可展示材料。

章末实战​

必做任务​

独立完成本章最终交付物：一个 Mock-first 的最小 Agent 演示脚本，以及一张经典 Agent 范式选择表。

不要只写概念总结。交付件必须能被另一位读者查看、复核，并能指出哪里通过、哪里需要返工。

必交证据​

  • 主交付件：本章要求的表格、流程图、字段契约、演示页面或验收材料。
  • 正常样例：证明主流程能够完成，并展示输入、处理结果和依据。
  • 边界或失败样例：至少覆盖资料不足、权限不足、工具失败、低置信度或高风险动作中的一种。
  • 取舍说明：用 3-5 句话解释为什么采用当前方案，以及没有采用的方案会增加什么成本或风险。
  • 复核记录：写明检查人、检查日期、发现的问题和修正结果。

评分标准​

维度2 分1 分0 分
业务目标输入、使用者和目标结果清楚目标基本清楚但缺一个关键条件只有技术名词，没有业务目标
工程边界明确说明系统做什么、不做什么和人工确认点有边界但缺少权限或责任说明默认模型可以处理所有问题
失败处理有可演示的失败分支、日志和下一步动作只写了失败说明，没有证据没有失败或兜底设计
可验证证据正常、边界/失败样例和主交付件能够互相对应有交付件但样例不完整只有文字总结
表达质量能用 90 秒讲清目标、方案、风险和验收能讲清功能但缺少取舍只能罗列工具名称

总分 10 分，达到 8 分且“工程边界”“失败处理”均不为 0 分才算通过。

自测步骤​

  1. 先遮住正文，只看自己的交付件，确认它能独立说明问题。
  2. 用正常样例走一遍主流程，再用边界或失败样例验证兜底。
  3. 根据评分表自评；低于 8 分时回到对应小节补材料，不继续堆新功能。
  4. 把最终交付件加入作品集目录，并准备一段 90 秒说明。

相关入口​