Gunakan panduan ini jika anda pentadbir ruang kerja ChatGPT atau pengguna ChatGPT Plus atau Pro yang sedang menyediakan penyambung Databricks Genie menggunakan OAuth terbina dalam atau klien OAuth organisasi anda.
OAuth terbina dalam: Gunakan sambungan yang telah diprakonfigurasi apabila tersedia dalam ChatGPT dan didayakan untuk ruang kerja Databricks anda. Anda tidak perlu mencipta aplikasi OAuth atau memasukkan ID klien atau rahsia klien. Ikuti bahagian OAuth terbina dalam di bawah.
Klien OAuth tersuai: Gunakan kaedah ini jika OAuth terbina dalam tidak tersedia atau organisasi anda memerlukan klien OAuth sendiri. Ikuti bahagian Klien OAuth tersuai di bawah.
Perkara yang anda sediakan
Anda akan mencipta sambungan aplikasi Databricks untuk akaun atau ruang kerja ChatGPT anda. Kedua-dua kaedah memerlukan butiran penyedia Databricks yang diminta dalam ChatGPT serta kebenaran untuk sumber yang ingin anda gunakan. Jika anda menggunakan klien OAuth tersuai, sediakan juga:
Sambungan aplikasi OAuth Databricks yang dicipta dalam Konsol Akaun Databricks anda.
ID klien dan rahsia klien OAuth Databricks.
URL panggil balik yang disalin tepat daripada ChatGPT.
Skop Databricks yang sepadan dengan keupayaan penyambung yang ingin anda dayakan.
Sebarang butiran penyedia Databricks yang diminta semasa proses persediaan ChatGPT, seperti hos ruang kerja, hos akaun, ID akaun atau gudang.
Sebelum anda bermula
Anda memerlukan:
Akses pentadbir atau pemilik ruang kerja ChatGPT, atau akaun ChatGPT Plus atau Pro.
Untuk klien OAuth tersuai, akses pentadbir akaun Databricks. Akses pentadbir ruang kerja mungkin mencukupi untuk sesetengah tugas, tetapi sambungan aplikasi tersuai dikonfigurasi melalui Konsol Akaun Databricks. Untuk OAuth terbina dalam, pentadbir Databricks mesti menyemak bahawa aplikasi ChatGPT tersedia dan didayakan untuk ruang kerja anda.
Untuk klien OAuth tersuai, Konsol Akaun Databricks yang dibuka dalam tab berasingan.
Untuk klien OAuth tersuai, skrin sambungan Databricks Genie yang dibuka dalam ChatGPT supaya anda dapat menyalin URL panggil balik dengan tepat.
Keputusan sama ada aplikasi memerlukan akses API Databricks umum atau akses Databricks SQL sahaja.
Untuk klien OAuth tersuai, tempat yang selamat untuk mengendalikan rahsia klien Databricks.
Jika akaun atau ruang kerja Databricks anda mengehadkan akses melalui senarai akses IP, kawalan trafik masuk berasaskan konteks, tembok api atau dasar rangkaian lain, bantuan daripada pentadbir Databricks yang boleh membenarkan julat IP trafik keluar penyambung ChatGPT yang terkini.
Untuk klien OAuth tersuai, salin URL Panggil Balik yang ditunjukkan dalam ChatGPT dengan tepat.
Nilai yang perlu disediakan
Untuk klien OAuth tersuai, URL Panggil Balik: salin URL ini daripada proses persediaan penyambung ChatGPT.
Untuk klien OAuth tersuai, ID klien OAuth Databricks.
Untuk klien OAuth tersuai, rahsia klien OAuth Databricks.
Untuk klien OAuth tersuai, skop akses Databricks yang sesuai dengan keupayaan aplikasi, seperti SEMUA API atau SQL.
Medan ruang kerja atau akaun Databricks yang diminta semasa proses persediaan ChatGPT.
OAuth terbina dalam
Penuhi prasyarat di atas terlebih dahulu. Gunakan kaedah ini hanya apabila OAuth terbina dalam tersedia dalam ChatGPT dan didayakan untuk ruang kerja Databricks anda.
Minta pentadbir Databricks menyemak bahawa aplikasi ChatGPT tersedia dalam tetapan integrasi aplikasi Konsol Akaun dan didayakan untuk ruang kerja anda. Jika aplikasi ChatGPT tidak disenaraikan dalam Konsol Akaun Databricks anda, hubungi wakil akaun Databricks anda untuk bertanya sama ada ciri ini tersedia untuk akaun anda.
Dalam ChatGPT, tukar ke akaun atau ruang kerja tempat aplikasi perlu disediakan. Pergi ke Tetapan > Pemalam untuk persediaan peribadi, atau ke Tetapan ruang kerja > Pemalam sebagai pentadbir atau pemilik ruang kerja untuk persediaan ruang kerja.
Pilih Databricks Genie, kemudian pilih Tambah Sambungan Aplikasi.
Masukkan Nama hos ruang kerja (wajib) tanpa
https://atau laluan URL.Pilih Teruskan, kemudian log masuk ke Databricks dan semak permintaan persetujuan.
Teruskan ke bahagian Sambungkan dan uji serta Urus akses di bawah, termasuk ujian ahli yang dibenarkan dan semakan akses ruang kerja.
Klien OAuth tersuai
Penuhi prasyarat di atas terlebih dahulu. Gunakan kaedah ini jika OAuth terbina dalam tidak tersedia atau organisasi anda memerlukan klien OAuth sendiri. Selepas persediaan, lengkapkan bahagian Sambungkan dan uji serta Urus akses di bawah.
Mulakan persediaan OAuth tersuai dalam ChatGPT
Dalam ChatGPT, tukar ke akaun atau ruang kerja tempat aplikasi perlu disediakan.
Pergi ke Tetapan > Pemalam untuk persediaan peribadi, atau ke Tetapan ruang kerja > Pemalam sebagai pentadbir atau pemilik ruang kerja untuk persediaan ruang kerja.
Pilih Databricks Genie dalam Direktori.
Pilih Tambah Sambungan Aplikasi.
Dalam dialog Sambungkan Databricks Genie, cari bahagian klien OAuth.
Salin URL Panggil Balik daripada ChatGPT. Biarkan dialog ini terbuka.
Contoh URL panggil balik:
https://chatgpt.com/connector/oauth/<callback_id>
Jangan buang ID panggil balik, tambah garis miring di hujung URL atau gantikan URL tersebut dengan URL ChatGPT umum. URL yang didaftarkan dalam Databricks mesti sama tepat dengan URL Panggil Balik yang ditunjukkan dalam ChatGPT.
Cipta sambungan aplikasi OAuth tersuai dalam Databricks
Buka Konsol Akaun Databricks untuk akaun Databricks anda.
Pada bar sisi kiri, buka Tetapan.
Buka tab Sambungan aplikasi.
Pilih Tambah sambungan.
Masukkan nama aplikasi, seperti Penyambung ChatGPT Databricks.
Dalam URL Ubah Hala, tampalkan URL panggil balik yang disalin tepat daripada ChatGPT.
Di bawah Skop akses, pilih skop yang diperlukan oleh aplikasi.
Gunakan SEMUA API untuk aplikasi Databricks umum yang memerlukan API Databricks selain SQL.
Gunakan SQL hanya untuk aplikasi yang terhad kepada API Databricks SQL.
Pastikan setiap skop yang disenaraikan kemudian dalam ChatGPT didayakan pada aplikasi OAuth Databricks ini. Databricks secara automatik membenarkan openid, email, profile dan offline_access untuk aplikasi yang dicipta melalui UI.
Kekalkan TTL token pada nilai lalai Databricks melainkan organisasi anda mempunyai dasar khusus: 60 minit untuk token akses dan 10080 minit untuk token muat semula.
Hidupkan Jana rahsia klien. ChatGPT memerlukan klien OAuth sulit untuk proses ini.
Cipta sambungan.
Salin kelayakan daripada Databricks
Dalam dialog Sambungan dicipta, salin ID Klien.
Salin Rahsia klien dengan segera dan simpan dengan selamat.
Jika anda menutup dialog sebelum menyalin rahsia, cipta atau ganti kelayakan aplikasi OAuth dan gunakan rahsia baharu.
Databricks hanya memaparkan rahsia sekali. Lindunginya seperti kelayakan akses dan jangan sertakannya dalam tangkapan skrin, tiket, komen atau sembang.
Selesaikan persediaan OAuth tersuai dalam ChatGPT
Kembali ke dialog Sambungkan Databricks Genie.
Masukkan ID klien Databricks dalam ID klien OAuth.
Masukkan rahsia klien Databricks dalam Rahsia klien OAuth.
Dalam Skop (pilihan), masukkan skop yang diperlukan untuk titik akhir Databricks dan keupayaan aplikasi anda. Padankan skop tersebut dengan skop yang didayakan pada aplikasi OAuth Databricks.
Masukkan satu skop pada setiap baris atau pisahkan skop dengan koma. Setiap skop yang disenaraikan dalam ChatGPT mesti didayakan pada aplikasi OAuth Databricks.
Masukkan Nama hos ruang kerja (wajib) tanpa https:// atau laluan URL. Isi mana-mana medan penyedia Databricks wajib yang lain yang ditunjukkan semasa proses persediaan.
Pilih Teruskan.
ChatGPT meminta hanya skop yang dimasukkan dalam Skop (pilihan). ChatGPT tidak menambahkan skop templat yang lebih luas secara automatik.
Sambungkan dan uji
Lengkapkan ujian sambungan dan semakan akses berikut untuk mana-mana kaedah OAuth.
Semak butiran penyambung, tindakan dan tetapan pengesahan.
Jika anda pentadbir ruang kerja, dayakan penyambung untuk ruang kerja dan tetapkan siapa yang boleh menggunakannya mengikut dasar ruang kerja.
Mulakan proses sambungan daripada ChatGPT sebagai pengguna ujian yang dibenarkan, kemudian log masuk ke Databricks.
Pastikan pelayar membuka akaun atau ruang kerja Databricks yang sepatutnya.
Semak skop yang diminta, kemudian pilih Benarkan.
Pastikan pelayar kembali ke ChatGPT dan penyambung dipaparkan sebagai telah disambungkan.
Jalankan tindakan baca berisiko rendah terlebih dahulu, seperti mendapatkan maklumat pengguna semasa atau membuat pertanyaan pada sumber Databricks SQL yang diluluskan.
Jika tindakan tulis didayakan, uji dengan aliran kerja Databricks yang jelas berisiko rendah sebelum pelaksanaan yang lebih meluas.
Untuk persediaan ruang kerja, minta ahli ruang kerja bukan pentadbir yang dibenarkan untuk menyambung dan mengulangi ujian berisiko rendah itu.
Urus akses
Databricks dan ChatGPT sama-sama berperanan dalam kawalan akses.
Dalam ChatGPT, pentadbir ruang kerja mengurus ketersediaan aplikasi dan cara ahli boleh menggunakannya. Dalam Business, pentadbir mengurus sama ada aplikasi didayakan di seluruh ruang kerja. Semak kawalan pentadbir aplikasi Databricks (Tetapan ruang kerja > Aplikasi) untuk:
Akses pengguna, untuk menetapkan peranan ruang kerja yang boleh menggunakan penyambung dalam ruang kerja Enterprise dan Edu yang disokong.
Kawalan tindakan, untuk menetapkan tindakan Databricks yang didayakan.
Kebenaran aplikasi, untuk menetapkan bila ChatGPT perlu meminta kebenaran ahli sebelum menggunakan penyambung.
Kebenaran aplikasi ini terpakai pada perbualan ChatGPT. Ejen Ruang Kerja menggunakan kawalan khusus bagi setiap ejen yang ditetapkan oleh pembinanya untuk menentukan tindakan aplikasi yang tersedia dan bila pengguna akhir diminta untuk meluluskannya. Untuk tingkah laku ejen, lihat: Ejen Ruang Kerja ChatGPT untuk Enterprise dan Business.
Dalam Databricks, pentadbir mengurus pengguna yang boleh membenarkan aplikasi OAuth dan sumber Databricks yang boleh diakses oleh pengguna tersebut. Kebenaran penyedia masih terpakai selepas aplikasi didayakan dalam ChatGPT.
Untuk kawalan aplikasi khusus mengikut pelan, lihat Kawalan pentadbir, keselamatan dan pematuhan dalam aplikasi.
Penyelesaian masalah persediaan penyambung Databricks
URI ubah hala tidak sepadan: Jika anda menggunakan klien OAuth tersuai, pastikan nilai URL Ubah Hala Databricks sama tepat dengan URL Panggil Balik yang ditunjukkan dalam ChatGPT, termasuk laluan dan ID panggil baliknya. Jangan buang ID panggil balik, tambah garis miring di hujung URL atau gantikannya dengan URL ubah hala ChatGPT yang lain.
Rahsia tiada: Jika anda menggunakan klien OAuth tersuai, rahsia Databricks hanya dipaparkan sekali. Jana rahsia klien baharu jika rahsia sebelumnya tidak disalin.
Aplikasi OAuth tidak tersedia serta-merta: Menurut Databricks, kemas kini aplikasi OAuth boleh mengambil masa sehingga 30 minit untuk diproses.
Skop tidak mencukupi atau tidak sepadan: Jika anda menggunakan klien OAuth tersuai, bandingkan Skop (pilihan) dalam ChatGPT dengan Skop akses pada aplikasi OAuth Databricks. Setiap skop yang diminta oleh ChatGPT mesti didayakan di situ. Pastikan skop menyokong titik akhir dan keupayaan yang anda gunakan, termasuk akses API umum atau akses SQL sahaja, mengikut keperluan.
Tindakan SQL gagal: Semak skop SQL, konfigurasi gudang dan kebenaran Databricks.
Ruang kerja ChatGPT yang salah: Cipta dan dayakan penyambung dalam ruang kerja ChatGPT yang sama tempat pengguna akan menyambungkannya.
Akaun atau ruang kerja Databricks yang salah: Semak nilai Nama hos ruang kerja (wajib), kemudian ulangi proses log masuk dan pastikan Databricks membuka akaun atau ruang kerja yang sepatutnya.
Pengguna tidak dapat menyambung: Pastikan pengguna mempunyai akses Databricks dan dibenarkan untuk memberikan kebenaran kepada aplikasi OAuth. Dalam Business, pastikan aplikasi didayakan di seluruh ruang kerja. Dalam ruang kerja Enterprise dan Edu yang disokong, pastikan juga tetapan Akses pengguna ChatGPT membenarkan penggunaan penyambung.
Dasar rangkaian Databricks menyekat penyambung: Jika Databricks hanya membenarkan IP sumber tertentu, pentadbir Databricks mesti mengemas kini senarai akses IP akaun atau ruang kerja yang berkaitan, kawalan trafik masuk berasaskan konteks, tembok api atau peraturan rangkaian lain yang dikawal oleh pelanggan.
Benarkan sambungan masuk daripada julat IP trafik keluar penyambung ChatGPT yang terkini.
Konfigurasikan senarai IP yang dibenarkan ini dalam Databricks atau pada lapisan rangkaian yang dikawal oleh pelanggan. Senarai ini berasingan daripada senarai IP yang dibenarkan untuk ruang kerja ChatGPT.
Julat yang diterbitkan boleh berubah. Automasikan kemas kini daripada JSON jika boleh.
Jangan ganti rahsia klien atau ubah skop OAuth untuk mengatasi sekatan rangkaian. Pastikan dahulu sama ada Databricks menolak IP sumber penyambung.