Felsöka sessioner i Azure AI Search

Felsökningssessioner är ett visuellt redigeringsprogram som fungerar med en befintlig kompetensuppsättning i Azure-portalen och exponerar strukturen och innehållet i ett enda berikat dokument, eftersom det produceras av en indexerare och kompetensuppsättning under hela sessionen. Eftersom du arbetar med ett livedokument är sessionen interaktiv – du kan identifiera fel, ändra och anropa färdighetskörning och verifiera resultatet i realtid. Om dina ändringar löser problemet kan du checka in dem till en publicerad kompetensuppsättning för att tillämpa korrigeringarna globalt.

Så här fungerar en felsökningssession

När du startar en session skapar söktjänsten en kopia av kompetensuppsättningen, indexeraren och en datakälla som innehåller ett enda dokument som används för att testa kompetensuppsättningen. Alla sessionstillstånd sparas i en ny blobcontainer som skapats av Azure AI-tjänsten Search i ett Azure Storage-konto som du anger. Namnet på den genererade containern har prefixet "ms-az-cognitive-search-debugsession". Prefixet krävs eftersom det minskar risken att oavsiktligt exportera sessionsdata till en annan container i ditt konto.

En cachelagrad kopia av det berikade dokumentet och kompetensuppsättningen läses in i den visuella redigeraren så att du kan granska innehållet och metadata i det berikade dokumentet, med möjlighet att kontrollera varje dokumentnod och redigera alla aspekter av kompetensuppsättningsdefinitionen. Alla ändringar som görs i sessionen cachelagras. Dessa ändringar påverkar inte den publicerade kompetensuppsättningen om du inte checkar in dem. Om du genomför ändringar skrivs produktionskunskapsuppsättningen över.

Om berikningspipelinen inte har några fel kan en felsökningssession användas för att stegvis utöka ett dokument, testa och verifiera varje ändring innan du genomför ändringarna.

Hantera tillståndet för felsökningssessionen

Du kan köra en felsökningssession igen med startknappen eller avbryta en pågående session med hjälp av knappen Avbryt.

Screenshot of the Debug Session control buttons.

FLIKEN > AI-berikanden – Skill Graph

Den visuella redigeraren är uppdelad i flikar och fönster. I det här avsnittet beskrivs komponenterna i det visuella redigeringsprogrammet.

Skill Graph innehåller en visuell hierarki av kompetensuppsättningen och dess körningsordning uppifrån och ned. Färdigheter som är beroende av utdata från andra färdigheter placeras lägre i diagrammet. Kunskaper på samma nivå i hierarkin kan köras parallellt. Färgkodade etiketter för färdigheter i diagrammet anger vilka typer av färdigheter som körs i kunskapsuppsättningen (TEXT eller VISION).

Om du väljer en färdighet i diagrammet visas information om den instansen av färdigheten i det högra fönstret, inklusive dess definition, fel eller varningar och körningshistorik. I Skill Graph väljer du vilken färdighet du vill felsöka eller förbättra. Informationsfönstret till höger är där du redigerar och utforskar.

Screenshot of Skills Graph tab.

Fönstret Kunskapsinformation

När du väljer ett objekt i Skill Graph innehåller det intilliggande fönstret interaktiva arbetsytor i en layout med flikar. En bild av informationsfönstret finns i föregående skärmbild.

Kunskapsinformation omfattar följande områden:

  • Kunskap Inställningar visar en formaterad version av kunskapsdefinitionen.
  • Skill JSON-redigeraren visar det råa JSON-dokumentet för definitionen.
  • Körningar visar de data som motsvarar varje gång en färdighet utfördes.
  • Fel och varningar visar de meddelanden som genereras när sessionen startas eller uppdateras.

På Körningar eller Färdighets-Inställningar väljer du symbolen </> för att öppna uttrycksutvärderingen som används för att visa och redigera uttrycken för kunskapsindata och utdata.

Kapslade indatakontroller i Skill Inställningar kan användas för att skapa komplexa former för projektioner, utdatafältmappningar för ett komplext typfält eller indata till en färdighet. När de används med Uttrycksutvärdering ger kapslade indata en enkel test- och verifieringsuttrycksbyggare.

Fönstret Körningar

En färdighet kan köras flera gånger i en kompetensuppsättning för ett enda dokument. Till exempel körs OCR-färdigheten en gång för varje bild som extraheras från ett enda dokument. Fönstret Körningar visar färdighetens körningshistorik och ger en djupare titt på varje anrop av kunskapen.

Körningshistoriken gör det möjligt att spåra en specifik berikning tillbaka till den färdighet som genererade den. Om du klickar på en kunskapsinmatning navigerar du till den färdighet som genererade indata, vilket ger en stackspårningsliknande funktion. Detta gör det möjligt att identifiera rotorsaken till ett problem som kan visas i en underordnad färdighet.

När du felsöker ett fel med en anpassad färdighet finns det möjlighet att generera en begäran om ett kompetensanrop i körningshistoriken.

FLIKEN > AI-berikade datastrukturer

Fönstret Berikad datastruktur visar dokumentets berikning genom kompetensuppsättningen, som beskriver kontexten för varje berikning och den ursprungliga färdigheten. Uttrycksutvärderaren kan också användas för att visa innehållet för varje berikning.

Screenshot of Enriched Data Structure tab.

Uttrycksutvärdering

Expression Evaluator ger en snabb titt på värdet för valfri sökväg. Det gör att du kan redigera sökvägen och testa resultaten innan du uppdaterar någon av indata eller kontexten för en färdighet eller projektion.

Du kan öppna fönstret från valfri nod eller ett element som visar symbolen </> , inklusive delar av ett beroendediagram eller noder i ett berikande träd.

Expression Evaluator ger dig fullständig interaktiv åtkomst för testning av kunskapskontext, indata och kontroll av utdata.

Screenshot of Expression Evaluator.

Nästa steg

Nu när du förstår elementen i felsökningssessioner startar du din första felsökningssession på en befintlig kompetensuppsättning.