Foundry IQ(Azure AI 搜尋服務)中的更多類似內容

Note

Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。

使用moreLikeThis搜尋文件 API 中的參數來尋找與索引中已存在文件相似的文件。 此參數已在 REST API 版本 2026-10-01 中正式提供。 Foundry IQ(Azure AI 搜尋服務)會從來源文件的可搜尋欄位推導出查詢詞,並將該文件排除在結果之外。

範例

這些範例使用 Create an index with permission filter fields 及其 索引工作流程中的四文件索引。 先完成該設定步驟。

以<SEARCH_ACCESS_TOKEN>替換為您的端點,並以<SEARCH_SERVICE_ENDPOINT>替換為已獲授權查詢索引的呼叫權杖。 將 <USER_OBJECT_ID> 替換為上傳時使用之 <USER_ACCESS_TOKEN> 的原始委派使用者權杖。

簡單查詢

使用 search 時,省略 moreLikeThis。 任何非空搜尋文字(包括 "search": "*")都會與 moreLikeThis 發生衝突並造成請求錯誤。

以下 POST 請求使用來源文件金鑰 21 及頂層的可搜尋 content 欄位:

POST <SEARCH_SERVICE_ENDPOINT>/indexes('secured-content-index')/docs/search.post.search?api-version=2026-10-01
Authorization: Bearer <SEARCH_ACCESS_TOKEN>
x-ms-query-source-authorization: <USER_ACCESS_TOKEN>
Content-Type: application/json
Accept: application/json

{
  "moreLikeThis": "21",
  "searchFields": "content",
  "select": "id,content",
  "top": 4,
  "count": true
}

參考資料:搜尋文件(POST)。

排除空白相似度結果的問題

相似性並不保證結果非空。 如果沒有指定金鑰的文件存在,請求會以空value陣列回傳200 OK。

如果這個正向查詢為空,請使用 查詢範例 檢查來源文件 21 與候選人 101 是否可用相同憑證搜尋且可讀取。

即使兩份文件皆可讀,較小的語料庫也可能無法符合相似度查詢的詞頻要求。 文件分發會影響這些要求是否被滿足。

套用濾鏡

搭配 moreLikeThis 篩選器限制候選結果。 此請求會選取園藝相關文件,但在正面查詢中排除該天文候選結果:

POST <SEARCH_SERVICE_ENDPOINT>/indexes('secured-content-index')/docs/search.post.search?api-version=2026-10-01
Authorization: Bearer <SEARCH_ACCESS_TOKEN>
x-ms-query-source-authorization: <USER_ACCESS_TOKEN>
Content-Type: application/json
Accept: application/json

{
  "moreLikeThis": "21",
  "searchFields": "content",
  "select": "id,content",
  "top": 4,
  "count": true,
  "filter": "category eq 'gardening'"
}

參考資料:搜尋文件(POST)。

選擇欄位並限制結果

用以 top 限制結果數量並 select 選擇回傳欄位。 使用以逗號分隔的 searchFields 參數來選取可搜尋欄位。 若省略此項,則適用正常可搜尋欄位解析機制。 由於 moreLikeThis 不支援 複雜的子欄位,當您的索引包含複雜欄位時,請明確選取合適的頂層可搜尋欄位。

範例要求最多四個結果,並返回 id 和 content。 結果仍排除來源文件。

原生文件權限

在啟用原生權限篩選的索引上, moreLikeThis 會在使用來源文件內容前檢查其權限。 它也會透過索引的 ACL 與 RBAC 範圍權限,獨立篩選候選文件。

對於經過權限篩選的查詢,請將受委派使用者的權杖傳入 x-ms-query-source-authorization。 標頭需要一個啟用權限篩選的索引。 有關支援的權限流程,請參閱 查詢時的權杖角色與權限流程。 範例使用直接使用者授權於來源文件與候選文件。

Purview 與代理式查詢不支援搭配 moreLikeThis。

下一步