Menambahkan sumber daya Genie Space ke aplikasi Databricks

Tambahkan Genie Spaces sebagai sumber daya Aplikasi Databricks untuk mengaktifkan kueri bahasa alami di aplikasi Anda. Genie Spaces menyediakan antarmuka percakapan untuk eksplorasi data, memungkinkan pengguna mengajukan pertanyaan bisnis dalam bahasa Inggris biasa dan menerima wawasan berbasis SQL dari himpunan data yang dikumpulkan.

Saat Anda menambahkan Genie Space sebagai sumber daya, aplikasi Anda dapat:

  • Mengonversi kueri bahasa alami dari pengguna menjadi SQL
  • Mengakses konteks bisnis dan metadata yang telah dikonfigurasi sebelumnya
  • Gunakan kueri sampel dan definisi data yang telah dikurasi
  • Membuat respons berdasarkan himpunan data organisasi Anda

Menambahkan sumber daya Genie Space

Sebelum Anda menambahkan Genie Space sebagai sumber daya, tinjau prasyarat sumber daya aplikasi.

  1. Di bagian Sumber daya aplikasi saat Anda membuat atau mengedit aplikasi, klik + Tambahkan sumber daya>Genie Space.
  2. Pilih Genie Space dari daftar ruang yang tersedia di ruang kerja Anda.
  3. Pilih tingkat izin untuk aplikasi Anda:
    • Dapat melihat: Memberikan izin aplikasi untuk membaca konfigurasi dan metadata Genie Space.
    • Dapat menjalankan: Memberikan izin aplikasi untuk mengirimkan kueri ke Genie Space dan menerima respons.
    • Dapat mengedit: Memberikan izin aplikasi untuk memodifikasi konfigurasi Genie Space.
    • Dapat mengelola: Memberikan akses administratif penuh aplikasi ke Genie Space.
  4. (Opsional) Tentukan kunci sumber daya kustom, yaitu cara Anda mereferensikan Genie Space di konfigurasi aplikasi Anda. Kunci defaultnya adalah genie-space.

Saat Anda menambahkan sumber daya Genie Space:

  • Azure Databricks memberikan service utama aplikasi Anda izin yang ditentukan pada Genie Space yang dipilih.
  • Aplikasi ini dapat mengirimkan kueri bahasa alami ke ruang dan menerima respons terstruktur dengan kueri dan hasil SQL.
  • Aplikasi ini mengakses konteks bisnis terkurasi dari ruang, termasuk metadata, kueri contoh, dan definisi data.
  • Akses dibatasi untuk ruang yang dipilih saja. Aplikasi Anda tidak dapat mengakses Genie Spaces lainnya kecuali Anda menambahkannya sebagai sumber daya terpisah.

Nota

Prinsipal layanan aplikasi juga memerlukan izin yang sesuai pada sumber data yang digunakan oleh Genie Space untuk melakukan kueri. Ini biasanya mencakup izin USE CATALOG, USE SCHEMA, dan SELECT pada tabel dan tampilan Katalog Unity yang relevan.

Variabel lingkungan

Saat Anda menyebarkan aplikasi dengan sumber daya Genie Space, Azure Databricks mengekspos ID ruang melalui variabel lingkungan yang dapat Anda referensikan menggunakan bidang valueFrom di konfigurasi app.yaml Anda.

Contoh konfigurasi:

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

Menggunakan ID ruang di aplikasi Anda:

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?"
)

Untuk informasi selengkapnya, lihat Mengakses variabel lingkungan dari sumber daya.

Menghapus sumber daya Genie Space

Saat Anda menghapus sumber daya Genie Space dari aplikasi, perwakilan layanan aplikasi akan kehilangan akses ke ruang tersebut. Genie Space sendiri tetap tidak berubah dan terus tersedia untuk pengguna dan aplikasi lain yang memiliki izin yang sesuai.

Menggabungkan Genie Spaces dengan sumber daya aplikasi lainnya

Gabungkan Genie Spaces dengan sumber daya Databricks Apps lainnya untuk membuat aplikasi data yang lebih canggih. Pola integrasi umum meliputi:

Dasbor analitik pemrosesan bahasa alami

Gunakan sumber daya berikut bersama-sama untuk menjalankan analitik interaktif:

  • Genie Space: Mengonversi pertanyaan pengguna menjadi kueri SQL
  • Gudang SQL: Menjalankan kueri dan mengembalikan hasil untuk visualisasi
  • Rahasia: Menyimpan kunci API untuk alat visualisasi eksternal

Contoh konfigurasi:

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

Kecerdasan bisnis yang ditingkatkan AI

Gunakan sumber daya berikut untuk berintegrasi dengan model AI:

  • Genie Space: Menghasilkan kueri awal dan konteks data
  • Titik akhir penyajian model: Mengembalikan ringkasan dan rekomendasi yang dihasilkan AI
  • Gudang SQL: Menjalankan kueri analitik yang kompleks

Izin perwakilan layanan

Berikan izin berikut kepada perwakilan layanan aplikasi Anda saat mengintegrasikan dengan sumber daya aplikasi lain:

  • CAN RUN pada Genie Space
  • CAN USE di gudang SQL (jika menggunakan yang terpisah dari Genie Space)
  • CAN QUERY pada model yang melayani titik akhir
  • USE CATALOG dan USE SCHEMA pada objek Katalog Unity yang relevan
  • SELECT pada tabel kueri aplikasi secara langsung

Praktik terbaik

Ikuti praktik terbaik ini saat Anda bekerja dengan sumber daya Genie Space:

  • Berikan izin minimal. Hanya berikan akses ke Genie Spaces tertentu yang perlu difungsikan aplikasi Anda.
  • Pastikan Genie Space berisi himpunan data dan metadata yang dikurasi dengan baik untuk meningkatkan kualitas respons kueri bahasa alami.
  • Uji kueri aplikasi Anda terhadap Genie Space untuk memvalidasi bahwa aplikasi dapat menghasilkan hasil yang akurat untuk pertanyaan pengguna yang diharapkan.
  • Pantau performa kueri dan sesuaikan pola interaksi aplikasi Anda dengan Genie Space untuk mengoptimalkan waktu respons.
  • Terapkan penanganan kesalahan untuk kasus di mana Genie Space tidak dapat menginterpretasikan atau menanggapi kueri pengguna secara efektif.
  • Last updated on