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

QnA Maker 疑难解答

关于 QnA Maker 服务的最常见问题解答特选列表有助于快速利用此服务,并获得更理想的结果。

注意

QnA Maker 服务将于 2025 年 3 月 31 日停用。 问答功能的较新版本现已作为 Azure AI 语言的一部分提供。 有关语言服务中的问答功能,请参阅问答。 从 2022 年 10 月 1 日开始,你将无法创建新的 QnA Maker 资源。 有关将现有 QnA Maker 知识库迁移到问题解答的信息,请参阅迁移指南

管理预测

如何提高查询预测的吞吐量性能?

答:吞吐量性能问题表明你需要同时扩展应用服务和认知搜索。 请考虑将副本添加到认知搜索以提高性能。

了解有关定价层的更多信息。

如何获取 QnAMaker 服务终结点

答:在联系 QnAMaker 客户支持部门或 UserVoice 时,QnAMaker 服务终结点对调试工作非常有用。 此终结点是采用以下格式的 URL:https://your-resource-name.azurewebsites.net

  1. Azure 门户中转到 QnAMaker 服务(资源组)

    Azure 门户中的 QnAMaker Azure 资源组

  2. 选择与 QnA Maker 资源关联的应用服务。 通常,名称是相同的。

    选择“QnAMaker 应用服务”

  3. 在“概述”部分可以找到终结点 URL

    QnAMaker 终结点

管理知识库

我不小心删除了一部分 QnA Maker,我该怎么办?

答:不要删除与 QnA Maker 资源一起创建的任何 Azure 服务,例如搜索或 Web 应用。 这些是 QnA Maker 工作所必需的,一旦删除某项 Azure 服务,QnA Maker 将停止正常工作。

所有删除操作都是永久性的,包括问题和答案对、文件、URL、自定义问题和答案、知识库或 Azure 资源。 在删除知识库的任何部分之前,请务必从“设置”页导出知识库。

为什么我的 URL/文件没有提取问答对?

答:QnA Maker 可能无法从有效的常见问题解答 URL 中自动提取某些问答 (QnA) 内容。 在这种情况下,可以将 QnA 内容粘贴到 .txt 文件中,并查看该工具是否可以引入它。 或者,也可以通过 QnA Maker 门户以编辑方式向知识库添加内容。

我能创建多大的知识库?

答:知识库的大小取决于在创建 QnA Maker 服务时选择的 Azure 搜索的 SKU。 请参阅此处了解详细信息。

当我尝试创建新知识库时,为什么在下拉列表中看不到任何内容?

答:你尚未在 Azure 中创建任何 QnA Maker 服务。 请阅读此文了解如何执行该操作。

如何与他人共享知识库?

答:共享 QnA Maker 服务级别的工作,即将共享服务中的所有知识库。 请参阅此处了解如何在知识库上进行协作。

是否可以与不在同一个 AAD 租户中的参与者共享知识库,以修改知识库?

答:共享依据的是 Azure 基于角色的访问控制。 如果可与其他用户共享 Azure 中的任何资源,则也可以共享 QnA Maker。

如果应用服务计划有 5 个 QnAMaker 知识库,能否向 5 位不同的用户分配读/写权限,使每位用户只能访问 1 个 QnAMaker 知识库?

答:可以共享整个 QnAMaker 服务,但不能共享个体知识库。

如果找不到良好匹配,如何更改默认消息?

答:默认消息是应用服务中设置的一部分。

  • 在 Azure 门户中转到自己的应用服务资源

qnamaker 应用服务

  • 选择“设置”选项

qnamaker 应用服务设置

  • 更改 DefaultAnswer 设置的值
  • 重启应用服务

qnamaker 应用服务重启

为什么我的 SharePoint 链接没有被提取?

答:有关详细信息,请参阅数据源位置

我对知识库所做的更新未反映在发布中,为什么?

答:每个编辑操作(无论在表更新、测试还是在设置中)需要先保存才能发布。 每次编辑操作后,都请务必选择“保存并训练”按钮。

知识库是否支持丰富的数据或多媒体?

答案:

文件和 URL 的多媒体自动提取

  • URLS - HTML-to-Markdown 转换功能有限。
  • 文件 - 不受支持

Markdown 中的回答文本

一旦 QnA 对位于知识库中,即可编辑回答的 Markdown 文本以包含指向公用 URL 上可用媒体的链接。

QnA Maker 是否支持非英语语言?

答:查看有关支持的语言的更多详细信息。

如果你有多种语言的内容,请务必为每种语言创建单独的服务。

管理服务

我何时应该重启应用服务?

:当警告图标位于“用户设置”上“终结点密钥”表中知识库版本值旁边时,请刷新应用服务。

我删除了现有搜索服务,该如何解决此问题?

:如果删除 Azure 认知搜索索引,则该操作是最终操作,且无法恢复索引。

我删除了搜索服务中的“testkb”,该如何解决此问题?

答:如果你删除了搜索服务中的 testkb 索引,可从上次发布的知识库中还原数据。 请使用 GitHub 上提供的恢复工具 RestoreTestKBIndex

我收到如下错误:“请检查 QnA Maker 应用服务的 CORS 设置是否允许 https://www.qnamaker.ai 或是否存在组织特定的网络限制。”该如何解决此问题?

答:在“应用服务”窗格的“API”部分,将“CORS 设置”更新为 * 或“https://www.qnamaker.ai"”。 如果此文档无法解决问题,请检查是否有组织特定的限制。

我应该何时刷新终结点密钥?

答:如果怀疑终结点密钥已被泄漏,请刷新终结点密钥。

是否可以将同一 Azure AI 搜索资源用于使用多种语言的知识库?

答:若要使用多种语言和多个知识库,用户必须为每种语言创建一个 QnA Maker 资源。 这会为每种语言创建单独的 Azure 搜索服务。 在单个 Azure 搜索服务中混合使用不同语言的知识库会导致结果相关性下降。

如何更改 QnA Maker 使用的 Azure AI 搜索资源的名称?

:Azure AI 搜索资源的名称是 QnA Maker 资源名称加上在末尾追加的一些随机字母。 这使得 QnA Maker 难以区分多个搜索资源。 请创建一个单独的搜索服务(以你喜欢的方式对其进行命名)并将其连接到你的 QnA 服务。 步骤类似于升级 Azure 搜索时需要执行的步骤。

当 QnA Maker 返回“运行时内核未初始化”时,我该如何解决?

答:应用服务的磁盘空间可能已满。 修复磁盘空间的步骤:

  1. Azure 门户中,选择 QnA Maker 的应用服务,然后停止该服务。

  2. 在仍然使用 App 服务时,依次选择“开发工具”、“高级工具”和“开始”。 此时将打开一个新的浏览器窗口。

  3. 选择“调试控制台”,再选择“CMD”打开命令行工具 。

  4. 导航到“site/wwwroot/Data/QnAMaker/”目录。

  5. 删除以 rd 名称开头的所有文件夹。

    不要删除以下内容:

    • KbIdToRankerMappings.txt 文件
    • EndpointSettings.json 文件
    • EndpointKeys 文件夹
  6. 启动应用服务。

  7. 访问知识库,以验证其现在是否正常工作。

为什么我的 Application Insights 不起作用?

答:请交叉检查并更新以下步骤来解决此问题:

  1. 在“应用服务”->“设置组”->“配置部分”->“应用程序设置”->名称”中,“UserAppInsightsKey”参数已正确配置,并设置为相应的应用程序见解“概述”选项卡(“检测密钥”)向导。

  2. 在“应用服务”->“设置组”->“应用程序见解”部分中 -> 保应用见解已启用,并将其连接到相应的应用程序见解资源。

我的 Application Insights 已启用,但为什么无法正常工作?

答:请按以下给定步骤进行操作:

  1. 如果其中已存在某个值,请通过重写将“APPINSIGHTS_INSTRUMENTATIONKEY”名称的值复制到“UserAppInsightsKey”名称。

  2. 如果“UserAppInsightsKey”密钥在应用设置中不存在,请使用该名称添加新密钥并复制值。

  3. 然后进行保存,之后将自动重启应用服务。 这应该可以解决问题。

与其他服务(包括机器人)集成

为了使用 QnA Maker,需要使用 Bot Framework 吗?

答:否,不需要将 Bot Framework 与 QnA Maker 一起使用。 但是,QnA Maker 作为 Azure 机器人服务中的几个模板之一提供。 机器人服务通过 Microsoft Bot Framework 实现快速智能机器人开发,并且它在无服务器的环境中运行。

如何使用 QnA Maker 创建新的机器人?

答:请按照文档中的说明使用 Azure AI 机器人服务创建机器人。

如何将其他知识库与现有的 Azure AI 机器人服务一起使用?

答:你需要了解有关知识库的下列信息:

  • 知识库 ID。
  • 发布后,“设置”页面上称为 host 的知识库的已发布终结点自定义子域名。
  • 发布后,“设置”页面上的知识库的已发布终结点密钥。

有关此信息,请转到 Azure 门户中的机器人的应用服务。 在“设置”->“配置”->“应用程序设置”下,更改这些值。

知识库的终结点密钥在 ABS 服务中标记为 QnAAuthkey

两个或多个客户端应用程序是否可以共享知识库?

答:是的,可以从任意数量的客户端查询知识库。 如果发现来自知识库的响应速度缓慢或超时,请考虑升级与知识库关联的应用服务的服务层。

如何将 QnA Maker 服务嵌入网站?

答:按照以下步骤将 QnA Maker 服务作为 Web 聊天控件嵌入网站:

  1. 按照此处的说明创建常见问题解答机器人。
  2. 按照此处的步骤启用 Web 聊天

数据存储

存储哪些数据以及存储在何处?

答案:

创建 QnA Maker 服务时,你选择了 Azure 区域。 知识库和日志文件存储在此区域中。