# 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 本身是否有效

运行测试脚本：

```bash
python scripts/test_cohere_api_key.py 4pLcF0CGE7LeDmAudBQHdvAxGaKwNOKfxUGkHb5C
```

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

如果测试失败，说明 API Key 本身有问题，需要：
- 检查 Cohere Dashboard: https://dashboard.cohere.com/
- 确认 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: 使用脚本重新创建

```bash
# 删除旧凭证并创建新凭证
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`