第 1 卷：AI Agent 基础与工具
课程元数据
| 项目 | 内容 |
|---|---|
| 学习时间 | 12-18 小时 |
| 难度 | 入门到初级工程 |
| 适合人群 | 准备从 AI 应用使用者转为 AI Agent 工程实践者的读者。 |
| 最终交付物 | 一套可解释、可验收的客服 Agent 最小闭环设计稿。 |
| 前置条件 | 能使用浏览器、命令行和 Codex/Trae 等编程代理；不要求系统学过后端开发。 |
本卷解决什么
从 Agent 边界、模型调用、Prompt、工具、状态、后端、数据契约和测试配置建立工程底座。
模块路线
| 模块 | 解决的问题 | 最终交付 |
|---|---|---|
| 第 1.1 章 Agent 边界：判断什么时候需要真正的 AI Agent | 判断什么时候需要真正的 AI Agent | 一张 Chatbot、Workflow、Agent 的需求判型表。 |
| 第 1.2 章 工程师能力地图：把岗位要求拆成可训练能力 | 把岗位要求拆成可训练能力 | 一份岗位能力差距表和学习任务清单。 |
| 第 1.3 章 模型、Token 与 API：理解一次模型调用的工程成本 | 理解一次模型调用的工程成本 | 模型调用链路图、上下文预算和供应商切换说明。 |
| 第 1.4 章 Prompt 与结构化输出：让模型输出变成稳定字段 | 让模型输出变成稳定字段 | 输出字段契约、失败样例和 Prompt 回归清单。 |
| 第 1.5 章 第一个 Agent：跑通 Mock-first 的最小闭环 | 跑通 Mock-first 的最小闭环 | 一个 Mock-first 的最小 Agent 演示脚本，以及一张经典 Agent 范式选择表。 |
| 第 1.6 章 工具调用：把业务动作接入受控工具 | 把业务动作接入受控工具 | 客服 Agent 工具调用设计包：边界判断表、函数接口契约表、权限审批矩阵、失败兜底与审计表、作品集讲法。 |
| 第 1.7 章 状态、记忆与会话：让 Agent 知道自己做到哪一步 | 让 Agent 知道自己做到哪一步 | 状态字段表、记忆范围表、停止条件、恢复策略和上下文包契约。 |
| 第 1.8 章 Python 工程能力：搭好可维护的 Agent 项目底座 | 搭好可维护的 Agent 项目底座 | AI Agent 项目目录、依赖、配置和任务脚本说明。 |
| 第 1.9 章 Pydantic 数据契约：统一模型、工具、接口和日志字段 | 统一模型、工具、接口和日志字段 | 模型输出、工具输入、API 响应和日志字段的统一契约。 |
| 第 1.10 章 FastAPI 后端：把 Agent 能力发布成可调用服务 | 把 Agent 能力发布成可调用服务 | Agent HTTP 服务接口清单、鉴权上下文和健康检查。 |
| 第 1.11 章 文件与数据格式：把资料入口变成可治理数据 | 把资料入口变成可治理数据 | 资料入口格式策略、解析边界和质量检查表。 |
| 第 1.12 章 测试、日志与配置：用证据证明 Agent 行为可靠 | 用证据证明 Agent 行为可靠 | 核心评测集、结构化日志字段和配置分层说明。 |
| 第 1.13 章 多模型适配：让供应商切换可评测、可回滚 | 让供应商切换可评测、可回滚 | 模型能力矩阵、供应商适配器、Fallback 路由策略和工具调用兼容表。 |
| 第 1.14 章 个人 AI 助手：把个人效率工具升级成项目雏形 | 把个人效率工具升级成项目雏形 | 个人助手到客服工作台的最小项目方案和演示脚本。 |
学习建议
按章节编号推进，不需要平均用力。每一章先看“模块路线”，再进入小节；每个小节结尾的“继续学习”只保留有效的前后导航，卷末会自然过渡到下一卷。