Gunakan panduan ini jika anda pentadbir ruang kerja ChatGPT atau pengguna ChatGPT Plus atau Pro yang menyediakan aplikasi Databricks Genie menggunakan OAuth terbina dalam atau klien OAuth organisasi anda.
OAuth terbina dalam: Jika tersedia dalam ChatGPT dan didayakan untuk ruang kerja Databricks anda, gunakan sambungan yang telah diprakonfigurasi. 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 sedang 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 anda rancang untuk 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 tepat yang disalin daripada ChatGPT.
Skop Databricks yang sepadan dengan keupayaan aplikasi 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
Untuk persediaan ruang kerja, buka konsol pentadbir, pilih ruang kerja ChatGPT yang dikehendaki dan buka Pemalam. Pilih Urus Aplikasi Legasi untuk membuka halaman Aplikasi yang masih dikekalkan. Untuk navigasi ruang kerja dan akses aplikasi legasi, lihat Kawalan pentadbir, keselamatan dan pematuhan untuk pemalam dan aplikasi.
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 dikonfigurasikan melalui Konsol Akaun Databricks. Untuk OAuth terbina dalam, pentadbir Databricks mesti memastikan 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 boleh menyalin URL panggil balik yang tepat.
Keputusan tentang keupayaan yang diperlukan oleh aplikasi: Genie dan papan pemuka AI/BI, akses API Databricks yang lebih luas atau aplikasi yang terhad kepada API SQL Databricks. Akses SQL sahaja tidak mencukupi untuk tindakan Genie atau papan pemuka.
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 keluar aplikasi ChatGPT semasa.
Untuk klien OAuth tersuai, salin URL panggil balik tepat seperti yang ditunjukkan dalam ChatGPT.
Nilai yang perlu disediakan
Untuk klien OAuth tersuai, URL panggil balik: salin nilai ini daripada proses persediaan aplikasi 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. Untuk sambungan Genie/papan pemuka baharu yang memaparkan
ai-gateway,dashboardsdanoffline_access, sediakan skop tersebut. SEMUA API (all-apisdenganoffline_access) kekal sebagai alternatif terdahulu yang lebih luas. Gunakan SQL hanya untuk aplikasi yang terhad kepada API SQL Databricks.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 apl 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, beralih ke akaun atau ruang kerja yang sepatutnya menyediakan apl tersebut. Pergi ke Tetapan > Pemalam untuk persediaan peribadi, atau ke Konsol pentadbir > Pemalam sebagai pentadbir atau pemilik ruang kerja untuk persediaan ruang kerja.
Pilih Databricks Genie, kemudian pilih Tambah Sambungan Apl.
Masukkan Nama hos ruang kerja (wajib) tanpa
https://atau laluan URL.ChatGPT menggunakan nama hos ini untuk membentuk titik akhir Genie MCP setempat ruang kerja,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Tiada titik akhir MCP serantau yang berasingan diperlukan.Pilih Teruskan, kemudian log masuk ke Databricks dan semak permintaan persetujuan.
Teruskan dengan 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, beralih ke akaun atau ruang kerja yang sepatutnya menyediakan apl tersebut.
Pergi ke Tetapan > Pemalam untuk persediaan peribadi, atau ke Konsol pentadbir > Pemalam sebagai pentadbir atau pemilik ruang kerja untuk persediaan ruang kerja.
Pilih Databricks Genie dalam Direktori.
Pilih Tambah Sambungan Apl.
Dalam dialog Sambungkan Databricks Genie, cari medan ID klien OAuth dan Rahsia klien OAuth. Untuk menggunakan aliran klien tersuai, masukkan bukti kelayakan dalam medan yang dipaparkan ini; tiada pemilih berasingan diperlukan.
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, tambahkan garis miring di hujung, atau gantikan URL itu dengan URL ChatGPT umum. URL yang didaftarkan dalam Databricks mesti sepadan tepat dengan URL Panggil Balik yang dipaparkan 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 ChatGPT Databricks.
Dalam URL ubah hala, tampalkan URL panggil balik tepat yang disalin daripada ChatGPT.
Di bawah Skop akses, pilih skop yang diperlukan oleh aplikasi.
Untuk sambungan Genie/papan pemuka baharu yang memaparkan
ai-gateway,dashboardsdanoffline_accessdalam ChatGPT, benarkan skop yang sama pada aplikasi OAuth Databricks.SEMUA API kekal sebagai alternatif terdahulu yang lebih luas untuk akses API Databricks umum. Untuk konfigurasi ini, gunakan
all-apisdanoffline_accessdalam ChatGPT dan pastikan aplikasi OAuth Databricks membenarkan kedua-duanya. Utamakan skop terperinci yang dipaparkan untuk sambungan Genie/papan pemuka baharu.Gunakan SQL hanya untuk aplikasi yang terhad kepada API SQL Databricks. Akses SQL sahaja tidak mencukupi untuk tindakan Genie atau papan pemuka.
Pastikan setiap skop yang disenaraikan dalam ChatGPT nanti didayakan pada aplikasi OAuth Databricks ini. Databricks membenarkan openid, email, profile dan offline_access secara automatik 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 penyegaran.
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 tersebut, cipta atau gantikan kelayakan aplikasi OAuth dan gunakan rahsia baharu.
Databricks hanya menunjukkan rahsia tersebut 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.
Dengan memasukkan bukti kelayakan ini, klien OAuth tersuai anda akan digunakan; tiada pemilih berasingan diperlukan.
Dalam Skop (pilihan), masukkan skop yang diperlukan untuk titik akhir Databricks dan keupayaan apl anda. Padankan skop tersebut dengan skop yang didayakan pada apl OAuth Databricks.
Untuk sambungan Genie/papan pemuka baharu yang memaparkan
ai-gateway,dashboardsdanoffline_access, kekalkan skop tersebut. Pastikan apl OAuth Databricks membenarkan skop yang sama.ai-gatewaymendayakan sambungan Genie MCP setempat ruang kerja,dashboardsmendayakan tindakan papan pemuka AI/BI, danoffline_accessmendayakan token penyegaran.Alternatif terdahulu yang lebih luas, iaitu
all-apisdanoffline_access, masih disokong untuk akses API yang lebih luas, tetapi tidak diutamakan untuk sambungan Genie/papan pemuka ini. Jika apl Databricks hanya membenarkanall-apis, kemas kini atau cipta semula apl itu supaya membenarkanai-gateway,dashboardsdanoffline_access. Jika skop terperinci tidak tersedia, tetapkan sendiri ChatGPT kepadaall-apisdanoffline_accessserta pastikan apl Databricks membenarkan kedua-duanya. Jangan minta ketiga-tiga skop terperinci dalam ChatGPT jika apl Databricks hanya membenarkanall-apis.Masukkan satu skop pada setiap baris atau pisahkan skop dengan koma. Setiap skop yang disenaraikan dalam ChatGPT mesti didayakan pada apl OAuth Databricks.
Masukkan Nama hos ruang kerja (wajib) tanpa https:// atau laluan URL. Isi mana-mana medan penyedia Databricks lain yang diwajibkan dalam aliran persediaan.
ChatGPT menggunakan nama hos ini untuk membentuk titik akhir Genie MCP setempat ruang kerja,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Tiada titik akhir MCP serantau yang berasingan diperlukan.Pilih Teruskan.
ChatGPT hanya meminta skop yang dimasukkan dalam Skop (pilihan). ChatGPT tidak menambahkan skop templat yang lebih luas secara automatik.
Sambung dan uji
Lengkapkan ujian sambungan dan semakan akses berikut untuk mana-mana kaedah OAuth.
Semak butiran aplikasi, tindakan dan tetapan pengesahan.
Jika anda pentadbir ruang kerja, dayakan aplikasi 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 Berikan keizinan.
Pastikan pelayar kembali ke ChatGPT dan aplikasi ditunjukkan sebagai telah disambungkan.
Jalankan tindakan baca berisiko rendah yang sepadan dengan keupayaan sambungan. Untuk sambungan Genie, hantar permintaan Genie tentang data yang dibenarkan untuk diakses oleh pengguna ujian. Untuk keupayaan lain yang disokong, dapatkan maklumat pengguna semasa atau jalankan pertanyaan pada sumber SQL Databricks yang diluluskan. Pastikan pengguna mempunyai kebenaran sumber Databricks yang diperlukan; skop OAuth sahaja tidak memberikan akses kepada data.
Jika tindakan tulis didayakan, uji menggunakan aliran kerja Databricks yang jelas berisiko rendah sebelum meluaskan penggunaannya.
Untuk persediaan ruang kerja, minta ahli ruang kerja bukan pentadbir yang dibenarkan untuk menyambung dan mengulangi ujian berisiko rendah.
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 atau Konsol Pentadbir > Pemalam > Urus Aplikasi Legasi) untuk:
Akses pengguna, untuk menetapkan peranan ruang kerja yang boleh menggunakan aplikasi 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 aplikasi.
Kebenaran aplikasi ini terpakai pada perbualan ChatGPT. Ejen Ruang Kerja menggunakan kawalan bagi setiap ejen yang ditetapkan oleh pembinanya untuk menentukan tindakan aplikasi yang tersedia dan bila pengguna akhir diminta meluluskannya. Untuk tingkah laku ejen, lihat: Ejen Ruang Kerja ChatGPT untuk Enterprise dan Business.
Dalam Databricks, pentadbir mengurus pengguna yang boleh memberikan keizinan kepada aplikasi OAuth dan sumber Databricks yang boleh diakses oleh pengguna tersebut. Kebenaran penyedia masih terpakai selepas aplikasi didayakan dalam ChatGPT.
Untuk navigasi ruang kerja, akses aplikasi dan kawalan aplikasi khusus mengikut pelan, lihat: Kawalan pentadbir, keselamatan dan pematuhan dalam aplikasi.
Menyelesaikan masalah persediaan aplikasi Databricks
URI ubah hala tidak sepadan: Jika anda menggunakan klien OAuth tersuai, pastikan nilai URL ubah hala Databricks sepadan 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 atau gantikannya dengan URL ubah hala ChatGPT yang lain.
Rahsia tiada: Jika anda menggunakan klien OAuth tersuai, rahsia Databricks hanya ditunjukkan sekali. Jana rahsia klien baharu jika rahsia tersebut 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 tersebut menyokong titik akhir dan keupayaan yang anda gunakan.
Untuk sambungan Genie/papan pemuka baharu yang memaparkan
ai-gateway,dashboardsdanoffline_access, kekalkan skop tersebut dalam ChatGPT dan pastikan aplikasi Databricks membenarkan ketiga-tiganya. Jika aplikasi hanya membenarkanall-apis, kemas kini atau cipta semula aplikasi itu untuk membenarkan ketiga-tiga skop terperinci tersebut.Jika skop terperinci tidak tersedia, gunakan alternatif lebih luas yang disokong: tetapkan ChatGPT kepada
all-apisdanoffline_access, dan pastikan aplikasi Databricks membenarkan kedua-duanya. Aplikasi yang hanya membenarkanall-apistidak sepadan dengan permintaan ChatGPT untukai-gateway,dashboardsdanoffline_access. Akses SQL sahaja hanya sesuai untuk aplikasi yang terhad kepada API SQL Databricks; akses ini tidak mencukupi untuk tindakan Genie atau papan pemuka.Tindakan SQL gagal: Untuk aplikasi yang terhad kepada API SQL Databricks, semak skop SQL, konfigurasi gudang dan kebenaran Databricks.
Ruang kerja ChatGPT yang salah: Cipta dan dayakan aplikasi dalam ruang kerja ChatGPT yang sama dengan ruang kerja 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 memberikan keizinan kepada aplikasi OAuth. Dalam Business, pastikan aplikasi didayakan di seluruh ruang kerja. Dalam ruang kerja Enterprise dan Edu yang disokong, pastikan juga Akses pengguna ChatGPT membenarkan aplikasi tersebut.
Dasar rangkaian Databricks menyekat aplikasi: 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 keluar aplikasi ChatGPT semasa.
Konfigurasikan senarai kebenaran ini dalam Databricks atau pada lapisan rangkaian yang dikawal oleh pelanggan. Senarai ini berasingan daripada senarai kebenaran IP ruang kerja ChatGPT.
Julat yang diterbitkan boleh berubah. Automasikan kemas kini daripada JSON jika boleh.
Jangan gantikan rahsia klien atau ubah skop OAuth untuk mengatasi sekatan rangkaian. Pastikan dahulu sama ada Databricks menolak IP sumber aplikasi.