Gunakan panduan ini jika Anda adalah admin workspace ChatGPT atau pengguna ChatGPT Plus atau Pro yang sedang menyiapkan aplikasi Databricks Genie menggunakan Oauth bawaan atau klien Oauth organisasi Anda.
Oauth bawaan: Jika tersedia di ChatGPT dan diaktifkan untuk workspace Databricks Anda, gunakan koneksi yang sudah dikonfigurasi. Anda tidak perlu membuat aplikasi Oauth atau memasukkan ID klien maupun secret klien. Ikuti bagian Oauth bawaan di bawah.
Klien Oauth kustom: Gunakan opsi ini jika Oauth bawaan tidak tersedia atau organisasi Anda mewajibkan penggunaan klien Oauth sendiri. Ikuti bagian Klien Oauth kustom di bawah.
Yang akan Anda siapkan
Anda akan membuat koneksi aplikasi Databricks untuk akun atau workspace ChatGPT Anda. Kedua opsi memerlukan detail penyedia Databricks yang diminta di ChatGPT serta izin untuk sumber daya yang akan Anda gunakan. Jika Anda menggunakan klien Oauth kustom, siapkan juga:
Koneksi aplikasi Oauth Databricks yang dibuat di Konsol Akun Databricks Anda.
ID klien dan secret klien Oauth Databricks.
URL callback yang disalin persis dari ChatGPT.
Cakupan Databricks yang sesuai dengan kemampuan aplikasi yang ingin Anda aktifkan.
Semua detail penyedia Databricks yang diminta dalam proses penyiapan ChatGPT, seperti host workspace, host akun, ID akun, atau warehouse.
Sebelum memulai
Untuk penyiapan workspace, buka konsol admin, pilih workspace ChatGPT yang dituju, lalu buka Plugin. Pilih Kelola Aplikasi Lama untuk membuka halaman Aplikasi yang masih dipertahankan. Untuk navigasi workspace dan akses aplikasi lama, lihat Kontrol admin, keamanan, dan kepatuhan untuk plugin dan aplikasi.
Anda memerlukan:
Akses admin atau pemilik workspace ChatGPT, atau akun ChatGPT Plus atau Pro.
Untuk klien Oauth kustom, akses admin akun Databricks. Akses admin workspace mungkin cukup untuk beberapa tugas, tetapi koneksi aplikasi kustom dikonfigurasi melalui Konsol Akun Databricks. Untuk Oauth bawaan, admin Databricks harus memeriksa bahwa aplikasi ChatGPT tersedia dan diaktifkan untuk workspace Anda.
Untuk klien Oauth kustom, Konsol Akun Databricks yang terbuka di tab terpisah.
Untuk klien Oauth kustom, layar koneksi Databricks Genie yang terbuka di ChatGPT agar Anda dapat menyalin URL callback secara persis.
Keputusan tentang kemampuan yang dibutuhkan aplikasi: Genie dan dasbor AI/BI, akses API Databricks yang lebih luas, atau aplikasi yang terbatas pada API Databricks SQL. Akses khusus SQL tidak memadai untuk tindakan Genie atau dasbor.
Untuk klien Oauth kustom, tempat yang aman untuk mengelola secret klien Databricks.
Jika akun atau workspace Databricks Anda membatasi akses melalui daftar akses IP, kontrol lalu lintas masuk berbasis konteks, firewall, atau kebijakan jaringan lainnya, bantuan admin Databricks yang dapat mengizinkan rentang IP keluar aplikasi ChatGPT terkini.
Untuk klien Oauth kustom, salin URL Callback yang ditampilkan di ChatGPT secara persis.
Nilai yang perlu disiapkan
Untuk klien Oauth kustom, URL Callback: salin dari proses penyiapan aplikasi ChatGPT.
Untuk klien Oauth kustom, ID klien Oauth Databricks.
Untuk klien Oauth kustom, secret klien Oauth Databricks.
Untuk klien Oauth kustom, cakupan akses Databricks yang sesuai dengan kemampuan aplikasi. Untuk koneksi Genie/dasbor baru yang menampilkan
ai-gateway,dashboards, danoffline_access, siapkan cakupan tersebut. SEMUA API (all-apisdenganoffline_access) tetap menjadi alternatif lama dengan cakupan yang lebih luas. Gunakan SQL hanya untuk aplikasi yang terbatas pada API Databricks SQL.Kolom workspace atau akun Databricks yang diminta dalam proses penyiapan ChatGPT.
Oauth bawaan
Penuhi prasyarat di atas terlebih dahulu. Gunakan cara ini hanya jika Oauth bawaan tersedia di ChatGPT dan diaktifkan untuk workspace Databricks Anda.
Minta admin Databricks untuk memeriksa bahwa aplikasi ChatGPT tersedia di pengaturan integrasi aplikasi pada Konsol Akun dan diaktifkan untuk workspace Anda. Jika aplikasi ChatGPT tidak tercantum di Konsol Akun Databricks Anda, hubungi perwakilan akun Databricks Anda untuk menanyakan apakah fitur ini tersedia bagi akun Anda.
Di ChatGPT, beralihlah ke akun atau workspace tempat aplikasi akan tersedia. Buka Pengaturan > Plugin untuk penyiapan pribadi, atau Konsol admin > Plugin sebagai admin atau pemilik workspace untuk penyiapan workspace.
Pilih Databricks Genie, lalu pilih Tambahkan Koneksi Aplikasi.
Masukkan Nama host workspace (wajib) tanpa
https://atau jalur URL.ChatGPT menentukan endpoint Genie MCP lokal workspace,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, berdasarkan nama host ini. Tidak diperlukan endpoint MCP regional terpisah.Pilih Lanjutkan, lalu masuk ke Databricks dan tinjau permintaan persetujuan.
Lanjutkan ke bagian Hubungkan dan uji serta Kelola akses di bawah, termasuk pengujian oleh anggota yang diizinkan dan pemeriksaan akses workspace.
Klien Oauth kustom
Penuhi prasyarat di atas terlebih dahulu. Gunakan cara ini jika Oauth bawaan tidak tersedia atau organisasi Anda mengharuskan penggunaan klien Oauth sendiri. Setelah penyiapan, selesaikan langkah-langkah di bagian Hubungkan dan uji serta Kelola akses di bawah.
Mulai penyiapan Oauth kustom di ChatGPT
Di ChatGPT, beralihlah ke akun atau workspace tempat aplikasi akan tersedia.
Buka Pengaturan > Plugin untuk penyiapan pribadi, atau Konsol admin > Plugin sebagai admin atau pemilik workspace untuk penyiapan workspace.
Pilih Databricks Genie di Direktori.
Pilih Tambahkan Koneksi Aplikasi.
Di dialog Hubungkan Databricks Genie, cari kolom ID klien Oauth dan Rahasia klien Oauth. Untuk menggunakan alur klien kustom, masukkan kredensial di kolom yang ditampilkan ini; tidak diperlukan pemilih terpisah.
Salin URL Callback dari ChatGPT. Biarkan dialog ini tetap terbuka.
Contoh URL callback:
https://chatgpt.com/connector/oauth/<callback_id>
Jangan hapus ID callback, tambahkan garis miring di akhir, atau ganti URL tersebut dengan URL ChatGPT generik. URL yang didaftarkan di Databricks harus sama persis dengan URL Callback yang ditampilkan di ChatGPT.
Buat koneksi aplikasi Oauth kustom di Databricks
Buka Konsol Akun Databricks untuk akun Databricks Anda.
Di bilah sisi kiri, buka Pengaturan.
Buka tab Koneksi aplikasi.
Pilih Tambahkan koneksi.
Masukkan nama aplikasi, misalnya ChatGPT Databricks.
Di URL Pengalihan, tempel URL callback yang disalin persis dari ChatGPT.
Di bagian Cakupan akses, pilih cakupan yang dibutuhkan aplikasi.
Untuk koneksi Genie/dasbor baru yang menampilkan
ai-gateway,dashboards, danoffline_accessdi ChatGPT, izinkan cakupan yang sama pada aplikasi Oauth Databricks.SEMUA API tetap menjadi alternatif lama dengan cakupan yang lebih luas untuk akses API Databricks secara umum. Untuk konfigurasi ini, gunakan
all-apisdanoffline_accessdi ChatGPT dan pastikan aplikasi Oauth Databricks mengizinkan keduanya. Untuk koneksi Genie/dasbor baru, utamakan cakupan terperinci yang ditampilkan.Gunakan SQL hanya untuk aplikasi yang terbatas pada API Databricks SQL. Akses khusus SQL tidak memadai untuk tindakan Genie atau dasbor.
Pastikan setiap cakupan yang nantinya tercantum di ChatGPT diaktifkan pada aplikasi Oauth Databricks ini. Databricks secara otomatis mengizinkan openid, email, profile, dan offline_access untuk aplikasi yang dibuat melalui antarmuka pengguna.
Biarkan TTL token menggunakan nilai default Databricks, kecuali organisasi Anda memiliki kebijakan khusus: 60 menit untuk token akses dan 10080 menit untuk token penyegaran.
Aktifkan Buat secret klien. ChatGPT memerlukan klien Oauth bertipe rahasia untuk proses ini.
Buat koneksi.
Salin kredensial dari Databricks
Di dialog Koneksi dibuat, salin ID Klien.
Segera salin Secret klien dan simpan dengan aman.
Jika Anda menutup dialog sebelum menyalin secret, buat atau rotasi kredensial aplikasi Oauth dan gunakan secret yang baru.
Databricks hanya menampilkan secret satu kali. Perlakukan secret sebagai kredensial dan jangan sertakan dalam tangkapan layar, tiket, komentar, atau obrolan.
Selesaikan penyiapan Oauth kustom di ChatGPT
Kembali ke dialog Hubungkan Databricks Genie.
Masukkan ID klien Databricks di ID klien Oauth.
Masukkan rahasia klien Databricks di Rahasia klien Oauth.
Dengan memasukkan kredensial ini, Anda akan menggunakan klien Oauth kustom; tidak diperlukan pemilih terpisah.
Di Cakupan (opsional), masukkan cakupan yang diperlukan untuk endpoint dan kemampuan Databricks aplikasi Anda. Sesuaikan dengan cakupan yang diaktifkan di aplikasi Oauth Databricks.
Untuk koneksi Genie/dasbor baru yang menampilkan
ai-gateway,dashboards, danoffline_access, pertahankan cakupan tersebut. Pastikan aplikasi Oauth Databricks mengizinkan cakupan yang sama.ai-gatewaymemungkinkan koneksi Genie MCP lokal workspace,dashboardsmemungkinkan tindakan dasbor AI/BI, danoffline_accessmemungkinkan penggunaan token penyegaran.Alternatif lama yang lebih luas,
all-apisdanoffline_access, tetap didukung untuk akses API yang lebih luas, tetapi tidak diutamakan untuk koneksi Genie/dasbor ini. Jika aplikasi Databricks hanya mengizinkanall-apis, perbarui atau buat ulang aplikasi tersebut agar mengizinkanai-gateway,dashboards, danoffline_access. Jika cakupan terperinci tidak tersedia, atur ChatGPT secara eksplisit keall-apisdanoffline_access, lalu pastikan aplikasi Databricks mengizinkan keduanya. Jangan meminta ketiga cakupan terperinci di ChatGPT jika aplikasi Databricks hanya mengizinkanall-apis.Masukkan satu cakupan per baris atau pisahkan cakupan dengan koma. Setiap cakupan yang tercantum di ChatGPT harus diaktifkan di aplikasi Oauth Databricks.
Masukkan Nama host workspace (wajib) tanpa https:// atau jalur URL. Isi kolom penyedia Databricks wajib lainnya yang ditampilkan dalam alur penyiapan.
ChatGPT menentukan endpoint Genie MCP lokal workspace,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, berdasarkan nama host ini. Tidak diperlukan endpoint MCP regional terpisah.Pilih Lanjutkan.
ChatGPT hanya meminta cakupan yang dimasukkan di Cakupan (opsional). ChatGPT tidak otomatis menambahkan cakupan templat yang lebih luas.
Hubungkan dan uji
Lakukan pengujian koneksi dan pemeriksaan akses berikut untuk opsi Oauth mana pun yang Anda pilih.
Tinjau detail aplikasi, tindakan, dan pengaturan autentikasi.
Jika Anda adalah admin workspace, aktifkan aplikasi untuk workspace dan atur siapa yang dapat menggunakannya sesuai kebijakan workspace.
Mulai proses koneksi dari ChatGPT sebagai pengguna uji yang diizinkan, lalu masuk ke Databricks.
Pastikan browser membuka akun atau workspace Databricks yang diinginkan.
Tinjau cakupan yang diminta, lalu pilih Otorisasi.
Pastikan browser kembali ke ChatGPT dan aplikasi ditampilkan sebagai terhubung.
Jalankan tindakan baca berisiko rendah yang sesuai dengan kemampuan koneksi. Untuk koneksi Genie, kirim permintaan Genie tentang data yang boleh diakses oleh pengguna uji. Untuk kemampuan lain yang didukung, ambil informasi pengguna saat ini atau jalankan kueri pada sumber daya Databricks SQL yang telah disetujui. Pastikan pengguna memiliki izin sumber daya Databricks yang diperlukan; cakupan Oauth saja tidak memberikan akses ke data.
Jika tindakan tulis diaktifkan, lakukan pengujian dengan alur kerja Databricks yang jelas berisiko rendah sebelum menerapkannya secara lebih luas.
Untuk penyiapan workspace, minta anggota workspace non-admin yang diizinkan untuk menghubungkan aplikasi dan mengulangi pengujian berisiko rendah tersebut.
Kelola akses
Databricks dan ChatGPT sama-sama berperan dalam kontrol akses.
Di ChatGPT, admin workspace mengelola ketersediaan aplikasi dan cara anggota dapat menggunakannya. Di Business, admin mengelola apakah aplikasi diaktifkan untuk seluruh workspace. Tinjau kontrol admin aplikasi Databricks (Pengaturan workspace > Aplikasi atau Konsol Admin > Plugin > Kelola Aplikasi Lama) untuk:
Akses pengguna, untuk mengatur peran workspace mana yang dapat menggunakan aplikasi di workspace Enterprise dan Edu yang didukung.
Kontrol tindakan, untuk mengatur tindakan Databricks mana yang diaktifkan.
Izin aplikasi, untuk mengatur kapan ChatGPT meminta persetujuan anggota sebelum menggunakan aplikasi.
Izin aplikasi ini berlaku untuk percakapan ChatGPT. Agen Workspace menggunakan kontrol per agen yang ditetapkan oleh pembuat agen untuk menentukan tindakan aplikasi yang tersedia dan kapan pengguna akhir diminta untuk menyetujuinya. Untuk perilaku agen, lihat: Agen Workspace ChatGPT untuk Enterprise dan Business.
Di Databricks, admin mengelola pengguna mana yang dapat mengotorisasi aplikasi Oauth dan sumber daya Databricks mana yang dapat diakses pengguna tersebut. Izin penyedia tetap berlaku setelah aplikasi diaktifkan di ChatGPT.
Untuk navigasi workspace, akses aplikasi, dan kontrol aplikasi khusus paket, lihat: Kontrol admin, keamanan, dan kepatuhan dalam aplikasi.
Pemecahan masalah penyiapan aplikasi Databricks
URI pengalihan tidak cocok: Jika Anda menggunakan klien Oauth kustom, pastikan nilai URL Pengalihan di Databricks sama persis dengan URL Callback yang ditampilkan di ChatGPT, termasuk jalur dan ID callback-nya. Jangan hapus ID callback, tambahkan garis miring di akhir, atau ganti URL tersebut dengan URL pengalihan ChatGPT lainnya.
Secret tidak ada: Jika Anda menggunakan klien Oauth kustom, secret Databricks hanya ditampilkan satu kali. Buat secret klien baru jika Anda belum menyalinnya.
Aplikasi Oauth tidak langsung tersedia: Menurut Databricks, pembaruan aplikasi Oauth dapat memerlukan waktu hingga 30 menit untuk diproses.
Cakupan tidak memadai atau tidak cocok: Jika Anda menggunakan klien Oauth kustom, bandingkan Cakupan (opsional) di ChatGPT dengan Cakupan akses pada aplikasi Oauth Databricks. Setiap cakupan yang diminta ChatGPT harus diaktifkan di sana. Pastikan cakupan tersebut mendukung endpoint dan kemampuan yang Anda gunakan.
Untuk koneksi Genie/dasbor baru yang menampilkan
ai-gateway,dashboards, danoffline_access, pertahankan cakupan tersebut di ChatGPT dan pastikan aplikasi Databricks mengizinkan ketiganya. Jika aplikasi hanya mengizinkanall-apis, perbarui atau buat ulang aplikasi agar mengizinkan ketiga cakupan terperinci tersebut.Jika cakupan terperinci tidak tersedia, gunakan alternatif yang lebih luas dan didukung: atur ChatGPT ke
all-apisdanoffline_access, lalu pastikan aplikasi Databricks mengizinkan keduanya. Aplikasi yang hanya mengizinkanall-apistidak sesuai dengan permintaan ChatGPT untukai-gateway,dashboards, danoffline_access. Akses khusus SQL hanya sesuai untuk aplikasi yang terbatas pada API Databricks SQL; akses ini tidak memadai untuk tindakan Genie atau dasbor.Tindakan SQL gagal: Untuk aplikasi yang terbatas pada API Databricks SQL, periksa cakupan SQL, konfigurasi warehouse, dan izin Databricks.
Workspace ChatGPT salah: Buat dan aktifkan aplikasi di workspace ChatGPT yang sama dengan yang akan digunakan pengguna untuk menghubungkannya.
Akun atau workspace Databricks salah: Periksa nilai Nama host workspace (wajib), lalu ulangi proses masuk dan pastikan Databricks membuka akun atau workspace yang diinginkan.
Pengguna tidak dapat terhubung: Pastikan pengguna memiliki akses ke Databricks dan diizinkan untuk mengotorisasi aplikasi Oauth. Di Business, pastikan aplikasi diaktifkan untuk seluruh workspace. Di workspace Enterprise dan Edu yang didukung, pastikan juga Akses pengguna ChatGPT mengizinkan aplikasi tersebut.
Kebijakan jaringan Databricks memblokir aplikasi: Jika Databricks hanya mengizinkan IP sumber tertentu, admin Databricks harus memperbarui daftar akses IP akun atau workspace yang relevan, kontrol lalu lintas masuk berbasis konteks, firewall, atau aturan jaringan lain yang dikelola pelanggan.
Izinkan koneksi masuk dari rentang IP keluar aplikasi ChatGPT terkini.
Konfigurasikan daftar izin ini di Databricks atau lapisan jaringan yang dikelola pelanggan. Daftar ini terpisah dari daftar izin IP workspace ChatGPT.
Rentang yang dipublikasikan dapat berubah. Jika memungkinkan, otomatiskan pembaruan dari JSON.
Jangan merotasi secret klien atau mengubah cakupan Oauth untuk mengatasi pemblokiran jaringan. Pastikan terlebih dahulu apakah Databricks menolak IP sumber aplikasi.