Menyematkan Agen Genie di aplikasi eksternal

Sematkan Agen Genie sebagai iframe di situs web atau aplikasi eksternal sehingga pengguna dapat berinteraksi dengan Genie di dalam alat atau portal internal Anda tanpa menavigasi ke Azure Databricks. Admin ruang kerja mengonfigurasi permukaan penyematan yang diizinkan; Pengguna yang disematkan dapat mengirim perintah tetapi tidak dapat mengedit konfigurasi agen.

Note

Genie Agents sebelumnya dikenal sebagai Genie Spaces.

Requirements

Sebelum Anda dapat menyematkan Genie Agent, hal-hal berikut harus sudah tersedia:

• Admin ruang kerja: Harus mengonfigurasi permukaan penyematan yang diizinkan di pengaturan manajemen akses Genie.
• Pembuat agen: Harus memiliki setidaknya izin CAN MANAGE di Genie Agent.
• Pengguna akhir: Harus memiliki akses eksplisit ke Agen Genie dan aset data mendasar yang digunakannya. Pengguna yang tidak masuk ke Azure Databricks diminta untuk mengautentikasi sebelum mereka dapat berinteraksi dengan agen yang disematkan.

Note

Pengguna Agen Genie Tersemat dapat mengirim perintah tetapi tidak dapat mengedit konfigurasi agen.

Langkah 1: Mengonfigurasi permukaan penyematan yang diizinkan

Admin ruang kerja harus mengonfigurasi permukaan penyematan yang diizinkan sebelum Agen Genie dapat disematkan. Lihat Mengelola dasbor dan penyematan Agen Genie.

Langkah 2: Hasilkan kode iframe

Setelah admin mengonfigurasi permukaan yang diizinkan, penulis agen dapat menghasilkan kode semat iframe.

1. Buka Agen Genie yang ingin Anda sematkan.
2. Klik Bagikan.
3. Dalam dialog Bagikan, klik Sematkan ruang.
4. Salin kode iframe yang dihasilkan.

Langkah 3: Tambahkan iframe ke aplikasi Anda

Tempelkan kode iframe ke situs web atau aplikasi eksternal Anda.

Untuk mengaktifkan fungsionalitas penuh, termasuk menyalin data CSV dan menyalin tautan percakapan, tambahkan allow="clipboard-write" atribut ke elemen iframe:

<iframe src="<your-genie-space-url>" allow="clipboard-write" width="100%" height="600"></iframe>

Praktik terbaik

• Memberikan akses data eksplisit: Pastikan pengguna akhir memiliki akses ke Agen Genie dan semua aset data mendasar yang digunakan oleh agen. Pengguna hanya melihat data yang mereka miliki izin untuk mengakses.
• Aktifkan akses clipboard: Sertakan allow="clipboard-write" pada elemen iframe sehingga pengguna dapat menyalin hasil kueri dan tautan percakapan.
• Batasi permukaan yang diizinkan: Hanya tambahkan domain ke daftar permukaan penyematan yang diizinkan yang Anda percayai dan kontrol.