你当前正在访问 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 服务(资源组)

    QnAMaker Azure resource group in Azure portal

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

    Select QnAMaker App Service

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

    QnAMaker endpoint

管理知识库

我不小心删除了一部分 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 appservice

  • 选择“设置”选项

qnamaker appservice settings

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

qnamaker appservice restart

为什么我的 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 区域。 知识库和日志文件存储在此区域中。