Konfigurowanie obszaru AI/BI Genie i zarządzanie nim

W tym artykule wyjaśniono, jak skonfigurować przestrzeń Genie i zarządzać nią— interfejs czatu dla użytkowników biznesowych w celu zadawania pytań dotyczących ich danych w języku naturalnym.

wymagania techniczne i limity

Podczas korzystania z miejsc Genie obowiązują następujące wymagania i limity:

• Unity Catalog: Dane dla obszaru Genie muszą być zarejestrowane w Unity Catalog.
• Compute: Musisz użyć usługi SQL Warehouse pro lub bezserwerowej.
• Wydajność: Każdy obszar roboczy może obsłużyć maksymalnie 20 pytań na minutę we wszystkich obszarach Genie.
• Pojemność: Każda przestrzeń Genie może obsługiwać maksymalnie 10 000 konwersacji, a każda konwersacja może zawierać maksymalnie 10 000 wiadomości.

Wymagane uprawnienia

Do tworzenia, edytowania i używania miejsc Genie są wymagane następujące uprawnienia:

• Uprawnienia obliczeniowe: twórcy, edytorzy i użytkownicy obszaru Genie wymagają dostępu do domyślnego magazynu SQL wyznaczonego dla przestrzeni. Twórcy wybierają domyślny magazyn SQL, gdy tworzą miejsce. Mogą wybrać dowolny magazyn SQL, dla którego mają uprawnienia CAN RUN.
• Uprawnienia dostępu do danych: Każdy użytkownik, który wchodzi w interakcję z miejscem, potrzebuje co najmniej SELECT uprawnień do danych używanych w przestrzeni.
• uprawnienia przestrzeni w usłudze Genie: Użytkownicy muszą mieć uprawnienia CAN RUN w przestrzeni Genie, aby wchodzić w interakcję z Genie oraz korzystać z danych w tej przestrzeni. Zobacz listy ACL miejsca Genie, aby uzyskać pełne odwzorowanie uprawnień i funkcji dla przestrzeni Genie.

Zarządzanie dostępem do usługi Genie

Usługa Genie korzysta z opartych na usługach sztucznej inteligencji platformy Azure funkcji pomocniczych sztucznej inteligencji, które muszą być włączone na poziomie konta. Aby dowiedzieć się, jak zarządzać tymi funkcjami dla konta, zobacz Włącz i wypróbuj Databricks Assistant.

Utwórz nową przestrzeń Genie

Przestrzenie Genie umożliwiają analitykom danych utworzenie specyficznego dla domeny środowiska Przestrzeni Genie dla użytkowników biznesowych poprzez podjęcie następujących kroków:

1. Kliknij Genie na pasku bocznym.

2. Kliknij Nowy w prawym górnym rogu ekranu.

   

3. W oknie dialogowym Nowy wybierz ustawienia początkowe. Opcje są opisane w następujący sposób:

• Tytuł: tytuł jest wyświetlany w przeglądarce obszaru roboczego z innymi obiektami obszaru roboczego. Wybierz tytuł, który pomoże użytkownikom końcowym odnaleźć przestrzeń Genie.
• Opis: użytkownicy widzą opis po otwarciu obszaru Genie. Użyj tego obszaru tekstowego, aby opisać przeznaczenie spacji. Pole opisu obsługuje formatowanie języka Markdown, dzięki czemu można stylizować tekst i podawać linki do przydatnego kontekstu i odwołań. Aby uzyskać więcej informacji na temat składni języka Markdown, zobacz ten przewodnik.
• domyślny magazyn: zasoby obliczeniowe te obsługują instrukcje SQL wygenerowane w obszarach Genie. Użytkownicy końcowi potrzebują dostępu do tego magazynu w celu interakcji z przestrzenią. Przestrzeń Genie może korzystać z pro składnicy danych SQL lub bezserwerowej. Aby uzyskać optymalną wydajność, usługa Databricks zaleca korzystanie z bezserwerowego magazynu SQL Warehouse.
• Tabele: Przestrzenie Genie mogą być oparte na jednej lub więcej tabelach. Maksymalnie można uwzględnić 25 tabel. Przycisk Dodaj tabele otwiera nowe okno dialogowe, w którym możesz wybrać tabele z Unity Catalog, które chcesz uwzględnić.
• przykładowe pytania: przykładowe pytania są opcjonalne. Są one wyświetlane w czatach, aby podać przykłady typów pytań, które mogą zadawać użytkownicy. Można je dodawać podczas tworzenia lub później z obszaru Ustawienia.

Podaj instrukcje

Instrukcje pomagają kierować odpowiedziami Genie, dzięki czemu może przetwarzać unikatowy żargon, logikę i pojęcia w danej domenie. Kompletna instrukcja ma kluczowe znaczenie dla bezproblemowego, intuicyjnego doświadczenia przestrzeni Genie. Aby wprowadzić instrukcje, kliknij ikonę Instrukcje na pasku bocznym w obszarze Genie i otwórz okienko instrukcji. Użyj tego okienka, aby dodać Ogólne instrukcje, Przykładowe zapytania SQLoraz Funkcje SQL.

W sumie można dodać do 100 instrukcji dla obszaru Genie. Następujące elementy przyczyniają się do licznika:

• Cały blok tekstu w Ogólne instrukcje jest liczony jako jeden.
• Każde przykładowe zapytanie SQL liczy się jako jedno.
• Każda funkcja SQL liczy się jako jedna.

Ogólne instrukcje

Przedstaw instrukcje w formie zwykłego tekstu, które przekazują preferencje biznesowe lub odpowiedzi, których Genie ma przestrzegać. Instrukcje można sformatować jako pojedynczą kompleksową notatkę lub kategoryzować według tematu w celu uzyskania lepszej organizacji.

Poniżej przedstawiono przykładowe informacje, które można uwzględnić w ogólnych instrukcjach:

• informacje biznesowe specyficzne dla firmy:
  • "Nasz rok obrachunkowy rozpoczyna się w lutym"
• Wartości, aliasy lub typowe filtry:
  • "Zawsze konwertuj na małe litery i używaj operatora LIKE podczas stosowania filtrów."
  • "Użyj skrótów dla stanów w wartościach filtru".
• Określ funkcje, aby odpowiedzieć na pytania i podać instrukcje dotyczące zwracanych wartości:
  • W przypadku kwartałów użyj adventureworks.oneb.get_quarter(date) UDF. Wynik get_quarter() to kwartał i wynosi 1; 2; 3 albo 4. Służy do filtrowania danych zgodnie z potrzebami.

Przykładowe zapytania SQL

Przykładowe zapytania SQL to zapytania SQL, które przygotowujesz, aby pomóc w trenowaniu Geniego. Genie inteligentnie wybiera odpowiednie zapytania, aby pomóc wygenerować odpowiedź podczas odpowiadania na pytania. Podczas dodawania przykładowych zapytań pokazano Genie, jak używać danych do odpowiadania na pytania. Możesz również dodać przykładowe pytania, aby nauczyć Genie o rodzajach pytań, na które można oczekiwać, że przykładowe zapytanie będzie odpowiadać. Jeśli Genie otrzyma pasujące pytanie, może użyć przykładowego zapytania bezpośrednio, aby podać odpowiedź. Jeśli otrzyma podobne pytanie, może użyć wskazówek z przykładowego zapytania, aby pomóc w strukturze kodu SQL podanego w odpowiedzi. Skoncentruj się na dostarczaniu przykładów, które podkreślają logikę unikatową dla organizacji i danych, jak w poniższym przykładzie:

  -- Return our current total open pipeline by region.
  -- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = 'Pipeline' AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

Dodawanie parametrów w zapytaniach SQL

Parametry umożliwiają pisanie przykładowych zapytań z symbolami zastępczymi dla określonych wartości, które mają być zastępowane w czasie wykonywania. Dzięki parametrom usługa Genie może pobierać określone dane wejściowe od pytań użytkownika i ponownie używać struktury przykładowego zapytania w celu dostarczenia zweryfikowanych odpowiedzi jako zaufanych zasobów. Można na przykład dostosować poprzednie zapytanie SQL, aby uwzględnić parametr filtrujący według wartości o.forecastcategory, umożliwiając zapytaniu odpowiadanie na pytania dotyczące możliwości oznaczonych w różnych kategoriach prognozy. Aby uzyskać więcej informacji na temat używania sparametryzowanych zapytań do generowania odpowiedzi oznaczonych jako zaufane zasoby, zobacz Use trusted assets in AI/BI Genie spaces (Używanie zaufanych zasobów w przestrzeniach AI/BI Genie).

Poniższy fragment kodu przedstawia poprzedni przykład zmodyfikowany przez dodanie parametru dla wartości o.forecastcategory. Parametry używają tej samej składni co znaczniki nazwanych parametrów. Zobacz Nazwane znaczniki parametrów.

-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = :forecast_category AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

Aby dodać parametr do zapytania:

1. Umieść kursor, w którym chcesz umieścić parametr w zapytaniu.

2. Kliknij Dodaj parametr, aby wstawić nowy parametr.

   Spowoduje to utworzenie nowego parametru o nazwie domyślnej parameter. Aby zmienić nazwę domyślną, zastąp ją w edytorze zapytań. Parametry można również dodać, wpisując dwukropek, po którym następuje nazwa parametru (:parameter_name) w edytorze.

Edytowanie parametru zapytania

Aby edytować parametr, wykonaj następujące czynności:

1. Kliknij obok nazwy parametru. Pojawi się okno dialogowe Szczegóły parametru, które zawiera następujące opcje konfiguracji:

   • słowo kluczowe: słowo kluczowe reprezentujące parametr w zapytaniu. Słowo kluczowe można zmienić tylko przez bezpośrednie zaktualizowanie tekstu w zapytaniu.

   • Nazwa wyświetlana: zrozumiała dla użytkownika nazwa używana przez Genie w interfejsie czatu. Gdy Genie generuje odpowiedź przy użyciu zapytania sparametryzowanego, w odpowiedzi zawiera nazwę wyświetlaną oraz skojarzoną wartość.

   • Typ: Obsługiwane typy obejmują Ciąg, Data, Data i Godzinaoraz Numer.

     • Domyślnym typem jest Ciąg.
     • Typ danych liczbowy umożliwia wybór pomiędzy liczbą dziesiętną a liczbą całkowitą. Domyślnym typem liczbowym jest dziesiętna.

     Notatka

     Jeśli rzeczywista wartość wejściowa nie jest zgodna z wybranym typem parametru, Genie traktuje wartość wejściową jako nieprawidłowy typ, co może prowadzić do niedokładnych wyników.

2. Kliknij inną część interfejsu użytkownika, aby zamknąć okno dialogowe.

Funkcje SQL

Funkcje SQL to funkcje niestandardowe, które są przechowywane w Unity Catalog i używane przez Genie do odpowiadania na konkretne pytania. Genie może wywoływać te funkcje i wstawiać wszystkie parametry określone przez użytkownika, ale nie może uzyskać dostępu do bazowej zawartości SQL. Oznacza to, że funkcje SQL idealnie nadają się do odpowiadania na typowe pytania, które obejmują złożone argumenty lub obliczenia, których usługa Genie nie powinna mieć dostępu do ani edytować. Aby uzyskać wskazówki dotyczące rejestrowania funkcji w katalogu Unity, zobacz Utwórz funkcję tabeli SQL i funkcje zdefiniowane przez użytkownika (UDF) w katalogu Unity.

Przetestuj swój obszar Genie

Większość interakcji użytkownika odbywa się w oknie czatu. Najlepszym sposobem, aby dowiedzieć się, czy twoja przestrzeń działa tak, jak chcesz, jest przetestowanie go za pomocą realistycznych pytań, które oczekujesz od użytkowników biznesowych.

Wszystkie przykładowe pytania wprowadzone w ustawieniach są wyświetlane w oknie czatu. Te przykładowe pytania pomagają użytkownikom zrozumieć, jakie pytania mogą zadać swojej przestrzeni Geniego. Pole tekstowe, w którym użytkownicy wprowadzają pytania, znajduje się w dolnej części ekranu.

Odpowiedzi pojawiają się nad polem tekstowym. Gdy użytkownik wprowadzi pytanie, zostanie on zapisany w wątku historii czatu w okienku po lewej stronie.

Aby rozpocząć nowy czat:

1. Kliknij ikonę czatu , aby otworzyć okno czatu.
2. Wpisz pytanie w pole tekstowe Zadaj pytanie.... Aby rozpocząć nowy wątek konwersacji, kliknij pozycję + Nowy czat.

Przeglądanie odpowiedzi

Odpowiedzi są zwykle dostarczane jako odpowiedź języka naturalnego na pytania i tabelę przedstawiającą odpowiedni zestaw wyników. Gdy usługa Genie wykryje, że wizualizacja może poprawić przejrzystość odpowiedzi, zwraca również wizualizację. Dokładna struktura odpowiedzi różni się w zależności od pytania. Wszystkie odpowiedzi obejmują zapytanie SQL, które zostało wygenerowane, aby odpowiedzieć na pytanie. Kliknij Pokaż wygenerowany kod, aby wyświetlić wygenerowane zapytanie.

Prawa dolna strona odpowiedzi zawiera opcjonalne akcje. Użytkownicy mogą skopiować odpowiedź w formacie CSV do schowka, pobrać ją jako plik CSV, dodać jako instrukcję dla obszaru Genie oraz zagłosować na odpowiedź w górę lub w dół. Aby edytować wizualizację, kliknij ikonę edycji w prawym górnym rogu wizualizacji. Aby uzyskać dodatkowe informacje o sposobie edytowania wizualizacji, zobacz Generowanie wizualizacji.

Zestaw kafelków szybkich akcji znajduje się po odpowiedziach, które zawierają dane tabelaryczne. Można ich użyć do generowania wizualizacji.

Wizualizację można również wygenerować, opisując ją w wyrazach po otrzymaniu wyniku zapytania. Zobacz Generowanie wizualizacji.

Formatowanie wyników

Aby sformatować kolumnę w tabeli w odpowiedzi, kliknij menu menu kebab w nagłówku kolumny, a następnie kliknij Format, aby wyświetlić dostępne opcje. Opcje formatowania zależą od typu danych kolumny.

Pobieranie zestawu wyników

Użytkownicy przestrzeni mogą pobierać do około 1 GB danych wyników w formacie pliku CSV. Ostateczny rozmiar pobierania pliku może być nieco większy lub mniejszy niż 1 GB, ponieważ limit 1 GB jest stosowany do wcześniejszego kroku niż pobieranie pliku końcowego. Aby pobrać wyniki, kliknij ikonę pobierania w odpowiedzi.

Generowanie wizualizacji

Użytkownicy mogą jawnie zażądać wizualizacji przy użyciu okna czatu lub za pomocą jednej z sugerowanych wizualizacji dostępnych w sekcji Szybkie akcje, następującej po odpowiedzi. Czasami usługa Genie oferuje wizualizację w ramach odpowiedzi. Aby ukryć automatycznie wygenerowaną wizualizację, kliknij ikonę ikonę zwiń. Aby wyświetlić go ponownie, kliknij Pokaż wizualizację.

Wizualizacje można edytować w oknie czatu.

Obsługiwane są następujące typy wykresów:

• Obszar
• Bar
• Linia
• Pie
• Rozrzuć

Aby edytować wizualizację:

• W prawym górnym rogu wizualizacji kliknij ikonę edycji . Po prawej stronie zostanie otwarte okienko edycji.
• Użyj menu rozwijanego Wizualizacji, aby wybrać inny typ wykresu.
• W przypadku większości typów wykresów użyj menu rozwijanych osi X i Y, aby wybrać wartości reprezentowane na każdej osi. Dla wykresów kołowych , użyj menu rozwijanego kąta , aby wybrać kolumnę, którą chcesz reprezentować.
• (Opcjonalnie) Aby dostosować schemat kolorów, kliknij + w kategorii Color.
• (Opcjonalnie) Aby wybrać dane do wyświetlenia w etykietce narzędzia po najechaniu kursorem na wizualizację, kliknij + w sekcji Tooltip.

Podaj opinię na temat odpowiedzi

Każda odpowiedź usługi AI/BI Genie zawiera przycisk opinii: kciuk w górę lub kciuk w dół. Usługa Databricks zaleca zachęcanie użytkowników do przekazywania opinii na temat przestrzeni przy użyciu tego mechanizmu.

Aby uzyskać odpowiedź zawierającą wyniki zapytania, użytkownicy mogą zażądać przejrzenia jej przez edytora obszaru Genie, klikając ikonę . Jeśli użytkownik ma pytania dotyczące jakości lub dokładności wygenerowanej odpowiedzi, może oznaczyć go do przeglądu i, opcjonalnie, dodać komentarz lub pytanie.

Użytkownicy biznesowi mogą wyświetlać aktualizacje pytań oznaczonych do przeglądu na stronie Historia. Użytkownicy z co najmniej uprawnieniami CAN MANAGE w obszarze Genie mogą przeglądać konkretną wymianę, komentować żądanie i potwierdzać lub poprawiać odpowiedź. Mogą oni uzyskiwać dostęp do opinii i przeglądać żądania na stronie monitorowania. Następnie możesz użyć tej opinii, aby dostosować odpowiedzi i wprowadzać zmiany w swoim projekcie. Zobacz Przejrzyj historię i opinie.

Przeglądanie historii i opinii

Przestrzeń Genie ma być narzędziem do ciągłej współpracy dla zespołów danych i użytkowników biznesowych w celu gromadzenia wiedzy, a nie jednorazowego wdrożenia. Zrozumienie nowych pytań, do których użytkownicy biznesowi potrzebują odpowiedzi, jest niezbędne do budowania wiedzy. Na stronie historii można wyświetlić poszczególne pytania i odpowiedzi, pozytywne lub negatywne opinie przekazane przez użytkowników oraz pytania oznaczone do przeglądu. Aby otworzyć stronę historii, kliknij ikonę Historia Historia na pasku bocznym obszaru Genie.

Na stronie historii są wyświetlane wszystkie pytania i odpowiedzi, które zostały zadane w przestrzeni. Pytania można filtrować według czasu, oceny, użytkownika lub stanu. Monitorując przestrzeń, edytory przestrzeni Genie mogą aktywnie zrozumieć zapytania zgłaszane przez użytkowników biznesowych i sposób reagowania przestrzeni Genie.

Identyfikując pytania, z którymi zmaga się Genie, możesz zaktualizować przestrzeń Genie za pomocą określonych instrukcji, aby poprawić odpowiedzi. Kliknij pytanie, aby otworzyć tekst pytania i odpowiedzi. Możesz również uzyskać dostęp do pełnego wątku czatu z tego widoku.

Edytowanie wygenerowanego kodu SQL

Wygenerowany kod SQL można przejrzeć i edytować w dowolnej odpowiedzi. Autorzy obszaru Genie zwykle znają domenę i dane, które pozwalają im rozpoznać, gdy Genie generuje niepoprawną odpowiedź. Często błędy można naprawić za pomocą niewielkiej ilości ręcznego dostrajania do wygenerowanego zapytania SQL. Aby wyświetlić wygenerowaną odpowiedź SQL, kliknij pozycję Pokaż wygenerowany kod, aby sprawdzić zapytanie.

Możesz edytować wygenerowaną instrukcję SQL, aby ją poprawić, jeśli masz uprawnienia CAN EDIT lub większe w obszarze Genie. Po wprowadzeniu poprawek uruchom zapytanie. Następnie możesz zapisać go jako instrukcję, aby nauczyć Genie, jak odpowiedzieć w przyszłości. Aby zapisać edytowane zapytanie, kliknij ikonę Zapisz jako instrukcję.

Udostępnij przestrzeń Genie

Użytkownicy przestrzeni Genie muszą mieć uprawnienia CAN USE w magazynie przypisanym do przestrzeni Genie i uprawnienia dostępu do obiektów Unity Catalog dostępnych w przestrzeni. Zobacz Jakich danych należy używać?.

Nowe przestrzenie Genie są domyślnie zapisywane w folderze użytkownika. Podobnie jak w przypadku innych obiektów obszaru roboczego, dziedziczą uprawnienia z otaczającego folderu. Możesz użyć struktury folderów obszaru roboczego, aby udostępnić je innym użytkownikom. Zobacz Organizowanie obiektów obszaru roboczego w folderach.

Można również określić określonych użytkowników lub grup do udostępnienia na danym poziomie uprawnień: CAN MANAGE, CAN EDIT, CAN RUN i CAN VIEW.

Aby udostępnić określonym użytkownikom lub grupom:

1. Kliknij Udostępnij.
2. Wprowadź użytkowników lub grupy, którym chcesz udostępnić miejsce. Następnie kliknij Dodaj i ustaw odpowiednie poziomy uprawnień. Indywidualni użytkownicy i członkowie małych grup otrzymują powiadomienie e-mail z potwierdzeniem, że miejsce zostało udostępnione.
3. Użyj przycisku Kopiuj łącze w dolnej części okna dialogowego Udostępnianie, aby uzyskać udostępnialny link do przestrzeni Genie. Uprzywilejowani użytkownicy mogą kliknąć link, aby otworzyć obszar Genie na nowej karcie i zadać pytania.

Skopiować przestrzeń Genie

Klonowanie przestrzeni Genie powoduje utworzenie kopii, w tym całego kontekstu konfiguracji i instrukcji. Jest to przydatne, jeśli masz dobrze opracowaną przestrzeń i chcesz utworzyć nowe miejsce na potrzeby dodatkowych testów lub ponownie użyć kontekstu z oryginalnego miejsca. Po sklonowaniu przestrzeni nowa przestrzeń jest niezależna od oryginału, umożliwiając wprowadzanie zmian i korekt bez wpływu na oryginał.

Następujące elementy są kopiowane do sklonowanej przestrzeni Genie:

• Tabele i ustawienia
• Ogólne instrukcje
• Przykładowe zapytania SQL
• Funkcje SQL

Istniejące wątki czatu i Historia danych nie są kopiowane do nowego miejsca.

Aby sklonować przestrzeń Genie, wykonaj następujące czynności:

1. Otwórz przestrzeń Genie, którą chcesz sklonować.
2. Kliknij menu kebab Kabab w prawym górnym rogu obszaru.
3. Kliknij , sklonuj.
4. (Opcjonalnie) W oknie dialogowym Klonowanie, określ nową nazwę i lokalizację folderu obszaru roboczego dla sklonowanego obszaru Genie.
5. Kliknij Sklonuj, aby utworzyć nową przestrzeń.

Najlepsze rozwiązania dotyczące przygotowywania przestrzeni

Aby uzyskać wskazówki dotyczące najlepszych rozwiązań i pomocy w rozwiązywaniu problemów, zobacz Jak skutecznie zarządzać przestrzenią Genie.

Monitorowanie użycia

Dzienniki inspekcji umożliwiają monitorowanie użycia przestrzeni Genie. Zobacz zdarzenia AI/BI Genie.

Korzystanie z interfejsu API konwersacji Genie

Interfejs API konwersacji Genie udostępnia punkt końcowy dla istniejącej przestrzeni Genie, w której można zadawać pytania, pobierać wygenerowany SQL oraz wyniki zapytań lub uzyskiwać szczegóły skojarzone z przestrzenią Genie. Współczynnik przepływności interfejsu API konwersacji jest najlepszy i zależy od pojemności systemu. W normalnych lub niskich warunkach ruchu żądania są ograniczone do 5 zapytań na minutę na obszar roboczy. W okresach szczytowego użycia rzeczywista przepływność może być niższa, ponieważ żądania są przetwarzane na podstawie dostępnej pojemności.

Aby dowiedzieć się, jak utworzyć system z wieloma agentami przy użyciu programu Mosaic AI Agent Framework, zobacz Use Genie in multi-agent systems.