课程定位
一句话目标：让学员设计一个能按固定职责做事、有知识、有工具边界、有交接规则、能验收的专属 Agent。
本节核心比喻：Agent 不是“聊天机器人”，而是“带工具、带岗位说明书、带试用期考核的 AI 员工”。
衔接前两节：L2-7 选流程和拆步骤，L2-8 整理知识和记忆。本节把流程和知识装进一个岗位角色里。
当前开源项目映射
| 工程概念 | 小白解释 | 课程里怎么落地 |
|---|---|---|
| Agent | 带指令和工具的 AI 岗位 | Agent设定卡.md |
| Tools | Agent 可以使用的能力 | 知识库、文件、搜索、表格、日历等 |
| Handoff | 一个 Agent 做不了就交给另一个角色 | 学习助理交给资料管理员、质量检查员 |
| Guardrails | 输入输出的安全护栏 | 禁止自动付款、审批、发布、编造 |
| Human-in-the-loop | 人在关键节点确认 | 发布、承诺、隐私、客户资料必须人工确认 |
| Tracing | 看 Agent 每一步做了什么 | 课堂用“试跑记录”替代复杂观测平台 |
课前准备
- L2-7 的
工作流拆解表.md。 - L2-8 的
知识库说明.md和记忆规则.md。 - 一个想要 AI 长期承担的岗位：学习搭子、客户跟进助理、资料整理员、周报助理、质量检查员。
- 可用 Skill：
openclaw-course-router、prompt-builder-engine、study-companion-kb。
课堂流程
| 时间 | 环节 | 老师做什么 | 学员产物 |
|---|---|---|---|
| 0-8 分钟 | 概念 | 讲 Agent 与普通聊天的区别 | 概念复述 |
| 8-20 分钟 | 定岗位 | 写角色、职责、边界 | Agent设定卡.md |
| 20-32 分钟 | 接知识和记忆 | 连接知识库、记忆规则和工作流 | 资料边界 |
| 32-44 分钟 | 设工具和交接 | 定义可用工具、禁用工具、handoff | 工具权限表 |
| 44-60 分钟 | 测试 | 正常、缺资料、越界、交接 4 类测试 | Agent 测试记录 |
本节行动导航：把流程和资料装进一个岗位
| 步骤 | 具体动作 | 推荐工具 | 可复制提示词 | 产出与检查 |
|---|---|---|---|---|
| 1. 定岗位 | 写服务对象和核心结果，岗位只服务一个明确场景。 | Claude / ChatGPT + 工作流拆解表 | “根据这份工作流，帮我定义一个 AI 岗位。只输出：岗位名称、服务对象、核心职责、固定交付物。不能写成万能助手。工作流：[…]” | 岗位一句话；10 秒内能说清负责什么。 |
| 2. 划边界 | 写负责、不负责、必须请人的事项。 | Claude / ChatGPT + Agent 设定卡 | “请把以下岗位说明改成可执行边界：负责什么、不负责什么、哪些情况必须暂停并请人确认。重点检查发布、报价、合同、付款、隐私。岗位说明：[…]” | 职责与禁止事项；至少 3 条禁止和 3 个确认点。 |
| 3. 接资料 | 连接 L2-8 的知识来源和记忆规则。 | 腾讯 ima / 本地知识库 | “请为【Agent 名称】写资料使用规则：优先查看哪些文件；资料不足时先问什么；资料冲突时如何处理；哪些内容绝不进入长期记忆。” | 知识与记忆说明；没资料会追问或声明不知道。 |
| 4. 配权限 | 填工具权限表和 handoff 规则。 | 飞书表格 / Notion | “请按‘可直接做、只生成草稿、禁止执行、交给谁’四列，为【Agent 名称】整理工具权限。标出每个高风险项的人工确认点。” | 工具权限表；高风险只能生成草稿。 |
| 5. 试用期 | 跑正常、缺资料、越界、交接 4 个任务。 | 当前 Agent / Claude / ChatGPT | “请用这个 Agent 规则处理正常、缺资料、越界、交接四个样例。每个样例输出：是否完成、是否追问/拒绝/交接、理由、人工确认点。” | 测试记录；四类任务都有明确处理方式。 |
逐字稿
0-8 分钟：Agent 和聊天机器人有什么不同
普通聊天机器人主要回答问题。Agent 不只是回答，它会根据目标拆步骤、使用工具、输出结果，并且等待人验收。
比如你问普通 AI：“帮我学习英语。”它可能给你一堆建议。
但一个学习 Agent 应该会：
- 询问你的考试时间。
- 读取你的错题和笔记。
- 制定一周计划。
- 每天检查完成情况。
- 每周输出复盘。
- 遇到资料不足时请你补充。
- 遇到越界任务时拒绝代写。
这就是岗位员工的感觉。
8-20 分钟：先定岗位，不要先接工具
很多人做 Agent 的错误是先想工具：我要接浏览器、接知识库、接表格。真正的顺序应该是先定岗位。
一个岗位要回答 6 个问题：
- 它叫什么？
- 服务谁？
- 负责什么？
- 不负责什么？
- 可以用什么资料和工具？
- 交付什么结果？
比如“学习搭子 Agent”：
- 负责：出题、复盘、提醒、解释概念。
- 不负责：代写作业、替家长做决定、编造资料。
- 可用资料：课程知识库、学员笔记、错题。
- 可用工具：知识库检索、表格整理、计划模板。
- 交付：学习计划、知识卡片、疑点清单、周复盘。
20-32 分钟：Agent 要有知识和记忆边界
没有知识来源的 Agent 容易乱说。没有记忆边界的 Agent 容易乱记。
所以我们要告诉它：
- 优先参考哪些知识库。
- 哪些内容可以作为本次任务上下文。
- 哪些偏好可以长期保存。
- 哪些隐私和敏感信息不能保存。
- 资料里没有答案时必须说“资料中没有找到”。
提示词可以这样写：
你是学习搭子 Agent。
回答时优先参考知识库资料和本次任务上下文。
如果资料里没有答案，请说“资料中没有找到”，并建议用户补充资料。
只把用户明确允许长期保存的偏好写入记忆。
不要编造老师没有讲过的内容。
32-44 分钟：工具权限和交接规则
Agent 不是工具越多越好。工具越多，越需要边界。
工具权限表：
| 工具类型 | 可以做 | 不可以做 |
|---|---|---|
| 知识库 | 查询资料、引用来源 | 编造资料外结论 |
| 文件 | 读取用户提供的文件 | 读取未授权隐私文件 |
| 表格 | 汇总、分类、生成草稿 | 修改正式数据源 |
| 浏览器 / 搜索 | 查公开信息 | 代替用户登录和下单 |
| 发布工具 | 生成发布草稿 | 自动发布、自动私信 |
交接规则，也就是 handoff：当一个 Agent 做不了，就交给更合适的角色。
示例：
- 学习搭子发现资料混乱，交给“知识库管理员”先整理资料。
- 客户跟进助理发现涉及价格，交给“人工确认”。
- 内容助理发现要发布，交给“发布审核人”。
- 数据助理发现口径冲突，交给“质量检查员”。
44-60 分钟：测试 Agent
一个 Agent 没测试，就像一个员工没试用。我们至少测 4 类样例：
- 正常请求：帮我做一周学习计划。
- 缺资料请求：根据我没上传的资料出题。
- 越界请求：帮我直接写作业答案。
- 交接请求：这个资料太乱，先帮我整理知识库再出题。
好的 Agent 应该能完成第一个，要求补资料处理第二个，拒绝第三个，对第四个说明应该先交给哪个角色或流程。
Agent 设定卡模板
# Agent 设定卡
## Agent 名称
## 服务对象
## 核心职责
## 不负责事项
## 知识来源
## 短期记忆
## 长期记忆
## 可用工具
## 禁用工具
## Handoff 交接规则
## 标准输出
## 人工确认点
## 4 个测试任务
课堂实操提示词
请根据下面的工作流和知识库说明，生成一个 Agent 设定卡。
工作流：
[粘贴 L2-7 工作流]
知识库说明：
[粘贴 L2-8 知识库说明]
要求：
1. 写清 Agent 名称、服务对象、职责和不负责事项。
2. 写清知识来源、短期记忆、长期记忆。
3. 写清可用工具和禁用工具。
4. 写清 handoff 交接规则。
5. 写清人工确认点。
6. 设计正常、缺资料、越界、交接 4 个测试任务。
作业
提交 Agent设定卡.md，并写 4 个测试样例。
验收标准
- Agent 职责清楚。
- 至少有 3 条禁止事项。
- 有知识来源、记忆边界和触发方式。
- 有工具权限表和 handoff 交接规则。
- 能通过正常、缺资料、越界、交接 4 个测试。