Debugowanie sesji w usłudze Azure AI Search
Sesje debugowania to edytor wizualizacji, który współpracuje z istniejącym zestawem umiejętności w witrynie Azure Portal, ujawniając strukturę i zawartość pojedynczego wzbogaconego dokumentu, ponieważ jest on tworzony przez indeksator i zestaw umiejętności na czas trwania sesji. Ponieważ pracujesz z dokumentem na żywo, sesja jest interaktywna — możesz identyfikować błędy, modyfikować i wywoływać wykonywanie umiejętności oraz weryfikować wyniki w czasie rzeczywistym. Jeśli zmiany rozwiążą ten problem, możesz zatwierdzić je w opublikowanym zestawie umiejętności, aby zastosować poprawki globalnie.
Jak działa sesja debugowania
Po rozpoczęciu sesji usługa wyszukiwania tworzy kopię zestawu umiejętności, indeksatora i źródła danych zawierającego pojedynczy dokument używany do testowania zestawu umiejętności. Cały stan sesji jest zapisywany w nowym kontenerze obiektów blob utworzonym przez usługę Azure AI usługa wyszukiwania na określonym koncie usługi Azure Storage. Nazwa wygenerowanego kontenera ma prefiks "ms-az-cognitive-search-debugsession". Prefiks jest wymagany, ponieważ zmniejsza prawdopodobieństwo przypadkowego wyeksportowania danych sesji do innego kontenera na koncie.
Buforowana kopia wzbogaconego dokumentu i zestawu umiejętności jest ładowana do edytora wizualizacji, dzięki czemu można sprawdzić zawartość i metadane wzbogaconego dokumentu z możliwością sprawdzania każdego węzła dokumentu i edytowania dowolnego aspektu definicji zestawu umiejętności. Wszelkie zmiany wprowadzone w sesji są buforowane. Te zmiany nie będą wpływać na opublikowany zestaw umiejętności, chyba że je zatwierdzisz. Zatwierdzanie zmian spowoduje zastąpienie zestawu umiejętności produkcyjnych.
Jeśli potok wzbogacania nie zawiera żadnych błędów, sesja debugowania może służyć do przyrostowego wzbogacania dokumentu, testowania i sprawdzania poprawności każdej zmiany przed zatwierdzeniem zmian.
Zarządzanie stanem sesji debugowania
Możesz ponownie uruchomić sesję debugowania przy użyciu przycisku Uruchom lub anulować sesję w toku przy użyciu przycisku Anuluj .
Wykres umiejętności karty Wzbogacanie sztucznej inteligencji >
Edytor wizualizacji jest podzielony na karty i okienka. W tej sekcji przedstawiono składniki edytora wizualizacji.
Wykres umiejętności zapewnia wizualną hierarchię zestawu umiejętności i jego kolejność wykonywania od góry do dołu. Umiejętności zależne od danych wyjściowych innych umiejętności są umieszczone na wykresie. Umiejętności na tym samym poziomie w hierarchii mogą być wykonywane równolegle. Kolorowe etykiety umiejętności na grafie wskazują typy umiejętności wykonywanych w zestawie umiejętności (TEXT lub VISION).
Wybranie umiejętności na grafie spowoduje wyświetlenie szczegółów tego wystąpienia umiejętności w okienku po prawej stronie, w tym jego definicji, błędów lub ostrzeżeń oraz historii wykonywania. Wykres umiejętności to miejsce, w którym można wybrać umiejętności do debugowania lub ulepszania. Okienko szczegółów po prawej stronie to miejsce, w którym można edytować i eksplorować.
Okienko szczegółów umiejętności
Po wybraniu obiektu w grafie umiejętności sąsiadujące okienko udostępnia interaktywne obszary robocze w układzie z kartami. Ilustracja okienka szczegółów znajduje się na poprzednim zrzucie ekranu.
Szczegóły umiejętności obejmują następujące obszary:
- Ustawienia umiejętności przedstawia sformatowaną wersję definicji umiejętności.
- Edytor umiejętności JSON przedstawia nieprzetworzone dokumenty JSON definicji.
- Wykonania pokazują dane odpowiadające za każdym razem, gdy wykonano umiejętności.
- Błędy i ostrzeżenia pokazują komunikaty wygenerowane podczas uruchamiania lub odświeżania sesji.
Na Ustawienia wykonania lub umiejętności wybierz </> symbol, aby otworzyć ewaluator wyrażeń używany do wyświetlania i edytowania wyrażeń danych wejściowych i wyjściowych umiejętności.
Zagnieżdżone kontrolki wejściowe w Ustawienia umiejętności mogą służyć do tworzenia złożonych kształtów projekcji, mapowań pól wyjściowych dla pola typu złożonego lub danych wejściowych do umiejętności. W przypadku użycia z ewaluatorem wyrażeń zagnieżdżone dane wejściowe zapewniają łatwy test i konstruktor walidacji wyrażeń.
Okienko Wykonania
Umiejętność może być wykonywana wiele razy w zestawie umiejętności dla pojedynczego dokumentu. Na przykład umiejętność OCR zostanie wykonana raz dla każdego obrazu wyodrębnionego z pojedynczego dokumentu. W okienku Wykonania zostanie wyświetlona historia wykonywania umiejętności, która umożliwia dokładniejsze przyjrzenie się każdej wywołaniu umiejętności.
Historia wykonywania umożliwia śledzenie określonego wzbogacania z powrotem do umiejętności, które je wygenerowały. Kliknięcie danych wejściowych umiejętności powoduje przejście do umiejętności, która wygenerowała te dane wejściowe, zapewniając funkcję podobną do śledzenia stosu. Umożliwia to identyfikację głównej przyczyny problemu, który może manifestować się w umiejętności podrzędnej.
Podczas debugowania błędu za pomocą umiejętności niestandardowych istnieje możliwość wygenerowania żądania wywołania umiejętności w historii wykonywania.
Karta Wzbogacanie sztucznej inteligencji > wzbogacona struktura danych
W okienku Wzbogacona struktura danych są wyświetlane wzbogacanie dokumentu za pośrednictwem zestawu umiejętności, szczegółowo opisujący kontekst każdego wzbogacania i umiejętności źródłowej. Ewaluator wyrażeń może również służyć do wyświetlania zawartości dla każdego wzbogacania.
Ewaluator wyrażeń
Ewaluator wyrażeń umożliwia szybkie wgląd w wartość dowolnej ścieżki. Umożliwia edytowanie ścieżki i testowanie wyników przed zaktualizowaniem dowolnego z danych wejściowych lub kontekstu dla umiejętności lub projekcji.
Okno można otworzyć z dowolnego węzła lub elementu, który pokazuje </> symbol, w tym części grafu zależności lub węzłów w drzewie wzbogacania.
Ewaluator wyrażeń zapewnia pełny interaktywny dostęp do testowania kontekstu umiejętności, danych wejściowych i sprawdzania danych wyjściowych.
Następne kroki
Teraz, gdy znasz elementy sesji debugowania, rozpocznij pierwszą sesję debugowania w istniejącym zestawie umiejętności.