你当前正在访问 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
。
在 Azure 门户中转到 QnAMaker 服务(资源组)
选择与 QnA Maker 资源关联的应用服务。 通常,名称是相同的。
在“概述”部分可以找到终结点 URL
管理知识库
我不小心删除了一部分 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 门户中转到自己的应用服务资源
- 选择“设置”选项
- 更改 DefaultAnswer 设置的值
- 重启应用服务
为什么我的 SharePoint 链接没有被提取?
答:有关详细信息,请参阅数据源位置。
我对知识库所做的更新未反映在发布中,为什么?
答:每个编辑操作(无论在表更新、测试还是在设置中)需要先保存才能发布。 每次编辑操作后,都请务必选择“保存并训练”按钮。
知识库是否支持丰富的数据或多媒体?
答案:
文件和 URL 的多媒体自动提取
- URLS - HTML-to-Markdown 转换功能有限。
- 文件 - 不受支持
Markdown 中的回答文本
一旦 QnA 对位于知识库中,即可编辑回答的 Markdown 文本以包含指向公用 URL 上可用媒体的链接。
管理服务
我何时应该重启应用服务?
答:当警告图标位于“用户设置”页上“终结点密钥”表中知识库版本值旁边时,请刷新应用服务。
我删除了现有搜索服务,该如何解决此问题?
答:如果删除 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 返回“运行时内核未初始化”时,我该如何解决?
答:应用服务的磁盘空间可能已满。 修复磁盘空间的步骤:
在 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 机器人服务中的几个模板之一提供。 机器人服务通过 Microsoft Bot Framework 实现快速智能机器人开发,并且它在无服务器的环境中运行。
如何使用 QnA Maker 创建新的机器人?
答:请按照本文档中的说明使用 Azure AI 机器人服务创建机器人。
如何将其他知识库与现有的 Azure AI 机器人服务一起使用?
答:你需要了解有关知识库的下列信息:
- 知识库 ID。
- 发布后,“设置”页面上称为
host
的知识库的已发布终结点自定义子域名。 - 发布后,“设置”页面上的知识库的已发布终结点密钥。
有关此信息,请转到 Azure 门户中的机器人的应用服务。 在“设置”->“配置”->“应用程序设置”下,更改这些值。
知识库的终结点密钥在 ABS 服务中标记为 QnAAuthkey
。
两个或多个客户端应用程序是否可以共享知识库?
答:是的,可以从任意数量的客户端查询知识库。 如果发现来自知识库的响应速度缓慢或超时,请考虑升级与知识库关联的应用服务的服务层。
数据存储
存储哪些数据以及存储在何处?
答案:
创建 QnA Maker 服务时,你选择了 Azure 区域。 知识库和日志文件存储在此区域中。