Debuggen von Suchproblemen mithilfe des Azure-Portals
Wenn Sie Ihren Suchdienst erstellen, müssen Sie einige Annahmen bezüglich der Daten vornehmen, die Sie indizieren. Sie treffen Entscheidungen zum Index und zum Erfassen dieser Daten. Bis Sie jedoch Ihren erstellten Indexer ausführen, können Sie nicht sicher sein, dass Sie alle richtigen Entscheidungen getroffen haben.
Hier erfahren Sie, wie Sie das Debugsitzungstool in Azure KI-Suche verwenden und wie das Debuggen und das Korrigieren eines bestimmten Skills funktionieren. Außerdem lernen Sie einen Ansatz zum lokalen Debuggen Ihrer eigenen benutzerdefinierten Skills kennen.
Kennenlernen des Debugsitzungstools in Azure KI-Suche
Das Debugsitzungstool ist ein interaktiver visueller Editor, mit dem Sie die Anreicherungspipeline eines Dokuments durchlaufen können, während es angereichert wird. Sie können sich jeden einzelnen Skill vornehmen, Änderungen und Korrekturen durchführen und dann den Indexer in Echtzeit noch einmal ausführen. Nachdem Sie etwaige Probleme behoben haben, können Sie den Indexer aktualisieren und wieder veröffentlichen, damit er noch einmal ausgeführt werden kann und alle Dokumente in Ihrem Index angereichert werden können.
Nachdem Sie Ihrer Debugsitzung einen Namen gegeben und den Index ausgewählt haben, den Sie debuggen möchten, kopiert der Suchdienst alles Benötigte in ein Azure Storage-Konto. Die Kopie enthält das Skillset, den Indexer, die Quelldaten und eine angereicherte Version des Dokuments, das sich im endgültigen Index befindet.
Die Sitzung besteht aus einem Skilldiagramm, einer angereicherten Datenquelle, einem Skilldetailbereich, einem Ausführungsbereich und einem Fehler-/Warnungsbereich.
Mit dem Skilldetailbereich können Sie einen Ausdrucksauswerter erweitern, um den Wert zu überprüfen sowie die Eingaben und Ausgaben zu testen.
Debuggen eines Skillsets mit Debugsitzungen
Um eine Debug-Sitzung zu erstellen, navigieren Sie zu Ihrem Suchdienst im Azure-Portal und führen 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.
Klicken Sie auf Sitzung speichern, um zu beginnen.
Erkunden und Bearbeiten eines Skills
Mit Ihrer Debugsitzung können Sie ermitteln, wie ein Dokument angereichert wird, während es jeden der KI-Skills durchläuft. Sie können einen Skill auswählen, die Eingaben und Ausgaben überprüfen und auch die JSON-Definition des Skills anzeigen.
Wählen Sie im Abhängigkeitsdiagramm einen Skill aus.
Wählen Sie in der Detailansicht auf der rechten Seite die Registerkarte Ausführungen und öffnen Sie dann in OUTPUTS den Expression Evaluator, indem Sie </> neben Organisationen wählen.
Um den Skill zu bearbeiten, wählen Sie die Registerkarte Skilleinstellungen aus.
Nehmen Sie alle Änderungen an der JSON des Skills vor, und wählen Sie dann Speichern aus.
Um zu testen, dass die Änderungen Ihr Problem behoben haben, wählen Sie Ausführen aus.
Wenn das Problem behoben ist und Sie die Änderungen veröffentlichen möchten, wählen Sie oben im Bereich Änderungen vornehmen… 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 dem Schema Ihres Zielindex entsprechen. Verwenden Sie Feldzuordnungen, um diese fehlerhaften Übereinstimmung in Ihren Daten während des Indizierungsprozesses neu zu gestalten und zu korrigieren.
Wählen Sie Skilldiagramm aus, und überprüfen Sie, ob das Abhängigkeitsdiagramm ausgewählt ist.
Wählen Sie den zweiten Schritt in der Anreicherungspipeline aus: Feldzuordnungen.
Ändern Sie alle Zuordnungen für Daten, wie Sie sie benötigen.
Wählen Sie Speichern aus.
Wählen Sie den letzten Schritt aus: Ausgabefeldzuordnungen.
Ausgabefeldzuordnungen aus den Skills können im Detailbereich korrigiert werden.
Wählen Sie Speichern aus.
Um zu testen, dass die Änderungen Ihr Problem behoben haben, wählen Sie Ausführen aus.
Wenn das Problem behoben ist und Sie die Änderungen veröffentlichen möchten, wählen Sie oben im Bereich Änderungen vornehmen… aus.