Hantera en berikningscache (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.

Viktigt

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.

En berikningscache (förhandsversion) är en valfri funktion som lagrar berikat innehåll som skapats under körningen av kompetensuppsättningen. Det bevarar innehåll mellan körningar så att endast ändrade kunskaper och dokument kräver ombearbetning. Det är inte en säkerhetskopia av kunskapsuppsättningens utdata, indexerarens tillstånd eller indexerade dokument.

Du skapar berikningscache i Azure Storage. Cachen innehåller utdata från dokumentbearbetning, plus utdata från varje färdighet för varje dokument. Även om cachelagring är fakturerbar (den använder Azure Storage) minskas den totala kostnaden för berikning eftersom kostnaderna för lagring är mindre än bildextrahering och AI-bearbetning.

Om du konfigurerar en berikningscache förklarar den här artikeln hur du hanterar kunskaps- och datakällans uppdateringar så att du får maximal nytta av cachelagrade berikanden.

Förutsättningar

Begränsningar

Försiktighet

Om du använder SharePoint indexeraren (förhandsversion) bör du undvika inkrementell berikning. Under vissa omständigheter blir cachen ogiltig. Om du vill ladda om den igen, utför du en återställning av indexeraren och en fullständig ombyggnad.

Stora datakällor har ytterligare en cachebegränsning.

Försiktighet

För stora datakällor kan en berikningscache öka den totala omarbetningen när långvariga kunskaper, upprepade avbrott eller frekventa kompetensfel inträffar. Indexeraren prioriterar korrekthet framför att minimera upparbetning, så en kvarvarande cachelagring från upprepade avbrott förstärker återförsöksbeteendet.

För att åtgärda en växande cachekö delar du upp datakällan i mindre containrar eller virtuella mappar. Använd sedan parallella indexerare som pekar på samma index. Om du vill koppla från cacheminnet anger du cache egenskapen till null på indexeraren.

Cachekonfiguration

Fysiskt lagras cachen i en blobcontainer och tabeller i ditt Azure Storage konto, en per indexerare. Varje indexerare tilldelas en unik och oföränderlig cacheidentifierare som motsvarar den container som den använder.

Cachen skapas när du anger cache egenskapen och kör indexeraren. Endast berikat innehåll kan cachelagras. Om indexeraren inte har någon bifogad kompetensuppsättning gäller inte cachelagring.

I följande exempel visas en indexerare med cachelagring aktiverat. Se Konfigurera cachelagring av berikning för fullständiga anvisningar.

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": []
    }

Cachehantering

Indexeraren hanterar cachens livscykel. Om du tar bort en indexerare tar du också bort dess cacheminne. Om du ställer in indexerarens cache egenskap på null eller ändrar reťazec pripojenia tas den befintliga cachen bort under nästa indexeringskörning.

Även om inkrementell berikning är utformad för att identifiera och svara på ändringar utan åtgärder från din sida, kan du ange parametrar för att anropa specifika beteenden:

Prioritera nya dokument

Egenskapen cache innehåller en enableReprocessing parameter som styr om cachelagrat innehåll bearbetas på nytt. När det är sant (standard) bearbetar indexeraren cachelagrade dokument när du kör det igen om en kunskapsuppdatering påverkar dem.

När det är falskt bearbetar indexeraren inte befintliga dokument, vilket prioriterar nytt innehåll. Ställ endast in enableReprocessing på false tillfälligt. Att hålla det korrekt för det mesta säkerställer att både nya och befintliga dokument förblir giltiga enligt definitionen av den aktuella kompetensuppsättningen.

Kringgå kompetensutvärdering

Att ändra en färdighet går vanligtvis hand i hand med omarbetning av den färdigheten. Vissa ändringar av en färdighet bör dock inte utlösa ombearbetning. Till exempel att distribuera en anpassad färdighet till en ny plats eller med en ny åtkomstnyckel. Dessa ändringar är vanligtvis perifera ändringar som inte påverkar innehållet i kunskapsutdata.

Om du vet att en ändring av färdigheten är ytlig åsidosätter du kunskapsutvärderingen genom att ange parametern disableCacheReprocessingChangeDetection till true:

  1. Anropa Update Skillset och ändra definitionen för kompetensuppsättningen.
  2. Lägg till parametern disableCacheReprocessingChangeDetection=true i begäran.
  3. Skicka ändringen.

När du anger den här parametern bekräftas endast uppdateringar av kompetensuppsättningsdefinitionen. Ändringen utvärderas inte för effekter på den befintliga cachen. Använd en förhandsversion av API:et 2020-06-30-Preview eller senare. Använd det senaste förhandsversions-API:et.

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

Kringgå verifieringskontroller av datakällor

De flesta ändringar i en datakällas definition gör cachen ogiltig. För scenarier där du vet att en ändring inte bör ogiltigförklara cacheminnet, till exempel att ändra en reťazec pripojenia eller rotera nyckeln på lagringskontot, lägger du till parametern ignoreResetRequirement i datakällans uppdatering. Ange den här parametern till true för att tillåta incheckningen att gå igenom, utan att utlösa ett återställningsvillkor som skulle leda till att alla objekt återskapas och fylls i från grunden.

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

Utvärdering av kraftfulla förmågor

Syftet med cachen är att undvika onödig bearbetning. Men anta att du ändrar till en färdighet som indexeraren inte identifierar (till exempel ändra något i extern kod, till exempel en anpassad färdighet).

I det här fallet använder du API:et för återställningsfärdigheter för att framtvinga ombearbetning av en viss färdighet, inklusive eventuella underordnade kunskaper som är beroende av den färdighetens utdata. Det här API:et accepterar en POST-begäran med en lista över färdigheter som ska ogiltigförklaras och markeras för ombearbetning. När du har återställt färdigheter följer du upp med en Run Indexer-begäran för att anropa pipeline-bearbetningen.

Cachelagrat om specifika dokument

Om du återställer en indexerare bearbetas alla dokument i sök corpus igen.

I scenarier där endast ett fåtal dokument behöver bearbetas igen använder du Återställ dokument (förhandsversion) för att tvinga fram ombearbetning av specifika dokument. När du återställer ett dokument ogiltigförklarar indexeraren cachen för dokumentet. Indexeraren bearbetar sedan dokumentet igen genom att läsa det från datakällan. Mer information finns i Köra eller återställa indexerare, färdigheter och dokument.

Om du vill återställa specifika dokument tar du med en lista över dokumentnycklar som lästa från sökindexet i begäran. Om nyckeln mappas till ett fält i den externa datakällan använder du värdet från sökindexet.

Beroende på hur du anropar API:et lägger begäran antingen till, skriver över eller köar upp nyckellistan:

  • Genom att anropa API:et flera gånger med olika nycklar läggs de nya nycklarna till i listan över dokumentnycklar som ska återställas.

  • Att anropa API:t med frågesträngsparametern overwrite inställd på true skriver över den aktuella listan med dokumentnycklar som ska återställas med nyttolasten i begäran.

  • När du anropar API:et läggs dokumentnycklarna till i kön för det arbete som indexeraren utför. När indexeraren anropas härnäst, antingen enligt schema eller på begäran, prioriteras bearbetningen av dokumentnycklarna för återställning innan andra ändringar från datakällan.

I följande exempel illustreras en begäran om ett återställningsdokument:

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

Ändringar som gör cachen ogiltig

När du aktiverar en cache söker indexeraren efter ändringar i pipelinesammansättningen för att avgöra vilket innehåll den kan återanvända och vilket innehåll som behöver bearbetas. I det här avsnittet visas ändringar som gör cachen ogiltig, följt av ändringar som utlöser inkrementell bearbetning.

En ogiltig ändring är en där hela cacheminnet blir ogiltigt. Att till exempel uppdatera datakällan är en ogiltig ändring. Här är hela listan över ändringar i någon del av indexeringspipelinen som gör cacheminnet ogiltigt:

  • Ändra datakällans typ
  • Ändra datakällans behållare
  • Ändra autentiseringsuppgifter för datakälla
  • Ändra princip för ändringsidentifiering av datakälla
  • Ändra datakällans detekteringspolicy för radering
  • Ändra indexeringsfältmappningar
  • Ändra indexerarparametrar:
    • Parsningsläge
    • Undantagna filnamnstillägg
    • Indexerade filnamnstillägg
    • Indexlagringsmetadata endast för överdimensionerade dokument
    • Avgränsade textrubriker
    • Avgränsad textavgränsare
    • Dokumentrot
    • Bildåtgärd (Ändringar i hur bilder extraheras)

Ändringar som utlöser inkrementell bearbetning

Inkrementell bearbetning utvärderar definitionen av kompetensuppsättningen och avgör vilka färdigheter som behöver köras om. Den uppdaterar selektivt de berörda delarna av dokumentträdet. Här är den fullständiga listan över ändringar som resulterar i inkrementell berikning:

  • Ändra färdighetstyp (uppdatera OData-typen för färdigheten)
  • Uppdatera kunskapsspecifika parametrar, till exempel en URL, standardvärden eller andra parametrar
  • Ändra kunskapsutdata, till exempel när färdigheten returnerar ytterligare eller olika utdata
  • Ändring av indata för färdigheter som resulterar i olika härkomst eller färdighetskedjning
  • All ogiltigförklaring av uppströmsfärdigheter om du uppdaterar en färdighet som ger indata till den här färdigheten
  • Uppdatera kunskapsarkivets projektionsplats, vilket resulterar i omprojekteringsdokument
  • Ändra kunskapslagerprojektionerna, vilket resulterar i omprojektering av dokument
  • Ändra mappningar för utdatafält på en indexerare, vilket resulterar i att dokument projiceras på nytt till indexet

API:er som används för cachelagring

Förhandsversions-API:er ger extra egenskaper för indexerare. Använd det senaste förhandsversions-API:et.

Använd den allmänt tillgängliga versionen för kompetensuppsättningar och datakällor. Förutom referensdokumentationen kan du läsa Konfigurera cachelagring för inkrementell berikning för mer information om ordningen på åtgärder.

  • Uppdaterades senast