在完成本页面上的任务之前，请确保已满足集成的 先决条件 。
创建脚本
所需权限：
您需要至少一个 Studio 脚本来将交互路由到虚拟坐席。 遵循脚本指南和要求{ 11}脚本指南和要求脚本指南和要求脚本指南和要求脚本指南和要求脚本指南和要求{ 21}。 
联系人通过其与预期收件人联系的一种媒介，如语音、电子邮件和聊天。，或者对于文本虚拟坐席，必须具有数字媒体类型。 支持的此提供程序的虚拟坐席操作是：
如果您正在使用 SIP 用于对多媒体通信会话（如语音和视频通话）发出信号和进行控制的协议。 秘密渠道与虚拟坐席的连接，请联系您的 客户代表。
如果您正在设置语音虚拟坐席并使用CXone Mpower Cloud TTS Hub 服务，请在您的脚本中包含CLOUD TTS 操作。
您可以在在线帮助的基础知识和技术参考指南部分中了解有关 Studio 脚本编写的更多信息。
当您的虚拟坐席准备投入生产时，将此脚本分配给一个或多个联络点。
自定义有效负载最佳实践
将自定义有效负载数据从 Google Dialogflow CX 集成至 CXone Mpower 时，请遵循以下最佳实践：
- DialogflowCX 不像 Dialogflow ES 使用上下文将数据传递给 Dialogflow 意图 联系人所说/输入内容背后的含义或目的；联系人想要沟通或完成的内容。
-
您可以使用 JSON 键值对将自定义数据传递到 Dialogflow CX。 在脚本的 Snippet action中，创建一个动态 customPayload 对象，并向其添加键值。 例如：
DYNAMIC customPayload customPayload.ani = ani customPayload.contactID = contactId customPayload.masterContactId = masterId customPayloadJSON = "{customPayload.asJSON()}" - 在脚本的
- 使用
。 - 通过
- 不要在
- 要将自定义数据从 Dialogflow CX 虚拟坐席传递回脚本，请使用 Dialogflow CX 控制台中的 Custom Payload 字段。 确保您位于与 CXone Mpower 结合使用的虚拟坐席的控制台中。 在脚本的 customPayloadVarName (out) 或 VOICEBOT EXCHANGE TEXTBOT EXCHANGE 操作中使用 Studio 变量将其映射到脚本。 例如，您可以使用此来设置下一个提示行为。
-
使用 customPayload 设置的参数只能在外部 Webhook 中使用。 如果要设置参数以便在外部 webhook 之外使用，请在包含 session_params 字段的 Snippet 操作中设置参数。 例如：
{ "session_params": { "name": "Winnie Le Pooh" "job": "Food critic" "location": "Hundred Acre Wood" } }使用以下语法访问 Dialogflow CX 坐席意图中的会话参数：
$session.params.name = Winnie Le Pooh
$session.params.job = Food critic
$session.params.location = 100 Acre Wood
会话参数仅与 Dialogflow CX 虚拟坐席一起使用。 要通过 Dialogflow 获得类似的结果，请使用上下文。
-
语音上下文提示可以通过 speechContexts 参数中的自定义有效负载进行传递。 voiceContexts.phrases 的值必须是您想要给出的提示的 Google 类令牌
。 该令牌必须与您的联系人的语言和区域设置相匹配。 例如： DYNAMIC customPayload customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE" customPayload.speechContexts.boost=10 -
将应用程序添加到 Virtual Agent Hub
所需权限：
将配置应用程序添加到 Virtual Agent Hub，以便在 CXone Mpower 与虚拟坐席提供程序之间建立连接。
如果您将 SIP 用于对多媒体通信会话（如语音和视频通话）发出信号和进行控制的协议。 秘密渠道连接与虚拟坐席结合使用，请联系您的 客户代表 获取设置帮助。
- 在 CXone Mpower 中单击应用程序选择器
并选择其他 > 自动化与人工智能，然后单击 Virtual Agent Hub。 您还可以双击 Studio 脚本中的虚拟坐席操作来启动 Virtual Agent Hub。 - 单击添加机器人。
-
输入虚拟坐席（机器人）名称，然后单击
-
单击下一步。
-
填写配置表单中的字段，然后单击下一步 。 您可以在此页面的配置页面详细信息部分中找到有关此表单的详细信息。
-
单击下一步。
-
如果要设置文本虚拟坐席，请在“语音”页面上选择仅文本（无语音支持）。 如果要设置语音虚拟坐席，请参见本页的配置语音集成选项部分。
-
单击下一步。
-
在“记录文本”页面上，选择是否要捕获对话记录文本和意图信息的选项。
用于对多媒体通信会话（如语音和视频通话）发出信号和进行控制的协议。 秘密渠道连接的语音集成不支持它。在此步骤中了解有关字段的更多信息
选项 详细信息 仅限意图信息 如果只想采集意图信息，请选择此选项。 默认情况下，仅在交互期间存储捕获的数据。
此选项需要自定义脚本。
什么都没有 如果您不想采集对话记录文本或意图 联系人所说/输入内容背后的含义或目的；联系人想要沟通或完成的内容信息，请选择此选项。记录文本和意图信息 如果要采集记录文本数据和意图数据，请选择此选项。 默认情况下，仅在交互期间存储捕获的数据。
此选项需要自定义脚本。
仅记录文本 如果只想采集记录文本信息，请选择此选项。 默认情况下，仅在交互期间存储捕获的数据。 此选项需要自定义脚本。
-
单击下一步。
-
您可以在“测试 + 添加”页面通过发送语音或文本提示，测试机器人的连接情况。 如果测试消息不起作用，请单击返回，以返回到“配置”页面并验证设置。 您可能还需要验证虚拟坐席提供程序管理控制台中的配置。
-
单击添加。
Google Dialogflow CX 配置页面详细信息
完成“配置”页面时，请使用下表中的信息。 在 Virtual Agent Hub 中添加应用程序时您会看到此页面
如果将DialogflowCX 设置为使用 SIP 用于对多媒体通信会话（如语音和视频通话）发出信号和进行控制的协议。 秘密渠道连接，请按照设置连接的步骤而不是本节中的步骤进行操作。
|
字段 |
详细信息 |
|---|---|
| 集成版 |
选择您要使用的 Virtual Agent Hub 的版本。 该选项可以让您使用以前的 Virtual Agent Hub 版本，直到您准备切换到新发布的版本为止。 可用的版本有：
|
| SIP 已配置 | 如果要与此虚拟坐席中使用 SIP 秘密渠道连接，请单击。 请联系您的CXone Mpower 客户代表，获取设置 SIP 秘密渠道连接的帮助。 |
| JSON 服务帐户 |
您从 Google Cloud Console 创建并下载的服务帐户密钥文件。 将密钥文件的全部内容复制并粘贴到该字段中，包括密钥周围的大括号。 此字段仅在您使用您自己的 Google Dialogflow CX 帐户时可见。 服务帐户密钥是类似于以下示例的 JSON 对象： { "type": "service_account", JSON 服务帐户必须具有 Dialogflow API 管理员角色 |
|
语言 |
您希望该虚拟坐席使用的语言。 这是虚拟坐席能理解的语言。 这是一个必填字段。 |
| 地区 | 您添加至 Virtual Agent Hub 的 Google Dialogflow CX 虚拟坐席所在地区。 这是一个必填字段。 |
| 坐席 | 您想要添加至 Virtual Agent Hub 的 Google Dialogflow CX 虚拟坐席的名称。 您可在虚拟坐席的 Dialogflow CX 控制台中查找名称，然后单击复制名称将其复制到剪贴板。 这是一个必填字段。 |
| 环境 | 输入您希望该 Dialogflow 应用程序使用的环境的 GUID。 在 Dialogflow CX 中，同一虚拟坐席的不同版本称为环境。 您可以在坐席设置的 Google Dialogflow CX 控制台中找到环境的 GUID。 |
| 执行输出 TTS |
如果要使用Google Dialogflow CX文本到语音转换 (TTS 如果您不想使用 Google Dialogflow CX TTS 服务，请将此字段的设置保留为关闭。 您可以使用CXone MpowerCloud TTS Hub服务。 如果是文本虚拟坐席，请禁用此选项。 |
| 超时事件处理程序 | 您希望在超时时触发的 Google Dialogflow CX 事件的名称。 |
| DTMF 突发模式 | 如果按下指定的字符，脚本将直接跳到 OnDTMFBreakout 分支。 |
| 执行情绪分析 |
如果您要接收来自 的情绪分析结果，请单击将其设为打开Google的滑块。 此选项要求您在 Google Cloud 项目中启用此选项。 您负责配置如何将情绪分析数据与您的虚拟坐席一起使用。 |
| 外部提供商超时 |
输入您希望脚本等待 |
配置 Google Dialogflow CX TTS 输出
所需权限：
如果要使用 GoogleTTS 服务，请完成本节中的步骤。 启用 Virtual Agent Hub 中 Dialogflow
- 在 Virtual Agent Hub 中，添加新的配置应用程序，并按照本页将应用程序添加到 Virtual Agent Hub 部分中的步骤进行配置。
- 启用执行输出 TTS。
-
要使用自定义语音模型，请启用使用自定义语音，然后在自定义语音模型字段中输入要使用的 AutoML 模型名称。
了解此步骤中字段的更多信息
字段
详细信息
使用自定义语音 允许您使用 AutoML（自动机器学习）模型为机器人合成自定义语音。 Dialogflow 使用此语音而不使用 TTS 语音。 如果您使用此选项，请在出现的自定义语音模型字段中输入您要使用的 AutoML 模型的名称。
此字段仅在启用执行 TTS 输出时可见。
-
如果要使用 Google 语音模型，请从下拉列表中选择 TTS 语音名称。
-
选择希望 Google TTS 服务在合成语音时使用的机器学习模型和模型变量。
了解此步骤中字段的更多信息
字段
详细信息
模型 选择您希望转录服务在转录音频时使用的机器学习模型。 这些模型已经过训练，可以识别来自特定音频类型和来源的语音。
可用选项为：
- 命令和搜索：当转录较短音频片段时使用，如命令或语音搜索。 考虑改用 最新短。
- 默认：当音频不符合其他模式时使用。 它可以转录任何类型的音频，但某些类型的结果可能质量较低。
- 最新长音：用于长格式内容，如即兴演讲或对话。
- 最新短音：用于几秒钟长的话语，如命令。 考虑使用此模型取代命令和搜索。
- 医疗对话：当转录医疗专业人员与患者之间对话时使用。
- 医疗口述：当转录医疗专业人员的口述说明时使用。
- 电话呼叫：用于电话呼叫中的音频。
- 视频：当转录有多个发言者的音频时使用，如来自视频片段或播客的音频。 如果视频没有您需要的语言，请改用最新长。
模型变体 选择您希望
对于 Phone Call 模型，建议的变体是 Enhanced。
该字段的可用选项包括：
- Best Available：如果所选模型有增强模型，则选择是否让 Dialogflow 使用该模型。 如果不是，则使用标准模型。
- Enhanced：选使用增强模型。 如果所选的模型没有可用的增强模型，则 Dialogflow 使用标准模型。
- Standard：选择使用标准模型，即使增强模型可用。
- Unspecified：如果不确定使用哪种变体，请选择。 Dialogflow 默认为所选模型的最佳可用变体。
-
要在虚拟坐席音频响应开始时添加静音，请在添加前导静音字段中输入要添加的静音毫秒数。 建议的静音时间为 500 毫秒。
-
输入语速、音调和音量增益，以配置 TTS 语音的声音效果。
了解此步骤中字段的更多信息
字段
详细信息
语速 单击 + 或 – 可更改 TTS 语音的语速。 语速可介于 0.25 和 4.0 之间。 正常语速是 1.0。 语速 2.0 是正常语速的两倍，语速 0.5 是正常语速的一半。 默认值为 0。
此字段仅在启用执行 TTS 输出时可见。
音调 单击 + 或 – 可更改 TTS 语音的音调。 音调是语音的高低。 默认值为 0。 最大值为 20.0，表示语音比默认值高 20 个半音。 最小值为 -20.0，表示语音比默认值低 20 个半音。
此字段仅在执行 TTS 输出开启时可见。
音量增益 单击 + 或 –可更改以分贝 (dB) 为单位测得的 TTS 语音的音量。 默认值为 0。 范围为 16.0 到 -96.0。 增益 +6.0 表示播放音量大约是默认音量的两倍。 请勿超过+10 dB。
此字段仅在执行 TTS 输出开启时可见。
- 返回本面的“将应用程序添加到 Virtual Agent Hub”部分，完成配置应用程序的添加。
配置语音集成选项
所需权限：
- 在 Virtual Agent Hub 中，添加一个新的配置应用程序，并根据本页上将应用程序添加到 Virtual Agent Hub 部分中的步骤配置它。
-
单击“配置”页面上的下一步。
- 在“语音”页面的“语音集成选项”下，选择逐个控制 (
-
在“转录”选项下，选择要使用的转录服务选项。
在此步骤中了解有关字段的更多信息
字段 详细信息 转录选项 选择要用于转录的服务：
- 使用机器人帐户转录：如果您要使用虚拟坐席提供程序的转录服务，请选择此选项。 联系人话语中的音频在转录之前会发送给提供程序。
- 使用 Turn-by-Turn Transcription 配置文件：如果您要使用 CXone Mpower 转录配置文件，请选择此选项。 您可以在 CXone Mpower Turn-by-Turn Transcription 帮助页面上了解有关此选项的更多信息。
- 如果您选择使用 Turn-by-Turn Transcription 配置文件，请单击Turn-by-Turn Transcription配置文件，选择您要使用的配置文件。 单击添加新的逐个转录配置文件，创建一个新配置文件。
- 在“转录”选项下，选择转录配置文件或单击添加新的逐个转录配置文件，创建一个新配置文件。
- 单击下一步。
- 返回本面的“将应用程序添加到 Virtual Agent Hub”部分，完成配置应用程序的添加。
将 Google Dialogflow CX 应用程序分配给操作
所需权限：
在 Virtual Agent Hub 中设置和配置虚拟坐席 联系人所说/输入内容背后的含义或目的；联系人想要沟通或完成的内容应用程序时，您需要将其分配给您脚本中的虚拟坐席操作。 这会将操作和脚本连接到您的虚拟坐席提供程序。
- 在 Studio 中，打开要修改的脚本。
-
如果您尚未这样做，请单击工具选项卡，展开自动化和 AI 类别，然后添加要使用的虚拟坐席操作。 确保将其放在脚本中的正确位置。 如果未看到预期的操作，请验证脚本媒体类型是否正确。 例如，如果要为语音虚拟坐席创建脚本，则该脚本必须为电话脚本。
-
- 在左侧的列中，找到要分配给操作的虚拟坐席，然后单击它旁边的复选标记
。 - 单击关闭。
更改转录配置文件
所需权限：
转录配置文件允许您使用与虚拟坐席提供程序所提供的转录服务不同的转录服务。 每个虚拟坐席可以拥有一个转录配置文件。 如果使用语音虚拟坐席并需要更改转录配置文件，则只需按照本节中的步骤操作。
- 在 CXone Mpower 中单击应用程序选择器 并选择其他 > 自动化与人工智能，然后单击 Virtual Agent Hub。 您还可以双击 Studio 脚本中的虚拟坐席操作来启动 Virtual Agent Hub。
- 在 Virtual Agent Hub 页面左侧的虚拟坐席配置应用程序列表中，单击要修改的应用程序。
- 在虚拟坐席应用程序属性页面的中心，单击语音选项卡。
-
在“转录选项”下，选择使用Turn-by-Turn Transcription配置文件（如果尚未选择）。
-
选择您希望此虚拟坐席集成使用的逐个转录配置文件。 如果您要使用的选项不存在，您可以添加它。
- 单击保存。
- 在虚拟坐席应用程序属性页面的“测试”部分，使用麦克风选项测试转录服务。
测试虚拟坐席
所需权限：
您可以测试虚拟坐席的多个方面，以确保一切都按预期进行。 您可以从 Virtual Agent Hub 中的虚拟坐席应用程序的属性页面运行测试。 测试时，您可以：
- 验证虚拟坐席应用程序是否已正确配置为与虚拟坐席提供程序进行通信。
- 添加自定义负载 JSON 以测试虚拟坐席对自定义负载数据的处理。
- 触发欢迎意图事件以测试虚拟坐席如何开始对话。
- 触发自定义意图事件来测试您为虚拟坐席创建的任何自定义事件。
- 触发超时事件以测试虚拟坐席在联系超时时如何响应。
- 测试虚拟坐席如何处理DTMF 当用户在电话按键上按下或敲击某个键时产生的信号音。 输入。
下图是 Virtual Agent Hub 中虚拟坐席应用程序的属性页面示例。 它会显示“配置”和“语音”选项卡以及“测试”窗格。
- 在 CXone Mpower 中单击应用程序选择器 并选择其他 > 自动化与人工智能，然后单击 Virtual Agent Hub。 您还可以双击 Studio 脚本中的虚拟坐席操作来启动 Virtual Agent Hub。
- 单击从左侧列表中选择要测试的虚拟坐席的配置应用程序。
-
在“测试”窗格中，在键入消息字段中输入测试消息，然后按 Enter 键发送。 您还可以单击麦克风
并对着计算机的麦克风讲话。 - 单击以欢迎意图开始以从头开始测试对话。 虚拟坐席以其默认的欢迎消息进行响应。 您可以输入测试消息。
-
单击更多选项
测试虚拟坐席的其他方面。在此步骤中了解有关字段的更多信息
字段 详细信息 添加自定义有效负载 JSON 选择以测试向虚拟坐席发送自定义有效负载 JSON。
在“测试 + 添加”页面上显示的添加自定义有效负载 JSON 文本框中输入自定义有效负载。 每行后按 Enter 键。
准备好测试自定义有效负载时，发送一条测试消息。 测试完自定义负载后，单击“添加自定义有效负载 JSON”窗格上的关闭。
触发欢迎意图事件 选择以测试默认欢迎意图 联系人所说/输入内容背后的含义或目的；联系人想要沟通或完成的内容。 虚拟坐席发送欢迎消息。 输入要回复的消息。触发自定义意图事件 选择以测试自定义意图事件。 在出现的弹出窗口中输入事件名称，然后单击触发。 虚拟坐席会为您输入的意图发送消息。 发送响应来测试意图。 触发超时事件 选择以查看默认超时意图。 虚拟坐席发送其配置的超时响应消息。 DTMF 输入 选择测试语音虚拟坐席对 DTMF 当用户在电话按键上按下或敲击某个键时产生的信号音。 音调的响应。 输入DTMF 字符，然后单击输入以查看虚拟坐席对这些字符的响应。 - 单击重置重新开始测试。
-
如果需要根据测试结果进行更改，您可以：
- 修改虚拟坐席的 Studio 脚本。
- 在Virtual Agent Hub中修改虚拟坐席应用程序中的配置设置。
- 在虚拟坐席提供程序的控制台中修改虚拟坐席的配置设置。 单击 Virtual Agent Hub 中应用程序属性页面上的大方形按钮。 本部分开头的示例显示了带有提供程序按钮的 Google Dialogflow CX 应用程序。 它上面有一个 图标，指示该链接打开了一个外部站点。
- 在每次更改脚本或任何配置设置后全面测试虚拟坐席。
- 完成测试后，单击关闭。