Dify
支持能力
- LLM：将 Dify Chat App 作为 LiveKit Agent 的文本模型。
- 支持 Dify 会话延续、稳定用户标识和应用开场白。
- 插件不提供 STT、TTS 或 RealtimeModel；语音 Agent 需搭配其他插件。
安装与 API Key
在 Dify 应用的“访问 API / API Access”页面创建 Service API Key：
自托管 Dify 通常把 DIFY_API_BASE 设置为 https://your-domain/v1。
基础使用
构造参数：
| 参数 | 来源 / 默认值 | 说明 |
|---|---|---|
api_key | DIFY_API_KEY | 应用 Service API Key |
api_base | DIFY_API_BASE 或 https://api.dify.ai/v1 | API 根地址 |
user | DIFY_USER 或 test_user | 终端用户稳定标识 |
搭配语音组件
Dify 只提供 LLM，完整语音 Agent 仍需 STT 与 TTS：
会话与用户
插件会把最新用户消息发送到 Dify Chat API，并维护 Dify 返回的会话 ID。user 应满足：
- 同一终端用户跨轮次保持稳定。
- 不包含手机号、邮箱或其他直接身份信息。
- 不同租户或用户之间不能复用同一个 ID，否则会话历史可能串线。
如 Dify 应用配置了开场白，可以调用：
限制
- 当前适配器面向 Dify Chat App，不是 Dify Workflow 的通用执行器。
- LiveKit 工具不会自动转换成 Dify 工具；工具应在 Dify 应用内配置，或由 Agent 层执行。
- API Key 必须放在服务端。Dify 官方同样建议不要在浏览器或客户端保存 Service API Key。