ClouisleClouisle

教程:构建客服 Agent

在团队中构建一个可引用知识库并调用网页搜索的客服 Agent

完成本教程后,你将得到一个能回答产品问题、引用内部文档、在需要时查询网页并显示运行来源的客服 Agent。

前置条件

已登录 Clouisle;当前团队有启用的 chat 模型;已有可用知识库,或先按创建知识库建立。网页搜索需要服务端配置 TAVILY_API_KEY

最终结果

客服 Agent 处于已发布状态,拥有系统提示词、一个关联知识库、网页搜索工具和至少一个建议问题。

客服 Agent 成品
客服 Agent 成品

步骤 1:创建 Agent

先建立资源外壳,后续步骤才能在同一 Agent 中配置知识和工具。
  1. 打开应用 > 创建应用 > Agent
  2. 名称填写 客服助手,描述填写服务范围。
  3. 选择一个团队已授权的 chat 模型。
  4. Agent 设置保存。
客服 Agent 创建结果
客服 Agent 创建结果

步骤 2:编写提示词

明确引用优先级和不确定时的升级规则,减少模型在知识库没有答案时编造。

提示词填入:

你是 Clouisle 产品客服助手。
优先根据关联知识库回答,并在有来源时给出引用。
知识库没有足够信息时,明确说明不确定,不要编造版本、配置或价格。
只有用户要求最新外部信息时才使用网页搜索。
回复使用简体中文,先给结论,再给步骤。

保存并在预览中发送一个产品问题。

步骤 3:关联知识库

知识库把客服答案绑定到企业可审阅的事实来源。
  1. 知识库卡片选择添加
  2. 选择目标知识库。
  3. 使用 hybrid 检索,Top K 使用 5,阈值使用 0.3
  4. 保存。
客服 Agent 的知识库绑定
客服 Agent 的知识库绑定

步骤 4:启用网页搜索

外部搜索只用于知识库之外的时效信息,避免所有问题都依赖实时网络。
  1. 工具选择添加
  2. 选择内置 web_search
  3. 如果显示需要配置,联系管理员配置 Tavily API Key。
  4. 保存并测试一个需要外部信息的问题。

步骤 5:发布并验收

  1. 用内部文档问题验证引用。
  2. 用时效问题验证工具调用。
  3. 用知识库没有覆盖的敏感问题验证拒答或不确定说明。
  4. 选择发布,打开公开页面
  5. 在 Agent 日志确认会话、来源、工具结果和 Token。

验收标准

内部问题有来源;外部问题只在需要时触发 web_search;工具失败显示错误而不是伪造成功;Agent 公开页可以继续多轮对话。

这篇文章对你有帮助吗?

本页目录