Dify 接入 kukuai.fyi

把 kukuai.fyi 接入 Dify 平台、Chatflow、Workflow 和知识库的逐步教程。

在 Dify 模型供应商里添加 kukuai.fyi。
把模型应用到普通聊天应用。
在 Workflow / Chatflow 里验证 LLM 节点。
把知识库相关模型和聊天模型拆开排查。

准备工作

checklisttext

1. 已有 Dify 管理员权限
2. 已准备 kukuai.fyi API Key
3. 已确认聊天模型 ID
4. 如果要做知识库，另外确认 embedding 模型
5. 已准备一个最小应用用于测试

第一步：添加模型供应商

进入 Dify 后台的模型供应商设置，新增 OpenAI 兼容供应商。

providertext

Provider: OpenAI Compatible
API Key: sk-你的-kukuai-api-key
API Base URL: https://www.kukuai.fyi/api-proxy/china/v1
Model Type: LLM
Model Name: gpt-5-2-chat-latest 或 claude-sonnet-4-6

第二步：接入应用

供应商保存成功后，再把模型挂到具体应用里。

app-setuptext

1. 打开 Dify 控制台
2. 进入 Settings / Model Provider
3. 新增 OpenAI Compatible Provider
4. 填入 kukuai.fyi API Key
5. Base URL 填 https://www.kukuai.fyi/api-proxy/china/v1
6. 保存后进入应用
7. 在应用模型设置里选择刚才添加的模型
8. 发起一次最小对话测试

第三步：接入工作流

Dify 工作流排障要从单节点开始。先让 LLM 节点独立成功，再接知识库、HTTP 工具或变量处理。

workflowtext

1. 新建 Chatflow 或 Workflow
2. 在 LLM 节点选择 kukuai.fyi 模型
3. 输入一个固定测试问题
4. 运行节点，观察输出和错误信息
5. 再逐步加入知识库、工具和复杂 Prompt

知识库配置

knowledgetext

知识库场景需要分开配置：

Chat Model: 负责最终回答
Embedding Model: 负责文档向量化
Rerank Model: 负责结果重排，可按需要配置

不要只配置聊天模型就直接导入大量知识库。先用 1-2 个短文档验证切块、召回和回答效果。

验证方式

在模型供应商页面保存并测试连接。
在普通聊天应用里发一条最短问题。
在 Workflow 里单独运行 LLM 节点。
如果使用知识库，只导入一个短文档做第一次验证。

排障清单

troubleshootingtext

1. Provider 保存失败
   - 检查 Base URL 是否为 https://www.kukuai.fyi/api-proxy/china/v1
   - 检查 API Key 是否完整

2. 应用里看不到模型
   - 确认模型已添加到 Dify Provider
   - 手动输入真实模型 ID

3. Workflow 节点报错
   - 先单独测试 LLM 节点
   - 再接知识库或工具节点

4. 知识库回答不准
   - 调整切块大小
   - 检查 embedding 模型是否配置
   - 减少一次性导入的文档量

5. 成本不清楚
   - 到 kukuai.fyi 控制台查看人民币余额和真实扣费

Dify 接入 kukuai.fyi ​

准备工作 ​

第一步：添加模型供应商 ​

第二步：接入应用 ​

第三步：接入工作流 ​

知识库配置 ​

验证方式 ​

排障清单 ​

下一步 ​