Debugowanie sesji w usłudze Wyszukiwanie AI platformy Azure

Note

Wyszukiwanie AI platformy Azure jest dostępna za pośrednictwem portalu Azure, interfejsów API REST i Azure SDKs. Jest także podstawą Foundry IQ — zarządzanej warstwy wiedzy, która przekształca treści przedsiębiorstwa w bazy wiedzy wielokrotnego użytku z uwzględnieniem uprawnień dla agentów w portalu Microsoft Foundry.

Sesje debugowania to edytor wizualny, który współpracuje z istniejącym mechanizmem umiejętności w portalu Azure, uwidaczniając strukturę i zawartość pojedynczego wzbogaconego dokumentu, gdy jest on tworzony przez mechanizm indeksujący 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.

W tym artykule opisano obsługiwane scenariusze i sposób organizowania edytora. Karty i sekcje edytora rozpakowują różne warstwy zestawu umiejętności, aby można było zbadać jego strukturę, przepływ oraz zawartość, którą generuje w czasie rzeczywistym.

Obsługiwane scenariusze

Użyj sesji debugowania, aby zbadać i rozwiązać problemy z:

• Wbudowane umiejętności używane do wzbogacania sztucznej inteligencji, takie jak OCR, analiza obrazów, rozpoznawanie jednostek i wyodrębnianie słów kluczowych.

• Wbudowane umiejętności używane do zintegrowanej wektoryzacji, z fragmentowaniem danych za pomocą funkcji Text Split oraz wektoryzacji za pomocą umiejętności embedowania.

• Niestandardowe umiejętności używane do integracji przetwarzania zewnętrznego, które udostępniasz.

Porównaj następujące obrazy sesji debugowania dla dwóch pierwszych scenariuszy. W obu scenariuszach obszar powierzchni pokazuje postęp umiejętności, które generują lub przekształcają zawartość w drodze z dokumentu źródłowego do indeksu wyszukiwania. Przepływ zawiera opcje mapowania indeksów i można śledzić strzałki, aby podążać śladem przetwarzania. Okienko szczegółów po prawej stronie jest wrażliwe na kontekst. Przedstawia on reprezentację wzbogaconego dokumentu utworzonego przez potok lub szczegóły umiejętności lub mapowania.

Pierwszy obraz przedstawia wzorzec stosowanego wzbogacania sztucznej inteligencji (bez wektorów). Umiejętności mogą być uruchamiane sekwencyjnie lub równolegle, jeśli nie ma zależności. Mapowania indeksów pokazują, jak wzbogacona lub generowana zawartość jest przenoszona ze struktur danych w pamięci do pól w indeksie. Wzbogacony dokument przedstawia strukturę danych utworzoną przez zestaw umiejętności.

Drugi obraz przedstawia typowy wzorzec zintegrowanej wektoryzacji. Umiejętności zintegrowanej wektoryzacji zwykle obejmują dzielenie tekstu i umiejętność osadzania. Umiejętność dzielenia tekstu dzieli dokument na fragmenty. Umiejętność osadzania wywołuje interfejs API do osadzania w celu wektoryzacji tych fragmentów. Ten konkretny zestaw umiejętności dzieli zawartość na tablicę "strony". W przypadku zintegrowanej wektoryzacji mapowania projekcyjne kontrolują sposób przypisywania fragmentów do pól w indeksie.

Ograniczenia

Sesje debugowania współpracują ze wszystkimi ogólnie dostępnymi źródłami danych indeksatora i większością źródeł danych w wersji zapoznawczej, z następującymi wyjątkami:

• Indeksator programu SharePoint.

• Indeksator Azure Cosmos DB dla MongoDB.

• W przypadku usługi Azure Cosmos DB for NoSQL, jeśli wiersz zawiedzie podczas indeksowania i nie ma odpowiednich metadanych, sesja debugowania może nie wybrać właściwego wiersza.

• W przypadku interfejsu API SQL usługi Azure Cosmos DB, jeśli kolekcja, która obecnie jest podzielona na partycje, wcześniej nie była podzielona, sesja debugowania nie będzie mogła znaleźć dokumentu.

• W przypadku niestandardowych umiejętności tożsamość zarządzana przypisana przez użytkownika nie jest obsługiwana w przypadku połączenia sesji debugowania z usługą Azure Storage. Zgodnie z wymaganiami wstępnymi można użyć tożsamości zarządzanej systemu lub podać ciąg połączenia z pełnym dostępem, który zawiera klucz. Aby uzyskać więcej informacji, zobacz Łączenie usługi wyszukiwania z innymi zasobami platformy Azure przy użyciu tożsamości zarządzanej.

• Źródła danych z szyfrowaniem włączonym za pośrednictwem kluczy zarządzanych przez klienta (CMK).

• Udostępnione łącza prywatne nie są obsługiwane. Jeśli usługa wyszukiwania używa łączności prywatnego punktu końcowego do uzyskiwania dostępu do źródeł danych lub innych zasobów, sesje debugowania nie mogą uzyskać dostępu do tych zasobów. Jako obejście problemu zobacz Sesje debugowania i łączność prywatna.

• Obecnie możliwość wybrania dokumentu do debugowania jest niedostępna. To ograniczenie nie jest trwałe i powinno zostać wkrótce zniesione. Obecnie sesje debugowania wybierają pierwszy dokument w źródłowym kontenerze danych lub folderze.

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. Usługa Wyszukiwanie AI platformy Azure zapisuje cały stan sesji w nowym kontenerze obiektów blob, który tworzy na podanym przez Ciebie koncie usługi Azure Storage. Wygenerowana nazwa kontenera ma prefiks .ms-az-cognitive-search-debugsession Ten prefiks zmniejsza prawdopodobieństwo przypadkowego wyeksportowania danych sesji do innego kontenera na twoim koncie.

Jeśli skonfigurujesz połączenie z kontem magazynu przy użyciu tożsamości zarządzanej, przypisz rolę Storage Blob Data Contributor tożsamości usługi wyszukiwania dla konta magazynu. Na koncie magazynu danych włącz zaufane usługi, aby zezwolić na dostęp do zapisu z usługi Wyszukiwanie AI platformy Azure.

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ą mieć wpływu 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 weryfikowania każdej zmiany przed zatwierdzeniem zmian.

Sesje debugowania pomagają zidentyfikować pierwotną przyczynę błędów lub ostrzeżeń poprzez analizę danych, danych wejściowych i wyjściowych umiejętności oraz mapowań pól. Użyj okienka szczegółów umiejętności, aby sprawdzić, co każda umiejętność otrzymuje jako dane wejściowe i generuje jako dane wyjściowe. Ta inspekcja pomaga sprawdzić, czy definicje umiejętności, wyrażenia i mapowania pól są poprawnie sformułowane. Jeśli indeksator napotka problemy z konfiguracją, takie jak niepoprawna konfiguracja sieci lub błędy dostępu związane z uprawnieniami, zapoznaj się z konkretnym komunikatem o błędzie i połączoną dokumentacją. Aby uzyskać wskazówki dotyczące rozwiązywania problemów, zobacz Typowe błędy i ostrzeżenia indeksatora.

Debugowanie sesji i łączności prywatnej

Sesje debugowania nie obsługują udostępnionych łączy prywatnych. Jeśli usługa wyszukiwania w środowisku produkcyjnym używa łączności prywatnego punktu końcowego do uzyskiwania dostępu do źródeł danych lub innych zasobów, sesje debugowania nie mogą być uruchamiane względem tej usługi.

Obejście: użyj usługi wyszukiwania testowego

Aby debugować zestaw umiejętności, utwórz oddzielną usługę Wyszukiwanie AI platformy Azure bez ograniczeń łączności prywatnej. Aby zachować szczegóły danych produkcyjnych i schematów poza środowiskiem prywatnym, skompiluj konfigurację testu przy użyciu syntetycznych dokumentów:

• Utwórz dokumenty testowe zgodne z typami pól i strukturą danych produkcyjnych, ale użyj nazw pól ogólnych (na przykład content, , titlecategory) i wartości zastępczych zamiast rzeczywistych danych. Logika zestawu umiejętności zależy od typów zawartości i struktury, a nie określonych nazw pól.
• Skopiuj kod JSON zestawu umiejętności z usługi produkcyjnej. Jeśli dane wejściowe umiejętności odwołują się do nazw pól produkcyjnych, zaktualizuj te odwołania, aby były zgodne z ogólnymi nazwami pól testowych. Użyj mapowań pól w indeksatorze testowym, aby wyrównać nazwy pól testowych z danymi wejściowymi zestawu umiejętności.
• Skonfiguruj indeksator dla testowego źródła danych.

Uruchom sesję debugowania w usłudze testowej, aby sprawdzić dane wejściowe i wyjściowe umiejętności, zweryfikować wyrażenia umiejętności i mapowania pól oraz zidentyfikować błędy. Po zweryfikowaniu zmian przywróć oryginalne odwołania do nazwy pola produkcyjnego w formacie JSON zestawu umiejętności i zastosuj je z powrotem do usługi produkcyjnej.

Debugowanie układu sesji

Edytor wizualny jest zorganizowany w obraz powierzchni przedstawiający postęp operacji, począwszy od przetwarzania dokumentów, a następnie poprzez umiejętności, mapowania i indeks.

Wybierz dowolną umiejętność lub mapowanie, a z boku otworzy się panel z odpowiednimi informacjami.

Skorzystaj z linków, aby zagłębić się w przetwarzanie umiejętności. Na przykład poniższy zrzut ekranu przedstawia dane wyjściowe pierwszej iteracji umiejętności dzielenia tekstu.

Panel szczegółów umiejętności

Okienko Szczegóły umiejętności zawiera następujące sekcje:

• Iteracje: Pokazuje, ile razy wykonywana jest umiejętność. Możesz sprawdzić dane wejściowe i wyjściowe każdego z nich.
• Ustawienia umiejętności: wyświetlanie lub edytowanie definicji zestawu umiejętności JSON.
• Błędy i ostrzeżenia: pokazuje błędy lub ostrzeżenia specyficzne dla tej umiejętności.

Wzbogacone okienko struktury danych

Okienko Wzbogacona struktura danych wysuwa się na bok, gdy wybierzesz niebieski symbol strzałki pokazującej lub ukrywającej. Jest to czytelna dla człowieka reprezentacja zawartości wzbogaconego dokumentu. Poprzednie zrzuty ekranu w tym artykule przedstawiają przykłady wzbogaconej struktury danych.

Następne kroki

Teraz, gdy znasz elementy sesji debugowania, rozpocznij pierwszą sesję debugowania w istniejącym zestawie umiejętności.

Jak debugować zestaw umiejętności