Dodawanie zasobu obszaru Genie do aplikacji usługi Databricks

Dodaj przestrzenie usługi AI/BI Genie jako zasoby usługi Databricks Apps, aby umożliwić wykonywanie zapytań w języku naturalnym w aplikacjach. Funkcja Genie Spaces udostępnia interfejs konwersacyjny do eksploracji danych, umożliwiając użytkownikom zadawanie pytań biznesowych w języku angielskim i otrzymywanie szczegółowych informacji opartych na języku SQL z wyselekcjonowanych zestawów danych.

Po dodaniu obszaru Genie jako zasobu aplikacja może wykonywać następujące czynności:

• Konwertowanie zapytań języka naturalnego z użytkowników na język SQL
• Dostęp do wstępnie skonfigurowanego kontekstu biznesowego i metadanych
• Używanie wyselekcjonowanych przykładowych zapytań i definicji danych
• Generowanie odpowiedzi na podstawie zestawów danych organizacji

Dodawanie zasobu obszaru Genie

Przed dodaniem obszaru Genie jako zasobu zapoznaj się z wymaganiami wstępnymi dotyczącymi zasobów aplikacji.

1. Podczas tworzenia lub edytowania aplikacji przejdź do kroku Konfigurowanie .
2. W sekcji Zasoby aplikacji kliknij pozycję + Dodaj zasób.
3. Wybierz pozycję Przestrzeń Genie jako typ zasobu.
4. Wybierz przestrzeń Genie z listy dostępnych miejsc w obszarze roboczym.
5. Wybierz poziom uprawnień dla aplikacji:
   • Może wyświetlać: Przyznaje aplikacji uprawnienia do odczytywania konfiguracji i metadanych obszaru Genie.
   • Można uruchomić: Przyznaje aplikacji uprawnienia do przesyłania zapytań do obszaru Genie i odbierania odpowiedzi.
   • Może edytować: Przyznaje aplikacji uprawnienia do modyfikowania konfiguracji obszaru Genie.
   • Może zarządzać: Przyznaje aplikacji pełny dostęp administracyjny do obszaru Genie.
6. (Opcjonalnie) Określ niestandardowy klucz zasobu, w jaki sposób odwołujesz się do obszaru Genie w konfiguracji aplikacji. Kluczem domyślnym jest genie-space.

Po dodaniu zasobu obszaru Genie:

• Usługa Azure Databricks przyznaje jednostce usługi aplikacji określone uprawnienia do wybranego obszaru Genie.
• Aplikacja może przesyłać zapytania języka naturalnego do przestrzeni i odbierać ustrukturyzowane odpowiedzi za pomocą zapytań SQL i wyników.
• Aplikacja uzyskuje dostęp do wyselekcjonowanych kontekstów biznesowych przestrzeni, w tym metadanych, przykładowych zapytań i definicji danych.
• Dostęp ma zakres tylko do wybranego miejsca. Aplikacja nie może uzyskać dostępu do innych miejsc Genie, chyba że zostaną dodane jako oddzielne zasoby.

Zmienne środowiskowe

Podczas wdrażania aplikacji za pomocą zasobu obszaru Genie usługa Azure Databricks uwidacznia identyfikator przestrzeni za pomocą zmiennych środowiskowych, do których można się odwołać przy użyciu valueFrom pola w app.yaml konfiguracji.

Przykładowa konfiguracja:

env:
  - name: GENIE_SPACE_ID
    valueFrom: genie-space # Use your custom resource key if different

Za pomocą identyfikatora spacji w aplikacji:

import os
from databricks.sdk import WorkspaceClient

# Access the Genie space using the injected environment variable
space_id = os.getenv("GENIE_SPACE_ID")

# Initialize the workspace client
w = WorkspaceClient()

# Start a conversation with a natural language query
response = w.genie.start_conversation_and_wait(
    space_id=space_id,
    content="What were our top-selling products last quarter?"
)

# Process the response (responses contain attachments with text, queries, and so on)
for attachment in response.attachments:
    print(f"Genie response: {attachment.text.content}")

# Continue the conversation with additional questions
follow_up = w.genie.create_message_and_wait(
    space_id=space_id,
    conversation_id=response.conversation_id,
    content="Can you break that down by product category?"
)

Aby uzyskać więcej informacji, zobacz Uzyskiwanie dostępu do zmiennych środowiskowych z zasobów.

Usuwanie zasobu obszaru Genie

Gdy usuniesz zasób obszaru Genie z aplikacji, jednostka usługi aplikacji utraci dostęp do miejsca. Sama przestrzeń Genie pozostaje niezmieniona i nadal jest dostępna dla innych użytkowników i aplikacji, które mają odpowiednie uprawnienia.

Łączenie przestrzeni genie z innymi zasobami aplikacji

Połącz przestrzenie Genie z innymi zasobami usługi Databricks Apps, aby utworzyć bardziej zaawansowane aplikacje danych. Typowe wzorce integracji obejmują:

Pulpit nawigacyjny analizy języka naturalnego

Użyj następujących zasobów razem, aby uruchomić interaktywną analizę:

• Przestrzeń Genie: Konwertuje pytania użytkowników na zapytania SQL
• SQL Warehouse: Uruchamia zapytania i zwraca wyniki wizualizacji
• Tajemnice: Przechowuje klucze interfejsu API dla zewnętrznych narzędzi do wizualizacji

Przykładowa konfiguracja:

env:
  - name: GENIE_SPACE_ID
    valueFrom: genie-space
  - name: SQL_WAREHOUSE_ID
    valueFrom: sql-warehouse
  - name: EXTERNAL_API_KEY
    valueFrom: viz-secret

Ulepszona analiza biznesowa w zakresie sztucznej inteligencji

Skorzystaj z następujących zasobów, aby zintegrować z modelami sztucznej inteligencji:

• Przestrzeń Genie: Generuje początkowe zapytanie i kontekst danych
• Punkt końcowy obsługujący model: Zwraca podsumowania i zalecenia wygenerowane przez sztuczną inteligencję
• SQL Warehouse: Uruchamia złożone zapytania analityczne

Uprawnienia jednostki usługi

Przyznaj jednostce usługi aplikacji następujące uprawnienia podczas integracji z innymi zasobami aplikacji:

• CAN RUN w obszarze Genie
• CAN USE w usłudze SQL Warehouse (jeśli używasz oddzielnej przestrzeni genie)
• CAN QUERY w modelu obsługującym punkty końcowe
• USE CATALOG i USE SCHEMA na odpowiednich obiektach wykazu aparatu Unity
• SELECT w tabelach, które aplikacja wykonuje zapytania bezpośrednio

Najlepsze rozwiązania

Postępuj zgodnie z tymi najlepszymi rozwiązaniami podczas pracy z zasobami obszaru Genie:

• Przyznaj minimalne uprawnienia. Zapewnij dostęp tylko do określonych obszarów Genie, które aplikacja musi działać.
• Upewnij się, że przestrzeń Genie zawiera dobrze wyselekcjonowane zestawy danych i metadane, aby poprawić jakość odpowiedzi zapytań języka naturalnego.
• Przetestuj zapytania aplikacji względem obszaru Genie, aby sprawdzić, czy może wygenerować dokładne wyniki dla oczekiwanych pytań użytkownika.
• Monitorowanie wydajności zapytań i dostosowywanie wzorców interakcji aplikacji za pomocą obszaru Genie w celu zoptymalizowania czasów odpowiedzi.
• Zaimplementuj obsługę błędów w przypadkach, w których przestrzeń Genie nie może skutecznie interpretować zapytań użytkowników ani reagować na nie.