Gamitin ang gabay na ito kung admin ka ng ChatGPT workspace o user ng ChatGPT Plus o Pro na nagse-set up ng Databricks Genie connector gamit ang Databricks OAuth client ng iyong organisasyon.
Para sa Databricks, karamihan ng pagse-set up ay ginagawa sa Databricks Account Console. Gagawa ka ng custom na koneksyon sa OAuth app, irerehistro ang callback URL ng ChatGPT, kokopyahin ang nabuong client credentials, at pagkatapos ay ilalagay ang mga value na iyon sa proseso ng pagse-set up ng ChatGPT connector.
Ang ise-set up mo
Gumagawa ka ng koneksyon sa Databricks app para sa iyong ChatGPT account o workspace. Ginagamit ng koneksyon ang:
Isang koneksyon sa Databricks OAuth app na ginawa sa iyong Databricks Account Console.
Ang client ID at client secret ng Databricks OAuth.
Ang eksaktong callback URL na kinopya mula sa ChatGPT.
Mga saklaw ng Databricks na tumutugma sa mga kakayahan ng connector na gusto mong i-enable.
Anumang detalye ng provider ng Databricks na hinihingi sa proseso ng pagse-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.
Access bilang admin ng Databricks account. Maaaring sapat ang access bilang workspace admin para sa ilang gawain, ngunit kino-configure ang mga custom na koneksyon sa app mula sa Databricks Account Console.
Nakabukas ang Databricks Account Console sa hiwalay na tab.
Nakabukas sa ChatGPT ang screen ng koneksyon sa Databricks Genie para makopya mo ang eksaktong callback URL.
Desisyon kung kailangan ng app ng pangkalahatang access sa Databricks API o access lang sa Databricks SQL.
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, humingi ng tulong sa isang Databricks admin na makakapagbigay-daan sa kasalukuyang mga egress IP range ng ChatGPT connector.
Tandaan: dapat mong kopyahin ang eksaktong Callback URL na ipinapakita sa ChatGPT.
Mga value na ihahanda
Callback URL: kopyahin ito mula sa proseso ng pagse-set up ng ChatGPT connector.
Client ID ng Databricks OAuth.
Client secret ng Databricks OAuth.
Mga saklaw ng access sa Databricks, gaya ng LAHAT NG API o SQL.
Mga field ng Databricks workspace o account na hinihingi sa proseso ng pagse-set up sa ChatGPT.
Simulan ang pagse-set up ng app sa ChatGPT
Sa ChatGPT, lumipat sa account o workspace kung saan dapat maging available ang app.
Bilang workspace admin o may-ari, pumunta sa Mga setting ng workspace > Mga Plugin.
Piliin ang Databricks Genie sa Directory.
Piliin ang Magdagdag ng Koneksyon sa App.
Sa dialog na Ikonekta ang Databricks Genie, hanapin ang seksyon ng OAuth client.
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 generic na ChatGPT URL. Dapat eksaktong tumugma ang URL na nakarehistro sa Databricks sa Callback URL na ipinapakita sa ChatGPT.
Gawin ang 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 saklaw ng access, piliin ang mga saklaw na kailangan ng app.
Gamitin ang LAHAT NG API para sa pangkalahatang Databricks app na nangangailangan ng mga Databricks API bukod sa SQL.
Gamitin lang ang SQL para sa app na limitado sa mga Databricks SQL API.
Tiyaking naka-enable sa Databricks OAuth app na ito ang bawat saklaw na ililista sa ChatGPT sa susunod. Awtomatikong pinapayagan ng Databricks ang openid, email, profile, at offline_access para sa mga app na ginawa sa UI.
Panatilihin ang mga default na token TTL ng 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 kumpidensyal na OAuth client para sa prosesong ito.
Gawin ang koneksyon.
Kopyahin ang credentials 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 isinara mo ang dialog bago makopya ang secret, gumawa o mag-rotate ng credentials ng OAuth app at gamitin ang bagong secret.
Isang beses lang ipinapakita ng Databricks ang secret. Ituring itong credential at huwag isama sa mga screenshot, ticket, komento, o chat.
Tapusin ang pagse-set up 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 saklaw (opsyonal), panatilihin ang all-apis at offline_access para sa pangkalahatang access sa API.
Maglagay ng isang saklaw bawat linya o paghiwalayin ang mga saklaw gamit ang mga kuwit. Dapat naka-enable sa Databricks OAuth app ang bawat saklaw na nakalista sa ChatGPT.
Ilagay ang Hostname ng workspace (kinakailangan) nang walang https:// o URL path. Punan ang anumang iba pang kinakailangang field ng provider ng Databricks na ipinapakita sa proseso ng pagse-set up.
Piliin ang Magpatuloy.
Eksaktong hinihiling ng ChatGPT ang mga saklaw na inilagay sa Mga saklaw (opsyonal). Hindi ito awtomatikong nagdaragdag ng mas malawak na mga saklaw mula sa template.
Kumonekta at magsubok
Suriin ang mga detalye, pagkilos, at setting ng authentication ng connector.
Kung workspace admin ka, i-enable ang connector para sa workspace at i-configure kung sino ang maaaring gumamit nito ayon sa patakaran ng workspace.
Bilang pinapayagang test user, simulan sa ChatGPT ang proseso ng pagkonekta, at pagkatapos ay mag-sign in sa Databricks.
Kumpirmahing binubuksan ng browser ang inaasahang Databricks account o workspace.
Suriin ang mga hinihiling na saklaw, at pagkatapos ay piliin ang Pahintulutan.
Tiyaking babalik ang browser sa ChatGPT at makikitang nakakonekta ang connector.
Magsagawa muna ng read action 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 write action, magsubok gamit ang isang Databricks workflow na malinaw na mababa ang panganib bago ito ilunsad nang mas malawakan.
Para sa pagse-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 workspace admin kung available ang app at kung paano ito magagamit ng mga miyembro. Suriin ang mga admin control ng Databricks apps (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.
Kontrol sa pagkilos, para i-configure kung aling mga pagkilos 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 connector.
Nalalapat ang mga pahintulot ng app na ito sa mga pag-uusap sa ChatGPT. Gumagamit ang Workspace Agents ng mga kontrol para sa bawat agent na itinakda ng bumuo sa agent upang matukoy kung aling mga pagkilos ng app ang available at kung kailan hihingan ng pag-apruba ang mga end user. Para sa gawi ng agent, tingnan ang: Mga ChatGPT Workspace Agent para sa Enterprise at Business.
Sa Databricks, pinamamahalaan ng mga admin kung aling 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.
Pag-troubleshoot sa pagse-set up ng Databricks connector
Hindi tugma ang Redirect URI: Kumpirmahing 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.
Walang secret: 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 nang hanggang 30 minuto ang pagproseso sa mga update ng OAuth application.
Kulang o hindi tugma ang saklaw: Ihambing ang Mga saklaw (opsyonal) sa ChatGPT sa Mga saklaw ng access sa Databricks OAuth app. Dapat naka-enable doon ang bawat saklaw na hinihiling ng ChatGPT. Para sa mga API na hindi SQL, kumpirmahing naka-enable ang all-apis sa Databricks at nananatili ito sa listahan ng saklaw sa ChatGPT.
Nabibigo ang mga SQL action: Kumpirmahin ang saklaw na SQL, configuration ng warehouse, at mga pahintulot sa Databricks.
Maling ChatGPT workspace: Gawin at i-enable ang connector sa ChatGPT workspace kung saan ito ikokonekta ng mga user.
Maling Databricks account o workspace: Kumpirmahin ang value ng Hostname ng workspace (kinakailangan), at pagkatapos ay ulitin ang proseso ng pag-sign in at tiyaking bubuksan ng Databricks ang inaasahang account o workspace.
Hindi makakonekta ang mga user: Kumpirmahing may access sa Databricks ang user at pinapayagan siyang magpahintulot sa OAuth app. Kumpirmahin din na pinapayagan ng Access ng user sa ChatGPT ang connector.
Hinaharang 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 nauugnay na account o workspace IP access list, context-based ingress control, firewall, o iba pang tuntunin 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 naka-publish na range. Kung posible, i-automate ang mga update mula sa JSON.
Huwag i-rotate ang client secret o baguhin ang mga saklaw ng OAuth para malusutan ang pag-block ng network. Kumpirmahin muna kung tinatanggihan ng Databricks ang mga source IP ng connector.