Note
Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。
Important
新度感知檢索目前處於公開預覽階段,並受 Microsoft Azure 預覽補充使用條款的約束。
有關此功能專屬的預覽條款,請參閱 預覽功能。
新鮮度感知檢索 (預覽)讓已索引的知識來源在代理檢索過程中偏好較新的內容。 知識來源可包含新鮮度原則,讓 Foundry IQ(Azure AI 搜尋服務)在排名時偏向較新的文件,而無需呼叫端在每次檢索請求時傳送自訂排名邏輯。
新鮮度是一種排名偏誤,而非硬性篩選。 舊文件在與查詢高度相關時仍可出現。
使用支援
| Azure portal | Microsoft Foundry 入口網站 | .NET SDK | Python SDK | Java SDK | JavaScript SDK | REST API |
|---|---|---|---|---|---|---|
| ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
先決條件
一個建立並維護 Foundry IQ 索引的 索引知識來源 ,例如 blob 知識來源。
一個參考知識來源的 知識庫 。
更新知識庫的權限 設定無金鑰驗證,並將搜尋服務參與者角色指派給您的使用者帳戶(建議),或使用管理員 API 金鑰。
最新的
Azure.Search.Documents預覽套件:dotnet add package Azure.Search.Documents --prerelease對於無鑰匙認證,套件如下
Azure.Identity:dotnet add package Azure.Identity
最新的
azure-search-documents預覽套件:pip install --pre azure-search-documents對於無鑰匙認證,套件如下
azure-identity:pip install azure-identity
Search Service REST API 的 2026-11-01-preview 版本。
對於無金鑰認證,請在
Authorization每個 HTTP 請求的標頭中加入 Microsoft Entra ID 令牌。
何時啟用新鮮度感知檢索
當新內容通常比舊內容更有用或更值得信賴時,啟用新鮮度感知檢索。 常見範例包括發布說明、政策更新、執行手冊、服務公告及營運指引。
不要用新鮮度來取代過濾。 如果查詢必須只返回特定日期範圍的內容,請在擷取請求或知識來源設定中使用過濾器。
設定新鮮度政策
在索引知識來源定義中新增新鮮性政策。 預覽版合約會使用原則套用感知近期性的排名訊號,同時保留擷取管線的其餘部分。
以下範例顯示具有新鮮度原則的 Blob 知識來源。
var knowledgeSource = new AzureBlobKnowledgeSource(
name: "news-articles-ks",
azureBlobParameters: new AzureBlobKnowledgeSourceParameters(connectionString: blobConnectionString, containerName: "news")
{
IngestionParameters = new IngestionParameters
{
FreshnessPolicy = new FreshnessPolicy
{
BoostingDuration = TimeSpan.FromDays(90)
}
}
}
)
{
Description = "A knowledge source for recent news articles."
};
await indexClient.CreateOrUpdateKnowledgeSourceAsync(knowledgeSource);
Reference:AzureBlobKnowledgeSourceParameters
knowledge_source = AzureBlobKnowledgeSource(
name="news-articles-ks",
description="A knowledge source for recent news articles.",
azure_blob_parameters=AzureBlobKnowledgeSourceParameters(
connection_string=blob_connection_string,
container_name="news",
ingestion_parameters=IngestionParameters(
freshness_policy=FreshnessPolicy(boosting_duration="P90D"),
),
),
)
index_client.create_or_update_knowledge_source(knowledge_source)
Reference:AzureBlobKnowledgeSourceParameters
PUT {{search-endpoint}}/knowledgesources/news-articles-ks?api-version=2026-11-01-preview
Content-Type: application/json
Authorization: Bearer {{search-access-token}}
{
"name": "news-articles-ks",
"kind": "azureBlob",
"description": "A knowledge source for recent news articles.",
"azureBlobParameters": {
"connectionString": "{{blob-connection-string}}",
"containerName": "news",
"ingestionParameters": {
"freshnessPolicy": {
"boostingDuration": "P90D"
}
}
}
}
參考:知識來源 - 建立或更新
新鮮度政策是來源攝取參數的一部分。 索引結構經過修改,以支援與 Foundry IQ 評分設定檔 新鮮度函數相容的生成新鮮度欄位。 該 boostingDuration 數值使用與評分檔案新鮮度功能的相同 ISO 8601 持續時間格式,例如 P90D 以 90 天為單位。 新鮮度為排名增添了近期性訊號,但查詢相關性、已設定的檢索設定、語意重新排序及其他排名訊號仍然適用。
您可以透過傳送另一個含新值的建立或更新要求,變更現有知識來源上的 boostingDuration。 評分設定檔可就地更新,無需重新擷取資料。
你無法從現有的知識來源中移除新鮮度政策。 要停用新度感知檢索,請刪除知識來源並建立一個不含 freshnessPolicy的新來源。
驗證排名行為
新鮮度欄位會在擷取時產生,因此該原則會套用至在原則生效後擷取的內容。 內容擷取完成後,執行可回傳近期和較早內容的擷取請求。 成功的配置能更早顯示較新的相關文件,而不會讓檢索變成簡單的日期排序。
如果排名未如預期反映新鮮度,請檢查基礎索引中的 last_modified 欄位。 缺少、過期或不一致的日期會降低新鮮度訊號的品質。