Home Verkennen Help
Inloggen
mxl_citu
/
DataOps-platform
1
0
Vork 0
Bestanden Issues 0 Pull-aanvragen 0 Wiki
Boom: c88a079f14
Aftakkingen Labels
DataOps-plat...
/
docs
/
n8n_cohere_credential_troubleshooting.md

n8n_cohere_credential_troubleshooting.md 4.9 KB
Geschiedenis Ruwe

n8n Cohere API Key 凭证故障排除指南

🔴 错误信息

Couldn't connect with these settings
Forbidden - perhaps check your credentials?

✅ 已完成的修复

新凭证 ID: Trtn1MtQhDwHYoPO
凭证名称: Cohere API Key
创建时间: 2026-01-19T03:55:55.019Z

旧凭证 xpFKP9JT4PmYZw61 已删除，新凭证已创建。

🔍 问题诊断步骤

步骤 1: 验证 API Key 本身是否有效

运行测试脚本：

python scripts/test_cohere_api_key.py 4pLcF0CGE7LeDmAudBQHdvAxGaKwNOKfxUGkHb5C

预期结果: 应该返回 成功: True 和 状态码: 200

如果测试失败，说明 API Key 本身有问题，需要：

步骤 2: 检查 n8n 凭证配置

  1. 访问凭证管理页面: https://n8n.citupro.com/home/credentials
  2. 找到 "Cohere API Key" 凭证（ID: Trtn1MtQhDwHYoPO）
  3. 点击打开凭证详情
  4. 检查 API Key 字段：
    • 确保没有多余的空格
    • 确保没有换行符
    • 确保完整复制了所有字符

步骤 3: 在工作流中重新选择凭证

  1. 打开使用 Cohere Reranker 节点的工作流
  2. 点击 Reranker Cohere 节点
  3. 在 "Credential to connect with" 字段中：
    • 先选择 "None"（清除旧凭证）
    • 保存节点
    • 再次打开节点
    • 选择 "Cohere API Key" 凭证
  4. 保存节点配置

步骤 4: 测试节点连接

  1. 在 Reranker Cohere 节点配置中，点击 "Test step" 或 "Execute Node"
  2. 观察是否还有 "Forbidden" 错误

🛠️ 常见原因和解决方案

原因 1: API Key 格式问题

症状: API Key 在复制时可能包含隐藏字符

解决方案:

  1. 在 n8n 凭证编辑页面，完全删除 API Key 字段内容
  2. 重新输入 API Key（不要复制粘贴，手动输入）
  3. 或者使用脚本重新创建凭证

原因 2: 凭证缓存问题

症状: 即使更新了凭证，节点仍然使用旧配置

解决方案:

  1. 在工作流中，先断开凭证连接（选择 "None"）
  2. 保存工作流
  3. 重新打开节点，选择新凭证
  4. 保存工作流

原因 3: Cohere 账户权限问题

症状: API Key 有效，但某些功能被限制

解决方案:

  1. 检查 Cohere Dashboard 中的账户状态
  2. 确认账户是否有使用 Reranker API 的权限
  3. 检查 API 使用限制和配额

原因 4: n8n 版本兼容性问题

症状: 凭证类型不被识别

解决方案:

  1. 检查 n8n 版本是否支持 Cohere 节点
  2. 确保安装了 @n8n/n8n-nodes-langchain 包
  3. 更新 n8n 到最新版本

🔧 手动修复步骤

如果脚本修复不起作用，请手动修复：

方法 1: 通过 Web UI 更新凭证

  1. 访问: https://n8n.citupro.com/home/credentials
  2. 找到 "Cohere API Key" 凭证
  3. 点击编辑
  4. 在 API Key 字段中：
    • 完全删除现有内容
    • 重新输入: 4pLcF0CGE7LeDmAudBQHdvAxGaKwNOKfxUGkHb5C
    • 注意: 确保没有前后空格
  5. 点击 "Test connection" 或 "Save"
  6. 如果测试失败，检查错误信息

方法 2: 删除并重新创建凭证

  1. 访问凭证管理页面
  2. 删除现有的 "Cohere API Key" 凭证
  3. 创建新凭证：
    • 类型: Cohere API
    • 名称: Cohere API Key
    • API Key: 4pLcF0CGE7LeDmAudBQHdvAxGaKwNOKfxUGkHb5C
  4. 保存并测试

方法 3: 使用脚本重新创建

# 删除旧凭证并创建新凭证
python scripts/update_n8n_cohere_credential.py --recreate

# 或者指定要删除的凭证 ID
python scripts/update_n8n_cohere_credential.py --recreate --credential-id <旧凭证ID>

📋 验证清单

完成修复后，请验证以下项目：

  • API Key 测试脚本返回成功
  • n8n 凭证配置中 API Key 正确（无空格、无换行）
  • 工作流节点已选择正确的凭证
  • 节点测试/执行不再报 "Forbidden" 错误
  • 可以正常使用 Reranker 功能

🆘 如果问题仍然存在

如果按照以上步骤操作后问题仍然存在，请检查：

  1. 网络连接: 确保 n8n 服务器可以访问 api.cohere.ai
  2. 防火墙规则: 检查是否有防火墙阻止了 API 请求
  3. Cohere 服务状态: 检查 Cohere 服务是否正常运行
  4. n8n 日志: 查看 n8n 服务器日志获取详细错误信息

获取详细错误信息

  1. 在 n8n 工作流编辑器中，点击失败的节点
  2. 查看 "Execution Data" 或 "Error" 标签
  3. 复制完整的错误信息
  4. 检查错误堆栈和详细信息

📞 联系支持

如果问题持续存在，请提供以下信息：

  1. n8n 版本号
  2. Cohere API Key 测试结果（使用测试脚本）
  3. 完整的错误信息（从 n8n 节点执行结果中复制）
  4. 凭证配置截图（隐藏 API Key 敏感部分）

最后更新: 2026-01-19
凭证 ID: Trtn1MtQhDwHYoPO