Een verrijkingscache beheren (preview)

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.

Belangrijk

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.

Een verrijkingscache (preview) is een optionele functie waarin verrijkte inhoud wordt opgeslagen die is gemaakt tijdens de uitvoering van de vaardighedenset. De inhoud tussen uitvoeringen blijft behouden, zodat alleen gewijzigde vaardigheden en documenten opnieuw moeten worden verwerkt. Het is geen back-up van de uitvoer van skillsets, de status van de indexer of geïndexeerde documenten.

U maakt de verrijkingscache in Azure Storage. De cache bevat de uitvoer van documentanalyse, plus de resultaten van elke functie voor elk document. Hoewel caching factureerbaar is (er wordt gebruikgemaakt van Azure Storage), worden de totale kosten voor verrijking verlaagd omdat de kosten van opslag lager zijn dan het extraheren van afbeeldingen en AI-verwerking.

Als u een verrijkingscache configureert, wordt in dit artikel uitgelegd hoe u updates voor vaardigheden en gegevensbronnen kunt beheren, zodat u het maximale hulpprogramma krijgt van verrijkingen in de cache.

Voorwaarden

Beperkingen

Voorzichtigheid

Als u de SharePoint indexeerfunctie (preview) gebruikt, vermijdt u incrementele verrijking. Onder bepaalde omstandigheden wordt de cache ongeldig. Als u het opnieuw wilt laden, voert u het opnieuw instellen van een indexeerfunctie en volledig opnieuw opbouwen uit.

Grote gegevensbronnen hebben een extra cachebeperking.

Voorzichtigheid

Voor grote gegevensbronnen kan een verrijkingscache de totale herverwerking verhogen wanneer langdurige vaardigheden, herhaalde onderbrekingen of frequente vaardigheidsfouten optreden. De indexeerfunctie geeft prioriteit aan de juistheid ten opzichte van het minimaliseren van herverwerking, zodat een cacheachterstand van herhaalde onderbrekingen het gedrag voor opnieuw proberen versterkt.

Als u wilt herstellen van een groeiende cacheachterstand, partitioneert u de gegevensbron in kleinere containers of virtuele mappen. Gebruik vervolgens parallelle indexeerfuncties die naar dezelfde index verwijzen. Als u de cache wilt ontkoppelen, stelt u de cache eigenschap in op null in de indexeerfunctie.

Cacheconfiguratie

Fysiek wordt de cache opgeslagen in een blobcontainer en tabellen in uw Azure Storage-account, één per indexeerfunctie. Aan elke indexeerfunctie wordt een unieke en onveranderbare cache-id toegewezen die overeenkomt met de container die wordt gebruikt.

De cache wordt gemaakt wanneer u de cache eigenschap opgeeft en de indexeerfunctie uitvoert. Alleen verrijkte inhoud kan in de cache worden opgeslagen. Als uw indexeerfunctie geen gekoppelde vaardighedenset heeft, is caching niet van toepassing.

In het volgende voorbeeld ziet u een indexeerfunctie waarvoor caching is ingeschakeld. Zie Verrijkingscache configureren voor volledige instructies.

POST https://[YOUR-SEARCH-SERVICE-NAME].search.windows.net/indexers?api-version=2026-08-01-preview
    {
        "name": "myIndexerName",
        "targetIndexName": "myIndex",
        "dataSourceName": "myDatasource",
        "skillsetName": "mySkillset",
        "cache" : {
            "storageConnectionString" : "<Your storage account connection string>",
            "enableReprocessing": true
        },
        "fieldMappings" : [],
        "outputFieldMappings": [],
        "parameters": []
    }

Cachebeheer

De indexeerfunctie beheert de levenscyclus van de cache. Als u een indexeerfunctie verwijdert, verwijdert u ook de cache. Als u de eigenschap van cache de indexeerfunctie instelt op null of de verbindingsreeks wijzigt, wordt de bestaande cache verwijderd tijdens de volgende uitvoering van de indexeerfunctie.

Hoewel incrementele verrijking is ontworpen om wijzigingen zonder tussenkomst van uw kant te detecteren en erop te reageren, kunt u parameters instellen om specifiek gedrag aan te roepen:

Prioriteit geven aan nieuwe documenten

De cache eigenschap bevat een enableReprocessing parameter waarmee wordt bepaald of inhoud in de cache opnieuw wordt verwerkt. Als dit waar is (standaard), verwerkt de indexer documenten in de cache opnieuw wanneer u deze opnieuw uitvoert als een update van een vaardigheid van invloed is op deze documenten.

Als dit onwaar is, worden bestaande documenten niet opnieuw verwerkt door de indexeerfunctie, die prioriteit geeft aan nieuwe inhoud. Stel enableReprocessing alleen tijdelijk in op false. Als u het de meeste tijd waar houdt, zorgt u ervoor dat zowel nieuwe als bestaande documenten geldig blijven voor de huidige definitie van de vaardighedenset.

Evaluatie van vaardigheden overslaan

Het wijzigen van een vaardigheid gaat meestal hand in hand met het opnieuw verwerken van die vaardigheid. Sommige wijzigingen in een vaardigheid moeten echter geen herverwerking activeren. Bijvoorbeeld het implementeren van een aangepaste vaardigheid op een nieuwe locatie of met een nieuwe toegangssleutel. Deze wijzigingen zijn meestal randapparatuurwijzigingen die niet van invloed zijn op de inhoud van de vaardigheidsuitvoer.

Als u weet dat een wijziging aan de vaardigheid oppervlakkig is, kunt u de evaluatie van de vaardigheid overschrijven door de parameter disableCacheReprocessingChangeDetection op true in te stellen:

  1. Roep updatevaardighedenset aan en wijzig de definitie van de vaardighedenset.
  2. Voeg de disableCacheReprocessingChangeDetection=true parameter toe aan de aanvraag.
  3. Verzend de wijziging.

Wanneer u deze parameter instelt, worden alleen updates voor de definitie van de vaardighedenset doorgevoerd. De wijziging wordt niet geëvalueerd op effecten op de bestaande cache. Gebruik een preview-API-versie, 2020-06-30-Preview of hoger. Gebruik de nieuwste preview-API.

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2026-08-01-preview&disableCacheReprocessingChangeDetection

Validatiecontroles voor gegevensbronnen overslaan

De meeste wijzigingen in een gegevensbrondefinitie maken de cache ongeldig. Voor scenario's waarin u echter weet dat een wijziging de cache niet ongeldig mag maken, zoals het wijzigen van een verbindingsreeks of het roteren van de sleutel in het opslagaccount, voegt u de parameter ignoreResetRequirement toe aan de gegevensbronupdate. Stel deze parameter in op true om de doorvoer door te laten gaan, zonder een resetvoorwaarde te activeren die ertoe zou leiden dat alle objecten opnieuw worden opgebouwd en helemaal opnieuw worden ingevuld.

PUT https://[search service].search.windows.net/datasources/[data source name]?api-version=2026-08-01-preview&ignoreResetRequirement

Vaardighedenset-evaluatie afdwingen

Het doel van de cache is om onnodige verwerking te voorkomen. Stel dat u een wijziging aanbrengt in een vaardigheid die de indexeerfunctie niet detecteert (bijvoorbeeld het wijzigen van iets in externe code, zoals een aangepaste vaardigheid).

In dit geval gebruikt u de Reset Skills-API om het opnieuw verwerken van een bepaalde vaardigheid af te dwingen, inclusief eventuele downstreamvaardigheden die afhankelijk zijn van de uitvoer van die vaardigheid. Deze API accepteert een POST-aanvraag met een lijst met vaardigheden die ongeldig moeten worden gemaakt en moeten worden gemarkeerd voor herverwerking. Na het resetten van vaardigheden volgt u een Run Indexer-aanroep om de pijplijnverwerking te starten.

Specifieke documenten opnieuw opslaan in de cache

Als u een indexeerfunctie opnieuw instelt, worden alle documenten in het zoekproces opnieuw verwerkt.

In scenario's waarin slechts een paar documenten opnieuw moeten worden verwerkt, gebruikt u Opnieuw instellen van documenten (preview) om het opnieuw verwerken van specifieke documenten af te dwingen. Wanneer u een document opnieuw instelt, wordt de cache voor dat document ongeldig door de indexeerfunctie. De indexeerfunctie verwerkt het document vervolgens opnieuw door het te lezen uit de gegevensbron. Zie Indexeerfuncties, vaardigheden en documenten uitvoeren of opnieuw instellen voor meer informatie.

Als u specifieke documenten opnieuw wilt instellen, moet u een lijst met documentsleutels opnemen die worden gelezen uit de zoekindex in de aanvraag. Als de sleutel overeenkomt met een veld in de externe gegevensbron, gebruikt u de waarde uit de zoekindex.

Afhankelijk van hoe u de API aanroept, wordt de sleutellijst aangevuld, overschreven of in de wachtrij gezet:

  • Als u de API meerdere keren aanroept met verschillende sleutels, worden de nieuwe sleutels toegevoegd aan de lijst met documentsleutels om deze opnieuw in te stellen.

  • Als u de API aanroept met de overwrite querystringparameter ingesteld op true, wordt de huidige lijst met documentsleutels die opnieuw moeten worden ingesteld overschreven door de payload van de aanvraag.

  • Als u de API aanroept, worden de documentsleutels toegevoegd aan de wachtrij met werk dat de indexeerfunctie uitvoert. Wanneer de indexeerder de volgende keer wordt aangeroepen, hetzij volgens planning hetzij op aanvraag, geeft deze prioriteit aan het verwerken van de opnieuw ingestelde documentsleutels vóór alle andere wijzigingen uit de gegevensbron.

In het volgende voorbeeld ziet u een aanvraag voor het opnieuw instellen van een document:

POST https://[search service name].search.windows.net/indexers/[indexer name]/resetdocs?api-version=2026-08-01-preview
    {
        "documentKeys" : [
            "key1",
            "key2",
            "key3"
        ]
    }

Wijzigingen die de cache ongeldig maken

Wanneer u een cache inschakelt, controleert de indexeerfunctie op wijzigingen in uw pijplijnsamenstelling om te bepalen welke inhoud opnieuw kan worden gebruikt en welke inhoud opnieuw moet worden verwerkt. Deze sectie bevat wijzigingen die de cache ongeldig maken, gevolgd door wijzigingen die incrementele verwerking activeren.

Een ongeldige wijziging is een wijziging waarbij de hele cache ongeldig wordt. Het bijwerken van uw gegevensbron is bijvoorbeeld een ongeldige wijziging. Hier volgt de volledige lijst met wijzigingen in een deel van de indexeerpijplijn die uw cache ongeldig maakt:

  • Het gegevensbrontype wijzigen
  • Gegevensbroncontainer wijzigen
  • Gegevensbronreferenties wijzigen
  • Beleid voor wijzigingsdetectie van gegevensbron wijzigen
  • Detectiebeleid voor verwijderen van gegevensbron wijzigen
  • Veldtoewijzingen voor indexeerfunctie wijzigen
  • Parameters voor indexeerfuncties wijzigen:
    • Parseermodus
    • Uitgesloten bestandsnaamextensies
    • Geïndexeerde bestandsnaamextensies
    • Alleen opslagmetagegevens indexeren voor te grote documenten
    • Tekstkoppen met scheidingstekens
    • Scheidingsteken voor gescheiden tekst
    • Documentroot
    • Afbeeldingsactie (wijzigingen in hoe afbeeldingen worden geëxtraheerd)

Wijzigingen die incrementele verwerking activeren

Incrementele verwerking evalueert uw definitie van uw vaardighedenset en bepaalt welke vaardigheden opnieuw moeten worden uitgevoerd. Hiermee worden de betrokken gedeelten van de documentstructuur selectief bijgewerkt. Hier volgt de volledige lijst met wijzigingen die resulteren in incrementele verrijking:

  • Het vaardigheidstype wijzigen (het OData-type van de vaardigheid bijwerken)
  • Vaardigheidsspecifieke parameters bijwerken, zoals een URL, standaardwaarden of andere parameters
  • Uitvoer van vaardigheden wijzigen, bijvoorbeeld wanneer de vaardigheid extra of andere uitvoer retourneert
  • Vaardigheidsinvoer wijzigen die leidt tot verschillende herkomst- of vaardigheidsketens
  • Het ongeldig maken van een voorgaande vaardigheid, als u een vaardigheid bijwerkt die invoer levert voor deze vaardigheid
  • De projectielocatie van het kennisarchief bijwerken, wat resulteert in het opnieuw projecteren van documenten
  • Het wijzigen van de projecties van het kennisarchief, wat resulteert in het opnieuw projecteren van documenten
  • Uitvoerveldtoewijzingen op een indexeerfunctie wijzigen, wat resulteert in het opnieuw projecteren van documenten naar de index

API's die worden gebruikt voor caching

Preview-API's bieden extra eigenschappen voor indexeerfuncties. Gebruik de nieuwste preview-API.

Gebruik de algemeen beschikbare versie voor vaardighedensets en gegevensbronnen. Naast de referentiedocumentatie raadpleegt u Caching configureren voor incrementele verrijking voor meer informatie over de volgorde van bewerkingen.

  • Laatst bijgewerkt om