Konfigurera fräschhetsmedveten hämtning i Azure AI-sökning (förhandsversion)

Note

Azure AI-sökning är tillgängligt via Azure-portalen, REST-API:er och Azure-SDK:er. Den ligger också till grund för Foundry IQ, det hanterade kunskapsskiktet som omvandlar företagsinnehåll till återanvändbara, behörighetsmedvetna kunskapsbaser för agenter i Microsoft Foundry-portalen.

Important

Funktioner, funktioner eller egenskaper som har markerats (förhandsversion) omfattas inte av ett serviceavtal, rekommenderas inte för produktionsarbetsbelastningar och kan ändras eller begränsas innan de blir allmänt tillgängliga. Villkoren för Azure AI-sökning förhandsgranskning gäller för alla förhandsgranskningsfunktioner, oavsett om de är fristående eller en del av en allmänt tillgänglig funktion.

Med nyhetsmedveten hämtning (förhandsversion) kan en indexerad kunskapskälla föredra nyare innehåll under agentisk hämtning. Kunskapskällan kan innehålla en aktualitetsprincip så att Azure AI-sökning styr rankningen mot nyare dokument utan att kräva att anropare skickar anpassad rankningslogik vid varje hämtningsbegäran.

Färskhet är en snedvridning i rankningen, inte ett strikt filter. Äldre dokument kan fortfarande visas när de är starkt relevanta för frågan.

Användningsstöd

Azure Portal Microsoft Foundry-portalen .NET SDK Python SDK Java SDK JavaScript SDK REST API
❌ ❌ ✔️ ✔️ ✔️ ✔️ ✔️

Förutsättningar

  • Det senaste Azure.Search.Documents förhandsversionspaketet: dotnet add package Azure.Search.Documents --prerelease

  • För nyckellös autentisering, paketet Azure.Identity: dotnet add package Azure.Identity

  • Det senaste azure-search-documents förhandsversionspaketet: pip install --pre azure-search-documents

  • För nyckellös autentisering, paketet azure-identity: pip install azure-identity

När du ska aktivera friskhetsmedveten hämtning

Aktivera fräschhetsmedveten hämtning när nyare innehåll i allmänhet är mer användbart eller tillförlitligt än äldre innehåll. Vanliga exempel är versionsinformation, policyuppdateringar, drifthandböcker, servicemeddelanden och driftanvisningar.

Använd inte färskhet som ersättning för filtrering. Om en fråga bara får returnera innehåll från ett visst datumintervall använder du ett filter i hämtningsbegäran eller kunskapskällans konfiguration i stället.

Konfigurera principen för färskhet

Lägg till en färskhetsprincip i den indexerade kunskapskällans definition. Förhandsgranskningskontraktet använder policyn för att tillämpa en aktualitetsmedveten rankningssignal samtidigt som resten av hämtningsflödet bevaras.

I följande exempel visas en blob-kunskapskälla med en färskhetsprincip.

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);

Referens: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)

Referens: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"
      }
    }
  }
}

Referens:Kunskapskällor – Skapa eller uppdatera

Färskhetsprincipen är en del av parametrarna för källinmatning. Indexschemat har ändrats för att stödja ett genererat fält för färskhet som är kompatibelt med färskhetsfunktioner i Azure AI-söknings poängsättningsprofil. Värdet boostingDuration använder samma ISO 8601-varaktighetsformat som bedömningsprofilens färskhetsfunktioner, till exempel P90D i 90 dagar. Aktualitet lägger till en aktualitetssignal i rankningen, men frågerelevans, konfigurerade hämtningsinställningar, semantisk omrangordning och andra rankningssignaler gäller fortfarande.

Du kan ändra boostingDuration på en befintlig kunskapskälla genom att skicka en annan begäran om att skapa eller uppdatera med det nya värdet. Bedömningsprofilen uppdateras direkt utan att kräva återimport.

Du kan inte ta bort principen för färskhet från en befintlig kunskapskälla. Om du vill inaktivera färskhetsmedveten hämtning tar du bort kunskapskällan och skapar en ny utan freshnessPolicy.

Verifiera rangordningsbeteende

Färskhetsfältet genereras vid inmatningstillfället, så principen gäller för innehåll som matas in när principen har införts. När innehållet har matats in kör du hämta begäranden som kan returnera både nyligen och äldre innehåll. En lyckad konfiguration visar nyare relevanta dokument tidigare utan att göra hämtningen till en enkel datumsortering.

Om rangordningen inte återspeglar färskhet som förväntat kontrollerar du fältet last_modified i det underliggande indexet. Saknade, inaktuella eller inkonsekventa datumvärden minskar kvaliteten på friskhetssignalen.

Relaterat innehåll

  • Uppdaterades senast