Debuggen von Suchproblemen mithilfe des Azure-Portals
Wenn Sie ihren Suchdienst zum ersten Mal erstellen, müssen Sie einige Annahmen zu den Daten machen, die Sie indizieren. Sie treffen Auswahlmöglichkeiten zum Index und zum Aufnehmen dieser Daten. Bis Sie den erstellten Indexer ausführen, können Sie jedoch nicht sicher sein, dass Sie alle richtigen Auswahlmöglichkeiten getroffen haben.
Hier erfahren Sie, wie Sie das Debugsitzungstool in Azure AI Search verwenden, debuggen und dann eine bestimmte Fähigkeit beheben und einen Ansatz zum lokalen Debuggen Ihrer eigenen benutzerdefinierten Fähigkeiten betrachten.
Erfahren Sie, wie Sie das Debugsitzungstool in Azure AI Search verwenden.
Das Tool "Debugsitzung" ist ein interaktiver visueller Editor, mit dem Sie die Anreicherungspipeline eines Dokuments während der Erweiterung durchlaufen können. Sie können zu jeder individuellen Fähigkeit wechseln, Änderungen und Korrekturen vornehmen und dann den Indexer in Echtzeit erneut ausführen. Nachdem Sie probleme behoben haben, können Sie den Indexer aktualisieren und erneut veröffentlichen, damit es erneut ausgeführt werden kann, um alle Dokumente in Ihrem Index zu erweitern.
Nachdem Sie Ihrer Debugsitzung einen Namen gegeben und den Index ausgewählt haben, den Sie debuggen möchten, kopiert der Suchdienst alles, was er in ein Azure Storage-Konto benötigt. Die Kopie enthält das Skillset, den Indexer, die Quelldaten und eine erweiterte Version des Dokuments, das sich im endgültigen Index befindet.
Die Sitzung besteht aus einem Qualifikationsdiagramm, einer erweiterten Datenquelle, einem Detailbereich, einem Ausführungsbereich und einem Bereich mit Fehlern/Warnungen.
Im Detailbereich können Sie einen Ausdrucksauswert erweitern, um den Wert zu überprüfen und die Eingaben und Ausgaben zu testen.
Debuggen eines Skillsets mit Debugsitzungen
Um eine Debugsitzung zu erstellen, navigieren Sie im Azure-Portal zu Ihrem Suchdienst, und führen Sie die folgenden Schritte aus:
Erstellen einer Debugsitzung
Wählen Sie "Debugsitzungen " unter "Suchverwaltung" im Bereich "Übersicht" aus.
Wählen Sie + Debugsitzung hinzufügen aus.
Geben Sie unter Name der Debugsitzung einen Namen an, der Ihnen hilft, sich zu merken, um welches Skillset, welchen Indexer und welche Datenquelle es sich bei der Debugsitzung handelt.
Suchen Sie in der Speicherverbindungszeichenfolge ein allgemeines Speicherkonto zum Zwischenspeichern der Debugsitzung.
Wählen Sie in der Indexervorlage den Indexer aus, der das Skillset steuert, das Sie debuggen möchten. Kopien von Indexer und Skillset werden zur Initialisierung der Sitzung verwendet.
Wählen Sie unter Zu debuggendes Dokument das erste Dokument im Index oder ein bestimmtes Dokument aus.
Wählen Sie "Sitzung speichern" aus, um zu beginnen.
Erkunden und Bearbeiten einer Fähigkeit
Mit Ihrer Debugsitzung können Sie untersuchen, wie ein Dokument bereichert wird, während es durch die einzelnen KI-Fähigkeiten geht. Sie können eine Fähigkeit auswählen, die Eingaben und Ausgaben überprüfen und sogar die JSON-Definition für die Fähigkeiten anzeigen.
Wählen Sie im Abhängigkeitsdiagramm eine Fähigkeit aus.
Wählen Sie im Detailbereich rechts die Registerkarte "Ausführungen" und dann in OUTPUTS den Ausdrucksauswert aus, indem Sie /<neben Organisationen auswählen>.
Um die Qualifikation zu bearbeiten, wählen Sie die Registerkarte "Qualifikationseinstellungen " aus.
Nehmen Sie alle Änderungen am JSON-Code der Fähigkeit vor, und wählen Sie dann "Speichern" aus.
Um zu testen, dass das Problem durch die Änderungen behoben wurde, wählen Sie "Ausführen" aus.
Wenn das Problem jetzt behoben ist und Sie die Änderungen veröffentlichen möchten, wählen Sie oben im Bereich commit-Änderungen... aus.
Um die Debugsitzung abzuschließen, wählen Sie " Sitzung speichern" aus.
Überprüfen der Feldzuordnungen
Indexer können geändert werden, wenn Ihre Eingabedaten nicht ganz mit dem Schema Ihres Zielindex übereinstimmen. Verwenden Sie Feldzuordnungen, um diese Nichtübereinstimmung in Ihren Daten während des Indizierungsprozesses neu zu gestalten und zu beheben.
Wählen Sie Skill Graph aus, und überprüfen Sie, ob Abhängigkeitsdiagramm ausgewählt ist.
Wählen Sie den zweiten Schritt in der Anreicherungspipeline aus, Feldzuordnungen.
Nehmen Sie änderungen an der Stelle vor, an der Daten zugeordnet werden sollen.
Wählen Sie Speichern aus.
Wählen Sie den letzten Schritt aus, Ausgabefeldzuordnungen.
Ausgabefeldzuordnungen aus den Fähigkeiten können im Detailbereich behoben werden.
Wählen Sie Speichern aus.
Um zu testen, dass das Problem durch die Änderungen behoben wurde, wählen Sie "Ausführen" aus.
Wenn das Problem jetzt behoben ist und Sie die Änderungen veröffentlichen möchten, wählen Sie oben im Bereich commit-Änderungen... aus.
