将聊天机器人添加到页面

备注

Power Apps 门户允许您添加 Power Virtual Agents 聊天机器人来回答访问者在您的门户页面上发布的问题。 配置有不同主题和触发短语的聊天机器人(机器人)可以自动回复访问者在聊天对话中发布的问题。

备注

不支持使用新的 Power Pages 设计工作室添加聊天机器人。 有关如何在 Power Pages 站点上嵌入聊天机器人的信息,请参阅操作方法:在网页上嵌入聊天机器人

先决条件

您必须先创建一个机器人,然后才能够将 Power Virtual Agents 机器人添加到 Power Apps 门户页面。 如果您还没有可用的机器人或满足您需求的机器人,您可以在门户中选择转到 Power Virtual Agents 创建一个。 要了解如何创建机器人,请转到创建和删除 Power Virtual Agents 机器人

重要

此功能需要以下版本的起点门户包和门户主机:

添加聊天机器人组件

创建聊天机器人后,您可以通过以下步骤将此组件添加到门户页面:

  1. 转至 Power Apps

  2. 从左侧窗格中选择应用

  3. 选择您的门户。

  4. 选择编辑打开门户工作室。

  5. 从左窗格选择组件

  6. 选择聊天机器人组件。

    向页面添加聊天机器人组件。

  7. 选择您的机器人。

    选择您的机器人。

    备注

    如果您尚未创建机器人,或者想要创建一个新机器人以在门户中使用,请选择 Power Virtual Agents。 创建机器人后,在门户工作室内选择同步配置反映机器人的更改。

  8. 选择机器人是出现在门户的所有页面上,还是出现在特定页面上。

  9. 如果选择特定页面,请使用管理页面中的机器人控制可以使用此机器人的页面。

您可以跨门户中的不同页面从您的环境添加更多机器人。 例如,可以将回答与工作区相关问题的机器人添加到 HR 页面。 或者可以将回答基本工资查询的机器人添加到一个 Finance 页面。 但是,不能让一个页面使用多个机器人。

高级配置

聊天机器人组件使用名为 Power Virtual Agents 的 Web 模板呈现。

聊天机器人 Web 模板。

您可以在“window.PvaEmbeddedWebChat.renderWebChat()”函数中更改以下参数的值。

每个部分都进行编号以供参考的聊天机器人。 每个部分都进行编号以供参考的聊天机器人小组件。

编号 参数
1 width 使用变量“chatWidth”。 要更改,请以像素为单位更新宽度:
let chatWidth = "320px";
2 height 使用变量“chatHeight”。 要更改,请以像素为单位更新高度:
let chatHeight = "480px";
3 headerText 机器人的标题。 默认使用机器人的名称。 要更改,请添加包含机器人标题值的“headerText”参数:
"headerText": 'Contoso chatbot';
4:fontColor
5:backgroundColor
webChatHeaderStyleOptions 确定聊天机器人组件的标头样式,如字体和背景的颜色。 要更改,请使用“fontColor”和“backgroundColor”属性的值更新“webChatHeaderStyleOptions”参数:
"webChatHeaderStyleOptions": {"fontColor":'black',"backgroundColor":'white'}
6:backgroundColor
7:bubbleBackgroundcolor
8:bubbleTextColor
9:bubbleFromUserBackground
10:bubbleFromUserTextColor
webChatCanvasStyleOptions 确定聊天机器人组件的聊天画布样式,如聊天机器人和用户的背景和气泡背景。 要更改,请使用“backgroundColor”、“bubbleBackgroundcolor”、“bubbleTextColor”、“bubbleFromUserBackground”和“bubbleFromUserTextColor”属性的值更新“webChatCanvasStyleOptions”参数:
"webChatCanvasStyleOptions": {"backgroundColor": "#123FFF","bubbleBackground":"#2340F0","bubbleTextColor": "#323130","bubbleFromUserBackground": "#412644","bubbleFromUserTextColor": "#F345FF"}
11:backgroundColor
12:iconColor
webChatWidgetStyleOptions 确定 ChatWidget 组件的样式,如图标和背景的颜色。 要更改,请使用“backgroundColor”和“iconColor”属性的值更新“webChatWidgetStyleOptions”参数:
"webChatWidgetStyleOptions": {"backgroundColor": "#486744","iconColor": "#DF234F"}

更改 Web 模板后,请确保选择同步配置更新配置并反映更改。

备注

除上述参数外,不支持对 Power Virtual Agents Web 模板进行任何更改。

其他注意事项

在门户内使用 Power Virtual Agents 聊天机器人时,请考虑以下事项:

门户模板的版本

此功能需要起点门户包版本 9.2.2103.x 或更高版本。 如果您的门户模板未升级,没有添加对聊天机器人组件的支持,您将在尝试添加组件时看到以下消息:

需要升级门户:需要升级才能在您的门户中使用此功能。如果升级门户,请确保同步配置,以使用新的门户包刷新当前门户工作室会话。

出现此消息时,请升级门户包。 有关详细信息,请参阅更新门户解决方案

备注

升级起点门户包将使您环境中的任何其他门户都能够使用聊天机器人组件。 详细信息:起点门户包更新

解决方案删除

此功能附带一个名为 MicrosoftPortalBot 的门户解决方案,显示名称为 Dynamics 365 门户 - 机器人。 如果您删除此解决方案,且不执行以下操作,您的门户将停止工作。

如果您删除 MicrosoftPortalBot 解决方案,必须重启门户以确保门户正常工作。

若要重启门户:

  1. 为您的门户打开 Power Platform 管理中心

  2. 在左侧窗格上,选择门户操作

  3. 选择重启重新启动门户。

    重要

    重启门户将使其在几分钟内不可用,在此期间用户将无法访问门户 URL。

  4. 选择重启确认重新启动门户。

另请参阅

备注

您能告诉我们您的文档语言首选项吗? 进行简短调查。(请注意,此调查是英文版调查)

此调查大约需要七分钟。 不会收集个人数据(隐私声明)。