What's my plan?
Suite Team, Growth, Professional, Enterprise, or Enterprise Plus
本文所述功能仅限于以下客户使用:在 2025 年 2 月 2 日前已获取人工智能专员(未正式或已正式发布版本)。有关人工智能专员(高级)附加功能中等效功能的信息,请参阅为人工智能专员(高级)构建对话。

在智能机器人生成器中,变量是与对话相关的数据的容器,例如客户姓名或商店订单 ID。在对话期间,消息传送人工智能专员可以多种方式利用变量,包括:

  • 插入人工智能专员消息中,以形成个性化文本回复、显示动态信息和图像或创建对话分支。
  • 根据终端用户的输入设置变量的值。
  • 用于在“转接给专员”步骤创建的工单的标签中。

人工智能专员在所有答案中最多包含 46 个唯一变量。每个唯一变量都可以根据需要在答案中多次使用。

本文章包含以下主题:
  • 关于变量名称和值
  • 关于变量类型
  • 在回复中使用变量
  • 在标签中使用变量

关于变量名称和值

在智能机器人生成器中,每个变量都有名称和值。在回复中配置步骤时,名称将用作值的占位符。人工智能专员在运行回复时会将变量的名称替换为变量的值。例如,您可以使用一个名为电邮的变量作为客户电邮地址的占位符。

注意:消息传送对话中显示的响应中仅显示变量值的前 280 个字符。

变量在人工智能专员中是全局性的。创建变量后,变量可通过自由文本或链接到另一个回复步骤用于终端用户对话中的所有后续回复。

处理空白变量

如果变量没有值,则为空白变量。人工智能专员在对话期间会跳过空白变量。

例如,发送消息步骤包含“您的包裹的物流状态为 shipping_status”的人工智能专员消息。如果在对话期间 shipping_status 变量为空白,人工智能专员将发送消息“您的包裹的送货状态为 ”。

人工智能专员消息 客户视图

处理缺失变量

在进行 API 调用步骤中,如果响应中缺失一个已保存的变量,则将触发该步骤的“失败”分支。请参阅在智能机器人生成器(旧版)中使用“进行 API 调用”步骤。

处理没有来源的变量

智能机器人生成器中的变量通常显示为灰色背景。但是,如果变量来源已移除,它将显示为红色背景。例如,考虑以下场景:

  1. 在答案工作流程中,您可以添加一个“设置变量”步骤,用于创建和设置一个名为 shipping_status 的变量。
  2. 在该工作流程的下一步中,您可以添加一个“发送消息”步骤,并在消息中添加 shipping_status 变量。

  3. 删除上面创建的“设置变量”步骤。

    由于 shipping_status 变量的来源已不存在,它现在在“发送消息”步骤中显示为红色。

关于变量类型

智能机器人生成器会根据变量的创建方式及其存储的数据来组织变量:
  • 客户变量
  • 外部服务变量
  • 消息传送元数据变量
  • Sunshine Conversations 变量

客户变量

客户变量会存储客户在询问详情步骤中提供的信息。例如,该步骤可能会要求客户提供其姓名和电邮地址。

当在一个步骤中使用添加变量图标 () 插入变量时,客户变量将显示在客户的响应下。

外部服务变量

外部服务变量会存储在进行 API 调用步骤期间接收的来自外部系统的数据。例如,该步骤可以向物流供应商发出 REST API 请求,以获取包裹的当前状态。

管理员会在配置进行 API 调用步骤时创建外部服务变量。在配置过程中,管理员可以为每个变量设置一个自定义名称。

当在一个步骤中使用添加变量图标 () 插入变量时,外部服务变量将显示在外部服务的响应下。

消息传送元数据变量

消息传送元数据变量包含关于客户身份和身份验证状态的信息。消息传送元数据变量从用于消息传送身份验证的已签名 JSON 网络密钥 (JWT) 中获取值。

消息传送元数据变量默认不启用,并且仅适用于 Web Widget 和移动 SDK 渠道。有关启用和使用消息传送元数据变量的更多信息,请参阅在人工智能专员回复中使用身份验证元数据。

如果启用,当在一个步骤中使用添加变量图标 () 插入变量时,消息传送元数据变量将显示在消息传送元数据下。

Sunshine Conversations 变量

Sunshine Conversations 变量可用于连接您的 Sunshine Conversations 整合。

可用变量包括:

  • SunCo 用户 ID
  • SunCo 对话 ID
  • SunCo 应用 ID

在回复中使用变量

通过智能机器人生成器,您可以使用插入的变量:
  • 自定义人工智能专员消息
  • 向外部系统发送数据
  • 创建回复的工作流程分支
  • 设置变量值

自定义人工智能专员消息

管理员可在以下步骤类型的人工智能专员消息中插入变量:
  • 显示选项
  • 添加轮播
  • 转接给专员
  • 发送消息
  • 显示帮助中心文章
例如,以下人工智能专员消息包含名称变量。

向外部系统发送数据

当使用进行 API 调用步骤对外部系统进行 REST API 调用时,管理员可以将插入变量添加到该步骤的端点 URL 字段的路径和查询字符串中。有关更多信息,请参阅在智能机器人生成器中使用进行 API 调用步骤。

创建回复的工作流程分支

按条件创建分支步骤允许管理员根据一个或多个变量的值创建回复流程的分支。有关更多信息,请参阅了解分支条件。
注意:自定义下拉工单字段使用标签值作为变量的值。

设置变量值

管理员可使用设置变量步骤,根据终端用户在对话中的操作创建新变量并分配一个值,或选择现有变量并覆盖其值。变量可在人工智能专员的所有答案中引用。

请参阅了解回复步骤类型:设置变量以获取使用详情。

在标签中使用变量

对于在转接给专员步骤创建的工单,管理员可以在添加的标签中使用变量。专员可以使用这些标签查看、组织和跟踪工单,以及用于自动操作,例如工单路由和其它业务规则。

尽管工单标签中的变量从技术上讲是回复的一部分,但其所遵循的规则和限制却与其它变量不同。

您可以使用从 API 调用生成的变量和系统变量。可用变量显示在选择下拉菜单中:

但是,含有终端用户输入的变量不能在标签中使用。它们将显示在下拉列表中,但将被禁用。例如,您无法使用在对话早期的询问详情步骤中收集的信息引用变量。

以下规则和建议适用于在标签中使用变量:

字符限制

  • 每个硬编码标签限制为 80 个字符以内。

特殊字符

  • 包含以下特殊字符的变量无法使用,也不会显示为可用变量:£、`、´、\、[, ]、{、}、(, )、<、>、%、&、?、+、@、!、*、$、#、= 和 "
  • 变量中使用的空格或逗号在标签中显示为下划线。

此外,在使用变量作为标签时,我们建议采用以下最佳实践:

  • 标签通常用于路由对话或用于触发器条件。如果您要在工单中添加专员背景信息,我们建议使用自定义字段。
  • 限制变量可能值的数量。太多的值会导致意外行为。
  • 值选项应尽量简短,以免作为标签被截断。
  • 值中避免含有特殊字符。
由 Zendesk 提供技术支持