I-set up ang template ng Databricks app sa ChatGPT

Alamin kung paano maikokonekta ng mga admin ng ChatGPT workspace at mga user ng ChatGPT Plus o Pro ang Databricks gamit ang OAuth client ng kanilang organisasyon.

Gamitin ang gabay na ito kung isa kang admin ng ChatGPT workspace o user ng ChatGPT Plus o Pro na nagse-set up ng Databricks Genie app gamit ang built-in na OAuth o ang OAuth client ng iyong organisasyon.

Built-in na OAuth: Kapag available sa ChatGPT at naka-enable para sa iyong Databricks workspace, gamitin ang koneksyong naka-configure na. Hindi mo kailangang gumawa ng OAuth app o maglagay ng client ID o client secret. Sundin ang seksyong Built-in na OAuth sa ibaba.
Custom na OAuth client: Gamitin ang paraang ito kung hindi available ang built-in na OAuth o kung kailangan ng iyong organisasyon ng sarili nitong OAuth client. Sundin ang seksyong Custom na OAuth client sa ibaba.

Ang ise-set up mo

Gagawa ka ng koneksyon sa Databricks app para sa iyong ChatGPT account o workspace. Sa parehong paraan, kailangan ang mga detalye ng Databricks provider na hinihiling sa ChatGPT at mga pahintulot para sa mga resource na balak mong gamitin. Kung gumagamit ka ng custom na OAuth client, ihanda rin ang:

Koneksyon sa Databricks OAuth app na ginawa sa iyong Databricks Account Console.
Databricks OAuth client ID at client secret.
Eksaktong callback URL na kinopya mula sa ChatGPT.
Mga Databricks scope na tumutugma sa mga kakayahan ng app na gusto mong i-enable.
Anumang detalye ng Databricks provider na hinihiling sa proseso ng pag-set up sa ChatGPT, gaya ng workspace host, account host, account ID, o warehouse.

Bago ka magsimula

Para sa pag-set up ng workspace, buksan ang admin console, piliin ang nilalayong ChatGPT workspace, at buksan ang Mga plugin. Piliin ang Pamahalaan ang mga legacy app para buksan ang pinanatiling pahina ng Mga app. Para sa pag-navigate sa workspace at pag-access sa mga legacy app, tingnan ang Mga kontrol ng admin, seguridad, at pagsunod sa mga patakaran para sa mga plugin at app.

Kailangan mo ang:

Access bilang admin o may-ari ng ChatGPT workspace, o isang ChatGPT Plus o Pro account.
Para sa custom na OAuth client, access bilang admin ng Databricks account. Maaaring sapat ang access bilang admin ng workspace para sa ilang gawain, pero sa Databricks Account Console kino-configure ang mga custom na koneksyon sa app. Para sa built-in na OAuth, dapat tiyakin ng isang Databricks admin na available at naka-enable ang ChatGPT application para sa iyong workspace.
Para sa custom na OAuth client, ang Databricks Account Console na nakabukas sa hiwalay na tab.
Para sa custom na OAuth client, ang screen ng koneksyon sa Databricks Genie na nakabukas sa ChatGPT para makopya mo ang eksaktong callback URL.
Desisyon tungkol sa mga kakayahang kailangan ng app: Genie at mga AI/BI dashboard, mas malawak na access sa Databricks API, o app na limitado sa Databricks SQL APIs. Hindi sapat ang access na para lang sa SQL para sa mga aksyon sa Genie o dashboard.
Para sa custom na OAuth client, isang ligtas na lugar para pangasiwaan ang Databricks client secret.
Kung nililimitahan ng iyong Databricks account o workspace ang access sa pamamagitan ng IP access list, kontrol sa papasok na trapiko batay sa konteksto, firewall, o ibang patakaran sa network, tulong mula sa isang Databricks admin na maaaring magpahintulot sa kasalukuyang mga egress IP range ng ChatGPT app.

Para sa custom na OAuth client, kopyahin ang eksaktong Callback URL na ipinapakita sa ChatGPT.

Mga value na ihahanda

Para sa custom na OAuth client, Callback URL: kopyahin ito mula sa proseso ng pag-set up ng app sa ChatGPT.
Para sa custom na OAuth client, ang Databricks OAuth client ID.
Para sa custom na OAuth client, ang Databricks OAuth client secret.
Para sa custom na OAuth client, mga scope ng access sa Databricks na angkop sa mga kakayahan ng app. Para sa bagong koneksyon sa Genie/dashboard na nagpapakita ng ai-gateway, dashboards, at offline_access, ihanda ang mga scope na iyon. Ang LAHAT ng API (all-apis kasama ng offline_access) pa rin ang mas lumang alternatibong may mas malawak na saklaw. Gamitin lang ang SQL para sa app na limitado sa Databricks SQL APIs.
Mga field ng Databricks workspace o account na hinihiling sa proseso ng pag-set up sa ChatGPT.

Built-in na OAuth

Kumpletuhin muna ang mga paunang kinakailangan sa itaas. Gamitin lang ang paraang ito kapag available ang built-in na OAuth sa ChatGPT at naka-enable ito para sa iyong Databricks workspace.

Hilingin sa isang Databricks admin na tingnan kung available ang ChatGPT application sa mga setting ng integration ng app sa Account Console at kung naka-enable ito para sa iyong workspace. Kung hindi nakalista ang ChatGPT application sa iyong Databricks Account Console, makipag-ugnayan sa iyong Databricks account representative para itanong kung available ang feature para sa iyong account.
Sa ChatGPT, lumipat sa account o workspace kung saan dapat maging available ang app. Pumunta sa Mga Setting > Mga Plugin para sa personal na pag-set up, o sa Admin console > Mga Plugin bilang admin o may-ari ng workspace para sa pag-set up ng workspace.
Piliin ang Databricks Genie, pagkatapos ay piliin ang Magdagdag ng Koneksyon ng App.
Ilagay ang Hostname ng workspace (kinakailangan) nang walang https:// o URL path.
Mula sa hostname na ito, binubuo ng ChatGPT ang Genie MCP endpoint na lokal sa workspace: https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Hindi kailangan ng hiwalay na panrehiyong MCP endpoint.
Piliin ang Magpatuloy, pagkatapos ay mag-sign in sa Databricks at suriin ang kahilingan para sa pahintulot.

Magpatuloy sa mga seksyong Kumonekta at subukan at Pamahalaan ang access sa ibaba, kasama ang mga pagsubok para sa mga pinapayagang miyembro at mga pagsusuri ng access sa workspace.

Custom na OAuth client

Kumpletuhin muna ang mga paunang kinakailangan sa itaas. Gamitin ang paraang ito kung hindi available ang naka-built-in na OAuth o kung nangangailangan ang iyong organisasyon ng sarili nitong OAuth client. Pagkatapos ng pag-set up, kumpletuhin ang mga seksyong Kumonekta at subukan at Pamahalaan ang access sa ibaba.

Simulan ang pag-set up ng custom OAuth sa ChatGPT

Sa ChatGPT, lumipat sa account o workspace kung saan dapat maging available ang app.
Pumunta sa Mga Setting > Mga Plugin para sa personal na pag-set up, o sa Admin console > Mga Plugin bilang admin o may-ari ng workspace para sa pag-set up ng workspace.
Piliin ang Databricks Genie sa Direktoryo.
Piliin ang Magdagdag ng Koneksyon ng App.
Sa dialog na Ikonekta ang Databricks Genie, hanapin ang mga field na OAuth client ID at OAuth client secret. Ang paglalagay ng mga credential sa mga nakikitang field na ito ang proseso para sa custom client; hindi na kailangan ng hiwalay na pagpipilian.
Kopyahin ang Callback URL mula sa ChatGPT. Panatilihing nakabukas ang dialog na ito.

ChatGPT Connect Databricks Genie dialog showing the callback URL field and OAuth client settings.

Halimbawa ng callback URL:

https://chatgpt.com/connector/oauth/<callback_id>

Huwag alisin ang callback ID, magdagdag ng slash sa dulo, o palitan ito ng pangkalahatang ChatGPT URL. Dapat eksaktong tumugma ang URL na nakarehistro sa Databricks sa Callback URL na ipinapakita sa ChatGPT.

Gumawa ng custom na koneksyon sa OAuth app sa Databricks

Buksan ang Databricks Account Console para sa iyong Databricks account.
Sa kaliwang sidebar, buksan ang Mga setting.
Buksan ang tab na Mga koneksyon sa app.
Piliin ang Magdagdag ng koneksyon.
Maglagay ng pangalan ng application, gaya ng ChatGPT Databricks.
Sa Mga redirect URL, i-paste ang eksaktong callback URL na kinopya mula sa ChatGPT.
Sa ilalim ng Mga scope ng access, piliin ang mga scope na kailangan ng app.
Para sa bagong koneksyon sa Genie/dashboard na nagpapakita ng ai-gateway, dashboards, at offline_access sa ChatGPT, payagan ang mga scope ring iyon sa Databricks OAuth app.
Ang LAHAT ng API pa rin ang mas lumang alternatibong may mas malawak na saklaw para sa pangkalahatang access sa Databricks API. Para sa configuration na ito, gamitin ang all-apis at offline_access sa ChatGPT at tiyaking pinapayagan ng Databricks OAuth app ang pareho. Mas piliin ang mga ipinapakitang mas partikular na scope para sa bagong koneksyon sa Genie/dashboard.
Gamitin lang ang SQL para sa app na limitado sa Databricks SQL APIs. Hindi sapat ang access na para lang sa SQL para sa mga aksyon sa Genie o dashboard.
Tiyaking naka-enable sa Databricks OAuth app na ito ang bawat scope na ililista sa ChatGPT sa mga susunod na hakbang. Awtomatikong pinapayagan ng Databricks ang openid, email, profile, at offline_access para sa mga app na ginawa sa UI.
Panatilihin ang mga default ng Databricks para sa mga TTL ng token maliban kung may partikular na patakaran ang iyong organisasyon: 60 minuto para sa access token at 10080 minuto para sa refresh token.
I-on ang Gumawa ng client secret. Kailangan ng ChatGPT ng confidential na OAuth client para sa prosesong ito.
Gawin ang koneksyon.

Databricks OAuth connection settings showing redacted client ID and redirect URL, access scopes, and the client-secret option.

Kopyahin ang mga credential mula sa Databricks

Sa dialog na Nagawa na ang koneksyon, kopyahin ang Client ID.
Kopyahin agad ang Client secret at itago ito nang ligtas.
Kung maisara mo ang dialog bago makopya ang secret, gumawa o magpalit ng mga credential ng OAuth app at gamitin ang bagong secret.

Isang beses lang ipinapakita ng Databricks ang secret. Pangalagaan ito tulad ng isang credential at huwag itong isama sa mga screenshot, ticket, komento, o chat.

Tapusin ang pag-set up ng custom OAuth sa ChatGPT

Bumalik sa dialog na Ikonekta ang Databricks Genie.
Ilagay ang Databricks client ID sa OAuth client ID.
Ilagay ang Databricks client secret sa OAuth client secret.
Kapag inilagay ang mga credential na ito, gagamitin ang iyong custom OAuth client; hindi na kailangan ng hiwalay na pagpipilian.
Sa Mga scope (opsyonal), ilagay ang mga scope na kailangan para sa Databricks endpoint at mga kakayahan ng iyong app. Itugma ang mga ito sa mga scope na naka-enable sa Databricks OAuth app.
Para sa bagong koneksyon ng Genie/dashboard na nagpapakita ng ai-gateway, dashboards, at offline_access, panatilihin ang mga scope na iyon. Tiyaking pinapayagan ng Databricks OAuth app ang parehong mga scope. Pinapagana ng ai-gateway ang koneksyon ng Genie MCP na lokal sa workspace, pinapagana ng dashboards ang mga aksyon sa AI/BI dashboard, at pinapagana ng offline_access ang mga refresh token.
Sinusuportahan pa rin ang mas lumang alternatibong may mas malawak na saklaw, ang all-apis at offline_access, para sa mas malawak na access sa API, pero hindi ito ang mas mainam para sa koneksyong ito ng Genie/dashboard. Kung all-apis lang ang pinapayagan ng Databricks app, i-update o gawin itong muli para payagan ang ai-gateway, dashboards, at offline_access. Kung hindi available ang mga scope na may mas tiyak na saklaw, manu-manong itakda ang ChatGPT sa all-apis at offline_access at tiyaking pinapayagan ng Databricks app ang dalawa. Huwag hilingin sa ChatGPT ang tatlong scope na may mas tiyak na saklaw kung all-apis lang ang pinapayagan ng Databricks app.
Maglagay ng isang scope bawat linya o paghiwalayin ang mga scope gamit ang mga kuwit. Dapat naka-enable sa Databricks OAuth app ang bawat scope na nakalista sa ChatGPT.
Ilagay ang Hostname ng workspace (kinakailangan) nang walang https:// o URL path. Punan ang iba pang kinakailangang field para sa Databricks provider na ipinapakita sa proseso ng pag-set up.
Mula sa hostname na ito, binubuo ng ChatGPT ang Genie MCP endpoint na lokal sa workspace: https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Hindi kailangan ng hiwalay na panrehiyong MCP endpoint.
Piliin ang Magpatuloy.

Ang mismong mga scope na inilagay sa Mga scope (opsyonal) lang ang hinihiling ng ChatGPT. Hindi ito awtomatikong nagdaragdag ng mga scope mula sa template na may mas malawak na saklaw.

ChatGPT Connect Databricks Genie dialog showing a mock workspace hostname, mock client ID, masked secret, and scopes.

Kumonekta at sumubok

Kumpletuhin ang mga sumusunod na pagsusuri sa koneksyon at access para sa alinmang paraan ng OAuth.

Suriin ang mga detalye ng app, mga aksyon, at mga setting ng authentication.
Kung isa kang admin ng workspace, i-enable ang app para sa workspace at i-configure kung sino ang maaaring gumamit nito alinsunod sa patakaran ng workspace.
Simulan ang proseso ng pagkonekta mula sa ChatGPT bilang isang pinapayagang test user, pagkatapos ay mag-sign in sa Databricks.
Tiyaking binubuksan ng browser ang inaasahang Databricks account o workspace.
Suriin ang mga hinihiling na scope, pagkatapos ay piliin ang Pahintulutan.
Tiyaking bumabalik ang browser sa ChatGPT at ipinapakitang nakakonekta ang app.
Magpatakbo ng aksyong nagbabasa ng data na mababa ang panganib at tumutugma sa mga kakayahan ng koneksyon. Para sa koneksyon sa Genie, magpadala ng kahilingan sa Genie tungkol sa data na pinapayagang i-access ng test user. Para sa iba pang sinusuportahang kakayahan, kunin ang impormasyon ng kasalukuyang user o mag-query sa isang aprubadong Databricks SQL resource. Tiyaking mayroon ang user ng mga kinakailangang pahintulot sa Databricks resource; hindi sapat ang mga OAuth scope lamang para magkaroon ng access sa data.
Kung naka-enable ang mga aksyong nagsusulat ng data, sumubok gamit ang isang Databricks workflow na malinaw na mababa ang panganib bago ang mas malawak na paglulunsad.
Para sa pag-set up ng workspace, hilingin sa isang pinapayagang miyembro ng workspace na hindi admin na kumonekta at ulitin ang pagsubok na mababa ang panganib.

Pamahalaan ang access

Parehong may papel ang Databricks at ChatGPT sa pagkontrol ng access.

Sa ChatGPT, pinamamahalaan ng mga admin ng workspace kung available ang app at kung paano ito magagamit ng mga miyembro. Sa Business, pinamamahalaan ng mga admin kung naka-enable ang app sa buong workspace. Suriin ang mga kontrol ng admin para sa mga Databricks app (Mga setting ng workspace > Mga app o Admin Console > Mga plugin > Pamahalaan ang mga legacy app) para sa:

Access ng user, para i-configure kung aling mga tungkulin sa workspace ang maaaring gumamit ng app sa mga sinusuportahang Enterprise at Edu workspace.
Kontrol sa aksyon, para i-configure kung aling mga aksyon sa Databricks ang naka-enable.
Mga pahintulot ng app, para i-configure kung kailan hihingi ng pahintulot ang ChatGPT sa mga miyembro bago gamitin ang app.

Nalalapat ang mga pahintulot na ito ng app sa mga pag-uusap sa ChatGPT. Gumagamit ang mga agent ng workspace ng mga kontrol na itinakda ng gumawa ng bawat agent para tukuyin kung aling mga aksyon ng app ang available at kung kailan hihingin ang pag-apruba ng mga end user. Para sa pagkilos ng agent, tingnan ang: Mga agent ng ChatGPT workspace para sa Enterprise at Business.

Sa Databricks, pinamamahalaan ng mga admin kung aling mga user ang maaaring magbigay ng awtorisasyon sa OAuth app at kung aling mga Databricks resource ang maaari nilang i-access. Nalalapat pa rin ang mga pahintulot ng provider pagkatapos ma-enable ang app sa ChatGPT.

Para sa pag-navigate sa workspace, pag-access sa app, at mga kontrol ng app na partikular sa plan, tingnan ang: Mga kontrol ng admin, seguridad, at pagsunod sa mga patakaran sa mga app.

Pag-troubleshoot sa pag-set up ng Databricks app

Hindi tugmang redirect URI: Kung gumagamit ka ng custom na OAuth client, tiyaking eksaktong tumutugma ang value ng Mga redirect URL sa Databricks sa Callback URL na ipinapakita sa ChatGPT, kasama ang path at callback ID nito. Huwag alisin ang callback ID, magdagdag ng slash sa dulo, o gumamit ng ibang ChatGPT redirect URL bilang kapalit.
Nawawalang secret: Kung gumagamit ka ng custom na OAuth client, isang beses lang ipinapakita ang mga secret ng Databricks. Gumawa ng bagong client secret kung hindi ito nakopya.
Hindi agad available ang OAuth app: Ayon sa Databricks, maaaring abutin nang hanggang 30 minuto ang pagproseso ng mga update sa OAuth application.
Kulang o hindi tugmang scope: Kung gumagamit ka ng custom na OAuth client, ihambing ang Mga scope (opsyonal) sa ChatGPT sa Mga scope ng access sa Databricks OAuth app. Dapat naka-enable roon ang bawat scope na hinihiling ng ChatGPT. Tiyaking sinusuportahan ng mga scope ang endpoint at mga kakayahang ginagamit mo.
Para sa bagong koneksyon sa Genie/dashboard na nagpapakita ng ai-gateway, dashboards, at offline_access, panatilihin ang mga scope na iyon sa ChatGPT at tiyaking pinapayagan ng Databricks app ang tatlo. Kung all-apis lang ang pinapayagan ng app, i-update o gawin itong muli para payagan ang tatlong mas partikular na scope.
Kung hindi available ang mga mas partikular na scope, gamitin ang sinusuportahang mas malawak na alternatibo: itakda ang ChatGPT sa all-apis at offline_access, at tiyaking pinapayagan ng Databricks app ang pareho. Ang app na all-apis lang ang pinapayagan ay hindi tumutugma sa kahilingan ng ChatGPT para sa ai-gateway, dashboards, at offline_access. Ang access na para lang sa SQL ay angkop lamang sa app na limitado sa Databricks SQL APIs; hindi ito sapat para sa mga aksyon sa Genie o dashboard.
Nabibigo ang mga aksyon sa SQL: Para sa app na limitado sa Databricks SQL APIs, tiyakin ang scope na SQL, configuration ng warehouse, at mga pahintulot sa Databricks.
Maling ChatGPT workspace: Gawin at i-enable ang app sa mismong ChatGPT workspace kung saan ito ikokonekta ng mga user.
Maling Databricks account o workspace: Tiyakin ang value ng Hostname ng workspace (kinakailangan), pagkatapos ay ulitin ang proseso ng pag-sign in at tiyaking binubuksan ng Databricks ang inaasahang account o workspace.
Hindi makakonekta ang mga user: Tiyaking may access sa Databricks ang user at pinapayagan siyang magbigay ng awtorisasyon sa OAuth app. Sa Business, tiyaking naka-enable ang app sa buong workspace. Sa mga sinusuportahang Enterprise at Edu workspace, tiyakin ding pinapayagan ang app sa Access ng user sa ChatGPT.
Hinaharang ng patakaran sa network ng Databricks ang app: Kung mga partikular na source IP lang ang pinapayagan ng Databricks, dapat i-update ng isang Databricks admin ang mga kaugnay na IP access list ng account o workspace, mga kontrol sa papasok na trapiko batay sa konteksto, firewall, o iba pang panuntunan sa network na kontrolado ng customer.
- Payagan ang mga papasok na koneksyon mula sa kasalukuyang mga egress IP range ng ChatGPT app.
- I-configure ang allowlisting na ito sa Databricks o sa network layer na kontrolado ng customer. Hiwalay ito sa IP allowlisting ng ChatGPT workspace.
- Maaaring magbago ang mga inilathalang range. I-automate ang mga update mula sa JSON kung maaari.
- Huwag palitan ang client secret o baguhin ang mga OAuth scope para malampasan ang pagharang ng network. Tiyakin muna kung tinatanggihan ng Databricks ang mga source IP ng app.