Menambahkan sumber daya Agen Genie ke aplikasi Databricks

Tambahkan Agen Genie sebagai sumber daya Aplikasi Databricks untuk mengaktifkan kueri bahasa alami di aplikasi Anda. Agen Genie 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 Agen Genie 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 Agen Genie

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

  1. Di bagian Sumber daya aplikasi saat Anda membuat atau mengedit aplikasi, klik + TambahkanAgen Genie>.
  2. Pilih Agen Genie 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 Agen Genie.
    • Dapat menjalankan: Memberikan izin aplikasi untuk mengirimkan kueri ke Agen Genie dan menerima respons.
    • Dapat mengedit: Memberikan izin aplikasi untuk memodifikasi konfigurasi Agen Genie.
    • Dapat mengelola: Memberikan akses administratif penuh aplikasi ke Agen Genie.
  4. (Opsional) Tentukan kunci sumber daya kustom, yaitu cara Anda mereferensikan Agen Genie di konfigurasi aplikasi Anda. Kunci defaultnya adalah genie-space.

Saat Anda menambahkan sumber daya Agen Genie:

  • Azure Databricks memberikan aplikasi Anda service principal izin yang ditentukan untuk Genie Agent yang dipilih.
  • Aplikasi ini dapat mengirimkan kueri bahasa alami ke agen dan menerima respons terstruktur dengan kueri dan hasil SQL.
  • Aplikasi ini mengakses konteks bisnis agen yang telah dikurasi, termasuk metadata, contoh kueri, dan definisi data.
  • Akses hanya dibatasi pada agen yang dipilih. Aplikasi Anda tidak dapat mengakses Agen Genie lainnya kecuali Anda menambahkannya sebagai sumber daya terpisah.

Nota

Prinsipal layanan aplikasi juga memerlukan izin yang sesuai pada sumber data yang mendasarinya yang dikueri oleh Agen Genie. Ini biasanya mencakup izin USE CATALOG, USE SCHEMA, dan SELECT pada tabel dan tampilan Katalog Unity yang relevan.

Variabel lingkungan

Saat Anda menerapkan aplikasi dengan sumber daya Agen Genie, Azure Databricks menyediakan ID ruang melalui variabel lingkungan yang dapat Anda rujuk menggunakan bidang valueFrom dalam 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 Agent 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 Agen Genie

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

Menggabungkan Agen Genie dengan sumber daya aplikasi lainnya

Gabungkan Agen Genie dengan sumber daya Aplikasi Databricks 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:

  • Agen Genie: 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:

  • Agen Genie: 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 Agen Genie
  • CAN USE pada gudang data SQL (jika menggunakan yang terpisah dari Agen Genie)
  • 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 Agen Genie:

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