Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Note
Azure AI Vyhledávač je k dispozici prostřednictvím portálu Azure, rozhraní REST API a Sady Azure SDK. Podporuje také Foundry IQ, spravovanou znalostní vrstvu, která transformuje podnikový obsah na opakovaně použitelné znalostní báze s podporou oprávnění pro agenty na portálu Microsoft Foundry.
Important
Na funkce, možnosti nebo vlastnosti označené jako (Preview) se nevztahuje smlouva o úrovni služeb, nejsou doporučené pro produkční úlohy a mohou se změnit nebo být omezeny dříve, než budou obecně k dispozici. Podmínky Azure AI Vyhledávač Preview platí pro všechny funkce ve verzi Preview, ať už jsou samostatné nebo součástí obecně dostupné funkce.
Načítání se zohledněním aktuálnosti (verze Preview) umožňuje indexovanému zdroji znalostí během agentního načítání upřednostňovat novější obsah. Zdroj znalostí může zahrnovat zásadu aktuálnosti, takže Azure AI Vyhledávač upřednostňuje v hodnocení novější dokumenty, aniž by volající museli při každém požadavku na načtení odesílat vlastní logiku řazení.
Aktuálnost je zvýhodnění v řazení, nikoli striktní filtr. Starší dokumenty se můžou stále zobrazovat, když jsou pro dotaz silně relevantní.
Podpora využití
| portál Azure | Portál Microsoft Foundry | .NET SDK | Python SDK | Java SDK | JavaScript SDK | REST API |
|---|---|---|---|---|---|---|
| ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Předpoklady
indexovaný zdroj znalostí, který vytváří a udržuje index Azure AI Vyhledávač, jako je zdroj znalostí objektů blob.
Znalostní báze, která odkazuje na zdroj znalostí.
Oprávnění k aktualizaci znalostních bází Nakonfigurujte ověřování bez klíčů s rolí Přispěvatel vyhledávací služby přiřazenou k vašemu uživatelskému účtu (doporučeno) nebo použijte klíč rozhraní API pro správu.
Nejnovější balíček
Azure.Search.Documentsve verzi Preview:dotnet add package Azure.Search.Documents --prereleaseBalíček
Azure.Identitypro bezklíčové ověřování:dotnet add package Azure.Identity
Nejnovější balíček
azure-search-documentsve verzi Preview:pip install --pre azure-search-documentsBalíček
azure-identitypro bezklíčové ověřování:pip install azure-identity
Verze 2026-08-01-preview rozhraní REST API vyhledávací služby.
Pro bezklíčové ověřování uveďte v
Authorizationhlavičce každého požadavku HTTP token Microsoft Entra ID.
Kdy povolit vyhledávání s ohledem na aktuálnost
Povolte načítání s podporou aktuálnosti, pokud je novější obsah obecně užitečnější nebo důvěryhodný než starší obsah. Mezi běžné příklady patří poznámky k vydání, aktualizace zásad, provozní příručky, servisní upozornění a provozní pokyny.
Nepoužívejte aktuálnost jako náhradu za filtrování. Pokud dotaz musí vracet pouze obsah z konkrétního rozsahu kalendářních dat, použijte filtr v konfiguraci načtení požadavku nebo zdroje znalostí.
Konfigurace zásad aktuálnosti
Přidejte do definice indexovaného zdroje znalostí zásadu aktuálnosti. Náhledový kontrakt používá zásadu k aplikaci signálu řazení zohledňujícího aktuálnost při zachování zbytku pipeline vyhledávání.
Následující příklad ukazuje zdroj znalostí pro objekty blob se zásadou aktuálnosti.
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);
Referenční informace: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)
Referenční informace:AzureBlobKnowledgeSourceParameters
PUT {{search-endpoint}}/knowledgesources/news-articles-ks?api-version=2026-08-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"
}
}
}
}
Referenční informace:Zdroje znalostí – Vytvoření nebo aktualizace
Zásady aktuálnosti jsou součástí parametrů příjmu dat zdroje. Schéma indexu bylo upraveno tak, aby podporovalo generované pole čerstvosti, které je kompatibilní s funkcemi čerstvosti v profilu hodnocení Azure AI Vyhledávač scoring profile. Hodnota boostingDuration používá stejný formát doby trvání ISO 8601 jako funkce aktuálnosti profilu bodování, například P90D po dobu 90 dnů. Aktuálnost přidává do hodnocení signál aktuálnosti, ale relevance dotazu, nakonfigurovaná nastavení načítání, sémantické přehodnocení pořadí a další signály hodnocení se stále uplatňují.
U existujícího zdroje znalostí můžete změnit boostingDuration odesláním jiného požadavku na vytvoření nebo aktualizaci s novou hodnotou. Bodovací profil se aktualizuje přímo, aniž by bylo nutné data znovu načítat.
Ze stávajícího zdroje znalostí nemůžete odebrat zásady aktuálnosti. Chcete-li zakázat načítání zohledňující aktuálnost, odstraňte zdroj znalostí a vytvořte nový bez freshnessPolicy.
Ověření chování řazení
Pole aktuálnosti se vygeneruje v době příjmu dat, takže zásada se vztahuje na obsah, který se ingestuje po vytvoření zásady. Po ingestci obsahu spusťte žádosti o načtení, které můžou vrátit nedávný i starší obsah. Úspěšná konfigurace upřednostní novější relevantní dokumenty, aby se zobrazovaly dříve, aniž by se vyhledávání změnilo v pouhé řazení podle data.
Pokud řazení neodráží aktuálnost podle očekávání, zkontrolujte last_modified pole v podkladovém indexu. Chybějící, neaktuální nebo nekonzistentní hodnoty data snižují kvalitu signálu aktuálnosti.