Lezen in het Engels

Delen via


Fouten opsporen in sessies in Azure AI Search

Foutopsporingssessies is een visuele editor die werkt met een bestaande vaardighedenset in De Azure-portal, waarbij de structuur en inhoud van één verrijkt document zichtbaar worden gemaakt, omdat deze wordt geproduceerd door een indexeerfunctie en vaardighedenset voor de duur van de sessie. Omdat u met een live document werkt, is de sessie interactief. U kunt fouten identificeren, de uitvoering van vaardigheden wijzigen en aanroepen en de resultaten in realtime valideren. Als uw wijzigingen het probleem oplossen, kunt u ze doorvoeren in een gepubliceerde vaardighedenset om de fixes wereldwijd toe te passen.

In dit artikel worden ondersteunde scenario's uitgelegd en hoe de editor is georganiseerd. Tabbladen en secties van de editor pakken verschillende lagen van de vaardighedenset uit, zodat u de structuur van de vaardighedenset, stroom en de inhoud die tijdens de uitvoering wordt gegenereerd, kunt onderzoeken.

Ondersteunde scenario's

Gebruik foutopsporingssessies om problemen met:

  • Ingebouwde vaardigheden die worden gebruikt voor AI-verrijking, zoals OCR, afbeeldingsanalyse, entiteitsherkenning en extractie van trefwoorden.

  • Ingebouwde vaardigheden die worden gebruikt voor geïntegreerde vectorisatie, met gegevenssegmentering via Tekst splitsen en vectorisatie via een insluitingsvaardigheid.

  • Aangepaste vaardigheden die worden gebruikt voor het integreren van externe verwerking die u biedt.

Vergelijk de volgende foutopsporingssessieafbeeldingen voor de eerste twee scenario's. Voor beide scenario's toont het oppervlak de voortgang van vaardigheden waarmee inhoud wordt gegenereerd of getransformeerd van het brondocument naar de zoekindex. De stroom bevat opties voor indextoewijzing en u kunt de pijlen traceren om het verwerkingspad te volgen. Het detailvenster aan de rechterkant is contextgevoelig. Het toont een weergave van het verrijkte document of de details van een vaardigheid of toewijzing.

In de eerste afbeelding ziet u een patroon voor toegepaste AI-verrijking. Vaardigheden kunnen opeenvolgend of parallel worden uitgevoerd als er geen afhankelijkheden zijn. Uitvoerveldtoewijzingen verzenden verrijkte of gegenereerde inhoud van in-memory gegevensstructuren naar velden in een index.

Schermopname van een foutopsporingssessie voor OCR- en afbeeldingsanalyse.

In de tweede afbeelding ziet u een typisch patroon voor geïntegreerde vectorisatie. Vaardigheden voor geïntegreerde vectorisatie omvatten meestal Text Split en een insluitingsvaardigheid. Een vaardigheid Tekst splitsen segmenteert een document in pagina's. Een insluitvaardigheden biedt vectorisering. Projectietoewijzingen bepalen hoe segmenten van inhoud indexeren. Deze specifieke vaardighedenset slaat de bovenliggende index over en maakt een index van alleen gesegmenteerde inhoud, met behulp van metagegevens om de bron van het segment te identificeren.

Schermopname van een foutopsporingssessie voor geïntegreerde vectorisatie.

Beperkingen

Foutopsporingssessies werken met alle algemeen beschikbare gegevensbronnen voor indexeerfuncties en de meeste voorbeeldgegevensbronnen, met de volgende uitzonderingen:

  • SharePoint Online-indexeerfunctie.

  • Azure Cosmos DB voor MongoDB-indexeerfunctie.

  • Als voor Azure Cosmos DB for NoSQL een rij mislukt tijdens de index en er geen bijbehorende metagegevens zijn, kiest de foutopsporingssessie mogelijk niet de juiste rij.

  • Als een gepartitioneerde verzameling eerder niet is gepartitioneerd, vindt de foutopsporingssessie het document niet voor de SQL-API van Azure Cosmos DB.

  • Voor aangepaste vaardigheden wordt een door de gebruiker toegewezen beheerde identiteit niet ondersteund voor een foutopsporingssessieverbinding met Azure Storage. Zoals vermeld in de vereisten, kunt u een door het systeem beheerde identiteit gebruiken of een volledige toegang opgeven verbindingsreeks die een sleutel bevat. Zie Een zoekservice verbinden met andere Azure-resources met behulp van een beheerde identiteit voor meer informatie.

  • Momenteel is de mogelijkheid om te selecteren welk document voor foutopsporing niet beschikbaar is. Deze beperking is niet permanent en wordt binnenkort opgeheven. Op dit moment selecteert Foutopsporingssessies het eerste document in de brongegevenscontainer of -map.

Hoe een foutopsporingssessie werkt

Wanneer u een sessie start, maakt de zoekservice een kopie van de vaardighedenset, indexeerfunctie en een gegevensbron met één document dat wordt gebruikt om de vaardighedenset te testen. Alle sessiestatus wordt opgeslagen in een nieuwe blobcontainer die is gemaakt door de Azure AI-Search-service in een Azure Storage-account dat u opgeeft. De naam van de gegenereerde container heeft een voorvoegsel van ms-az-cognitive-search-debugsession. Het voorvoegsel is vereist omdat hiermee de kans wordt beperkt dat sessiegegevens per ongeluk worden geëxporteerd naar een andere container in uw account.

Een kopie in de cache van het verrijkte document en de vaardighedenset wordt geladen in de visuele editor, zodat u de inhoud en metagegevens van het verrijkte document kunt inspecteren, met de mogelijkheid om elk documentknooppunt te controleren en elk aspect van de definitie van de vaardighedenset te bewerken. Wijzigingen die in de sessie zijn aangebracht, worden in de cache opgeslagen. Deze wijzigingen hebben geen invloed op de gepubliceerde vaardighedenset, tenzij u ze doorvoert. Als u wijzigingen doorvoert, wordt de productievaardighedenset overschreven.

Als de verrijkingspijplijn geen fouten bevat, kan een foutopsporingssessie worden gebruikt om een document incrementeel te verrijken, elke wijziging te testen en te valideren voordat de wijzigingen worden doorgevoerd.

Foutopsporing in sessieindeling

De visuele editor is ingedeeld in een oppervlakgebied met een voortgang van bewerkingen, te beginnen met het kraken van documenten, gevolgd door vaardigheden, toewijzingen en een index.

Selecteer een vaardigheid of toewijzing en er wordt een deelvenster geopend met relevante informatie.

Schermopname van een detailvenster voor vaardigheden met inzoomen voor meer informatie.

Volg de koppelingen om verder in te zoomen op het verwerken van vaardigheden. In de volgende schermopname ziet u bijvoorbeeld de uitvoer van de eerste iteratie van de vaardigheid Tekst splitsen.

Schermopname van een detailvenster voor vaardigheden met expressie-evaluator voor een bepaalde uitvoer.

Deelvenster Details van vaardigheid

Het detailvenster Vaardigheid bevat de volgende secties:

  • Iteraties: Hier ziet u hoe vaak een vaardigheid wordt uitgevoerd. U kunt de invoer en uitvoer van elk item controleren.
  • Vaardigheidsinstellingen: de JSON-vaardighedensetdefinitie weergeven of bewerken.
  • Fouten en waarschuwingen: geeft de fouten of waarschuwingen weer die specifiek zijn voor deze vaardigheid.

Deelvenster Verrijkte gegevensstructuur

Het deelvenster Verrijkte gegevensstructuur schuift naar de zijkant wanneer u het blauwe symbool voor de weergave of het verbergen van de pijl selecteert. Het is een leesbare weergave van wat het verrijkte document bevat. In eerdere schermafbeeldingen in dit artikel ziet u voorbeelden van de verrijkte gegevensstructuur.

Volgende stappen

Nu u de elementen van foutopsporingssessies begrijpt, start u uw eerste foutopsporingssessie voor een bestaande vaardighedenset.