FAQ：AI Agent 工程教材常见问题

这套书是不是源码课？

不是。本书讲工程制作方法、字段契约、测试、评估、发布门禁和作品集表达。examples/ 下的内容是教学用最小可验证包，不是完整商业源码。

它证明一个项目的 schema（结构定义）、样例输入输出、pytest（测试框架）、eval（评估）和日志闭环存在。它不证明真实线上效果、真实客户交付或完整生产能力。

制作自己的作品集项目时，先按最小可验证包模板检查样例、字段、失败路径和验收方式。

如果已经拿到配套工程目录，按最小工程包运行指南先跑一个单独工程包，再用 cmd /c npm run test:examples 做全部回归。只在线阅读网页时，先看项目页的“最小可验证包”区块，不需要配置本地环境。

不要。1000 题是训练集和追问地图。面试前优先准备 2 个主项目，每个项目能讲 90 秒、5 分钟和连续追问，再用题卡补短板。

因为没有安全、评估和回归门禁，Agent 项目只能算演示。工程师教程必须证明系统能被测试、能被拒绝、能被复盘，而不是只展示成功回答。

可以作为下一阶段，但首版最小包保持 Mock-first。接真实能力前必须补密钥隔离、真实供应商配置、成本限流、红队测试和发布门禁。

可以按读者反馈与勘误的格式反馈。反馈前请先脱敏，不要提交 API Key、密码、真实客户数据、订单号、合同号或生产日志全文。

项目	内容
最低交付	读者能判断本书边界、最小包用途、面试题使用方法和真实项目升级条件。
可验证证据	FAQ 页、质量检查页、examples README 和 eval 门禁。
不合格表现	把教学包说成完整源码；把面试题当背诵稿；忽略安全和评估。
面试可说内容	我能区分演示、教学工件和生产系统，并能说明每一层需要什么证据。
前置条件	已阅读项目首页和 6 个作品集总览。
回归测试要点	口径不能变成“完整源码交付”或“真实生产指标”。