Gamitin ang gabay na ito kung isa kang admin ng ChatGPT workspace na nagse-set up ng template ng Databricks app para sa iyong organisasyon. Ang template ay hindi ang pinal na app na gagamitin ng mga miyembro. Isa itong daloy ng pag-setup na gumagawa ng draft app na partikular sa workspace pagkatapos mong ibigay ang kinakailangang configuration ng Databricks.
Para sa Databricks, karamihan ng pag-setup ay ginagawa sa Databricks Account Console. Gagawa ka ng custom na OAuth app connection, irerehistro ang callback URL ng ChatGPT, kokopyahin ang nabuong client credentials, pagkatapos ay ipe-paste ang mga value na iyon sa daloy ng pag-setup ng template sa ChatGPT. Pagkatapos gawin ng ChatGPT ang draft app, maaari mo itong i-publish at pamahalaan tulad ng iba pang workspace app.
Ano ang ise-set up mo
Gumagawa ka ng Databricks app na partikular sa workspace sa ChatGPT. Ginagamit ng app ang:
Isang Databricks OAuth app connection na ginawa sa iyong Databricks Account Console.
Ang Databricks OAuth client ID at client secret.
Ang eksaktong callback URL na kinopya mula sa ChatGPT.
Mga Databricks scope na tumutugma sa mga kakayahan ng connector na gusto mong i-enable.
Anumang detalye ng Databricks provider na hinihingi ng daloy ng pag-setup ng ChatGPT, tulad ng workspace host, account host, account ID, o warehouse.
Bago ka magsimula
Kailangan mo ng:
Access bilang admin o owner ng ChatGPT workspace.
Access bilang admin ng Databricks account. Maaaring sapat ang access bilang admin ng workspace para sa ilang gawain, ngunit kino-configure ang mga custom app connection mula sa Databricks Account Console.
Naka-open ang Databricks Account Console sa hiwalay na tab.
Naka-open ang screen ng pag-setup ng template ng Databricks app 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.
Isang secure na lugar para pangasiwaan ang Databricks client secret.
Huwag imbentuhin ang callback URL. Kopyahin ang eksaktong callback URL na ipinapakita sa ChatGPT.
Mga value na ihahanda
Callback URL: kopyahin ito mula sa daloy ng pag-setup ng template sa ChatGPT.
Databricks OAuth client ID.
Databricks OAuth client secret.
Mga scope ng access sa Databricks, tulad ng ALL APIs o SQL.
Mga field ng Databricks workspace o account na hinihingi ng daloy ng pag-setup ng ChatGPT.
I-publish at pamahalaan ang app sa ChatGPT
Hindi awtomatikong magiging available sa mga miyembro ang paggawa ng draft app. Pagkatapos suriin ang draft:
I-publish ang draft app.
Kumpirmahing lumalabas ang app sa Mga setting ng workspace > Mga app > Naka-enable.
I-configure ang Access ng user para sa mga role na dapat gumamit nito.
Suriin ang Kontrol sa pagkilos para sa mga Databricks action na inilalantad ng app.
Suriin ang Mga pahintulot ng app para piliin kung kailan tatanungin ng ChatGPT ang mga miyembro bago gamitin ang app.
Hilingin sa isang pinapayagang test user na buksan ang Apps sa ChatGPT at kumpirmahing lumalabas ang app.
Nalalapat ang mga pahintulot ng app na ito sa mga pag-uusap sa ChatGPT. Gumagamit ang Workspace Agents ng mga kontrol kada agent na itinakda ng builder ng agent para tukuyin kung aling mga action ng app ang available at kung kailan hihingan ng pag-apruba ang mga end user. Para sa gawi ng agent, tingnan ang: ChatGPT Workspace Agents para sa Enterprise at Business.
Simulan ang pag-setup ng template sa ChatGPT
Sa ChatGPT, lumipat sa workspace kung saan dapat maging available ang app.
Buksan ang Mga setting ng workspace > Mga app.
Piliin ang Direktoryo.
Hanapin ang Databricks.
Piliin ang template ng Databricks app at simulan ang pag-setup.
Maglagay ng malinaw na pangalan at paglalarawan ng app, tulad ng Databricks o Databricks - Data Platform.
Sa seksyon ng OAuth client, kopyahin ang callback URL mula sa ChatGPT. Panatilihing bukas ang tab na ito.
Halimbawang callback URL: https://chatgpt.com/connector/oauth/<callback_id>
Huwag alisin ang callback ID, magdagdag ng trailing slash, o palitan ito ng generic na ChatGPT URL.
Gawin ang OAuth app connection sa Databricks
Buksan ang Databricks Account Console para sa iyong Databricks account.
Sa kaliwang sidebar, buksan ang Mga setting.
Buksan ang tab na Mga app connection.
Piliin ang Magdagdag ng connection.
Maglagay ng pangalan ng application, tulad 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 ALL APIs 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.
Panatilihin ang mga token TTL sa mga default ng Databricks maliban kung may partikular na patakaran ang iyong organisasyon.
I-enable ang Bumuo ng client secret. Kailangan ng ChatGPT ng confidential OAuth client para sa daloy na ito.
Gawin ang connection.
Kopyahin ang credentials mula sa Databricks
Sa dialog na Connection created, kopyahin ang Client ID.
Kopyahin agad ang Client secret at i-store ito nang secure.
Kung isasara mo ang dialog bago makopya ang secret, gumawa o i-rotate ang credentials ng OAuth app at gamitin ang bagong secret.
Isang beses lang ipinapakita ng Databricks ang secret. Ituring ito bilang credential at huwag itong isama sa mga screenshot, ticket, comment, o chat.
Tapusin ang pag-setup sa ChatGPT
Bumalik sa tab ng pag-setup ng template sa ChatGPT.
I-paste ang Databricks Client ID sa OAuth client ID.
I-paste ang Databricks Client secret sa OAuth client secret.
Huwag baguhin ang Scopes maliban kung sinasadya mong i-override ang mga default ng template.
Punan ang anumang field ng Databricks provider na kinakailangan ng daloy ng pag-setup, tulad ng workspace host, account host, account ID, warehouse, o iba pang value na partikular sa Databricks.
Gawin ang draft app.
Subukan ang app bilang user
Simulan ang daloy ng pagkonekta mula sa ChatGPT bilang pinapayagang test user.
Kumpirmahing binubuksan ng browser ang inaasahang Databricks account o workspace.
Aprubahan ang mga hinihinging scope.
I-verify na bumabalik ang browser sa ChatGPT at ipinapakitang nakakonekta ang app.
Magpatakbo muna ng low-risk na read action, tulad ng pagkuha ng impormasyon ng kasalukuyang user o pag-query sa isang aprubadong Databricks SQL resource.
Kung naka-enable ang mga write action, subukan gamit ang malinaw na low-risk na Databricks workflow bago ang mas malawak na rollout.
Pamahalaan ang access
Parehong may ambag ang Databricks at ChatGPT sa access control.
Sa ChatGPT, pinamamahalaan ng mga admin ng workspace kung available ang naka-publish na app, aling mga role sa workspace ang makakagamit nito, aling mga action ang naka-enable, at kung kailan tatanungin ng ChatGPT ang mga user bago gamitin ang app.
Sa Databricks, pinamamahalaan ng mga admin kung aling mga user ang makakapag-authorize ng OAuth app at kung aling mga Databricks resource ang maa-access ng mga user na iyon. Nalalapat pa rin ang mga pahintulot ng provider pagkatapos ma-enable ang app sa ChatGPT.
Pag-troubleshoot
Hindi tugma ang Redirect URI: kumpirmahing eksaktong tumutugma ang Databricks Redirect URL sa callback URL na ipinapakita sa ChatGPT, kasama ang path at callback ID.
Nawawala ang secret: isang beses lang ipinapakita ang mga Databricks secret. Bumuo ng bagong client secret kung hindi ito nakopya.
Hindi agad available ang OAuth app: sinasabi ng Databricks na maaaring umabot nang hanggang 30 minuto bago maproseso ang mga update sa OAuth application.
Hindi sapat ang scope: kung nakakapag-authenticate ang ChatGPT ngunit nabibigo ang mga Databricks API call, kumpirmahing may ALL APIs ang Databricks app kapag kailangan ng app ng mga non-SQL API.
Nabibigo ang mga SQL action: kumpirmahin ang SQL scope, configuration ng warehouse, at mga pahintulot sa Databricks.
Maling workspace: gawin at i-publish ang app sa parehong ChatGPT workspace kung saan ito ikokonekta ng mga user.
Hindi makakonekta ang mga user: kumpirmahing may access sa Databricks ang user at pinapayagang i-authorize ang OAuth app.