教程:构建客服 Agent
在团队中构建一个可引用知识库并调用网页搜索的客服 Agent
完成本教程后,你将得到一个能回答产品问题、引用内部文档、在需要时查询网页并显示运行来源的客服 Agent。
前置条件
已登录 Clouisle;当前团队有启用的 chat 模型;已有可用知识库,或先按创建知识库建立。网页搜索需要服务端配置 TAVILY_API_KEY。
最终结果
客服 Agent 处于已发布状态,拥有系统提示词、一个关联知识库、网页搜索工具和至少一个建议问题。

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

步骤 2:编写提示词
明确引用优先级和不确定时的升级规则,减少模型在知识库没有答案时编造。
在提示词填入:
你是 Clouisle 产品客服助手。
优先根据关联知识库回答,并在有来源时给出引用。
知识库没有足够信息时,明确说明不确定,不要编造版本、配置或价格。
只有用户要求最新外部信息时才使用网页搜索。
回复使用简体中文,先给结论,再给步骤。保存并在预览中发送一个产品问题。
步骤 3:关联知识库
知识库把客服答案绑定到企业可审阅的事实来源。
- 在知识库卡片选择添加。
- 选择目标知识库。
- 使用
hybrid检索,Top K 使用5,阈值使用0.3。 - 保存。

步骤 4:启用网页搜索
外部搜索只用于知识库之外的时效信息,避免所有问题都依赖实时网络。
- 在工具选择添加。
- 选择内置
web_search。 - 如果显示需要配置,联系管理员配置 Tavily API Key。
- 保存并测试一个需要外部信息的问题。
步骤 5:发布并验收
- 用内部文档问题验证引用。
- 用时效问题验证工具调用。
- 用知识库没有覆盖的敏感问题验证拒答或不确定说明。
- 选择发布,打开公开页面。
- 在 Agent 日志确认会话、来源、工具结果和 Token。
验收标准
内部问题有来源;外部问题只在需要时触发 web_search;工具失败显示错误而不是伪造成功;Agent 公开页可以继续多轮对话。
这篇文章对你有帮助吗?