你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
注意
某些智能检索功能在2026-04-01 REST API版本中通过编程访问已普遍可用。 Azure门户和 Microsoft Foundry 门户继续提供对所有代理检索功能的仅限预览的访问权限。 有关迁移指南(包括正式发布的内容和预览版的内容的细分),请参阅 将代理检索代码迁移到最新版本。
知识源指定用于代理检索的内容。 它封装由外部数据填充的搜索索引,或者它是与直接查询的远程目标(例如必应或SharePoint)的直接连接。 知识源是知识库中的必需定义。
在搜索服务上将知识源创建为顶级资源。 每个知识源都指向一个数据结构,即 满足代理检索条件 的搜索索引或受支持的外部资源。
引用 知识库中的一个或多个知识源。 在代理检索管道中,可以在单个请求中针对多个知识源进行查询。 为每个知识源生成子查询。 检索响应中返回排名靠前的结果。
对于某些知识源,可以使用知识源定义生成可用于代理检索的完整索引器管道(数据源、技能组、索引器和索引)。 知识源中的信息用于生成所有对象,包括填充索引、分块索引和可搜索索引,而不是手动创建多个对象。
在创建知识库之前,请确保至少有一个知识库。 可以在 REST API 参考中找到有关知识来源和知识库的完整规范。
使用知识库
创建路径:首先创建知识源,然后创建知识库。
删除路径:更新或删除知识库以删除对知识库的引用,然后最后删除知识库。
知识源、其索引和知识库必须全部存在于同一搜索服务上。 外部内容可以通过公共互联网(必应)或在 Microsoft 组织租户(远程 SharePoint)中进行访问。
支持的知识源
可以创建以下知识源:
| 种类 | 索引或远程 |
|---|---|
"searchIndex" API 包装现有索引。 |
已编入索引 |
"azureBlob" API 生成一个从 Blob 容器中提取数据的索引器管道。 |
已索引 |
"indexedOneLake" API 生成一个索引器管道,该管道从 Lakehouse 中拉取数据。 |
索引 |
"indexedSharePoint" API(预览版)生成用于从 SharePoint 站点提取数据的索引器管道。 |
索引 |
"remoteSharePoint" API(预览版)直接从SharePoint检索内容。 |
远程 |
"web" API从Microsoft 必应检索实时地面数据。 |
远程 |
在 Azure AI 搜索 中,已索引的知识源指向目标索引。 查询的执行是在您的搜索服务中的搜索引擎本地完成的。 关键字(全文搜索)、矢量和混合查询功能用于从索引知识源检索数据。
在查询时访问远程知识源。 代理检索引擎调用平台本机的检索API(必应或SharePoint API)。
检索到的所有内容(无论是索引内容还是远程内容)都会被拉入 Azure AI 搜索的排名管道,其中对内容的相关性进行评分、合并(假设有多个查询)、重新排序,并在检索响应中返回。
创建知识源
将知识源创建为独立对象。 然后,在“knowledgeSources”数组的知识库中指定它们。
若要在搜索服务上创建对象,需要 “搜索服务参与者” 权限。 如果使用创建索引器管道的知识源,则还需要 搜索索引数据参与者 权限才能加载索引。 或者,可以使用 API 管理密钥 而不是角色。
使用Azure门户、REST API 或Azure SDK包创建知识源。 以下链接提供有关创建知识源的说明:
- 如何创建搜索索引知识源(包装现有索引)
- 如何创建 Blob 知识源(生成索引器管道)
- 如何创建 OneLake 知识源(生成索引器管道)
- 如何创建SharePoint(索引)知识源(生成索引器管道)
- 如何创建SharePoint(远程)知识源(直接查询SharePoint)
- 如何创建 Web 知识库资源(连接到必应的公共终结点)
创建知识库后,请在知识库中引用它。
使用知识资源
可以通过设置 alwaysQuery 知识源定义或通过查询规划期间使用的指导说明来显式控制知识源使用情况。 指导说明是指有关索引的说明,或知识源中的显式检索说明,这些说明提供有关何时使用索引的指导。 使用 LLM 的低或中等检索推理工作时,会发生查询规划。 为了尽量减少推理工作,知识库中列出的所有知识源都属于每个查询的范围。 对于低和中等情况,知识库和 LLM 可以在查询时确定哪些知识源最有可能提供最佳的搜索语料库。
知识源选择逻辑基于以下因素:
alwaysQuery是否已设置? 如果是,则始终在每个查询上使用知识源。name知识来源。假设
description是一个包含索引的知识源。retrievalInstructions检索操作或知识库定义中指定的指导包括或排除知识源。 这类似于提示。 你可以将简洁性、音调和格式指定为检索指令。outputMode在知识库上也会影响查询输出以及响应中包含的内容。
使用检索推理方法来管控 LLM 使用
并非所有解决方案都受益于 LLM 查询规划和执行。 如果简单性和速度超过了 LLM 查询规划和上下文工程提供的好处,请指定最少的推理工作,以防止在管道中进行 LLM 处理。
对于低和中,LLM 处理级别是一种平衡或最大方法,可提高相关性。 有关详细信息,请参阅 设置检索推理工作。
注意
如果在上一个预览版中使用了 attemptFastPath,则该方法现在被 retrievalReasoningEffort 替代,设置为 minimal。