> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

**扣子助手**是扣子官方提供的客服场景的智能体。你可以通过复制该模板，快速创建和定制一个满足自己业务场景的智能客服智能体。
:::tip 说明
扣子编程的智能客服搭建方案已全面升级。升级后的方案编排更简洁、效果更优秀、满意度更高。具体方案，请参考[升级版扣子助手能力拆解](/tutorial/new_coze_assistant_template)。
:::
<Player src="https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/fd79a239459c477f99aa6863760acf28~tplv-goo7wpa0wc-image.image"></Player>
点击[这里](https://www.coze.cn/template/agent/7416353271499096116?)体验扣子助手智能体。
![Image=605x322](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ebe28f5a17b74c6db3a33bb8a6ce2724~tplv-goo7wpa0wc-image.image)
## AI 客服智能体的优势 {#b3daa37d}
随着大语言模型能力的提高，智能客服已成为生成式 AI 的典型应用场景之一。与传统的智能客服机器人相比，基于 AI 能力的智能客服无论是用户使用体验还是维护成本上都有着显著优势。扣子集成了丰富的大语言模型供你选择，可快速生成问答能力。此外，扣子的开放能力和丰富的 AI 应用搭建能力，极大地简化了客服智能体的搭建和维护成本。
<!-- @cols-width: 115,326,425 -->
| | | | \
|**对比项** |**传统智能客服** |**AI-Powered 智能客服** |
|---|---|---|
| ||| \
|**用户使用体验对比** | | |
| | | | \
|交互体验 |由于依赖预定义的规则和关键词匹配，传统客服机器人的对话往往显得生硬、不自然。 |利用高级的自然语言处理（NLP）技术，能够理解和生成自然语言，使对话更加自然流畅。 |
| | | | \
|回复准确性和效率 |* 提供预定义的固定回答，无法灵活应对用户的多样化需求。 |\
| |* 通常只能进行简单的问答，无法处理多轮对话，用户需要重复输入信息。 |* 支持多轮对话，能够进行更复杂和深入的互动，减少用户的重复输入。 |\
| | |* 能够理解对话的上下文，并且能够通过知识库的内容进行总结和提炼，提供更相关和准确的回答。 |
| | | | \
|个性化服务 |无法根据用户的历史记录和偏好提供个性化的服务，用户体验较为单一。 |根据用户的历史记录和偏好，提供个性化的服务和推荐，提升用户体验。 |
| ||| \
|**搭建和维护成本对比** | | |
| | | | \
|搭建成本 |* 通常需要借助第三方客服机器人平台或工具，需要一定的搭建和部署成本。 |\
| |* 规则和关键词设置：需要大量时间和人力来定义规则和关键词。 |* 基于扣子的智能客服模板可以快速复制一个智能客服智能体，并支持进行定制化改造。 |\
| | |* 除了丰富的发布渠道外，扣子提供了各种接口和 Web SDK  能力，支持与已有应用快速集成。 |
| | | | \
|维护成本 |* 需要手工、定期维护知识库内容。容易因为知识库更新不及时导致回复内容不准确。 |* 支持实时自动更新在线知识库，并能够对知识库内容进行提炼和总结。 |

## 扣子智能客服模板介绍 {#ae3ae085}
基于扣子的官方智能客服——扣子助手的最佳实践和经验沉淀，扣子将扣子助手制作成智能体模板，方便开发者一键复制和定制改造。
### 业务流程 {#7a7f2de3}
扣子智能客服智能体解决了智能客服在落地过程中的共同痛点问题：

* 无法准确识别用户意图并做出分类解答。
* 无法准确召回企业知识库进行正确回复。
* 无法高效分析智能客服回复效果并及时更新知识库。

下图展示了扣子助手智能体的流程。

1. 当用户向小助手发起咨询后，小助手会首选判断用户咨询的问题是否与扣子产品有关。
2. 如果是扣子使用的相关问题，则调用扣子知识库查找相关说明并使用大模型能力进行总结和回复。并且将消息记录写入到多维表格中，进行自动分析。
3. 如果不是扣子使用的相关问题，则直接调用大语言模型进行回复，且不进行问题记录。

![Image=2112x946](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/24d290cc4ecf4534b5420579deb17a76~tplv-goo7wpa0wc-image.image)
### 实现流程 {#58e07dca}
扣子助手智能体使用的是工作流模式（workflow-as-agent），工作流整体编排如下。
![Image=2505x605](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/76696d73d5214a2cb7946246f20711fd~tplv-goo7wpa0wc-image.image)
#### 问题分发 {#f887c13e}
通过意图识别节点判断用户意图，将问题分发到对应的分支处理。
![Image=200x622](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2fa4cdd485e74c8781061c74885231a1~tplv-goo7wpa0wc-image.image)
各节点说明如下：
<!-- @cols-width: 150,554,261 -->
| | | | \
|**工作流节点** |**说明** |**示例** |
|---|---|---|
| | | | \
|开始节点 |使用用户问题开始启动工作流。 |\
| |实现方式：默认使用用户在智能体中提交的问题作为开始。 |![Image=200x127](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4672686126b946749c3f290fab36e69f~tplv-goo7wpa0wc-image.image) |
| | | | \
|意图识别节点 |判断用户是否在咨询与产品使用的相关问题。 |\
| |**实现方式**：使用意图识别节点，基于豆包·1.5·Pro·32k 模型对用户问题分类：扣子产品使用相关的问题、不相关的问题，并在**系统提示词**中对问题分类的规则进行定义。 |![Image=200x622](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2fa4cdd485e74c8781061c74885231a1~tplv-goo7wpa0wc-image.image) |

#### 处理产品相关问题 {#b3dbf503}
大模型参考历史对话改写用户的 Query，再根据 Query 检索知识库，并由大模型进行总结和输出。用户 Query、大模型回复均通过插件记录在指定的飞书多维表格中。
![Image=1431x498](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f87e7d6cb7ad4c6bbfe9fbdd0120162c~tplv-goo7wpa0wc-image.image)
各节点说明如下：
<!-- @cols-width: 147,536,275 -->
| | | | \
|**工作流节点** |**说明** |**示例** |
|---|---|---|
| | | | \
|大模型 0 |参考历史对话改写用户的 Query。 |\
| |**实现方式**：在大模型节点中定义一个用户问题理解专家的角色，并提供详细的提示词。 |![Image=200x631](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8f97f82b6e684719ae914cf4f52d63dc~tplv-goo7wpa0wc-image.image) |
| | | | \
|知识库节点 |根据用户问题检索并召回对应的产品知识。 |\
| |**实现方式**：首先将产品相关的资料上传至扣子知识库，然后使用知识库节点选择要使用的知识库内容，并使用混合检索策略对内容进行召回，提升命中率。 |\
| | |![Image=200x628](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0d66da69b1c04e66a04d57d3e83542de~tplv-goo7wpa0wc-image.image) |
| | | | \
|大模型 1 |本工作流中添加了两个大模型节点。其中一个大模型节点用于对知识库召回的扣子产品教程内容进行进一步总结和输出。 |\
| |**实现方式**：在大模型节点中定义一个具备产品专业知识的角色，并提供详细的提示词。 |\
| | |![Image=200x515](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/177c002cfa3d433dbce233dc2d4dacfd~tplv-goo7wpa0wc-image.image) |
| | | | \
|代码节点 |将和产品相关的用户问题和回复进行标准化的数据处理。 |\
| |**实现方式**：根据输入的参数构建一个包含用户问题和对应的的回复的结构化数据对象。 |\
| | |![Image=200x328](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/53f5778896724c139cf2d62f08794762~tplv-goo7wpa0wc-image.image) |
| | | | \
|插件节点 |将代码节点处理的用户问题和回复写入小助手管理员的飞书多维表格。 |\
| |**实现方式**：使用[飞书多维表格插件](https://www.coze.cn/store/plugin/7395043460165779483)，设置授权方式，填入创建好的多维表格 URL。 |\
| | |![Image=672x446](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e1ad915d77d74755a256356f2dea2dd3~tplv-goo7wpa0wc-image.image) |

#### 处理其他问题 {#ce6efe45}
此分支中有一个大模型节点，用于当用户咨询非产品问题时进行回复。
**实现方式：​**定义一个具备产品基础知识的回复助手。
![Image=200x498](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f712eb5813054cc79f7571e31388255a~tplv-goo7wpa0wc-image.image)
## 使用扣子智能客服模板 {#1c6f2819}
### 准备工作 {#60d9cded}
#### 创建飞书应用 {#a31d1506}
扣子助手智能体模板中使用飞书应用将智能体的用户问题写入到多维表格中。因此，你需要创建一个飞书应用。

1. 登录[飞书开发者后台](https://open.larkoffice.com/app?lang=zh-CN)。
2. 单击**创建企业自建应用**，根据引导完成应用创建。更多详细信息可参考[创建自建应用](https://open.feishu.cn/document/home/introduction-to-custom-app-development/self-built-application-development-process)。
   ![Image=600x142](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c451b573159a46f8848c0f60fc2cad48~tplv-goo7wpa0wc-image.image)
3. 在应用配置页面，单击**权限管理**，应用开通多维表格的读写（**新增记录**和**查看、评论、编辑和管理多维表格**）权限。
   ![Image=321x155](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/15663ad394a045fca8f6dee208266e3a~tplv-goo7wpa0wc-image.image)
4. 单击**版本管理与发布**，创建一个版本并完成应用发布。

#### 创建并配置飞书多维表格 {#3a411d83}
扣子助手智能体模板中使用飞书多维表格来记录用户问题，并使用飞书多维表格的 AI 能力自动实现问题分析。
![Image=703x259](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/85130e9694cd4e46bf8f02e5dbe8b696~tplv-goo7wpa0wc-image.image)
为了方便体验，你可以使用我们提供的多维表格模板，快速复制一个多维表格。

1. 访问[这里](https://ncpkm88jg5.feishu.cn/base/IRhBbIsCkaqxUSsS0GictKoLnze?from=from_copylink)打开小助手用户问题记录多维表格模板。
2. 单击**使用该模板**复制一个多维表格文档，并修改复制的多维表格名称。
3. 单击**设置**图标，选择**更多 > 添加文档应用**。
   ![Image=346x378](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/72b6eeb53106475bbada4154711130ae~tplv-goo7wpa0wc-image.image)
4. 在搜索框中输入上一步已发布的飞书应用名称，然后选中该应用，并给该应用授予**编辑**权限。
   ![Image=350x147](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7c4449da876f41ce9d54466476a9348c~tplv-goo7wpa0wc-image.image)

#### 配置表格数据同步 {#0ca8f2c8}
当小助手发布后，你可以将小助手记录在多维表格中的有效问题，通过自动化的方式自动同步到这个常见问题文档中。
我们可以借助飞书机器人指令模板来搭建一个数据同步流程，将小助手的多维表格问答记录中**添加为 FAQ** 数据标注为**是**的问答记录同步到一个常见问题的飞书表格中。

1. 创建一个飞书表格文档，并添加常见问题和解决方案两个字段。
   ![Image=310x210](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/63a0774b2ad949398d39081042abec64~tplv-goo7wpa0wc-image.image)
2. 访问飞书应用中心的[飞书机器人助手](https://app.feishu.cn/app/cli_9d4d38c2a8bd5102)，然后单击**打开**，根据引导完成应用安装。
3. 打开[飞书机器人助手页面](https://botbuilder.feishu.cn/home)。
4. 在**我的指令**页签下，找到**多维表格跨表数据同步**，然后单击**使用模板**。
   ![Image=546x198](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/abec794aaabd4a6e9affc34d06a8a276~tplv-goo7wpa0wc-image.image)
5. 在展示的指令配置页面，删除第一个节点。
6. 单击**触发器**选择框，然后选择**多维表格内容变更**。
   ![Image=373x234](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4924eee7cf504ed9bf5bc81fd688868e~tplv-goo7wpa0wc-image.image)
7. 单击**由数据表内容变更触发**文本框，然后选择用于记录小助手问答的多维表格，将条件设置为**添加为 FAQ** 为“是”时触发。
   ![Image=366x319](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/177e08be320640439678e357dadf417a~tplv-goo7wpa0wc-image.image)
8. 删除第二个节点，参考上述步骤，添加**新增电子表格记录**事件。
9. 单击**新增记录**文本框，然后选择步骤一中创建的飞书表格文档，将多维表格中记录的用户问题和回复写入到这个表格中。
   ![Image=373x216](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/821eb30f096b4cfa8bad7cb471837c3c~tplv-goo7wpa0wc-image.image)
10. 单击**启用**。
   ![Image=373x182](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c3240bfb92d9497f9fa8dc0e3e5957a8~tplv-goo7wpa0wc-image.image)
   启用后，每次当你将一条多维表格中记录的**添加为 FAQ** 标记为**是**时，该条记录就会自动写入到飞书表格中。
   完成以上准备工作后，你就可以通过扣子助手模板快速搭建一个智能客服智能体了。

### 步骤一：创建知识库 {#e622dc05}
RAG （Retrieval-Augmented Generation 检索增强生成）技术被广泛应用于问答类型的智能体搭建中。RAG 指的是在回答问题或生成文本时，先从大规模文档库中检索相关信息，然后利用这些检索到的信息来生成响应或文本，从而提高回复内容的质量。
RAG 的两个关键阶段：

* **检索阶段**：使用编码模型基于问题检索相关文档。
* **生成阶段**：使用检索到的上下文作为条件生成文本。

RAG 技术的应用可以很好地解决大模型的胡乱编造的问题，即让大模型在回答用户问题前先参考知识库中的相关内容，可极大抑制大模型的幻觉现象。
扣子的知识库功能支持上传外部数据，上传后可自动分段和编码，实现 RAG 对话。因此，在开始搭建客服智能体前，你需要先收集和整理要上传至知识库的产品资料。
当你准备好知识库内容后，可以先将这些资料上传至知识库。
####  上传在线资料 {#2a999de9}
参考以下操作，将产品相关的在线资料上传至扣子知识库中。本教程中以一个火山引擎产品的帮助文档为例。

1. 登录[扣子编程](https://code.coze.cn/home)。
2. 选择一个工作空间。单击**知识库**页签。
3. 在**知识库**页面，单击**创建知识库**。
4. 在**创建知识库**页面，选择**文本格式**，然后输入一个知识库名称，再选择**在线数据**，最后单击**下一步**。
   ![Image=270x407](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6f3be2da0fc04339a65a7fa7b9914199~tplv-goo7wpa0wc-image.image)
5. 选择**自动采集**，然后选择**批量添加**方式，输入帮助中心的地址，再单击**导入**。
6. 选择要导入的内容，然后单击**确认**。全部内容上传完成后，单击**下一步**。
   ![Image=261x405](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c609be664fd646ba97a791ae69ff26bb~tplv-goo7wpa0wc-image.image)
7. 分段方式选择**自动分段与清洗**，然后单击**下一步**。
   ![Image=333x256](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f2e734e6c5d044d6a122a75651d4ab74~tplv-goo7wpa0wc-image.image)
8. 单击**确认**完成知识库内容创建和分段。

#### 上传飞书表格文档 {#1ce34391}
在本模板中，需要添加一个表格文档记录产品使用的常见问题。这些常见问题从小助手的问答记录中整理而来，作为知识库内容提升问题回复的准确性和覆盖度。
参考以下操作创建表格文本知识库：

1. 在**知识库**页面，单击**创建知识库**。
2. 在**创建知识库**页面，选择**表格格式**，然后输入一个知识库名称，再选择**飞书表格**，最后单击**下一步**。
   ![Image=236x350](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f7faeeb2c82545308e28dc8ed6fdc205~tplv-goo7wpa0wc-image.image)
3. 如果你是第一次上传飞书文档，根据提示完成授权。
4. 选择已创建的飞书表格文档并选择自动更新频率，然后单击**下一步**。
   ![Image=484x125](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/387a6006326f404badac463a6ac7c62d~tplv-goo7wpa0wc-image.image)
5. 配置表格结构，将用户问题配置为索引列，然后单击**下一步**。
   ![Image=488x158](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2e48322396144156873b1bb21f2e0849~tplv-goo7wpa0wc-image.image)
6. 根据引导完成上传。

### 步骤二：复制并修模板配置 {#28c280ae}
完成知识库内容准备后，就可以复制模板进行智能体搭建了。
#### 2.1 复制模板 {#d1e6ac48}

1. 打开[扣子助手](https://www.coze.cn/template/agent/7416353271499096116?)智能体，然后单击**复制**。
   ![Image=424x226](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/305bade10ae144bca9df5ac1d06e4bdc~tplv-goo7wpa0wc-image.image)
2. 选择智能体的所属空间并输入一个智能体名称，然后单击**确定**。
3. 在复制的智能体编排页面，单击智能体名称旁的修改图标，修改智能体名称。
4. 根据实际需求，修改开场白文案和预置问题。
   ![Image=401x205](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/902d3d5033f545a9935dcefc09908376~tplv-goo7wpa0wc-image.image)

#### 2.2 修改工作流 {#785d3f27}

1. 进入复制的智能体。
2. 单击左侧搭建面板中的工作流。
3. 按需修改工作流配置。
   1. （可选）单击工作流名称旁边的修改图标，修改工作流名称。
      ![Image=487x66](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5371a2bc2600462e9b6484b89aec1c06~tplv-goo7wpa0wc-image.image)
   2. 找到工作流中的**意图识别**节点，展开**系统提示词**修改提示词内容。
      ![Image=200x565](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/97780c17596943a38cc1022696c98900~tplv-goo7wpa0wc-image.image)
   3. 找到工作流中的大模型节点，根据自己的实际需求修改大模型的提示词。
      ![Image=200x437](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d3a3af6e66ac4900be2926a04f6259f9~tplv-goo7wpa0wc-image.image)
   4. 找到工作流中的**知识库**节点，删除复制的知识库，添加上一步中准备好的知识库。
      ![Image=200x604](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/92513d41cd964c098109b88c7fabb9b6~tplv-goo7wpa0wc-image.image)
   5. 找到工作流中的**多维表格插件**节点，修改插件中的以下配置。
      * app_token：输入已创建的多维表格 URL。
      * records：引用**使用异步函数构建用户问题节点**的输出参数 records。
      * 授权方式：选择**单独授权**。详细说明，请参考[如何设置 OAuth 插件的授权模式？](/guides/plugin_node#79ba9ce6)。
         ![Image=475x186](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5421e8ade82f43a1b4aade904b51bd28~tplv-goo7wpa0wc-image.image)
   6. 单击**试运行**测试工作流，工作流测试通过后，再单击**发布**。

#### 2.3 测试并发布智能体 {#f2e18f4b}
完成工作流修改后，你就可以测试智能体效果并发布上线了。

1. 进入智能体编排页面。
2. 在右侧调试区域，输入问题进行测试。你也可以单击创建测试集，方便测试调优效果。
3. 完成测试后，单击**发布**将智能体发布到需要的渠道中。

### 步骤三：分析用户问题 {#a5645481}
根据工作流的配置，每次用户提交的问题都会写入到飞书多维表格中并通过 AI 能力自动完成分析。完成小助手发布上线后，你就可以对小助手的问答进行分析和总结了。

1. 打开记录小助手问答的多维表格查看用户问题记录。
   下图是根据模板创建的一个智能客服智能体的问答记录（记录的内容是通过工作流中的多维表格插件自动生成的），其中：
   * **用户问题**和 **Bot** **回复** 分别是用户提交的问题和智能体的回复内容。
   * **原始问答**、**分类**和**解决状态**都是通过多维表格的 AI 能力自动生成的。
   ![Image=608x95](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/754a7eeef1ca47debc145ee5d1142143~tplv-goo7wpa0wc-image.image)
2. 分析用户问答。如果某一个问答记录可以作为一个常见问题补充到扣子智能体知识库中，你可以将**是否添加为FAQ**设置为**是**。配置后，这条记录会自动同步到飞书常见问题文档中。
   * 打标后的多维表格文档示例。
      ![Image=583x111](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0f6085dc09df47faabbe6e393be45b48~tplv-goo7wpa0wc-image.image)
   * 自动同步后的常见问题文档示例。
      ![Image=580x234](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/37cdd73e1ffc4b708a93552de2be49d1~tplv-goo7wpa0wc-image.image)
3. 你也可以基于多维表格的仪表盘功能，对问答情况进行数据分析，查看问题分布和解决率等。