在 AI 代理工作室中配置传入的自定义事件

1. 在 AI 代理配置页面上，在响应 Tab 中 创建新响应。
2. 在默认响应下，单击 默认（Web） 频道旁边的 + 以添加 语音 频道
3. 在传入事件名称 字段中，定义代理接收的事件名称。

从流设计器调用自定义事件

1. 在 Webex Contact Center 流设计器中，配置 流中的虚拟代理 V2 活动。
2. 在“状态事件 ”设置中，在“ 事件名称 - 事件数据” 列中指定以下详细信息：

   1. 输入您在 AI 代理工作室的 AI 代理配置页面的响应 Tab 中 配置的自定义事件名称。

   2. 输入要从流设计器传递到脚本化 AI 代理的自定义数据。

访问 AI 代理工作室中的自定义事件数据

您可以在配置传入事件的“ 默认响应 ”部分中访问事件数据（在流设计器中配置）。 在下图中，您可以看到自定义事件名称“custom_welcome”和事件数据“存储名称”从流设计器传递到 AI 代理工作室。

在 AI Agent Studio 中配置自定义退出事件和有效负载

1. 在 AI 代理工作室中，导航到脚本化的 AI 代理配置页面，然后转到 响应 ，您希望将控件传递回流设计器的位置。

2. 将自定义事件 添加到默认响应 部分。

3. 在要返回到流的 JSON 中输入事件名称和事件有效负载数据。

在此示例中，收集的槽将与自定义退出事件 “order_details”一起返回到流。

在流设计器中访问自定义事件数据

可以从虚拟代理 V2 活动的“输出变量 ”部分 访问 自定义事件和有效负载。

事件 名称 在 StateEventName 变量下 返回， 事件有效负载 作为元数据 返回 ，如下图所示：

在 AI 代理工作室中更新系统值

您可以使用特殊事件 state_update 和 事件有效负载 来更新系统值，例如上下文、意图和槽，如以下示例所示：

{“意图”：“order_status”，“插槽”：{“first_name”：“约翰”} } 

在上面的示例中，脚本代理的意图设置为 order_status，该意图中的插槽“first_name”设置为“John”，并将名为“track”的上下文添加到会话中。

此事件对于脚本化代理会话必须由流逻辑控制的用例非常有用。 此功能特别有用的一些用例包括：

• 如果流程中的完成失败，则重新提示用户输入信息

  考虑代理为用户预约的场景。 收集日期和时间后，此信息通过自定义事件发送到流，然后自定义事件尝试使用 HTTPS 请求活动预订约会。 如果约会因计划冲突而被拒绝，则 AI 代理需要请求备用时隙。 若要解决此问题，开发人员可以使用以下事件有效负载：

  {“意图”：“预订约会”，“空位”：{“时间”：“”} } }

  在这种情况下，将为时间收集的值清除，AI 代理会提示用户提供新值。 开发人员可以设置条件响应，让用户知道上一个时段未有空并请求新时间。

• 导航到其他目的

  考虑这样一种情况：用户请求检查其余额，但作为先决条件，用户必须首先验证其身份。 作为余额查询过程的一部分，开发人员可以发送事件有效负载，以通知流用户是否已通过验证。 如果经过验证，系统可以继续提取余额；如果没有，流可以提示 AI 代理使用以下事件有效负载启动用户验证过程：

  {“意图”：“验证用户”，}

  在同一示例中，假设验证需要用户的出生日期和 PIN 代码。 的流已经通过 CJDS 获得了有关用户出生日期的信息，这些信息可以作为插槽传递，并且只能收集 PIN 代码。 其事件有效负载将如下所示：

  {“意图”：“验证用户”，“插槽”：{“出生日期”：“06/26/1993”} }

• 在对话中引入或重置上下文

  当需要更新会话上下文时，开发人员可以将其包含在 state_update 事件的事件 有效负载中。 例如，AI 代理收集“验证用户”意图的槽位后，会将对话上下文设置为“验证”。 如果验证在流中失败，则应重置上下文，以防止用户访问需要“验证”上下文的意图。 此方案的事件有效负载如下所示：

  {“意图”：“验证用户”，“插槽”：{“出生日期”：“”，“密码”：“”}，“上下文”：{“验证”：0 } }