整合生成器 是一个功能强大的无代码工具，让您可以将人工智能专员连接到任何 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 秒钟，我们建议尽可能在对话开始时（例如，在 Chat 已开始 事件时）进行必要的 API 调用，并将相关信息存储在会话。这可确保数据在需要时准备就绪，避免对话流程中的延迟。
翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性
如对翻译准确性有任何疑问，请以文章的英语版本为准。