GitLab Duo Chat 故障排除
使用 GitLab Duo Chat 时，您可能会遇到以下问题。
GitLab Duo Chat 按钮未显示
如果按钮在用户界面右上角不可见， 请确保 GitLab Duo Chat 已启用。
GitLab Duo Chat 按钮在 已禁用 GitLab Duo 功能的群组和项目 中不会显示。
启用 GitLab Duo Chat 后，可能需要几分钟按钮才会出现。
如果这不起作用，您还可以查看以下故障排除文档：
- GitLab Duo Code 建议。
- VS Code。
- Microsoft Visual Studio。
- JetBrains IDEs。
- Neovim。
- Eclipse。
- GitLab Duo 故障排除。
- GitLab Duo 自托管故障排除。
错误 M2000
您可能会收到一个错误，提示
抱歉，我找不到任何文档来回答您的问题。错误代码：M2000。
当聊天无法找到相关文档来回答您的问题时，会发生此错误。如果搜索查询与任何可用文档不匹配，或者文档搜索功能存在问题，都可能出现这种情况。
请重试或参考 GitLab Duo Chat 最佳实践文档 来优化您的问题。
错误 M3002
您可能会收到一个错误，提示
抱歉，我无法访问您询问的信息。群组或项目所有者已在此群组或项目中关闭了 Duo 功能。错误代码：M3002。
当您询问属于已关闭 GitLab Duo 功能 的项目或群组中的项目时，会发生此错误。
如果 GitLab Duo 未启用，GitLab Duo Chat 无法处理群组或项目中项目（如问题、史诗和合并请求）的信息。
错误 M3003
您可能会收到一个错误，提示
抱歉，我无法生成响应。您可能想重试。您收到此错误可能是因为您询问的项目不存在、您无权访问它们，或者您的会话已过期。错误代码：M3003。
当以下情况发生时，会出现此错误：
- 您询问 GitLab Duo Chat 无权访问的项目（如问题、史诗和合并请求），或者询问不存在的项目。
- 您的会话已过期。
请重试，询问您有权访问的项目。如果您继续遇到问题，可能是由于会话已过期。要继续使用 GitLab Duo Chat，请重新登录。有关更多信息，请参阅 控制 GitLab Duo 可用性。
错误 M3004
您可能会收到一个错误，提示
抱歉，我无法生成响应。您无权使用 GitLab Duo Chat。错误代码：M3004。
当您尝试访问 GitLab Duo Chat 但没有所需权限时，会发生此错误。
请确保您有 使用 GitLab Duo Chat 的权限。
错误 M3005
您可能会收到一个错误，提示
抱歉，您的问题在您的 Duo Pro 订阅中不受支持。您可以考虑升级到 Duo Enterprise。错误代码：M3005。
当您尝试访问 GitLab Duo Chat 中未包含在您的 GitLab Duo 订阅级别中的工具时，会发生此错误。
请确保您的 GitLab Duo 订阅级别 包含所选工具。
错误 M3006
您可能会收到一个错误，提示
抱歉，您没有使用 Duo Chat 所需的 GitLab Duo 订阅。请联系您的管理员。错误代码：M3006。
当 GitLab Duo Chat 未包含在您的 GitLab Duo 订阅中时，会发生此错误。
请确保您的 GitLab Duo 订阅级别 包含 GitLab Duo Chat。
错误 M4000
您可能会收到一个错误，提示
抱歉，我无法生成响应。请重试。错误代码：M4000。
当处理斜杠命令请求时出现意外问题时，会发生此错误。请重试您的请求。如果问题仍然存在，请确保您的命令语法正确。
有关斜杠命令的更多信息，请参阅文档：
错误 M4001
您可能会收到一个错误，提示
抱歉，我无法生成响应。请重试。错误代码：M4001。
当在查找完成您请求所需的信息时出现问题时，会发生此错误。请重试您的请求。
错误 M4002
您可能会收到一个错误，提示
抱歉，我无法生成响应。请重试。错误代码：M4002。
当在回答 与 CI/CD 相关的问题 时出现问题时，会发生此错误。请重试您的请求。
错误 M4003
您可能会收到一个错误，提示
此命令用于解释漏洞，只能从漏洞详情页面调用。 或
漏洞解释目前仅支持由 SAST 报告的漏洞。错误代码：M4003。
当使用 解释漏洞 功能时出现问题。
错误 M4004
您可能会收到一个错误，提示
此资源没有可总结的评论。
当使用 总结讨论 功能时出现问题。
错误 M4005
您可能会收到一个错误，提示
没有可排查的作业日志。 或 此命令用于排查作业，只能从失败的作业日志页面调用。。
当使用 排查作业 功能时出现问题。
错误 M5000
您可能会收到一个错误，提示
抱歉，我无法生成响应。请重试。错误代码：M5000。
当处理与项目（如问题、史诗和合并请求）相关的内容时出现问题，会发生此错误。请重试您的请求。
错误 A1000
您可能会收到一个错误，提示
抱歉，我无法及时响应。请重试。错误代码：A1000。
当处理过程中发生超时时，会发生此错误。请重试您的请求。
错误 A1001
您可能会收到一个错误，提示
抱歉，我无法生成响应。请重试。错误代码：A1001。
此错误表示处理您请求的 AI 服务遇到了问题。
可能的原因：
- 由 GitLab 代码中的错误引起的客户端错误。
- 由 Anthropic 代码中的错误引起的服务器端错误。
- 未到达 AI 网关的 HTTP 请求。
存在一个问题 以更清楚地说明错误的原因。
要解决此问题，请重试您的请求。
如果错误仍然存在，请使用 /clear 命令重置聊天。
如果问题继续存在，请向 GitLab 支持团队报告问题。
错误 A1002
您可能会收到一个错误，提示
抱歉，我无法及时响应。请重试。错误代码：A1002。
当从 AI 网关未返回事件或 GitLab 无法解析事件时，会发生此错误。请重试您的请求。
错误 A1003
您可能会收到一个错误，提示
抱歉，我无法及时响应。请重试。错误代码：A1003。
当从 AI 网关的流式响应失败时，会发生此错误。请重试您的请求。
错误 A1004
您可能会收到一个错误，提示
抱歉，我无法及时响应。请重试。错误代码：A1004。
当 AI 网关进程发生错误时，会发生此错误。请重试您的请求。
错误 A1005
您可能会收到一个错误，提示
抱歉，您输入的提示词过多。请在询问下一个问题之前运行 /clear 或 /reset。错误代码：A1005。
当提示词长度超过 LLM 的最大 token 限制时，会发生此错误。使用 /new 命令开始新的对话，然后重试您的请求。
错误 A1006
您可能会收到一个错误，提示
抱歉，Duo Chat 代理在找到您问题的答案前达到了限制。请尝试不同的提示词或使用 /clear 清除您的对话历史。错误代码：A1006。
当 ReAct 代理无法为您的查询找到解决方案时，会发生此错误。请尝试不同的提示词或使用 /clear 清除您的对话历史。
错误 A6000
您可能会收到一个错误，提示
抱歉，我无法及时响应。请尝试更具体的请求或输入 /clear 开始新的聊天。错误代码：A6000。
当 GitLab Duo Chat 出现问题时，会发生此回退错误。
请尝试更具体的请求，输入 /clear 开始新的聊天，或提供反馈以帮助我们改进。
错误 A9999
您可能会收到一个错误，提示
抱歉，我无法及时响应。请重试。错误代码：A9999。
当 ReAct 代理中发生未知错误时，会发生此错误。请重试您的请求。
错误 G3001
您可能会收到一个错误，提示
抱歉，回答这个问题需要不同的 Duo 订阅。请联系您的管理员。。
当 GitLab Duo Chat 在您的订阅中不可用时，会发生此错误。 请尝试不同的请求并联系您的管理员。
标头不匹配问题
您可能会收到一个错误，提示 抱歉，我无法生成响应。请重试，没有具体的错误代码。
检查 Sidekiq 日志，看是否能找到以下错误：Header mismatch 'X-Gitlab-Instance-Id'。
如果您看到此错误，请联系 GitLab 支持团队，请他们为您发送新的许可证激活码。
有关更多信息，请参阅 问题 103。
检查 Cloud Connector 的健康状况
我们创建了一个脚本来验证 Cloud Connector 相关的各种组件的状态，例如：
- 访问数据
- 令牌
- 许可证
- 主机连接性
- 功能可访问性
您可以在调试模式下运行此脚本，以获得更详细的输出并生成报告文件。
-
通过 SSH 连接到您的单节点实例并下载脚本：
wget https://gitlab.com/gitlab-org/gitlab/-/snippets/3734617/raw/main/health_check.rb -
使用 Rails Runner 执行脚本。
确保使用脚本的完整路径。
用法：gitlab-rails runner 完整路径/to/health_check.rb --debug 启用调试模式 --output-file <文件路径> 将报告写入指定文件 --username <用户名> 提供用户名来测试席位分配 --skip [检查] 跳过特定检查（选项：access_data, token, license, host, features, end_to_end）