交接包bridge-materials/templates/03_to_04_agent_scenario_handoff.md
第 3 → 第 4 课交接包:项目助理交给多智能体协作
文件路径:/Users/apple/Documents/4.0 Sanyuan/2.4 环境公益"新"力量/course/bridge-materials/templates/03_to_04_agent_scenario_handoff.md
用途:第 3 课下课前填写,第 4 课用于选择主场景、判断协作缺口、拆出多智能体角色与交接协议。
1. 项目助理边界卡
| 项目 | 填写 |
|---|---|
| 项目助理名称 | |
| 主要服务对象 | 本机构同事 / 志愿者 / 合作伙伴 / 公众 / 其他: |
| 能处理的 3 类问题 | 1. 2. 3. |
| 明确不处理的 3 类问题 | 1. 2. 3. |
| 需要人工审核的情形 | |
| 需要拒答或转人工的情形 |
2. 已挂载资产
2.1 Skill 接口清单
| Skill 名称 | 触发条件 | 输入要求 | 输出契约 | 成功标准 | 知识库依赖 | 不适用场景 | 稳定性状态 |
|---|---|---|---|---|---|---|---|
| 草稿 / 可用 / 稳定 | |||||||
| 草稿 / 可用 / 稳定 |
必填 Gotchas:
Skill 1 最容易翻车的 3 点:
Skill 2 最容易翻车的 3 点:
评测用例:
| Skill | 必测问题 | 期望输出 | 是否通过 |
|---|---|---|---|
| 是 / 否 | |||
| 是 / 否 |
2.2 知识库接口清单
| 知识库名称 | 资料范围 | 允许回答范围 | Top-K/检索设置 | 不能回答什么 |
|---|---|---|---|---|
3. 路由表
| 用户问题类型 | 判定条件 | 调用 Skill | 相邻易混 Skill | 优先归属规则 | 是否检索知识库 | 输出形式 | 需要追问的条件 | 超边界处理 |
|---|---|---|---|---|---|---|---|---|
| 是 / 否 | ||||||||
| 是 / 否 | ||||||||
| 是 / 否 | ||||||||
| 是 / 否 |
兜底规则:
当用户意图不清时:
当 Skill 和知识库都可能适用时:
当知识库没有依据时:
4. 主工作流最小闭环
先只写一条主工作流,不要同时扩三个模块。
用户输入:
↓
路由判定:
↓
检索 / 不检索:
↓
调用 Skill / 直接回答:
↓
输出结果:
↓
记录问题并人工复核:
5. 10 问诊断表
| # | 测试问题 | 覆盖类型 | 期望行为 | 实际表现 | 问题归因 |
|---|---|---|---|---|---|
| 1 | 边界 / Skill / 知识库 / 工作流 / 输出 | ||||
| 2 | 边界 / Skill / 知识库 / 工作流 / 输出 | ||||
| 3 | 边界 / Skill / 知识库 / 工作流 / 输出 | ||||
| 4 | 边界 / Skill / 知识库 / 工作流 / 输出 | ||||
| 5 | 边界 / Skill / 知识库 / 工作流 / 输出 | ||||
| 6 | 边界 / Skill / 知识库 / 工作流 / 输出 | ||||
| 7 | 边界 / Skill / 知识库 / 工作流 / 输出 | ||||
| 8 | 边界 / Skill / 知识库 / 工作流 / 输出 | ||||
| 9 | 边界 / Skill / 知识库 / 工作流 / 输出 | ||||
| 10 | 边界 / Skill / 知识库 / 工作流 / 输出 |
诊断规则:
| 问题归因 | 第 4 课优先修什么 |
|---|---|
| 边界错 | 改项目助理边界卡 |
| 路由错 | 改路由表和触发条件 |
| 知识库错 | 回补资料、metadata、检索参数 |
| Skill 错 | 改输出契约、Gotchas、输入要求 |
| 工作流错 | 简化步骤,补人工审核点 |
6. 交给第 4 课的主场景
第 4 课只选一个主场景先闭环:
| 项目 | 填写 |
|---|---|
| 主场景名称 | |
| 为什么优先做它 | |
| 当前最常失败的问题 | |
| 闭环缺口 | Skill / 知识库 / 路由 / 人工审核 / 其他: |
| 是否需要补第二个 Skill | 是 / 否 / 待确认 |
第 4 课开场要回答:
我最想让项目助理稳定完成的真实任务是:
现在卡住它的最大缺口是:
如果第 4 课只能修一个问题,我会先修:
7. 多智能体拆分草图
第 4 课开场前,先粗略判断这条主场景是否需要拆成多智能体协作。
| 候选角色 | 负责什么 | 输入 | 输出 | 需要人审吗 |
|---|---|---|---|---|
| 主控智能体 | 判断任务类型、分派下一步 | 用户任务、边界卡 | 分派结果、交接包 | 是 / 否 |
| 资料员智能体 | 是 / 否 | |||
| 写作/执行智能体 | 是 / 否 | |||
| 审核员智能体 | 是 / 否 |
初步停止条件:
什么情况下不能继续自动处理:
什么情况下必须交给人:
什么情况下可以自动进入下一步: