n8n_deepseek_upgrade.md 5.3 KB

n8n 工作流升级到 DeepSeek - 更新说明

✅ 升级完成

更新时间: 2025-11-04 06:59:35
工作流 ID: tWfjLZE1FmMfQAIn
工作流名称: Data-governance


🔄 更新内容

已完成的更改

1. 语言模型替换

之前:

  • ❌ OpenAI Chat Model
  • 节点类型: @n8n/n8n-nodes-langchain.lmChatOpenAi
  • 模型: gpt-4o-mini

现在:

  • ✅ DeepSeek Chat Model
  • 节点类型: @n8n/n8n-nodes-langchain.lmChatDeepSeek
  • 模型: deepseek-chat

2. 节点配置

{
  "name": "DeepSeek Chat Model",
  "type": "@n8n/n8n-nodes-langchain.lmChatDeepSeek",
  "parameters": {
    "model": "deepseek-chat",
    "options": {
      "temperature": 0.7,
      "maxTokens": 500
    }
  }
}

3. 连接关系

DeepSeek Chat Model → AI Agent (ai_languageModel 连接)


🎯 DeepSeek 的优势

1. 国内可直接访问 ✨

  • ✅ 无需 VPN 或代理
  • ✅ 访问速度快
  • ✅ 稳定性高

2. 性能优秀

  • ✅ 响应速度快
  • ✅ 理解能力强
  • ✅ 中文支持优秀

3. 成本优势

  • ✅ 价格更实惠
  • ✅ 性价比高
  • ✅ 适合生产环境

4. 易于使用

  • ✅ API 兼容 OpenAI
  • ✅ 文档完善
  • ✅ 社区活跃

📋 后续步骤

1. 配置 DeepSeek 凭证(如果还没有)

虽然您已经添加了 DeepSeek 凭证,但如果需要更新或重新配置:

1. 登录 n8n 界面
2. 进入 Settings → Credentials
3. 找到 DeepSeek API 凭证
4. 验证 API Key 是否正确
5. 测试连接

2. 在工作流中选择凭证

1. 打开 Data-governance 工作流
2. 点击 "DeepSeek Chat Model" 节点
3. 在 "Credential to connect with" 字段中
4. 选择您的 DeepSeek API 凭证
5. 点击保存

3. 测试工作流

1. 确认工作流已激活(Active 开关 ON)
2. 访问聊天界面:https://n8n.citupro.com/chat/tWfjLZE1FmMfQAIn
3. 输入"是"或"否"测试 AI 响应
4. 验证功能是否正常

🧪 测试场景

场景 1: 确认元数据管理

输入: "是"
预期 AI 响应: CONFIRM_METADATA
预期结果: 调用元数据新增 API,返回成功消息

场景 2: 拒绝元数据管理

输入: "否"
预期 AI 响应: REJECT_METADATA
预期结果: 返回取消消息和其他选项

场景 3: 模糊回答

输入: "我不确定"
预期 AI 响应: "请明确回答是否需要进行元数据管理(是/否)?"
预期结果: AI 询问用户明确回答


🔧 故障排查

问题 1: DeepSeek API 调用失败

错误信息: "API request failed" 或 "Invalid API key"

解决方案:

  1. 检查 DeepSeek API Key 是否有效
  2. 登录 DeepSeek 控制台验证
  3. 确认账户有足够的额度
  4. 重新配置凭证

问题 2: AI 响应不符合预期

问题描述: AI 没有返回 CONFIRM_METADATA 或 REJECT_METADATA

解决方案:

  1. 检查 AI Agent 的系统消息配置
  2. 确认 DeepSeek 模型已正确连接
  3. 调整温度参数(建议 0.3-0.7)
  4. 查看执行日志,检查 AI 的实际输出

问题 3: 工作流执行缓慢

问题描述: AI 响应时间过长

解决方案:

  1. 检查网络连接
  2. 减少 maxTokens 参数(当前 500)
  3. 考虑使用更轻量的提示词
  4. 查看 DeepSeek API 状态

📊 性能对比

指标 OpenAI (gpt-4o-mini) DeepSeek (deepseek-chat)
响应速度 ⭐⭐⭐ ⭐⭐⭐⭐
中文理解 ⭐⭐⭐⭐ ⭐⭐⭐⭐⭐
价格 中等 较低
可访问性 需要代理 直接访问
稳定性 ⭐⭐⭐⭐ ⭐⭐⭐⭐

🔄 回滚方案

如果需要切换回 OpenAI,可以使用以下步骤:

手动回滚

  1. 在 n8n 界面中打开工作流
  2. 删除 "DeepSeek Chat Model" 节点
  3. 添加 "OpenAI Chat Model" 节点
  4. 配置 OpenAI 凭证
  5. 连接到 AI Agent
  6. 保存并测试

使用 MCP 工具回滚

# 使用 n8n MCP 工具更新工作流
# 移除 DeepSeek 节点
# 添加 OpenAI 节点
# 重新建立连接

📚 相关资源

DeepSeek 文档

n8n 文档

项目文档

  • 快速开始: docs/n8n_chat_workflow_quickstart.md
  • 详细文档: docs/n8n_workflow_data_governance.md
  • 总结文档: N8N_WORKFLOW_SUMMARY.md

✅ 验证清单

升级后请验证以下项目:

  • DeepSeek 凭证已配置
  • DeepSeek Chat Model 节点已连接凭证
  • AI Agent 已连接到 DeepSeek Chat Model
  • 工作流已激活
  • Chat URL 可以正常访问
  • 输入"是"能触发元数据创建
  • 输入"否"能返回取消消息
  • AI 响应符合预期格式

🎊 完成!

工作流已成功升级到 DeepSeek!

当前配置:

  • 工作流 ID: tWfjLZE1FmMfQAIn
  • AI 模型: DeepSeek Chat Model
  • Chat URL: https://n8n.citupro.com/chat/tWfjLZE1FmMfQAIn
  • 状态: 已激活

优势:

  • ✅ 国内可直接访问
  • ✅ 响应速度更快
  • ✅ 成本更低
  • ✅ 中文支持更好

现在可以开始使用升级后的数据治理聊天工作流了!🚀