Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Note
Azure AI Zoeken is beschikbaar via de Azure-portal, REST API's en Azure-SDK's. Het vormt ook een basis voor Foundry IQ, de beheerde kennislaag die bedrijfsinhoud transformeert in herbruikbare, machtigingsbewuste knowledge bases voor agents in de Microsoft Foundry-portal.
Important
Functies, mogelijkheden of eigenschappen die zijn gemarkeerd (preview) vallen niet onder een service level agreement, worden niet aanbevolen voor productieworkloads en kunnen worden gewijzigd of beperkt voordat ze algemeen beschikbaar worden. De Azure AI Zoeken preview-voorwaarden zijn van toepassing op alle preview-functionaliteit, ongeacht of deze zelfstandig is of deel uitmaakt van een algemeen beschikbare functie.
Ophalen met aandacht voor actualiteit (preview) zorgt ervoor dat een geïndexeerde kennisbron tijdens agentische gegevensophaling de voorkeur kan geven aan nieuwere inhoud. De kennisbron kan een versheidsbeleid bevatten, zodat Azure AI Zoeken de rangschikking in de richting van recentere documenten bevoordeelt zonder dat aanroepers bij elk ophaalverzoek aangepaste rangschikkingslogica hoeven mee te sturen.
Versheid is een rankingvoorkeur, geen strikte filter. Oudere documenten kunnen nog steeds worden weergegeven wanneer ze sterk relevant zijn voor de query.
Gebruiksondersteuning
| Azure-portal | Microsoft Foundry-portal | .NET SDK | Python SDK | Java SDK | JavaScript SDK | REST API |
|---|---|---|---|---|---|---|
| ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Prerequisites
Een geïndexeerde kennisbron die een Azure AI Zoeken-index maakt en onderhoudt, zoals een Blob Storage-kennisbron.
Een knowledge base die verwijst naar de kennisbron.
Machtiging om knowledge bases bij te werken. Configureer sleutelloze verificatie met de rol Inzender voor zoekservice die is toegewezen aan uw gebruikersaccount (aanbevolen) of gebruik een beheer-API-sleutel.
Het nieuwste preview-pakket
Azure.Search.Documents:dotnet add package Azure.Search.Documents --prereleaseVoor sleutelloze verificatie is het
Azure.Identitypakket:dotnet add package Azure.Identity
Het nieuwste preview-pakket
azure-search-documents:pip install --pre azure-search-documentsVoor sleutelloze verificatie is het
azure-identitypakket:pip install azure-identity
De preview-versie 2026-08-01 van de REST API van de Search Service.
Neem voor sleutelloze verificatie een Microsoft Entra ID token op in de
Authorizationheader van elke HTTP-aanvraag.
Wanneer moet u het ophalen van nieuwheidsbewuste gegevens inschakelen
Schakel het ophalen van nieuwheidsbewuste gegevens in wanneer nieuwere inhoud over het algemeen nuttiger of betrouwbaarder is dan oudere inhoud. Veelvoorkomende voorbeelden zijn releaseopmerkingen, beleidsupdates, runbooks, serviceadviezen en operationele richtlijnen.
Gebruik geen versheid als vervanging voor filteren. Als een query alleen inhoud uit een specifiek datumbereik mag retourneren, gebruikt u in plaats daarvan een filter in de aanvraag voor ophalen of de configuratie van de kennisbron.
Het beleid voor nieuwheid configureren
Voeg een nieuwheidsbeleid toe aan de geïndexeerde definitie van de kennisbron. Het previewcontract gebruikt de beleidsregel om een rangschikkingssignaal toe te passen dat rekening houdt met recentheid, met behoud van de rest van de retrieval-pijplijn.
In het volgende voorbeeld ziet u een blobkennisbron met een nieuwheidsbeleid.
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);
Verwijzing: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)
Verwijzing: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"
}
}
}
}
Naslaginformatie:Kennisbronnen - Maken of bijwerken
Het versheidsbeleid maakt deel uit van de bronopnameparameters. Het indexschema wordt aangepast om een gegenereerd freshness-veld te ondersteunen dat compatibel is met de freshness-functies van het Azure AI Zoeken scoringprofiel. De boostingDuration-waarde gebruikt dezelfde ISO 8601-duurindeling als freshness-functies van scoreprofielen, zoals P90D voor 90 dagen. Actualiteit voegt een actualiteitssignaal toe aan de rangschikking, maar queryrelevantie, geconfigureerde instellingen voor ophalen, semantische herordening en andere rangschikkingssignalen zijn nog steeds van toepassing.
U kunt boostingDuration van een bestaande kennisbron wijzigen door een nieuwe aanvraag voor maken of bijwerken te verzenden met de nieuwe waarde. Het scoringsprofiel wordt ter plekke bijgewerkt zonder dat gegevens opnieuw hoeven te worden opgenomen.
U kunt het nieuwheidsbeleid niet verwijderen uit een bestaande kennisbron. Als u nieuwheidsbewust ophalen wilt uitschakelen, verwijdert u de kennisbron en maakt u een nieuwe zonder freshnessPolicy.
Classificatiegedrag valideren
Het versheidsveld wordt gegenereerd tijdens opnametijd, dus het beleid is van toepassing op inhoud die wordt opgenomen nadat het beleid is ingesteld. Nadat inhoud is opgenomen, voert u aanvragen voor ophalen uit die zowel recente als oudere inhoud kunnen retourneren. Een geslaagde configuratie brengt nieuwere relevante documenten eerder naar voren zonder van het ophalen van documenten een eenvoudige sortering op datum te maken.
Als de classificatie niet overeenkomt met de nieuwheid zoals verwacht, controleert u het last_modified veld in de onderliggende index. Ontbrekende, verouderde of inconsistente datumwaarden verminderen de kwaliteit van het versheidssignaal.