整合生成器 是一个功能强大的无代码工具，使您可以将人工智能专员连接到任何 API 或数据源，而无需大量技术或编程技能。本文章介绍了关于整合生成器的常见问题 (FAQ)。
本文章包含以下主题：
相关文章：
参数和数据常见问题解答
是如何从对话收集会话数据的？
人工智能专员对话中的会话数据收集从会话开始时自动捕获用户元数据开始，一直到与人工智能专员的交互，期间可以捕获输入、响应和实体。
当发起在线交谈会话时，尤其是用户登录时，系统会自动收集某些元数据。此元数据通常包括特定于用户的详情，其中包括用户 ID 或帐户信息、会话 ID、位置、时间戳等。然后可以作为 对话操作保存这些数据。
在对话期间，您可以选择捕获用户的某些回复（以自由文本形式撰写或使用按钮提交）。您可以通过以下方式完成此操作：
- 在条件块中使用“收集参数”设置的参数
- 实体
然后可以将这些参数传递给整合，并用作 URL 端点或请求正文中的 请求参数 。
什么是 URL 参数以及如何使用？
URL 参数是 URL 中的动态参数，会随着来自对话的请求参数中传递给整合的信息而变化。
以下是将用户 ID 用作参数的示例：
https://{{zendesk_subdomain}}.zendesk.com/api/v2/users/{{user_id}}
在双花括号中，参数 user_id 将添加到 URL 中。
如何从对话访问数据以便在 API 中使用？
要使用来自对话的数据，必须将数据作为参数保存到会话（如上所述），可以收集参数或将元数据保存到会话数据中的参数。如果数据来自对话，则必须作为请求参数保存在整合生成器中，或者作为会话数据/元数据保存，以发送到 API。然后，您也可以在请求正文中动态发送该参数。
如何从 API 响应访问参数或数据以在对话中使用？
要使用来自 API 响应的参数或数据，必须将其保存为 环境 （在大多数情况下为成功场景）中的会话参数。保存后且当 API 登陆特定场景后，您可以访问并使用会话参数，以在人工智能专员消息中使用，或用作 有条件块的参数：
- 在人工智能专员消息中，将作为 {{parameterName}}更新。
- 在条件块中，可使用参数名称访问。
如何发送包含正文的请求参数？
要在正文中发送请求参数，您必须将其包含在双花括号中，如下所示：
{{exampleParameter}}
是否可以在请求正文中发送数组？
是的，您可以在定义请求参数时选择数据类型为数组。测试时，请确保使用 JSONdata 函数 $eval($)重新设置值的格式 。eval 函数可分析并评估包含 JSON 表达式或 JSONdata 表达式的字符串，就像它是 JSON 一样。
本例中，我们获取了一个数组中的字符串，并使用 $eval() 将其作为数组进行分析。最常见的用例是发送一系列订单。
测试时为什么我未收到任何请求参数或收到错误参数？
为进行测试，您必须对整合生成器中的请求参数使用一个与端点中实际数据匹配的测试值。但是，在实时对话中，此参数的值来自对话。如果您在测试时无法在会话数据中看到参数和值，应进行检查，以确保您捕获并保存为对话框中的正确参数。
请记住， 已清除的会话数据 将不会显示在对话日志中。在这种情况下，您可能需要暂时将其记录到人工智能专员消息中，以便进行调试。
为什么会看到[对象，对象]？
看到 [对象，对象] 意味着您正在尝试输出一个对象，但系统没有结构化的方式来显示它。要解决此问题，您需要将该对象转换为字符串格式。
您是否记录了成功的通话？
不会，由于PII和GDPR 的原因，我们不会记录成功的数据通话。我们会记录失败的通话，以便在必要时在故障排除期间提供更多关于故障原因的信息。
环境常见问题解答
为什么我需要不同的环境？
在测试整合时，您可能不想使用现实生活中的数据。如果您有权访问沙盒环境、过渡环境或开发环境（我们建议向您的技术团队或 API 文档查找），则可以在整合生成器中进行设置。
环境共享请求参数和输出。然而，它们的不同之处在于端点和身份验证详情。在对话生成器中，您可以在 API 节点上的环境之间轻松切换。这意味着您只需在测试时建立一个对话，然后在准备好上线整合时切换到生产环境。
卡片和轮播常见问题解答
是否需要设置卡片的最大数量？
对于Sunshine Conversations整合，最多有 10 张卡片。
我们建议将轮播中的卡片数量限制在 9 张以内，即 8 张卡片加一张回退卡片。回退卡片可为用户提供退出轮播的方法（例如，在用户未看到项目时）。
是否需要在轮播中显示卡片上的图像？
是的，图像是必填数据字段。如果您不需要动态图像（例如每个产品一个图像），可以在图像字段中填充通用图像链接。
身份验证常见问题
我可以使用哪些身份验证方法？
您可以使用以下身份验证方法：
- API 密钥
- 不记名密钥
- 过期密钥
- 基本身份验证
- OAuth 2.0
- IP 允许列表
要开始对整合生成器进行身份验证，请参阅 整合技术要求。
是否可以与已添加允许的端点建立整合？
可以。为此，您必须将我们的 IP 地址添加到允许列表中。有关 IP 地址列表，请参阅 允许 IP 将高级人工智能专员连接到您的客户关系管理。
什么是仅限身份验证整合？我何时需要它？
要了解更多关于仅限身份验证的整合的信息，请参阅 通过整合生成器使用自定义授权。
是否可以实施速率限制和扼制？
我们不会直接实施速率限制和扼流。速率限制通常由与我们整合的系统或 API 强制执行，例如您的后端系统。这些限制取决于您的后端配置。
如果我的 API 响应时间超过 9 秒，会怎样？
人工智能专员（高级）附加功能强制 API 响应设置 9 秒的超时。如果您的 API 在此时间内未提供响应，请求将超时，并返回错误 经济崩溃。此外，响应时间过长会对用户体验产生负面影响，因为用户等待信息的过程可能令人沮丧。
要解决此问题，如果您预计某些 API 响应时间将超过 9 秒钟，我们建议尽可能在对话开始时（例如，在在线交谈开始 事件时）进行必要的 API 调用，并将相关信息存储在会话。这可确保数据在需要时准备就绪，避免对话流程中的延迟。
翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性
如对翻译准确性有任何疑问，请以文章的英语版本为准。