配置和创建多语言代理
多语言代理是可以用不同语言与客户沟通的代理,同时将所有内容保存在一个代理中。 在许多情况下,他们可以根据代理用户的 Web 浏览器设置自动检测所需的语言,并以相同的语言进行响应,为客户提供更加个性化和引人入胜的体验。
有关支持语言的列表,请参阅语言支持。
备注
Copilot Studio 经典聊天机器人不支持多语言代理。 有关将经典聊天机器人转换为代理的详细信息,请参阅升级到 Copilot Studio 统一创作。
发布到频道时,如果在会话开始时未指定语言,则多语言代理默认为主要语言。 您可以配置代理以在对话期间更改语言,请参阅多语言代理的创作注意事项。
配置多语言代理
最初创建代理时,会定义一种主要语言。 有关如何选择代理的主要语言的详细信息,请参阅语言支持。
要启用多语言代理:
打开代理后,选择页面顶部的设置,然后选择语言。
在设置页面上选择添加语言。
在添加语言窗格中选择要添加到代理的语言,然后选择底部的添加语言。
确认语言页面上的语言列表是否正确。
备注
您可以根据需要向代理添加任意数量的辅助语言,只要它们在支持的语言列表中即可。
在多语言代理中管理本地化
备注
所有代理主题和内容编辑必须以代理的主要语言完成。 若要编辑代理的辅助语言以本地化字符串,必须使用本节中的步骤。
将代理字符串本地化并上传到代理(如此处所述)后,您可以通过在测试代理中切换语言来在创作画布中查看本地化的内容。
要将本地化字符串添加到多语言代理:
打开代理后,选择页面顶部的设置,然后选择语言。
在语言页面上,在添加的辅助语言表中,为您要更新的语言选择本地化列中的上传。
在所选辅助语言的更新本地化页面上,选择 JSON 或 ResX 格式下载该语言的当前本地化文件。
备注
下载的文件包含代理的最新本地化内容。 如果您需要下载以前版本的本地化文件,请打开代理的解决方案以下载以前的版本。
打开下载的文件,用适当的翻译文本替换主要语言字符串。
返回到更新本地化页面,选择浏览,然后上传翻译后的文件。
关闭更新本地化页面。
更新本地化内容
首次下载辅助语言的本地化文件时,字符串采用主要语言。 下载本地化文件后,请将其与您首选的本地化过程一起使用。
如果对主要语言字符串进行更改,则还需要更新次要语言的本地化内容。 此过程包括新内容和修改的内容。 增量更改不会自动翻译。 您必须下载辅助语言 JSON 或 ResX 文件,并使用首选的本地化过程更新未翻译的字符串。
以下方案是翻译内容工作流的典型情况。 您之前已将主要语言(en-US)翻译为次要语言(fr-FR),并且添加和修改了主要语言的内容。 当您下载辅助语言本地化文件时,所有新内容都将使用主要语言(en-US)。 但是,修改后的内容仍以辅助语言显示。 由于修改后的内容使用相同的 ID,因此您必须将新文件与之前上传的文件进行比较。
多语言代理的创作注意事项
创作时,您可以将代理配置为在对话过程中更改当前所说的语言。 该逻辑可以驻留在代理中的任何主题中。 但是,最佳做法是在问题节点之后立即切换语言,这样可以确保在下一个问题节点之前,所有后续消息都使用同一种语言。
要更改代理的当前语言,您可以将 User.Language
变量值设置为代理的辅助语言之一。 此选择会立即更改您的代理所说的语言。
测试多语言代理
要测试多语言代理:
打开测试您的代理窗格。
打开测试代理顶部的菜单,然后选择一种辅助语言。
测试代理会重新加载自身,这次使用选定的辅助语言。 创作画布显示辅助语言。
要测试代理,请输入第二语言的消息。
您还可以将浏览器语言设置为代理支持的辅助语言,然后打开演示代理网站。 演示网站以第二语言打开,代理使用第二语言字符串进行聊天。
针对未配置的语言的多语言代理行为
如果代理的用户将其浏览器配置为代理未配置的语言,则代理始终回退到其主要语言。
重要提示
代理的主要语言在代理创建后无法更改。
缺少翻译的多语言代理行为
如果代理作者对主要语言的代理进行了更改,但未上传翻译,则代理会显示其主要语言中未翻译的更改。 在对主要语言的代理进行更改后,请务必确保翻译是最新的。
发布多语言代理时出错
当您尝试发布多语言代理时,如果您看到带有原始响应错误代码的“机器人验证失败”错误消息,SynonymsNotUnique
,则您的辅助本地化文件包含重复的同义词或与 DisplayName
值匹配的同义词。 当节点包含 Entity.Definition.'closedListItem'
发生以下任一情况的情况时,通常会遇到此错误:
- 其中一个
Synonyms
元素不是唯一的。 - 其中一个
Synonyms
元素与该DisplayName
元素具有相同的值。
同一实体的所有 Synonyms
元素必须是唯一的,且名称与 DisplayName
元素不同。
若要更正此错误,请查看辅助语言的 JSON 或 ResX 文件,并确定可能存在此条件的任何实例。