# 第 3 课 · AI智能体编排：组装「项目助理」（学员手册）

> 文件路径：`/Users/apple/Documents/4.0 Sanyuan/2.4 环境公益"新"力量/course/part-03-agent/README.md`
>
> 时长 120 分钟　|　课后产出：项目助理 AI 智能体调试通过
>
> 前置：完成第 1 课「技能构建」+ 第 2 课「知识库实战」，手上有 ≥1 个技能 + ≥1 个知识库。

---

## 一、这节课要解决什么

前两课分别解决了「怎么做」（技能）和「有什么」（知识库），但它们各自独立——用户得记住哪个技能对应什么场景，还得手动切换知识库。这就像厨房里菜谱和食材都备齐了，但没有厨师把它们串起来。

第 3 课的目标：把多个技能和知识库**编排**成一个统一的**项目助理**。用户只需要开口说一句话，项目助理自动判断意图、选对技能、查对知识库、输出结构化回答。

一句话：**项目助理 = 统一入口 + 多技能路由 + 知识库增强。**

## 二、项目助理架构

![项目助理架构图解](assets/illustrations/project-assistant-architecture.png)

```text
┌──────────────────────────────────────────────┐
│                  用户入口                      │
│          （扫码 / 链接 / 嵌入网页）              │
└──────────────────┬───────────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────────┐
│              意图识别层                        │
│   用户说了什么 → 分到哪个技能？                  │
│   ┌────────┬────────┬────────┬────────┐      │
│   │ 文书   │ 案例   │ 传播   │ 综合   │      │
│   │ 类意图 │ 类意图 │ 类意图 │ 问答   │      │
│   └───┬────┴───┬────┴───┬────┴───┬────┘      │
└───────┼────────┼────────┼────────┼────────────┘
        │        │        │        │
        ▼        ▼        ▼        ▼
┌──────────────────────────────────────────────┐
│              技能路由层                        │
│   根据意图加载对应技能的 SOP + 输出契约          │
│   （结项报告 / 项目书 / 案例检索 / 推文…）       │
└──────────────────┬───────────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────────┐
│            知识库 RAG 增强                     │
│   从云端知识库检索相关文档切片                    │
│   补充事实、案例、数据，减少幻觉                  │
└──────────────────┬───────────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────────┐
│            格式化输出                          │
│   按技能定义的输出契约组织回答                    │
│   标注来源 / 缺失项 / 置信度                    │
└──────────────────────────────────────────────┘
```

**核心思路**：用户不需要知道背后有几个技能、几个知识库——只需要一个入口，说清楚自己要什么。

## 三、三个必须讲清楚的概念图

### 3.1 完整智能体不是一段提示词

![智能体四要素图解](assets/illustrations/agent-four-components.png)

一个完整的 AI 智能体，至少由四个部分共同构成：

| 要素 | 本课说法 | 对应配置 |
|------|----------|----------|
| 性格 | 它是谁、用什么语气、有什么红线 | 系统提示词 |
| 能力 | 它会做哪些事 | 第 1 课沉淀的技能 |
| 行动 | 它能调用哪些外部能力 | 工作流节点、插件、知识库检索 |
| 记忆 | 它能基于什么材料回答 | 第 2 课知识库 + 对话上下文 |

这张图要帮助学员建立一个边界：**系统提示词只是性格，不等于完整智能体**。如果只有提示词，没有技能、工具和知识库，项目助理很容易变成「听起来会做事，但实际没有抓手」的聊天窗口。

### 3.2 知识库只是长期记忆

![智能体三层记忆图解](assets/illustrations/agent-memory-layers.png)

学员常把「知识库」理解成智能体的全部记忆，但真实使用时至少要分三层：

| 记忆层 | 解决什么 | 常见误区 |
|--------|----------|----------|
| 短期记忆 | 当前对话里刚说过的信息 | 对话太长后会被上下文窗口挤掉 |
| 长期记忆 | 机构项目、报告、案例、模板等沉淀资料 | 需要先上传、清洗、分层，不能凭空记住 |
| 工具记忆 | 外部表格、数据库、项目系统里的结构化数据 | 基础课不强制接入，但要知道它和知识库不同 |

这张图要帮助学员理解：第 2 课建的知识库主要解决**长期记忆**，它不能自动解决所有「忘记」问题，也不能替代实时数据库。

## 四、课堂四步

### 4.1 Agent平台 首配（25 分钟）

1. **注册**：打开 Agent平台（yuanqi.tencent.com），用微信扫码注册/登录
2. **工作区**：创建「XX机构项目助理」工作区（XX = 你的机构简称）
3. **Fork 模板**：从课程提供的「环境公益项目助理·主模板」Fork 一份到自己工作区
4. **自定义**：
   - 机构名称：把模板里的「XX机构」替换成你的真实机构名
   - 欢迎语：改成你机构的语气，例如「你好，我是 XX 的项目助理，可以帮你写文书、查案例、做传播内容。」
   - 系统提示词：确认角色定位（你是XX机构的项目助理）、边界（只回答与本机构项目相关的问题）

### 4.2 挂载技能与知识库（35 分钟）

**技能挂载**：把第 1 课做的技能嵌入系统提示词的触发条件中：

```text
## 技能路由规则
- 当用户提到「结项报告」「项目总结」「执行报告」→ 加载【结项报告技能】
- 当用户提到「项目书」「立项」「申请书」→ 加载【项目书技能】
- 当用户提到「资助信」「申请信」「项目摘要」→ 加载【资助信技能】
- 其他问题 → 综合问答模式，优先从知识库检索
```

**知识库挂载**：
1. 将第 2 课整理好的 L1/L2 文档上传到 Agent平台 的云端知识库
2. 配置检索参数（Top-K、相似度阈值）
3. 在系统提示词里加一句：「回答前先查阅知识库，优先使用知识库中的真实信息，不要编造」

**调试 5 个真实问题**：

| # | 测试问题 | 期望行为 | 实际表现 | 修改 |
|---|---------|---------|---------|------|
| 1 | 「帮我写结项报告」 | 加载结项技能 + 查知识库 | | |
| 2 | 「XX基金会的申请要求是什么」 | 走综合问答 + 检索资助指南 | | |
| 3 | 「把这段改成朋友圈文案」 | 走传播技能（如有）或综合 | | |
| 4 | 「去年我们做了几个项目」 | 查知识库，列出项目清单 | | |
| 5 | 「帮我算一下预算」 | 礼貌拒绝或提示超出能力范围 | | |

### 4.3 按模块升级工作流（50 分钟）

当简单的「意图 → 技能 → 回答」不够用时，用工作流把多步骤串起来。三个模块各升级一个工作流：

#### M1 文书链工作流

```text
用户上传流水账
    │
    ▼
[Step 1] 材料预处理
    │  提取关键信息（活动、时间、人数、产出）
    │  标注缺失项
    ▼
[Step 2] 知识库检索
    │  查找同类项目的历年报告作为参考
    │  提取资助方模板要求
    ▼
[Step 3] 报告生成
    │  按技能定义的六章节输出契约填充
    │  引用知识库中的真实数据
    ▼
[Step 4] 自检 + 缺失项清单
    │  对照输出契约逐项检查
    │  生成「缺失项 + 建议补充方向」清单
    ▼
输出：结构化报告 + 缺失项清单
```

#### M2 案例库工作流

```text
用户提出案例需求
    │  「找一个湿地保护的成功案例」
    ▼
[Step 1] 意图解析
    │  提取关键词：领域=湿地保护，类型=成功案例
    ▼
[Step 2] 知识库多维检索
    │  按领域 + 类型 + 年份检索
    │  返回 Top-3 匹配案例
    ▼
[Step 3] 案例卡片格式化
    │  每个案例按「背景→干预→结果→反思」输出
    │  标注来源文档
    ▼
输出：3 张案例卡片 + 来源标注
```

#### M3 传播运营工作流

```text
用户提出传播需求
    │  「写一篇项目推文」
    ▼
[Step 1] 素材收集
    │  从知识库检索项目亮点、受益人故事（已脱敏）
    │  从用户输入提取关键信息
    ▼
[Step 2] 内容生成
    │  根据平台（公众号 / 朋友圈 / 微博）调整篇幅与语气
    │  嵌入数据与故事
    ▼
[Step 3] 合规检查
    │  检查是否包含未脱敏的个人信息
    │  检查数据引用是否有来源
    ▼
输出：传播内容初稿 + 合规检查清单
```

### 4.4 互测（10 分钟）

1. **扫码互测**：和邻座交换项目助理的二维码
2. **各问 3 个问题**：覆盖不同技能场景
3. **记录反馈**，分三类：
   - **准**：回答正确、格式对、引用了真实信息
   - **不准**：回答了但信息有误或编造了内容
   - **乱答**：答非所问、加载了错误的技能、格式混乱

## 五、和前后课的衔接

| 课程 | 角色 | 类比 |
|------|------|------|
| 第 1 课 · 技能 | 定义「怎么做」 | 菜谱 |
| 第 2 课 · 知识库 | 提供「做事素材」 | 食材库 |
| **第 3 课 · AI智能体**（本课） | 编排技能 + 知识库 | 厨师 |
| 第 4 课 · 多智能体协作 | 拆分专责智能体 + 交接协议 | 后厨小队 |

本课下课前，请填写：

- 第 3 → 第 4 课交接包：`/Users/apple/Documents/4.0 Sanyuan/2.4 环境公益"新"力量/course/bridge-materials/templates/03_to_04_agent_scenario_handoff.md`
- 课程产物跟踪表：`/Users/apple/Documents/4.0 Sanyuan/2.4 环境公益"新"力量/course/bridge-materials/templates/cross_lesson_artifact_tracker.md`

第 4 课会直接使用交接包里的项目助理边界卡、路由表、主工作流和 10 问诊断结果，把一个主场景拆成「主控分派 + 专责处理 + 审核收口」的多智能体协作链。

## 六、课后作业（分层）

| 层级 | 任务 | 验收标准 |
|------|------|---------|
| 入门 L1（用起来） | 对话 Bot + 挂载 ≥1 个知识库 | 自己问 10 个问题，准确率 ≥60% |
| 进阶 L2（用得顺） | 包含 ≥3 步工作流 + ≥1 个插件 | 找 3 个同事内测，收集反馈并修一轮 |

下课带走一句话：**「我的项目助理已经能处理 _____ 类问题，互测中 ___/___（准/总）。」**

## 七、下一课预告

项目助理跑通了，但「一个智能体扛所有步骤」不适合复杂任务。第 4 课《多智能体协作》会教你把一个主场景拆成主控智能体、文书智能体、案例智能体、审核智能体等角色，用结构化交接协议让它们联合工作。
