Gunakan panduan ini jika Anda adalah admin workspace ChatGPT yang menyiapkan templat aplikasi Databricks untuk organisasi Anda. Templat bukanlah aplikasi final yang digunakan anggota. Ini adalah alur penyiapan yang membuat draf aplikasi khusus workspace setelah Anda memberikan konfigurasi Databricks yang diperlukan.
Untuk Databricks, sebagian besar penyiapan dilakukan di Databricks Account Console. Anda membuat koneksi aplikasi Oauth kustom, mendaftarkan URL callback ChatGPT, menyalin kredensial klien yang dihasilkan, lalu menempelkan nilai tersebut ke alur penyiapan templat ChatGPT. Setelah ChatGPT membuat draf aplikasi, Anda dapat memublikasikan dan mengelolanya seperti aplikasi workspace lainnya.
Yang Anda siapkan
Anda membuat aplikasi Databricks khusus workspace di ChatGPT. Aplikasi ini menggunakan:
Koneksi aplikasi Oauth Databricks yang dibuat di Databricks Account Console Anda.
ID klien dan rahasia klien Oauth Databricks.
URL callback persis yang disalin dari ChatGPT.
Cakupan Databricks yang sesuai dengan kemampuan konektor yang ingin Anda aktifkan.
Detail penyedia Databricks apa pun yang diminta oleh alur penyiapan ChatGPT, seperti host workspace, host akun, ID akun, atau warehouse.
Sebelum memulai
Anda memerlukan:
Akses admin atau pemilik workspace ChatGPT.
Akses admin akun Databricks. Akses admin workspace mungkin cukup untuk beberapa tugas, tetapi koneksi aplikasi kustom dikonfigurasi dari Databricks Account Console.
Databricks Account Console terbuka di tab terpisah.
Layar penyiapan templat aplikasi Databricks terbuka di ChatGPT agar Anda dapat menyalin URL callback yang persis.
Keputusan apakah aplikasi memerlukan akses API Databricks umum atau hanya akses Databricks SQL.
Tempat yang aman untuk menangani rahasia klien Databricks.
Jangan mengarang URL callback. Salin URL callback persis yang ditampilkan di ChatGPT.
Nilai yang perlu disiapkan
URL callback: salin ini dari alur penyiapan templat ChatGPT.
ID klien Oauth Databricks.
Rahasia klien Oauth Databricks.
Cakupan akses Databricks, seperti ALL APIs atau SQL.
Kolom workspace atau akun Databricks yang diminta oleh alur penyiapan ChatGPT.
Publikasikan dan kelola aplikasi di ChatGPT
Membuat draf aplikasi tidak otomatis membuatnya tersedia bagi anggota. Setelah meninjau draf:
Publikasikan draf aplikasi.
Konfirmasikan bahwa aplikasi muncul di Pengaturan workspace > Aplikasi > Diaktifkan.
Konfigurasikan Akses pengguna untuk peran yang akan menggunakannya.
Tinjau Kontrol tindakan untuk tindakan Databricks yang diekspos oleh aplikasi.
Tinjau Izin aplikasi untuk memilih kapan ChatGPT meminta anggota sebelum menggunakan aplikasi.
Minta pengguna uji yang diizinkan untuk membuka Aplikasi di ChatGPT dan mengonfirmasi bahwa aplikasi muncul.
Izin aplikasi ini berlaku untuk percakapan ChatGPT. Agen Workspace menggunakan kontrol per agen yang ditetapkan oleh pembuat agen untuk menentukan tindakan aplikasi mana yang tersedia dan kapan pengguna akhir diminta menyetujuinya. Untuk perilaku agen, lihat: Agen Workspace ChatGPT untuk Enterprise dan Business.
Mulai penyiapan templat di ChatGPT
Di ChatGPT, beralihlah ke workspace tempat aplikasi harus tersedia.
Buka Pengaturan workspace > Aplikasi.
Pilih Direktori.
Cari Databricks.
Pilih templat aplikasi Databricks dan mulai penyiapan.
Masukkan nama dan deskripsi aplikasi yang jelas, seperti Databricks atau Databricks - Data Platform.
Di bagian klien Oauth, salin URL callback dari ChatGPT. Biarkan tab ini tetap terbuka.
Contoh URL callback: https://chatgpt.com/connector/oauth/<callback_id>
Jangan hapus ID callback, menambahkan garis miring di akhir, atau menggantinya dengan URL ChatGPT generik.
Buat koneksi aplikasi Oauth di Databricks
Buka Databricks Account Console untuk akun Databricks Anda.
Di bilah sisi kiri, buka Pengaturan.
Buka tab Koneksi aplikasi.
Pilih Tambahkan koneksi.
Masukkan nama aplikasi, seperti ChatGPT Databricks Connector.
Di URL Pengalihan, tempelkan URL callback persis yang disalin dari ChatGPT.
Di bawah Cakupan akses, pilih cakupan yang diperlukan aplikasi.
Gunakan ALL APIs untuk aplikasi Databricks umum yang memerlukan API Databricks selain SQL.
Gunakan SQL saja untuk aplikasi yang dibatasi pada API Databricks SQL.
Biarkan TTL token pada default Databricks kecuali organisasi Anda memiliki kebijakan tertentu.
Aktifkan Buat rahasia klien. ChatGPT memerlukan klien Oauth rahasia untuk alur ini.
Buat koneksi.
Salin kredensial dari Databricks
Dalam dialog Koneksi dibuat, salin ID Klien.
Segera salin Rahasia klien dan simpan dengan aman.
Jika Anda menutup dialog sebelum menyalin rahasia, buat atau rotasi kredensial aplikasi Oauth dan gunakan rahasia baru.
Databricks hanya menampilkan rahasia sekali. Perlakukan seperti kredensial dan jangan sertakan dalam tangkapan layar, tiket, komentar, atau chat.
Selesaikan penyiapan di ChatGPT
Kembali ke tab penyiapan templat ChatGPT.
Tempelkan ID Klien Databricks ke ID klien Oauth.
Tempelkan rahasia Klien Databricks ke rahasia klien Oauth.
Biarkan Cakupan tidak berubah kecuali Anda sengaja perlu menimpa default templat.
Isi kolom penyedia Databricks apa pun yang diperlukan oleh alur penyiapan, seperti host workspace, host akun, ID akun, warehouse, atau nilai khusus Databricks lainnya.
Buat draf aplikasi.
Uji aplikasi sebagai pengguna
Mulai alur koneksi dari ChatGPT sebagai pengguna uji yang diizinkan.
Konfirmasikan bahwa browser membuka akun atau workspace Databricks yang diharapkan.
Setujui cakupan yang diminta.
Verifikasi bahwa browser kembali ke ChatGPT dan aplikasi ditampilkan sebagai terhubung.
Jalankan tindakan baca berisiko rendah terlebih dahulu, seperti mengambil informasi pengguna saat ini atau mengueri resource Databricks SQL yang disetujui.
Jika tindakan tulis diaktifkan, uji dengan workflow Databricks yang jelas berisiko rendah sebelum peluncuran lebih luas.
Kelola akses
Databricks dan ChatGPT sama-sama berperan dalam kontrol akses.
Di ChatGPT, admin workspace mengelola apakah aplikasi yang dipublikasikan tersedia, peran workspace mana yang dapat menggunakannya, tindakan mana yang diaktifkan, dan kapan ChatGPT meminta pengguna sebelum menggunakan aplikasi.
Di Databricks, admin mengelola pengguna mana yang dapat mengotorisasi aplikasi Oauth dan resource Databricks mana yang dapat diakses pengguna tersebut. Izin penyedia tetap berlaku setelah aplikasi diaktifkan di ChatGPT.
Pemecahan masalah
URI pengalihan tidak cocok: konfirmasikan bahwa URL Pengalihan Databricks sama persis dengan URL callback yang ditampilkan di ChatGPT, termasuk path dan ID callback.
Rahasia hilang: rahasia Databricks hanya ditampilkan satu kali. Buat rahasia klien baru jika belum disalin.
Aplikasi Oauth tidak langsung tersedia: Databricks menyatakan pembaruan aplikasi Oauth dapat memerlukan waktu hingga 30 menit untuk diproses.
Cakupan tidak memadai: jika ChatGPT dapat mengautentikasi tetapi panggilan API Databricks gagal, pastikan aplikasi Databricks memiliki ALL APIs saat aplikasi memerlukan API non-SQL.
Tindakan SQL gagal: konfirmasikan cakupan SQL, konfigurasi warehouse, dan izin Databricks.
Workspace salah: buat dan publikasikan aplikasi di workspace ChatGPT yang sama tempat pengguna akan menghubungkannya.
Pengguna tidak dapat terhubung: pastikan pengguna memiliki akses Databricks dan diizinkan mengotorisasi aplikasi Oauth.