你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

从 QnA Maker 迁移到自定义问答

自定义问答是适用于语言的 Azure 认知服务的一项功能,于 2021 年 5 月引入,其中包含一些新功能,包括使用深度学习排名程序的增强型相关性、精确答案和端到端区域支持。 每个自定义问答项目与 QnA Maker 中的知识库等效。 你可以轻松地将知识库从 QnA Maker 资源迁移到语言资源中的自定义问答项目。 还可以选择将知识库从多个 QnA Maker 资源迁移到特定语言资源。

若要成功迁移知识库,执行迁移的帐户需要具有对所选 QnA Maker 和语言资源的参与者访问权限。 迁移知识库时,会将以下详细信息复制到新的自定义问答项目:

  • QnA 对,其中包括主动学习建议。
  • QnA Maker 资源中的同义词和默认答案。
  • 知识库名称将复制到项目说明字段。

资源级别设置(如基于角色的访问控制 (RBAC))不会迁移到新资源。 必须为迁移后的语言资源重新配置这些资源级别设置。 还需要为语言资源重新启用分析

迁移 SDK 的步骤

SDK 迁移指南旨在帮助从旧的 Microsoft.Azure.CognitiveServices.Knowledge.QnAMaker 迁移到新的问题解答客户端库 Azure.AI.Language.QuestionAnswering。 它将侧重于两个包之间类似操作的并排比较。

迁移知识库的步骤

可以按照以下步骤来迁移知识库:

  1. 使用预先启用的自定义问答创建语言资源。 在 Azure 门户中创建语言资源时,可看到启用自定义问答的选项。 选择该选项并继续时,系统将要求你提供 Azure 搜索详细信息来保存知识库。

  2. 如果要将多种语言的知识库添加到语言资源,请访问 Language Studio,创建你的第一个自定义问答项目,然后选择第一个选项,如下所示。 只能在创建项目时指定语言资源的语言设置。 如果要将一种语言的现有知识库迁移到语言资源,则可以跳过此步骤。

    Screenshot of choose language UI screen

  3. 访问 https://www.qnamaker.ai,然后选择知识库页面上的迁移说明中的“开始迁移”。 这时将打开一个对话框以启动迁移。

    Start Migration button that appears in a banner on qnamaker.ai

  4. 填写启动迁移所需的详细信息。 系统将自动选择租户。 你可以选择切换租户。

    Migrate QnAMaker with red selection box around the tenant selection option

  5. 选择 QnA Maker 资源,其中包含要迁移的知识库。

    Migrate QnAMaker with red selection box around the QnAMaker resource selection option

  6. 选择要将知识库迁移到的语言资源。 你将只能看到那些启用了自定义问答的语言资源。 语言资源的语言设置显示在选项中。 如果未指定语言设置,你将无法将多种语言的知识库从 QnA Maker 资源迁移到语言资源。

    Migrate QnAMaker with red selection box around the language resource option currently selected resource contains the information that language is unspecified

    如果要将多种语言的知识库迁移到语言资源,则必须在创建语言资源的第一个自定义问答项目时启用多语言设置。 可以按照步骤 #2 中的说明进行操作。 如果未指定语言资源的语言设置,则会为其分配所选 QnA Maker 资源的语言。

  7. 选择要迁移的所有知识库,然后选择“下一步”。

    Migrate QnAMaker with red selection box around the knowledge base selection option with a drop-down displaying three knowledge base names

  8. 你可以查看你计划迁移的知识库。 由于我们对自定义问答项目遵循更严格的验证规则,因此项目名称中可能存在一些验证错误。 若要解决因无效字符而出现的这些错误,请选中复选框(红色)并单击“下一步”。 这是一种一键式方法,可以将名称中有问题的字符替换为已接受的字符。 如果存在重复项,系统会生成新的唯一项目名称。

    注意

    如果迁移的知识库与目标语言资源中已存在的项目同名,则所选知识库的内容将覆盖该项目的内容。

    Screenshot of an error message starting project names can't contain special characters

  9. 解决验证错误后,选择“开始迁移”

    Screenshot with special characters removed

  10. 完成迁移需要几分钟时间。 请不要在迁移过程中取消迁移。 可以在迁移后导航到 Language Studio 中的已迁移项目。

    Screenshot of successfully migrated knowledge bases with information that you can publish by using Language Studio

    如果有任何知识库未能迁移到自定义问答项目,则会显示错误。 最常见的迁移错误发生在以下情况:

    • 源资源和目标资源无效。
    • 你正在尝试迁移空知识库 (KB)。
    • 已达到与目标资源链接的 Azure 搜索实例的限制。

    Screenshot of a failed migration with an example error

    解决这些错误后,可以重新运行迁移。

  11. 迁移只会复制知识库的测试实例。 迁移完成后,将需要手动部署知识库,以将测试索引复制到生产索引。

后续步骤