Rozwiązywanie problemów z agentami Genie

Rozwiązywanie typowych problemów podczas tworzenia i obsługi agenta Genie: błędnie zrozumiały żargon biznesowy, niepoprawne użycie tabeli lub kolumny, filtrowanie błędów określonych wartości i obcinanie limitu tokenów w długich konwersacjach. Każda poniższa sekcja obejmuje objaw, przyczynę i poprawkę.

Note

Genie Agents były wcześniej znane jako Genie Spaces.

W przypadku wielu z tych problemów najszybszą ścieżką do rozwiązania jest Kod Genie. Opisz problem narzędziu Genie Code, a ono zasugeruje zmiany w kontekście do przejrzenia i zaakceptowania. Aby zdiagnozować jedną nieprawidłową odpowiedź, zobacz Debugowanie odpowiedzi za pomocą kodu Genie. Aby przejrzeć razem błędy testów porównawczych, zobacz Analizowanie przebiegu testu porównawczego za pomocą kodu Genie.

Niezrozumiany żargon biznesowy

Większość firm lub domen ma określone skróty, których używają do komunikowania się o wydarzeniach specyficznych dla branży. Na przykład w przypadku odwoływania się do roku może to zawsze oznaczać rok obrachunkowy, a ten rok obrachunkowy może rozpoczynać się w lutym lub marcu zamiast stycznia. Aby umożliwić Genie naturalne i dokładne odpowiadanie na te pytania, dołącz instrukcje, które jawnie mapują żargon biznesowy na słowa i pojęcia, które Genie może zrozumieć. Zobacz Zapewnianie instrukcji.

Nieprawidłowe użycie tabeli lub kolumny

Jeśli usługa Genie próbuje ściągnąć dane z nieprawidłowej tabeli lub uruchomić analizę nieprawidłowych kolumn, możesz dostosować dane w jeden z następujących sposobów:

  • Podaj jasne i dokładne opisy: Sprawdź tabele i skojarzone metadane, aby sprawdzić, czy używana terminologia jest zgodna z terminologią użytkowników w przesłanych pytaniach. Jeśli tak nie jest, uściślij opis lub dodaj instrukcję, która mapuje terminologię używaną w tabeli do terminologii używanej w pytaniu.
  • Dodaj przykładowe zapytania: podaj przykładowe zapytania SQL, których usługa Genie może użyć, aby dowiedzieć się, jak odpowiedzieć na określone pytania. Zobacz Zapewnianie instrukcji.
  • Usuń tabele lub kolumny z agenta: Niektóre tabele mogą zawierać pokrywające się kolumny lub pojęcia, które utrudniają Genie ustalenie, których danych użyć w odpowiedzi. Jeśli to możliwe, usuń niepotrzebne lub nakładające się tabele lub kolumny. Aby ukryć kolumny z interfejsu użytkownika agenta Genie bez zmieniania bazowych obiektów danych, zobacz Ukryj lub pokaż odpowiednie kolumny.

Błędy filtrowania

Wygenerowane zapytania często zawierają klauzulę filtrowania WHERE wyników zgodnie z określoną wartością. Gdy usługa Genie nie ma wglądu w wartości danych, może ustawić klauzulę WHERE , aby filtrować nieprawidłową wartość. Na przykład może próbować dopasować nazwę "California", gdy w tabeli są używane skróty, takie jak "CA".

W takich sytuacjach sprawdź, czy odpowiednie kolumny mają włączone przykładowe wartości i słowniki wartości . Jeśli nowe dane zostały dodane do odpowiednich tabel, odśwież wartości. Zobacz Omówienie dopasowywania monitów.

Nieprawidłowe połączenia

Jeśli odwołania do kluczy obcych nie są zdefiniowane w Unity Catalog, agent może nie wiedzieć, jak łączyć ze sobą różne tabele.

Spróbuj zaimplementować co najmniej jedno z następujących rozwiązań:

  • Zdefiniuj odwołania do kluczy obcych w katalogu Unity, jeśli to możliwe. Zobacz CONSTRAINT klauzulę.
  • Jeśli relacje kluczy obcych między tabelami nie są określone w Unity Catalog, zdefiniuj relacje łączenia w magazynie wiedzy agenta Genie. Ta strategia jest przydatna w przypadku bardziej złożonych scenariuszy sprzężenia, takich jak sprzężenia samodzielne, lub jeśli nie masz wystarczających uprawnień do modyfikowania tabel bazowych. Zobacz Definiowanie relacji sprzężenia.
  • Podaj przykładowe zapytania, w których łączysz tabele w standardowy sposób.

Jeśli żaden z tych elementów nie rozwiąże problemu, należy wstępnie dołączyć tabelę do widoku i użyć go jako danych wejściowych dla agenta.

Komentarze kolumn nie są synchronizowane z tabel obcych

Azure Databricks może synchronizować komentarze tabelowe i kolumnowe z obsługiwanych zewnętrznych źródeł danych. Aby odświeżyć komentarze bez zapytania do danych tabeli, uruchom DESCRIBE EXTENDED na tabeli obcej. Aby sprawdzić, czy Twoje źródło obsługuje synchronizację komentarzy oraz znaleźć wymagania obliczeniowe i kontrole pobierania, zobacz: Połącz się z zewnętrznymi bazami danych i katalogami oraz wybierz swój łącznik.

Komentarze mogą być nieobecne w obsługiwanym źródle, gdy zasób obliczeniowy nie spełnia minimalnej wymaganej wersji, enableForeignCommentFetching to false, lub gdy tabela jest odczytywana przez potoki Lakeflow. Jeśli komentarze są niedostępne, skorzystaj z jednego z następujących obejść:

Problemy z obliczeniami metryk

Sposób, w jaki metryki są obliczane i rzutowane, może być arbitralnie skomplikowany i obejmować wiele szczegółów biznesowych, których agent nie rozumie. Może to prowadzić do nieprawidłowego raportowania.

Spróbuj zaimplementować co najmniej jedno z następujących rozwiązań:

  • Zdefiniuj metryki jako wyrażenia SQL w magazynie wiedzy. Wyrażenia SQL zapewniają wielokrotnego użytku, precyzyjne definicje miar, filtrów i wymiarów, które Genie może stosować spójnie. Zobacz Definiowanie wyrażeń SQL.
  • Jeśli metryki są agregowane z tabel bazowych, podaj przykładowe zapytania SQL obliczeniowe dla każdej wartości zbiorczej.
  • Jeśli metryki zostały wstępnie obliczone i znajdują się w zagregowanych tabelach, wyjaśnij to w komentarzach tabeli. Określ prawidłowe agregacje dla każdego wskaźnika, jeśli metryki w tej tabeli mogą być dodatkowo zsumowane.
  • Jeśli zapytanie SQL, które próbujesz wygenerować, jest bardzo skomplikowane, spróbuj utworzyć widoki, które mają już zagregowane metryki na potrzeby agenta.

Nieprawidłowe obliczenia oparte na czasie

Genie może nie zawsze być w stanie wywnioskować strefę czasową reprezentowaną w danych lub strefę czasową, w której należy przeprowadzić analizę, chyba że jawnie podasz dodatkowe wskazówki.

Dołącz bardziej jawne instrukcje szczegółowo opisujące oryginalną strefę czasową źródła, funkcję konwersji i docelową strefę czasową. W poniższych przykładach pokazano, jak zmienić ogólne instrukcje dotyczące bardziej niezawodnych konwersji strefy czasowej:

  • Zawsze konwertuj czasy na określoną strefę czasową: w tym przykładzie załóżmy, że sygnatura czasowa źródła to UTC i chcesz uzyskać wyniki w America/Los_Angeles strefie czasowej. Dodaj następujące treści do instrukcji, zastępując <timezone-column> odpowiednią nazwą kolumny.
    • Strefy czasowe w tabelach znajdują się w UTC.
    • Przekonwertuj wszystkie strefy czasowe przy użyciu następującej funkcji: convert_timezone('UTC', 'America/Los_Angeles', <timezone-column>).
  • Przekonwertuj formaty daty i godziny innej niż UTC na UTC: Jeśli domyślna strefa czasowa obszaru roboczego to UTC , ale użytkownicy w Los Angeles muszą odwoływać się dzisiaj do określonego zestawu rekordów, dodaj następujące informacje do ogólnych instrukcji agenta:
    • Aby odwołać się do 'dzisiaj', użyj .

Zobacz convert_timezone funkcję , aby uzyskać więcej szczegółów i składni.

Ignorowanie instrukcji

Nawet jeśli objaśniono tabele i kolumny w komentarzach i podano ogólne instrukcje, agent może nadal nie używać ich poprawnie.

Wypróbuj co najmniej jedną z następujących strategii:

  • Podaj przykładowe zapytania, które prawidłowo używają tabel. Przykładowe zapytania są szczególnie skuteczne w przypadku nauczania agenta, jak używać danych.
  • Ukryj nieistotne kolumny w agencie Genie. Zobacz Ukrywanie lub pokazywanie odpowiednich kolumn.
  • Utwórz widoki na podstawie tabel, które zapewniają prostszy widok danych.
  • Przejrzyj instrukcje i spróbuj skoncentrować agenta, usuwając nieistotne tabele lub instrukcje.
  • Spróbuj uruchomić nowy czat. Poprzednie interakcje mogą mieć wpływ na odpowiedzi Genie w danym czacie, ale rozpoczęcie nowego czatu daje pusty punkt wyjścia do testowania nowych instrukcji.

Problemy z wydajnością

Gdy Genie musi wygenerować wyjątkowo długie zapytania lub odpowiedzi tekstowe, reakcja może zająć dużo czasu lub nawet nastąpić przekroczenie limitu czasu przy przetwarzaniu.

Spróbuj wykonać co najmniej jedną z następujących akcji, aby zwiększyć wydajność:

  • Sprawdź historię zapytań, aby zidentyfikować wolno działające zapytania. Wiele problemów z wydajnością można rozwiązać, optymalizując wygenerowane zapytania SQL zamiast modyfikować konfigurację agenta Genie. Przejrzyj czas wykonywania zapytań i plany zapytań w historii zapytań usługi SQL Warehouse, aby zidentyfikować wąskie gardła i możliwości optymalizacji.
  • Użyj zaufanych zasobów lub widoków, aby hermetyzować złożone zapytania. Zobacz Zaufane zasoby.
  • Zmniejsz długość przykładowych zapytań SQL zawsze, gdy jest to możliwe.
  • Rozpocznij nowy czat, jeśli genie zacznie generować powolne lub kończące się niepowodzeniem odpowiedzi.

Zachowanie limitu czasu

Genie anuluje zapytania SQL, które działają dłużej niż 5 minut, oraz anuluje wiadomości, które działają dłużej niż 30 minut.

Zawodne odpowiedzi na pytania o znaczeniu krytycznym

Użyj zaufanych zasobów, aby podać zweryfikowane odpowiedzi na konkretne pytania, których oczekujesz od użytkowników. Zobacz Zaufane zasoby.

Ostrzeżenie dotyczące limitu tokenu

Tokeny to podstawowe jednostki tekstu używane przez genie do przetwarzania i zrozumienia języka. Instrukcje tekstowe i metadane w agencie Genie są konwertowane na tokeny. Jeśli agent zbliża się do limitu tokenów, zostanie wyświetlone ostrzeżenie. Usługa Genie używa filtrowania kontekstu do określania priorytetów tokenów, które uważa za najbardziej istotne dla pytania. Chociaż odpowiedzi powinny być nadal generowane po wyświetleniu ostrzeżenia, jakość może zostać zmniejszona, jeśli ważny kontekst zostanie odfiltrowany. Po przekroczeniu limitu tokenu nie można już wysyłać ani odbierać komunikatów w agencie Genie.

Rozważ następujące rozwiązania, aby zmniejszyć liczbę tokenów:

  • Usuwanie niepotrzebnych kolumn: niepotrzebne kolumny w tabelach mogą znacząco przyczynić się do użycia tokenów. Jeśli to możliwe, utwórz widoki w celu wykluczenia nadmiarowych lub nieistotnych pól z nieprzetworzonych tabel. Możesz również ukryć niepotrzebne kolumny w agencie Genie. Zobacz Ukrywanie lub pokazywanie odpowiednich kolumn.
  • Usprawnij opisy kolumn: Chociaż opisy kolumn są ważne, unikaj duplikowania informacji już przekazywanych według nazw kolumn. Jeśli na przykład kolumna ma nazwę account_name, opis taki jak "nazwa konta" może być nadmiarowy i można go pominąć.
  • Edytowanie metadanych kolumn w agencie Genie: Zobacz Edytowanie metadanych kolumn, aby dowiedzieć się, jak edytować opisy i udostępniać synonimy w metadanych kolumn.
  • Przycinanie przykładowych zapytań SQL: uwzględnij zróżnicowany zakres przykładowych zapytań SQL w celu pokrycia różnych typów pytań, ale usuń nakładające się lub nadmiarowe przykłady.
  • Upraszczanie instrukcji: Sprawdź, czy instrukcje są jasne i zwięzłe. Unikaj niepotrzebnych słów.

Twoje konto nie jest aktywowane do przetwarzania międzyregionowego

Genie to wyznaczona usługa zarządzana przez usługę Azure Databricks. Wyznaczone usługi używają usługi Databricks Geos do zarządzania miejscem przechowywania danych. Nie można przetworzyć danych w tym samym obszarze geograficznym co obszar roboczy dla niektórych regionów. Jeśli obszar roboczy znajduje się w jednym z tych regionów, przetwarzanie między regionami musi być aktywowane przez administratora konta.

Ostatni autor agenta jest usuwany z obszaru roboczego

Agent Genie uzyskuje dostęp do swojego magazynu danych SQL za pomocą poświadczeń obliczeniowych osadzonych przez autora, który skonfigurował go jako ostatni. Jeśli ten autor zostanie usunięty z obszaru roboczego, ich osadzone poświadczenia nie są już prawidłowe, a zapytania kończą się niepowodzeniem dla wszystkich użytkowników korzystających z agenta.

Aby przywrócić agenta, poproś innego użytkownika z co najmniej uprawnieniem CAN EDIT dla agenta Genie o ponowne skonfigurowanie magazynu SQL Warehouse tego agenta. Zapisanie wyboru magazynu powoduje osadzenie poświadczeń obliczeniowych użytkownika dokonującego edycji zamiast poświadczeń usuniętego autora. Zobacz Konfigurowanie ustawień.