¶ 把手教你用 Arcs-mini 接入 Dify
¶ 前言
Dify 是一个开源的LLM（大语言模型）应用开发平台，其定位是打造以可视化和低代码/零代码为核心的一站式AI应用开发解决方案。它融合了后端即服务与LLMOps的理念，支持快速构建、部署和管理基于大语言模型的应用程序。Dify 企业级能力涵盖了强大的RAG（检索增强生成）引擎、AI工作流编排以及多模型集成与管理等核心组件。相信许多开发者也希望了解如何将具体的模型或服务与该平台进行集成。
此外，通过 Dify 也可以接入 OpenAI 而无需考虑代理问题，只需在 Dify 中安装 OpenAI 插件并配置 API-KEY 即可。同时，LSPlatform 平台能够通过自定义编排实现直接接入 OpenAI 的大模型，但是需要自行解决代理问题。
这里就以接入DeepSeek大模型并在Dify上创建一个简单的AI应用为例，演示一下基础接入步骤，大家可以参考以下流程进行操作即可。
¶ 云端服务接入 Dify
¶ 一、 创建应用
登录 LSplatform，创建新应用
创建成功后在弹出的界面进入应用编排服务。
¶ 二、 导入工程
-
下载工程示例：Dify 示例.json
-
导入工程示例：选择
Dify 示例.json文件导入
若提示“您要导入的某些节点已经存在于工作空间中。”，则选择“导入副本”即可。
¶ 三、 链路说明
示例中包含 3 条链路，分别为
- 链路 1: 可通过注入节点调用 Dify 节点，并将结果输出到 output1。
- 链路 2: 可通过 web 对话页调用 Dify 节点，最终将大模型结果输出到对话页面上。
- 链路 3: 可通过开发板调用 Dify 节点，最终将大模型输出的结果进行语音合成实现端侧播报。
其中:
【prompt】节点用于添加提示词。
【构造tts输入】节点用于调整音色、语速以及"请稍后"提示语。
【keepalive】节点用于保持端云链路的连接，如果没有该节点您的 第三方大模型 响应时间超过 5s 将会下发音频失败
¶ 四、 配置参数
- 参数说明：
- API-KEY：Dify 的 API-KEY 获取链接：Dify 开放平台
- protocol:
https(根据Dify官网的接口文档填写) - Host:
api.dify.ai(根据Dify官网的接口文档填写,如果您是私有部署的Dify, 则填写您自有的域名) - Path:
/v1/chat-messages(根据Dify官网的接口文档填写) - Timeout: 超时时间，单位ms
- Stream：是否流式返回
¶ 五、 部署验证
-
在完成参数配置，进入完整体验之前，我们可以简单测试验证，验证是否成功调用 Dify。
-
部署成功后关闭当前编排服务
-
重启应用
¶ 六、 测试链路
-
链路1：调用接口
重启应用后，再次点开【编排应用】，点击注入，会触发一次Dify子流程调用，标记 2 的红框中输出类似日志即代表成功建立链接。
-
链路2： web 对话页面
回到【我的应用】，双击Arcs-mini-Dify应用，在弹出的应用详情页面点击右上角分享按钮打开 web 验证配置，该配置页包含测试地址和访问密码。
-
访问 web 验证页面链接，在打开的 web 页即可与 Dify 对话
-
链路3：语音交互
在进行语音交互之前，需要将 Arcs-mini 接入 Dify，具体操作步骤如下：
¶ Arcs-mini 接入 Dify
云端接入 Dify 成功后，要想在 Arcs-mini 上进行语音交互，需要把对接了 Dify 的云端服务跟指定开发板绑定。
请确保已经根据文档《应用功能说明》的【网络配置】章节的步骤成功配网。
¶ 一、 Arcs-mini 接入您的应用
完成云端配置后，需将产品ID（product ID）与密钥（secret ID）写入设备，才能让设备连接对应的产品并完成鉴权服务。
使用数据线连接 Arcs-mini 后，打开终端，通过命令 adb shell device set_pid 和adb shell device set_sid指令可以分别配置开发板接入的大模型应用 product ID 及其密钥，示例如下：
adb shell device set_pid 71cd1721-xxx-xxx-xxx-1000055c8b2f
adb shell device set_sid cb09013f-xxx-xxx-xxx-e212b32f9218
最后，通过命令 adb shell reboot hard 重启设备就成功接入云端的自建应用。
¶ 二、 通过语音交互验证是否接入
最后，用 小聆小聆唤醒，并提问 你是谁，语音回复 Dify 即可确认接入成功。
本文使用的聆思Arcs-mini开发板的详细信息可参考线上文档: https://docs2.listenai.com/x/Ml1uU-api
¶ 附：申请 Dify API-KEY
如果您没有 Dify 的 API-KEY 的话，可以按照以下步骤申请：
-
登录注册 Dify 官网
-
安装【OpenAI】插件
如果您没有 OpenAI 的 API-KEY 也可以使用 Deepseek 插件，填入 Deepseek 的 API-KEY
-
插件填写 OpenAI 的 API-KEY
-
创建【聊天助手】应用
-
获取 API 密钥
-
填写API密钥
