Een verrijkingscache configureren

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

Deze functie is in preview onder aanvullende gebruiksvoorwaarden. Preview REST API's ondersteunen deze functie.

In dit artikel wordt uitgelegd hoe u caching toevoegt aan een pijplijn voor vaardigheden, zodat u verrijkingsstappen stroomafwaarts kunt wijzigen zonder elke keer volledig opnieuw op te bouwen. Een vaardighedenset is standaard staatloos en het wijzigen van een deel van de samenstelling vereist een volledige herrun van de indexeerfunctie. Met een verrijkingscache bepaalt de indexeerfunctie welke onderdelen van de documentstructuur moeten worden vernieuwd op basis van wijzigingen in de vaardighedenset of indexeerfunctiedefinitie. De indexeerfunctie behoudt en hergebruikt waar mogelijk bestaande verwerkte uitvoer.

U plaatst inhoud in de cache in Azure Storage met behulp van een verbindingsreeks die u opgeeft. De indexeerfunctie maakt deze objecten wanneer deze wordt uitgevoerd. Houd rekening met de verrijkingscache van een intern onderdeel dat wordt beheerd door uw zoekservice die u niet mag wijzigen.

Belangrijk

Een verrijkingscache is geen back-up van de uitvoer van skillsets, de status van de indexer of geïndexeerde documenten. Er wordt niet bijgehouden welke documenten worden verwerkt. Raadpleeg de sectie Beperkingen voor grote gegevensbronnen voordat u caching inschakelt.

• Een container met de naam ms-az-search-indexercache-<alpha-numeric-string>
• Tabellen met de naam MsAzSearchIndexerCacheIndex<alpha-numeric-string>

Voorwaarden

• Azure Storage voor het opslaan van verrijkingen in de cache. Het opslagaccount moet algemeen v2 zijn.

• Als u alleen voor het indexeren van blobs gesynchroniseerde documenten wilt verwijderen uit zowel de cache als de index wanneer blobs uit uw gegevensbron worden verwijderd, schakelt u een verwijderingsbeleid in de indexeerfunctie in. Zonder dit beleid wordt documentverwijdering uit de cache niet ondersteund.

U moet bekend zijn met het instellen van indexeerders en vaardigheidsets. Begin met het overzicht van de indexeerfunctie en ga verder met vaardighedensets voor meer informatie over verrijkingspijplijnen.

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. Dit gedrag wordt verwacht, geen bug.

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. Zie Grote gegevenssets indexeren voor hulp bij het partitioneringspatroon.

Machtigingen

Een Azure AI Zoeken identiteit moet schrijftoegang hebben tot Azure Storage:

• Inzender voor opslagblobgegevens
• Inzender voor opslagtabelgegevens

De verbindingsreeks syntaxis bepaalt of een door het systeem toegewezen of door de gebruiker toegewezen identiteit wordt gebruikt. Zie Connect to Azure Storage using a managed identity voor meer informatie.

De cache-eigenschap instellen

Gebruik deze procedure voor zowel nieuwe als bestaande indexeerfuncties.

Stel in de definitie van de indexeerfunctie het volgende cache in:

• (Vereist) storageConnectionString moet ingesteld zijn op een Azure Storage verbindingstekenreeks.
• (Optioneel) enableReprocessing (true standaard). Stel deze in op false om de incrementele verrijking tijdelijk te onderbreken, en schakel het later weer terug naar true.

Azure portal

1. Kies aan de linkerkant Indexers.

2. Selecteer Indexeerfunctie toevoegen om een nieuwe indexeerfunctie te maken of open een bestaande indexeerfunctie in de JSON-bewerkingsmodus.

3. Schakel incrementele verrijking in, stel het opslagaccount voor de verrijkingscache in en sla de indexeerfunctie op.

   

4. Stel de indexeerfunctie opnieuw in als deze al bestaat.

5. Voer de indexeerfunctie uit. Deze eenmalige volledige opbouw vult de cache. Nadat het is geladen, is incrementeel hergebruik van toepassing op volgende uitvoeringen.

REST

Als u een bestaande indexeerfunctie bewerkt, gebruikt u GET Indexer om de huidige configuratie op te halen.

1. Gebruik de nieuwste preview-API voor Indexeerfunctie maken of bijwerken.

   PUT https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]?api-version=2026-08-01-preview
       Content-Type: application/json
       api-key: [YOUR-ADMIN-KEY]
       {
           "name": "<YOUR-INDEXER-NAME>",
           "targetIndexName": "<YOUR-INDEX-NAME>",
           "dataSourceName": "<YOUR-DATASOURCE-NAME>",
           "skillsetName": "<YOUR-SKILLSET-NAME>",
           "cache": {
               "storageConnectionString": "<YOUR-STORAGE-ACCOUNT-CONNECTION-STRING>",
               "enableReprocessing": true
           },
           "fieldMappings": [],
           "outputFieldMappings": [],
           "parameters": []
       }
   

2. Stel de indexeerfunctie opnieuw in als deze al bestaat.

3. Voer de indexeerfunctie uit. Deze eenmalige volledige opbouw vult de cache. Nadat het is geladen, is incrementeel hergebruik van toepassing op volgende uitvoeringen.

   POST https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]/run?api-version=2026-08-01-preview
       Content-Type: application/json
       api-key: [YOUR-ADMIN-KEY]
   

Als u nu een andere GET-aanvraag op de indexeerfunctie uitgeeft, bevat het antwoord van de service een ID eigenschap in het cacheobject. De tekenreeks wordt toegevoegd aan de naam van de container met alle resultaten in de cache en tussenliggende status van elk document dat door deze indexeerfunctie wordt verwerkt. De id wordt gebruikt om de cache in Blob Storage een unieke naam te geven.

    "cache": {
        "ID": "<ALPHA-NUMERIC STRING>",
        "enableReprocessing": true,
        "storageConnectionString": "DefaultEndpointsProtocol=https;AccountName=<YOUR-STORAGE-ACCOUNT>;AccountKey=<YOUR-STORAGE-KEY>;EndpointSuffix=core.windows.net"
    }

Controleren op gecachte uitvoer

1. Meld u aan bij de Azure-portal en zoek uw Azure Storage-account.

2. Gebruik Opslagbrowser om containers en tabellen te controleren.

   • De containernaam is ms-az-search-indexercache-<some-alphanumeric-string>.

   • Tabelnamen zijn MsAzSearchIndexerCacheIndex<alpha-numeric-string>.

Een indexeerfunctie maakt en gebruikt een cache. De inhoud ervan kan niet door mensen worden gelezen.

Als u wilt controleren of de cache operationeel is, wijzigt u een vaardighedenset en voert u de indexeerfunctie uit en vergelijkt u de metrische gegevens vóór en na voor de uitvoeringstijd en het aantal documenten.

Vaardigheden die afbeeldingsanalyse en OCR (Optical Character Recognition) van gescande documenten omvatten, zijn goede testcases. Als u een vaardigheid voor downstreamtekst of een vaardigheid wijzigt die niet gerelateerd is aan afbeeldingen, kan de indexeerfunctie eerder verwerkte afbeeldings- en OCR-inhoud ophalen uit de cache en alleen tekstgerelateerde wijzigingen van uw bewerkingen verwerken. U kunt minder documenten verwachten in het aantal indexeerfuncties, kortere uitvoeringstijden en lagere kosten.

De bestandset gebruikt in cog-search-demo tutorials is een handige testcase omdat het 14 bestanden van verschillende indelingen JPG, PNG, HTML, DOCX, PPTX en andere typen bevat. Wijzig en naar es of een andere taal in de tekstvertaalvaardigheid voor proof-of-concepttests van incrementele verrijking.

Veelvoorkomende fouten

De volgende fout treedt op als u vergeet een preview-API-versie op te geven voor de aanvraag:

"The request is invalid. Details: indexer : A resource without a type name was found, but no expected type was specified. To allow entries without type information, the expected type must also be specified when the model is specified."

Er treedt ook een 400 Bad Request-fout op als een vereiste voor de indexeerfunctie ontbreekt. Het foutbericht geeft eventuele ontbrekende afhankelijkheden op.

Volgende stap

U kunt incrementele verrijking gebruiken voor indexeerfuncties die vaardighedensets bevatten, zodat u inhoud voor zowel indexen als kennisarchieven opnieuw kunt gebruiken. Zie het volgende artikel voor meer informatie over cachebeheer:

• Een verrijkingscache beheren