如果人工智能专员工作区与另一个系统之间的整合行为不符合预期，您可能需要进行故障排除。本文概述了可以执行的一些故障排除步骤，以尝试识别整合问题。
本文章包含以下主题：
相关文章：
在整合生成器中测试整合
要对整合进行故障排除，首先应在整合生成器中对其进行测试。确保您收到回复，并在会话参数中看到正确的数据。
检查请求参数是否匹配
您在整合生成器中使用的请求参数（无论是在 URL 查询、正文还是标头中）都必须与在对话中捕获的参数完全匹配。
确保满足以下条件：
- 没有拼写错误。
- 如果您在对话的任意阶段更新了参数的拼写或名称，您也将在整合中进行更新。
- 大小写完全匹配。参数区分大小写。
提示：我们建议您对所有请求或会话参数采用一致的命名规则，例如小写的CamelCase 或 snake_case。
检查对话日志以了解会话参数
检查对话日志以获取更多信息，例如会话数据。您可以使用 API 通过筛选标签来搜索对话。如果对话使用 API，那么您将可以搜索它。
在对话日志中，单击左上角的添加筛选。
在左侧菜单中，导航到标签。
在这里，您可以按名称和场景（例如整合是否成功、失败或是否有 API 错误）筛选整合。
在整合生成器中构建的整合将以 API 为前缀，后跟整合的名称，最后以场景名称结尾。
以下屏幕截图中的一个示例是 API-Chloe 演示：Apple 购物车-成功：
- API = 前缀
- Chloe 演示：Apple 购物车 = 整合的名称
- 成功 = 场景名称
作为快速查看整合，您还可以将鼠标悬停在对话日志的标签符号上，以查看与对话关联的标签。
如果您只想查看与 API 的对话出错的原因，请在标签搜索中搜索 apiError。
然后，选择您的对话以查看更多信息。
处于对话中时，您可以查看会话数据中存在的内容。
单击右上角的 Details（详情）。
单击此按钮后，您将看到“对话概览”。接下来，单击会话数据。
现在您可以在在线交谈中查看会话数据。出于兴趣，我们在底部看到来自 API 整合的会话参数。
检查对话以了解会话参数
要快速检查会话参数是否存在，您可以通过对话将其记录在人工智能专员消息中。在过渡环境中测试对话时，这样做最安全；如果整合是实时的，请确保不要在测试时保存对话。
在下面的人工智能专员消息中，会话参数将被记录下来，以便在测试时可见。
将原始值输出到失败场景
通过将“data”包装在函数“$string(data)”中，将响应中所有数据组成一个字符串。然后在测试时将其记录在失败场景中，以便快速查看返回的内容。
检查 HTTP 状态代码
测试整合时，请务必检查返回的 http 状态代码。您可在右侧响应中看到，键值为“statusCode”。
2xx：成功
-
200 OK：请求成功，服务器以预期的数据响应。
- 这是测试整合时的理想响应。
4xx：客户端错误
此范围内的错误通常表示在整合生成器中发送的请求出现了问题。
-
400 错误请求：由于语法无效或缺少参数，服务器无法理解请求。
- 检查请求有效负载是否有错误、缺失字段或格式不正确。
-
401 Unauthorized：身份验证为必填项，但未提供或无效。
- 验证 API 密钥、密钥或其它身份验证凭证。仔细检查授权标头。
-
403 Forbidden：服务器已识别该请求，但拒绝授权。
- 确保您的 IP 地址在允许列表中，或验证 API 的权限。
-
404 Not found：无法在服务器上找到所请求的资源。
- 检查 URL 或端点。确保使用正确的路径并且资源存在。
5xx：服务器错误
此范围内的错误通常表示后端服务器出现问题。
-
500 Internal Server Error:一般错误，表示后端服务器出现了问题。
- 联系后端团队提供请求详情，以便进一步调试。
-
502 Bad 网关：服务器从上游服务器接收到一个无效的响应。
- 这通常表示后端的内部服务或依赖项出现了问题。
-
503 服务不可用：服务器当前无法处理请求，可能是由于过载或正在进行维护。
- 请稍后重试，并检查是否有计划停机时间。
-
504 网关超时：服务器未从上游服务器收到及时响应。
- 确保后端服务可操作，并检查是否有延迟问题。
调查对话中的任何技术错误
有时，您可能会看到包含技术错误的消息。技术错误包括以下文本：
“真的很抱歉，出现了技术问题。希望很快就能恢复工作状态。”
在这种情况下，问题很可能是对话错误，而不是与整合本身相关的任何错误。这里有一些提示：
- 检查对话，确保工作流程到达整合。使用缓冲消息进行确认，并检查是否有问题，例如混合按钮功能、断开的链接或循环引用。
- 验证是否存在任何必需的参数。缺失必要参数将在整合运行前触发错误。
- 对于动态内容，例如卡片和轮播，请确保所有字段都已填充。未定义、空白或空值会破坏这些组件并导致错误。
翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性
如对翻译准确性有任何疑问，请以文章的英语版本为准。