Gunakan panduan ini jika anda pentadbir ruang kerja ChatGPT atau pengguna ChatGPT Plus atau Pro yang menyediakan penyambung Databricks Genie menggunakan klien OAuth Databricks organisasi anda.
Untuk Databricks, kebanyakan persediaan dilakukan dalam Konsol Akaun Databricks. Anda membuat sambungan aplikasi OAuth tersuai, mendaftarkan URL panggil balik ChatGPT, menyalin kelayakan klien yang dijana, kemudian memasukkan nilai tersebut dalam aliran persediaan penyambung ChatGPT.
Perkara yang anda sediakan
Anda sedang membuat sambungan aplikasi Databricks untuk akaun atau ruang kerja ChatGPT anda. Sambungan ini menggunakan:
Sambungan aplikasi OAuth Databricks yang dibuat dalam Konsol Akaun Databricks anda.
ID klien dan rahsia klien OAuth Databricks.
URL panggil balik tepat yang disalin daripada ChatGPT.
Skop Databricks yang sepadan dengan keupayaan penyambung yang ingin anda dayakan.
Sebarang butiran penyedia Databricks yang diminta oleh aliran 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.
Akses pentadbir akaun Databricks. Akses pentadbir ruang kerja mungkin memadai untuk sesetengah tugas, tetapi sambungan aplikasi tersuai dikonfigurasikan melalui Konsol Akaun Databricks.
Konsol Akaun Databricks dibuka dalam tab berasingan.
Skrin sambungan Databricks Genie dibuka dalam ChatGPT supaya anda boleh menyalin URL panggil balik yang tepat.
Keputusan sama ada aplikasi memerlukan akses umum kepada API Databricks atau hanya akses Databricks SQL.
Tempat yang selamat untuk mengendalikan rahsia klien Databricks.
Jika akaun atau ruang kerja Databricks anda mengehadkan akses melalui senarai akses IP, kawalan kemasukan berasaskan konteks, tembok api atau dasar rangkaian lain, dapatkan bantuan pentadbir Databricks yang boleh membenarkan julat IP egress penyambung ChatGPT semasa.
Nota: anda mesti menyalin URL panggil balik tepat yang ditunjukkan dalam ChatGPT.
Nilai yang perlu disediakan
URL panggil balik: salin URL ini daripada aliran persediaan penyambung ChatGPT.
ID klien OAuth Databricks.
Rahsia klien OAuth Databricks.
Skop akses Databricks, seperti SEMUA API atau SQL.
Medan ruang kerja atau akaun Databricks yang diminta oleh aliran persediaan ChatGPT.
Mulakan persediaan aplikasi dalam ChatGPT
Dalam ChatGPT, beralih kepada akaun atau ruang kerja tempat aplikasi itu perlu tersedia.
Sebagai pentadbir atau pemilik ruang kerja, pergi ke Tetapan ruang kerja > Pemalam.
Pilih Databricks Genie dalam Direktori.
Pilih Tambah Sambungan Aplikasi.
Dalam dialog Sambungkan Databricks Genie, cari bahagian klien OAuth.
URL panggil balik daripada ChatGPT. Biarkan dialog ini terbuka.
Contoh URL panggil balik:
https://chatgpt.com/connector/oauth/<callback_id>
Jangan alih keluar ID panggil balik, tambahkan garis miring di hujung atau gantikannya dengan URL ChatGPT umum. URL yang didaftarkan dalam Databricks mesti betul-betul sepadan dengan URL panggil balik yang ditunjukkan dalam ChatGPT.
Buat sambungan aplikasi OAuth 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 Databricks ChatGPT.
Dalam URL ubah hala, tampal URL panggil balik tepat yang disalin 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 sahaja untuk aplikasi yang dihadkan kepada API Databricks SQL.
Pastikan setiap skop yang kemudiannya disenaraikan dalam ChatGPT didayakan pada aplikasi OAuth Databricks ini. Databricks membenarkan openid, email, profile dan offline_access secara automatik untuk aplikasi yang dibuat dalam UI.
Kekalkan TTL token pada nilai lalai Databricks melainkan organisasi anda mempunyai dasar khusus: 60 minit untuk token akses dan 10080 minit untuk token segar semula.
Hidupkan Jana rahsia klien. ChatGPT memerlukan klien OAuth sulit untuk aliran ini.
Buat sambungan.
Salin kelayakan daripada Databricks
Dalam dialog Sambungan dibuat, salin ID klien.
Salin Rahsia klien dengan segera dan simpan dengan selamat.
Jika anda menutup dialog sebelum menyalin rahsia, buat atau putarkan kelayakan aplikasi OAuth dan gunakan rahsia baharu.
Databricks hanya menunjukkan rahsia sekali. Kendalikan rahsia itu seperti kelayakan dan jangan sertakannya dalam tangkap layar, tiket, komen atau sembang.
Selesaikan persediaan 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), kekalkan all-apis dan offline_access untuk akses API umum.
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 (diperlukan) tanpa https:// atau laluan URL. Isi sebarang medan penyedia Databricks lain yang diperlukan dan ditunjukkan dalam aliran persediaan.
Pilih Teruskan.
ChatGPT hanya meminta skop yang dimasukkan dalam Skop (pilihan). ChatGPT tidak menambahkan skop templat yang lebih luas secara automatik.
Sambungkan dan uji
Semak butiran penyambung, tindakan dan tetapan pengesahan.
Jika anda pentadbir ruang kerja, dayakan penyambung untuk ruang kerja dan tetapkan pengguna yang boleh menggunakannya mengikut dasar ruang kerja.
Mulakan aliran sambungan daripada ChatGPT sebagai pengguna ujian yang dibenarkan, kemudian log masuk ke Databricks.
Sahkan bahawa pelayar membuka akaun atau ruang kerja Databricks yang dijangkakan.
Semak skop yang diminta, kemudian pilih Benarkan.
Pastikan pelayar kembali ke ChatGPT dan penyambung ditunjukkan sebagai tersambung.
Jalankan tindakan baca berisiko rendah terlebih dahulu, seperti mendapatkan maklumat pengguna semasa atau membuat pertanyaan terhadap 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 kedua-duanya menyumbang kepada kawalan akses.
Dalam ChatGPT, pentadbir ruang kerja mengurus ketersediaan aplikasi dan cara ahli boleh menggunakannya. Semak kawalan pentadbir aplikasi Databricks (Tetapan ruang kerja > Aplikasi) untuk:
Akses pengguna, untuk menetapkan peranan ruang kerja yang boleh menggunakan penyambung.
Kawalan tindakan, untuk menetapkan tindakan Databricks yang didayakan.
Kebenaran aplikasi, untuk menetapkan masa ChatGPT meminta izin ahli sebelum menggunakan penyambung.
Kebenaran aplikasi ini digunakan pada perbualan ChatGPT. Ejen Ruang Kerja menggunakan kawalan bagi setiap ejen yang ditetapkan oleh pembina ejen untuk menentukan tindakan aplikasi yang tersedia dan masa pengguna akhir diminta meluluskannya. Untuk tingkah laku ejen, lihat: Ejen Ruang Kerja ChatGPT untuk Enterprise dan Business.
Dalam Databricks, pentadbir mengurus pengguna yang boleh membenarkan aplikasi OAuth serta sumber Databricks yang boleh diakses oleh pengguna tersebut. Kebenaran penyedia masih terpakai selepas aplikasi didayakan dalam ChatGPT.
Menyelesaikan masalah persediaan penyambung Databricks
URI ubah hala tidak sepadan: Sahkan bahawa nilai URL ubah hala Databricks betul-betul sepadan dengan URL panggil balik yang ditunjukkan dalam ChatGPT, termasuk laluan dan ID panggil baliknya. Jangan alih keluar ID panggil balik, tambahkan garis miring di hujung atau gantikannya dengan URL ubah hala ChatGPT yang lain.
Rahsia tiada: Rahsia Databricks hanya ditunjukkan sekali. Jana rahsia klien baharu jika rahsia itu tidak disalin.
Aplikasi OAuth tidak tersedia serta-merta: Menurut Databricks, pemprosesan kemas kini aplikasi OAuth boleh mengambil masa sehingga 30 minit.
Skop tidak mencukupi atau tidak sepadan: Bandingkan Skop (pilihan) dalam ChatGPT dengan Skop akses pada aplikasi OAuth Databricks. Setiap skop yang diminta oleh ChatGPT mesti didayakan di situ. Untuk API bukan SQL, sahkan bahawa all-apis didayakan dalam Databricks dan kekal dalam senarai skop ChatGPT.
Tindakan SQL gagal: Sahkan skop SQL, konfigurasi gudang dan kebenaran Databricks.
Ruang kerja ChatGPT yang salah: Buat dan dayakan penyambung dalam ruang kerja ChatGPT yang sama tempat pengguna akan menyambungkannya.
Akaun atau ruang kerja Databricks yang salah: Sahkan nilai Nama hos ruang kerja (diperlukan), kemudian ulangi aliran log masuk dan pastikan Databricks membuka akaun atau ruang kerja yang dijangkakan.
Pengguna tidak dapat menyambung: Sahkan bahawa pengguna mempunyai akses Databricks dan dibenarkan untuk membenarkan aplikasi OAuth. Sahkan juga bahawa Akses pengguna ChatGPT pengguna tersebut membenarkan 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 kemasukan berasaskan konteks, tembok api atau peraturan rangkaian lain yang dikawal pelanggan.
Benarkan sambungan masuk daripada julat IP egress penyambung ChatGPT semasa.
Konfigurasikan penyenaraian dibenarkan ini dalam Databricks atau lapisan rangkaian yang dikawal pelanggan. Ini berasingan daripada penyenaraian IP dibenarkan bagi ruang kerja ChatGPT.
Julat yang diterbitkan boleh berubah. Automatikkan kemas kini daripada JSON jika boleh.
Jangan putarkan rahsia klien atau ubah skop OAuth untuk memintas sekatan rangkaian. Mula-mula, sahkan sama ada Databricks menolak IP sumber penyambung.