7.2 工作流设计实战
工作流是 Agent 的"骨架"——它决定了 Agent 接到任务后，按什么顺序、调用什么工具、如何一步步完成任务。
一、工作流的基本结构
一个典型的扣子工作流由以下节点组成：
开始节点 → 大模型节点 → 插件节点 → 输出节点
| 节点类型 | 功能 | 示例 |
|---|---|---|
| 开始节点 | 接收用户输入，定义输入变量 | 接收用户输入的活动主题 |
| 大模型节点 | 调用 AI 大模型进行理解、生成、推理 | 根据主题生成策划方案 |
| 插件节点 | 调用外部工具扩展能力 | 用 LinkReader 读取网页内容 |
| 条件节点 | 根据条件分支执行不同路径 | 判断活动类型选择不同模板 |
| 输出节点 | 将结果返回给用户 | 输出完整的策划方案 |
工作流的设计遵循一个基本原则：将复杂任务拆解为若干个明确的步骤，每个步骤由最合适的节点类型来执行。 这与软件工程中的"模块化设计"思想一脉相承——每个节点只负责一件事，节点之间通过变量传递数据。
工作流设计的三个要点：
- 明确输入输出：每个节点需要什么数据？产出什么结果？在动手搭建之前，先在纸上画出数据流向图。
- 合理拆分粒度：步骤太粗，单个节点负担过重，容易出错；步骤太细，节点过多，维护困难。一般建议每个大模型节点只承担一个明确的任务。
- 预设异常处理：用户输入不完整怎么办？插件调用失败怎么办？好的工作流应该包含条件判断节点来处理这些边界情况。
二、知识库构建
知识库让 Agent 拥有"专属记忆"，能够基于你上传的文档来回答问题。这就是 1.3 节介绍的 RAG 技术的实际应用——Agent 不再只依赖训练数据，而是能从你提供的资料中检索信息。
为什么需要知识库？ 假设你要搭建一个"校规问答助手"。如果不配置知识库，Agent 只能根据通用知识回答，很可能给出错误的校规信息。配置了知识库后，Agent 会先从你上传的学生手册中检索相关内容，再基于检索结果生成回答——准确率大幅提升。
构建步骤：
- 在扣子平台点击"知识库" → "新建知识库"；
📷 【截图位置】：扣子平台知识库创建界面截图，展示文档上传区域和分段参数配置（建议尺寸：宽度占满页面）
- 上传文档（支持 PDF、Word、TXT 等格式）；
- 系统自动将文档切分为若干段落（分段）；
- 配置检索参数：
- 分段大小：每段包含多少字（建议 300—500 字）；
- 检索数量：每次查询返回几个相关段落（建议 3—5 个）；
- 在 Bot 设置中关联该知识库。
知识库的适用场景：
| 场景 | 上传内容 | 效果 |
|---|---|---|
| 校规问答助手 | 学生手册、校规校纪文件 | Agent 能准确回答校规相关问题 |
| 课程答疑助手 | 教材章节、课件 PPT | Agent 基于教材内容回答学生提问 |
| 产品客服 | 产品说明书、FAQ 文档 | Agent 能回答产品使用问题 |
三、实战：搭建"校园活动策划助手"
下面通过一个完整案例，演示从零搭建 Agent 的全过程。
步骤 1：明确需求
- 目标：输入活动主题和基本要求，自动生成完整的活动策划方案；
- 输出：包含活动目标、时间安排、预算、宣传方案、应急预案的结构化文档。
步骤 2：设计工作流
用户输入活动主题和要求
↓
大模型节点 1：分析需求，确定活动类型和规模
↓
插件节点：搜索同类活动的优秀案例（LinkReader）
↓
大模型节点 2：结合案例和需求，生成完整策划方案
↓
输出节点：返回格式化的策划方案
步骤 3：配置各节点
开始节点——定义输入变量：
| 变量名 | 类型 | 说明 |
|---|---|---|
| topic | 文本 | 活动主题 |
| scale | 文本 | 活动规模（小型/中型/大型） |
| budget | 文本 | 预算范围 |
大模型节点 2——提示词配置：
你是一位经验丰富的校园活动策划师。
请根据以下信息生成一份完整的活动策划方案：
活动主题：{{topic}}
活动规模：{{scale}}
预算范围：{{budget}}
参考案例：{{search_result}}
输出格式：
1. 活动概述（目标、主题、时间、地点）
2. 活动流程（时间表）
3. 预算明细（表格）
4. 宣传方案
5. 应急预案
步骤 4：测试与迭代
发布前在预览区进行充分测试：
- 测试不同类型的活动主题，检查输出质量；
- 测试边界情况（如预算极低、主题模糊），检查 Agent 的应对能力；
- 根据测试结果调整提示词和工作流。
★ 主线任务：搭建"校园活动策划助手"智能体
在扣子平台上完成以下任务：
- 创建一个 Bot，设定角色为"校园活动策划师"；
- 搭建包含至少 3 个节点的工作流；
- 创建知识库，上传 2—3 份活动策划模板或案例；
- 测试至少 3 种不同的活动主题，记录输出效果和优化过程。