你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
有关 QnA Maker 服务的最常见问题的特选列表可帮助你更快、更顺利地采用该服务。
注意
QnA Maker 服务将于 2025 年 10 月 31 日停用(从 2025 年 3 月 31 日延长)。 问答功能的较新版本现已作为 Azure AI 语言的一部分提供。 有关语言服务中的问答功能,请参阅问答。 从 2022 年 10 月 1 日开始,你将无法再创建新的 QnA Maker 资源。 从 2025 年 3 月 31 日开始,QnA Maker 门户不再可用。 有关将现有 QnA Maker 知识库迁移到问题解答的信息,请参阅迁移指南。
管理预测
如何获取 QnAMaker 服务终结点
答:在联系 QnAMaker 客户支持部门或 UserVoice 时,QnAMaker 服务终结点对调试工作非常有用。 此终结点是采用以下格式的 URL:https://your-resource-name.azurewebsites.net。
在 Azure 门户中转到 QnAMaker 服务(资源组)

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

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

管理知识库
我不小心删除了一部分 QnA Maker,我该怎么办?
答:请勿删除随 QnA Maker 资源(如搜索或 Web 应用)一起创建的任何 Azure 服务。 如果删除一个服务,QnA Maker 将停止正常工作,这些服务是必需的。
所有删除操作都是永久性的,包括问题和答案对、文件、URL、自定义问题和答案、知识库或 Azure 资源。 在删除知识库的任何部分之前,请务必从“设置”页导出知识库。
为什么我的 URL/文件没有提取问答对?
答:QnA Maker 可能无法从有效的常见问题解答 URL 自动检索某些问答(QnA)内容。 在这种情况下,可以将 QnA 内容粘贴到 .txt 文件中,并查看该工具是否可以引入它。 或者,也可以通过 QnA Maker 门户以编辑方式向知识库添加内容。
我能创建多大的知识库?
答:知识库的大小取决于在创建 QnA Maker 服务时选择的 Azure 搜索的 SKU。 请参阅此处了解详细信息。
当我尝试创建新知识库时,为什么在下拉列表中看不到任何内容?
答:尚未在 Azure 中创建任何 QnA Maker 服务。 请阅读此文了解如何执行该操作。
如何与他人共享知识库?
答:共享服务中的所有知识库。 请参阅此处了解如何在知识库上进行协作。
是否可以与不在同一个 AAD 租户中的参与者共享知识库,以修改知识库?
答:共享依据的是 Azure 基于角色的访问控制。 如果可与其他用户共享 Azure 中的任何资源,则也可以共享 QnA Maker。
如果应用服务计划有 5 个 QnAMaker 知识库,能否向 5 位不同的用户分配读/写权限,使每位用户只能访问 1 个 QnAMaker 知识库?
答:可以共享整个 QnAMaker 服务,但不能共享个体知识库。
如果找不到良好匹配,如何更改默认消息?
答:默认消息是应用服务中设置的一部分。
- 在 Azure 门户中转到自己的应用服务资源

- 选择“设置”选项

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

为什么我的 SharePoint 链接没有被提取?
答:有关详细信息, 请参阅数据源位置 了解详细信息。
我对知识库所做的更新未反映在发布中,为什么?
答:每个编辑操作(无论在表更新、测试还是在设置中)需要先保存才能发布。 每次编辑操作后,都请务必选择“保存并训练”按钮。
知识库是否支持丰富的数据或多媒体?
答:
文件和 URL 的多媒体自动提取功能
URLS- 有限的 HTML 到 Markdown 转换功能。- 文件 - 不受支持
Markdown 中的回答文本
一旦 QnA 对位于知识库中,即可编辑回答的 Markdown 文本以包含指向公用 URL 上可用媒体的链接。
管理服务
我何时应该重启应用服务?
答:在“用户设置”页上终结点密钥表中知识库的版本值旁边出现警告图标时,刷新应用服务。
我删除了现有搜索服务,该如何解决此问题?
答:如果删除 Azure AI 搜索索引,则该操作是不可逆的,并且无法恢复索引。
我删除了搜索服务中的“testkb”,该如何解决此问题?
答:如果你删除了搜索服务中的 testkb 索引,可从上次发布的知识库中还原数据。 使用 GitHub 上提供的恢复工具 RestoreTestKBIndex 。
我收到以下错误:请检查是否存在任何组织特定的网络限制。如何解决此问题?
答:在“应用服务”窗格的“API”部分中,更新 CORS 设置。 如果此设置无法解决问题,请检查是否存在任何特定于组织的限制。
我应该何时刷新终结点密钥?
答:如果怀疑终结点密钥遭到入侵,请刷新终结点密钥。
是否可以将同一 Azure AI 搜索资源用于使用多种语言的知识库?
答:若要使用多种语言和多个知识库,用户必须为每种语言创建一个 QnA Maker 资源。 此步骤为每个语言创建单独的 Azure 搜索服务。 在单个 Azure 搜索结果中混合不同的语言知识库会导致结果相关性下降。
如何更改 QnA Maker 使用的 Azure AI 搜索资源的名称?
答:Azure AI 搜索资源的名称是 QnA Maker 资源名称加上在末尾追加的一些随机字母。 命名约定使得很难区分 QnA Maker 的多个搜索资源。 请创建一个单独的搜索服务(以你喜欢的方式对其进行命名)并将其连接到你的 QnA 服务。 步骤类似于升级 Azure 搜索时需要执行的步骤。
当 QnA Maker 返回“运行时内核未初始化”时,我该如何解决?
答:应用服务的磁盘空间可能已满。 修复磁盘空间的步骤:
在 Azure 门户中,选择 QnA Maker 的应用服务,然后停止该服务。
在仍然使用 App 服务时,依次选择“开发工具”、“高级工具”和“开始”。 此步骤将打开新的浏览器窗口。
选择“调试控制台”,再选择“CMD”打开命令行工具。
导航到“site/wwwroot/Data/QnAMaker/”目录。
删除以
rd名称开头的所有文件夹。不要删除以下内容:
- KbIdToRankerMappings.txt 文件
- EndpointSettings.json 文件
- EndpointKeys 文件夹
启动应用服务。
访问知识库,以验证其现在是否正常工作。
为什么我的 Application Insights 不起作用?
答:交叉检查并更新以下步骤并修复问题:
在“应用服务”->“设置组”->“配置部分”->“应用程序设置”->名称”中,“UserAppInsightsKey”参数已正确配置,并设置为相应的应用程序见解“概述”选项卡(“检测密钥”)向导。
在“应用服务”->“设置组”->“应用程序见解”部分中 -> 保应用见解已启用,并将其连接到相应的应用程序见解资源。
我的 Application Insights 已启用,但为什么无法正常工作?
答:按照以下给定步骤作:
如果其中已存在某个值,请通过重写将“APPINSIGHTS_INSTRUMENTATIONKEY”名称的值复制到“UserAppInsightsKey”名称。
如果应用设置中不存在“UserAppInsightsKey”密钥,请添加具有该名称的新密钥并复制该值。
保存它,并自动重启应用服务。 此步骤应解决此问题。
与其他服务(包括机器人)集成
为了使用 QnA Maker,需要使用 Bot Framework 吗?
答:否,无需将 Bot Framework 与 QnA Maker 配合使用。 但是,QnA Maker 作为 Azure AI 机器人服务中的几个模板之一提供。 机器人服务通过 Microsoft Bot Framework 实现快速智能机器人开发,并且它在无服务器的环境中运行。
如何使用 QnA Maker 创建新的机器人?
答:请按照本文档中的说明使用 Azure AI 机器人服务创建机器人。
如何将其他知识库与现有的 Azure AI 机器人服务一起使用?
答:你需要了解有关知识库的下列信息:
- 知识库 ID。
- 发布后,“设置”页面上称为
host的知识库的已发布终结点自定义子域名。 - 发布后,“设置”页面上的知识库的已发布终结点密钥。
有关此信息,请转到 Azure 门户中的机器人的应用服务。 在“设置”->“配置”->“应用程序设置”下,更改这些值。
知识库的终结点密钥在 ABS 服务中标记为 QnAAuthkey。
两个或多个客户端应用程序是否可以共享知识库?
答:是的,可以从任意数量的客户端查询知识库。 如果发现来自知识库的响应速度缓慢或超时,请考虑升级与知识库关联的应用服务的服务层。
数据存储
存储哪些数据以及存储在何处?
答:
创建 QnA Maker 服务时,你选择了 Azure 区域。 知识库和日志文件存储在此区域中。