Gamitin ang gabay na ito kung isa kang admin ng ChatGPT workspace o gumagamit ng ChatGPT Plus o Pro na nagse-set up ng Databricks Genie connector gamit ang built-in na OAuth o ang OAuth client ng iyong organisasyon.
Built-in na OAuth: Kapag available ito 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 hinihingi sa ChatGPT at ang mga pahintulot para sa mga resource na balak mong gamitin. Kung gagamit ka ng custom na OAuth client, ihanda rin ang:
Isang koneksyon sa Databricks OAuth app na ginawa sa iyong Databricks Account Console.
Ang OAuth client ID at client secret ng Databricks.
Ang eksaktong callback URL na kinopya mula sa ChatGPT.
Mga scope ng Databricks na tumutugma sa mga kakayahan ng connector na gusto mong i-enable.
Anumang detalye ng Databricks provider na hinihingi sa proseso ng pag-set up sa ChatGPT, gaya ng workspace host, account host, account ID, o warehouse.
Bago ka magsimula
Kailangan mo ng:
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 kung kailangan ng app ng pangkalahatang access sa Databricks API o access lang sa Databricks SQL.
Para sa custom na OAuth client, isang ligtas na lugar para pangasiwaan ang client secret ng Databricks.
Kung nililimitahan ng iyong Databricks account o workspace ang access sa pamamagitan ng IP access list, context-based ingress control, firewall, o iba pang patakaran sa network, tulong mula sa isang Databricks admin na maaaring magpahintulot sa kasalukuyang mga egress IP range ng ChatGPT connector.
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 connector sa ChatGPT.
Para sa custom na OAuth client, ang OAuth client ID ng Databricks.
Para sa custom na OAuth client, ang OAuth client secret ng Databricks.
Para sa custom na OAuth client, mga access scope ng Databricks na angkop sa mga kakayahan ng app, gaya ng LAHAT ng API o SQL.
Mga field ng Databricks workspace o account na hinihingi 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 tiyaking available ang ChatGPT application sa mga setting ng integration ng app sa Account Console at naka-enable ito para sa iyong workspace. Kung hindi nakalista ang ChatGPT application sa iyong Databricks Account Console, makipag-ugnayan sa kinatawan ng iyong Databricks account 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 setup, o sa Mga setting ng workspace > Mga plugin bilang admin o may-ari ng workspace para sa setup ng workspace.
Piliin ang Databricks Genie, pagkatapos ay piliin ang Magdagdag ng koneksyon sa app.
Ilagay ang Hostname ng workspace (kinakailangan) nang walang
https://o URL path.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 gamit ang mga pinahihintulutang miyembro at pagsusuri sa access sa workspace.
Custom na OAuth client
Kumpletuhin muna ang mga paunang kinakailangan sa itaas. Gamitin ang paraang ito kung hindi available ang built-in na OAuth o kung kailangan ng iyong organisasyon ng sarili nitong OAuth client. Pagkatapos ng setup, kumpletuhin ang mga seksyong Kumonekta at subukan at Pamahalaan ang access sa ibaba.
Simulan ang pag-set up ng custom na 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 setup, o sa Mga setting ng workspace > Mga plugin bilang admin o may-ari ng workspace para sa setup ng workspace.
Piliin ang Databricks Genie sa Direktoryo.
Piliin ang Magdagdag ng koneksyon sa app.
Sa dialog na Ikonekta ang Databricks Genie, hanapin ang seksyon ng OAuth client.
Kopyahin ang Callback URL mula sa ChatGPT. Panatilihing bukas ang dialog na ito.
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 Connector.
Sa Mga redirect URL, i-paste ang eksaktong callback URL na kinopya mula sa ChatGPT.
Sa ilalim ng Mga access scope, piliin ang mga scope na kailangan ng app.
Gamitin ang LAHAT ng API para sa isang pangkalahatang Databricks app na nangangailangan ng mga Databricks API bukod sa SQL.
SQL lang ang gamitin para sa app na limitado sa mga Databricks SQL API.
Tiyaking naka-enable sa Databricks OAuth app na ito ang bawat scope na ililista sa ChatGPT sa 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 na TTL ng token sa Databricks 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 Bumuo ng client secret. Kailangan ng ChatGPT ng confidential na OAuth client para sa prosesong ito.
Gawin ang koneksyon.
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 naisara 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. Ingatan ito gaya ng isang credential at huwag isama sa mga screenshot, ticket, komento, o chat.
Tapusin ang pag-set up ng custom na OAuth sa ChatGPT
Bumalik sa dialog na Ikonekta ang Databricks Genie.
Ilagay ang client ID ng Databricks sa OAuth client ID.
Ilagay ang client secret ng Databricks sa OAuth client secret.
Sa Mga scope (opsyonal), ilagay ang mga scope na kailangan para sa endpoint at mga kakayahan ng iyong app sa Databricks. Itugma ang mga ito sa mga scope na naka-enable sa Databricks OAuth app.
Maglagay ng isang scope sa bawat linya o paghiwalayin ang mga scope gamit ang 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 ng Databricks provider na ipinapakita sa proseso ng pag-set up.
Piliin ang Magpatuloy.
Eksaktong mga scope na inilagay sa Mga scope (opsyonal) ang hinihingi ng ChatGPT. Hindi ito awtomatikong nagdaragdag ng mas malalawak na scope mula sa template.
Kumonekta at subukan
Kumpletuhin ang mga sumusunod na pagsubok sa koneksyon at pagsusuri sa access, alinmang paraan ng OAuth ang gamitin mo.
Suriin ang mga detalye, aksyon, at setting ng authentication ng connector.
Kung isa kang admin ng workspace, i-enable ang connector para sa workspace at i-configure kung sino ang maaaring gumamit nito ayon sa patakaran ng workspace.
Simulan ang proseso ng pagkonekta mula sa ChatGPT bilang isang pinahihintulutang test user, pagkatapos ay mag-sign in sa Databricks.
Tiyaking binubuksan ng browser ang inaasahang Databricks account o workspace.
Suriin ang mga hinihinging scope, pagkatapos ay piliin ang Pahintulutan.
Tiyaking bumabalik ang browser sa ChatGPT at nakikitang nakakonekta na ang connector.
Magsagawa muna ng aksyong nagbabasa ng data na mababa ang panganib, gaya ng pagkuha ng impormasyon ng kasalukuyang user o pag-query sa isang aprubadong Databricks SQL resource.
Kung naka-enable ang mga aksyong nagsusulat ng data, subukan muna ang isang Databricks workflow na malinaw na mababa ang panganib bago ito ipagamit nang mas malawakan.
Para sa setup ng workspace, hilingin sa isang pinahihintulutang 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) para sa:
Access ng user, para i-configure kung aling mga tungkulin sa workspace ang maaaring gumamit ng connector sa mga sinusuportahang Enterprise at Edu workspace.
Kontrol sa aksyon, para i-configure kung aling mga aksyon sa Databricks ang naka-enable.
Mga pahintulot sa app, para i-configure kung kailan magpapaalam ang ChatGPT sa mga miyembro bago gamitin ang connector.
Nalalapat ang mga pahintulot na ito sa app sa mga pag-uusap sa ChatGPT. Gumagamit ang mga agent sa workspace ng mga kontrol na itinakda ng gumawa ng bawat agent para tukuyin kung aling mga aksyon sa app ang available at kung kailan hihingan ng pag-apruba ang mga end user. Para sa paggana ng agent, tingnan ang: Mga agent sa ChatGPT workspace para sa Enterprise at Business.
Sa Databricks, pinamamahalaan ng mga admin kung sinong mga user ang maaaring magpahintulot sa OAuth app at kung aling mga resource ng Databricks ang maa-access ng mga user na iyon. Nalalapat pa rin ang mga pahintulot ng provider pagkatapos i-enable ang app sa ChatGPT.
Para sa mga kontrol sa app na partikular sa bawat plan, tingnan ang Mga kontrol ng admin, seguridad, at pagsunod sa mga regulasyon sa mga app.
Pag-troubleshoot sa pag-set up ng Databricks connector
Hindi tugma ang 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 ipalit ang ibang ChatGPT redirect URL.
Nawawala ang secret: Kung gumagamit ka ng custom na OAuth client, isang beses lang ipinapakita ang mga secret ng Databricks. Bumuo ng bagong client secret kung hindi ito nakopya.
Hindi agad available ang OAuth app: Ayon sa Databricks, maaaring abutin ng hanggang 30 minuto ang pagproseso ng mga update sa OAuth application.
Kulang o hindi tugma ang scope: Kung gumagamit ka ng custom na OAuth client, ihambing ang Mga scope (opsyonal) sa ChatGPT sa Mga access scope sa Databricks OAuth app. Dapat naka-enable doon ang bawat scope na hinihingi ng ChatGPT. Tiyaking sinusuportahan ng mga scope ang endpoint at mga kakayahang ginagamit mo, kasama ang pangkalahatang access sa API o access sa SQL lang, kung alin ang angkop.
Nabibigo ang mga aksyon sa SQL: Suriin ang scope na SQL, configuration ng warehouse, at mga pahintulot sa Databricks.
Maling ChatGPT workspace: Gawin at i-enable ang connector sa mismong ChatGPT workspace kung saan ito ikokonekta ng mga user.
Maling Databricks account o workspace: Suriin 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 magpahintulot sa OAuth app. Sa Business, tiyaking naka-enable ang app sa buong workspace. Sa mga sinusuportahang Enterprise at Edu workspace, tiyakin ding pinapayagan ng Access ng user sa ChatGPT ang connector.
Hinaharangan ng patakaran sa network ng Databricks ang connector: 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, context-based ingress control, 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 connector.
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. Gawing awtomatiko 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 connector.