Dodaj zasób przestrzeni Genie do aplikacji Databricks

Dodaj obszar 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.

Podczas tworzenia lub edytowania aplikacji przejdź do kroku Konfigurowanie .
W sekcji Zasoby aplikacji kliknij pozycję + Dodaj zasób.
Wybierz Przestrzeń Genie jako typ zasobu.
Wybierz przestrzeń Genie z listy dostępnych miejsc w przestrzeni roboczej.
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.
(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 przestrzeni Genie:

Usługa Azure Databricks przyznaje głównej nazwie 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 jest ograniczony tylko do wybranego obszaru. Aplikacja nie może uzyskać dostępu do innych miejsc Genie, chyba że zostaną dodane jako oddzielne zasoby.

Uwaga / Notatka

Jednostka usługi aplikacji wymaga również odpowiednich uprawnień do bazowych źródeł danych, które wykonuje zapytania dotyczące obszaru Genie. Zazwyczaj obejmuje to uprawnienia USE CATALOG, USE SCHEMA, i SELECT dotyczące odpowiednich tabel i widoków katalogu Unity.

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 przestrzeni Genie z aplikacji, główny element usługi aplikacji utraci dostęp do tej przestrzeni. 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 magazynie SQL (jeśli korzystasz z oddzielnego magazynu niż przestrzeń Genie)
CAN QUERY w modelu obsługującym punkty końcowe
USE CATALOG i USE SCHEMA na odpowiednich obiektach Unity Catalog
SELECT na tabelach, które aplikacja zapytuje 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órych aplikacja potrzebuje do działania.
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.

Opinia

Czy ta strona była pomocna?

Last updated on 2026-03-15