Nakonfigurujte v Azure AI Vyhledávač vyhledávání zohledňující aktuálnost (Preview verze)

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

  • Nejnovější balíček Azure.Search.Documents ve verzi Preview: dotnet add package Azure.Search.Documents --prerelease

  • Balíček Azure.Identity pro bezklíčové ověřování: dotnet add package Azure.Identity

  • Nejnovější balíček azure-search-documents ve verzi Preview: pip install --pre azure-search-documents

  • Balíček azure-identity pro bezklíčové ověřování: pip install azure-identity

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.