接入 Dify

最近更新时间:2025-06-19 11:49:42

我的收藏
提示:
腾讯云联络中心语音智能体功能目前内测中,您可以点击 问卷链接 提供您的使用场景等信息,我们会根据您提供的信息邀请您参与内测。

场景说明

腾讯云联络中心语音智能体支接入开源 Agent 构建平台 Dify 实现流程编排、知识库检索能力,您可参见 Dify 官方文档 了解更多 Dify 的产品介绍。
以下文档介绍接入 Dify 所需的3个步骤。

操作步骤

步骤1:新建 Dify 应用并验证效果

您可参见 Dify 构建应用指引Dify 构建工作流指引 新建 Dify 应用并完成调试与发布。如果需要搭建简单客服场景问答机器人可参见 Dify 搭建客服机器人实践教程
在调试时除对话效果外您需重点关注时延消耗,您可在 运行日志 中查看每轮对话时延。由于联络中心的语音合成均采用流式输出,所以您仅需关注生成首句文本的时延,一般将首文本的时延控制在1.5秒内可实现较流畅的实时通话体验。您可尝试简化工作流链路、接入私有部署大模型、本地部署 Dify 等方式降低时延。

步骤2:实现挂断和转人工

1. 在插件库中添加 Dify 腾讯云联络中心官方插件。
1.1 如果在通话过程中需要智能体主动挂断电话或转人工,您需先下载 Dify 腾讯云联络中心官方插件。完成下载后前往 Dify 插件市场,单击安装插件 > 本地插件,上传已下载的 Dify 腾讯云联络中心官方插件 tccc.difypkg。

说明:
若您在上传插件时遇到“PluginDaemonBadRequestError: plugin verification has been enabled, and the plugin you want to install has a bad signature”报错,可参见 Dify 常见问题 解决。

1.2 上传成功后插件市场会展示腾讯云联络中心工具,打开该工具后单击去授权

1.3 设置授权弹窗填写腾讯云 SecretId 和 SecretKey 并单击保存。其中 SecretId 和 SecretKey 的具体获取方式可参见 主账号访问密钥管理

1.4 保存验证无误后将显示操作成功的弹窗。

2. 在应用中添加腾讯云联络中心的挂断通话转人工座席工具。
2.1 首先在开始节点中需要添加 tccc_dify_sdkappidtccc_dify_sessionid 两个固定变量。

2.2 在工具中可添加腾讯云联络中心的挂断通话转人工座席

2.3 在转人工座席工具中,应用 ID 和会话 ID 分别引用在开始节点中配置的 tccc_dify_sdkappidtccc_dify_sessionid,技能组 ID 中填写需转接的客服技能组的 ID(可在 技能组管理 中查看)。

2.4 在挂断通话工具中,应用 ID 和会话 ID 分别引用在开始节点中配置的 tccc_dify_sdkappidtccc_dify_sessionid


步骤3:绑定 Dify 应用至腾讯云联络中心智能体

1. 访问 腾讯云联络中心 TCCC 管理工作台,左侧导航栏单击智能体管理,单击新建空白智能体后切换模型至 Dify,并填写 Dify 应用的 API Url 和 API KEY,获取方式可参见 Dify API 文档

2. 校验成功后单击新建进入智能体配置页,您可在配置页调试语音交互效果,具体可参见 调试语音交互