Iestatiet Databricks lietotnes veidni ChatGPT

Izmantojiet šo ceļvedi, ja esat ChatGPT darbvietas administrators vai ChatGPT Plus vai Pro lietotājs un iestatāt Databricks Genie savienotāju, izmantojot iebūvēto OAuth vai savas organizācijas OAuth klientu.

• Iebūvētais OAuth: ja tas ir pieejams ChatGPT un iespējots jūsu Databricks darbvietā, izmantojiet iepriekš konfigurēto savienojumu. Jums nav jāizveido OAuth lietotne vai jāievada klienta ID vai klienta slepenā atslēga. Izpildiet tālāk sadaļā „Iebūvētais OAuth” sniegtos norādījumus.

• Pielāgots OAuth klients: izmantojiet šo iespēju, ja iebūvētais OAuth nav pieejams vai jūsu organizācija pieprasa izmantot savu OAuth klientu. Izpildiet tālāk sadaļā „Pielāgots OAuth klients” sniegtos norādījumus.

Ko jūs iestatāt

Jūs veidojat Databricks lietotnes savienojumu savam ChatGPT kontam vai darbvietai. Abos gadījumos ir nepieciešama ChatGPT pieprasītā Databricks pakalpojuma sniedzēja informācija un atļaujas izmantot resursus, kurus plānojat lietot. Ja izmantojat pielāgotu OAuth klientu, sagatavojiet arī:

• Databricks OAuth lietotnes savienojumu, kas izveidots jūsu Databricks konta konsolē.

• Databricks OAuth klienta ID un klienta slepeno atslēgu.

• Precīzu atzvana URL, kas nokopēts no ChatGPT.

• Databricks tvērumus, kas atbilst savienotāja iespējām, kuras vēlaties iespējot.

• Visu Databricks pakalpojuma sniedzēja informāciju, kas tiek pieprasīta ChatGPT iestatīšanas gaitā, piemēram, darbvietas resursdatoru, konta resursdatoru, konta ID vai datu noliktavu.

Pirms sākat

Lai iestatītu savienojumu darbvietai, atveriet administrēšanas konsoli, atlasiet paredzēto ChatGPT darbvietu un atveriet sadaļu “Spraudņi”. Atlasiet “Pārvaldīt iepriekšējās paaudzes lietotnes”, lai atvērtu saglabāto lapu “Lietotnes”. Informāciju par pārvietošanos darbvietā un piekļuvi iepriekšējās paaudzes lietotnēm skatiet rakstā Spraudņu un lietotņu administrēšanas iespējas, drošība un atbilstība.

Jums nepieciešams:

• ChatGPT darbvietas administratora vai īpašnieka piekļuve vai ChatGPT Plus vai Pro konts.

• Pielāgotam OAuth klientam — Databricks konta administratora piekļuve. Dažiem uzdevumiem var pietikt ar darbvietas administratora piekļuvi, taču pielāgotu lietotņu savienojumi tiek konfigurēti Databricks konta konsolē. Iebūvētā OAuth gadījumā Databricks administratoram jāpārbauda, vai ChatGPT lietotne ir pieejama un iespējota jūsu darbvietai.

• Pielāgotam OAuth klientam — atsevišķā cilnē atvērta Databricks konta konsole.

• Pielāgotam OAuth klientam — pakalpojumā ChatGPT atvērts Databricks Genie savienojuma ekrāns, lai varētu nokopēt precīzu atzvanīšanas URL.

• Lēmums par lietotnei nepieciešamajām iespējām: Genie un AI/BI informācijas paneļi, plašāka piekļuve Databricks API vai tikai Databricks SQL API izmantošana. Piekļuve tikai SQL nav pietiekama Genie vai informācijas paneļu darbībām.

• Pielāgotam OAuth klientam — droša vieta darbam ar Databricks klienta slepeno atslēgu.

• Ja piekļuvi jūsu Databricks kontam vai darbvietai ierobežo IP piekļuves saraksts, kontekstā balstīta ienākošās datplūsmas kontrole, ugunsmūris vai cita tīkla politika, nepieciešama Databricks administratora palīdzība, lai atļautu pašreizējos ChatGPT savienotāju izejošās datplūsmas IP diapazonus.

Pielāgotam OAuth klientam nokopējiet precīzu pakalpojumā ChatGPT redzamo atzvanīšanas URL.

Sagatavojamās vērtības

• Pielāgotam OAuth klientam — atzvanīšanas URL: nokopējiet to no ChatGPT savienotāja iestatīšanas procesa.

• Pielāgotam OAuth klientam — Databricks OAuth klienta ID.

• Pielāgotam OAuth klientam — Databricks OAuth klienta slepenā atslēga.

• Pielāgotam OAuth klientam — lietotnes iespējām atbilstoši Databricks piekļuves tvērumi. Ja jaunam Genie vai informācijas paneļu savienojumam tiek rādīti tvērumi ai-gateway, dashboards un offline_access, sagatavojiet šos tvērumus. VISI API (all-apis kopā ar offline_access) joprojām ir agrākā, plašākā alternatīva. Izmantojiet SQL tikai lietotnei, kas izmanto vienīgi Databricks SQL API.

• Databricks darbvietas vai konta lauki, kas jāaizpilda ChatGPT iestatīšanas procesā.

Iebūvētais OAuth

Vispirms izpildiet iepriekš norādītos priekšnosacījumus. Izmantojiet šo variantu tikai tad, ja iebūvētais OAuth ir pieejams pakalpojumā ChatGPT un iespējots jūsu Databricks darbvietai.

1. Lūdziet Databricks administratoram pārbaudīt, vai ChatGPT lietotne ir pieejama konta konsoles lietotņu integrāciju iestatījumos un iespējota jūsu darbvietai. Ja ChatGPT lietotne nav norādīta jūsu Databricks konta konsolē, sazinieties ar savu Databricks konta pārstāvi, lai noskaidrotu, vai šī funkcija ir pieejama jūsu kontam.

2. Pakalpojumā ChatGPT pārslēdzieties uz kontu vai darbvietu, kurā lietotnei jābūt pieejamai. Personīgai iestatīšanai atveriet Iestatījumi > Spraudņi, bet darbvietas iestatīšanai kā darbvietas administrators vai īpašnieks atveriet Administrēšanas konsole > Spraudņi.

3. Atlasiet Databricks Genie un pēc tam Pievienot lietotnes savienojumu.

4. Laukā Darbvietas resursdatora nosaukums (obligāts) ievadiet nosaukumu bez https:// vai URL ceļa.

   No šī resursdatora nosaukuma ChatGPT iegūst darbvietas lokālo Genie MCP galapunktu https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Atsevišķs reģionālais MCP galapunkts nav nepieciešams.

5. Atlasiet Turpināt, pēc tam pierakstieties pakalpojumā Databricks un pārskatiet piekrišanas pieprasījumu.

Turpiniet ar tālāk esošajām sadaļām “Savienošana un testēšana” un “Piekļuves pārvaldība”, tostarp veiciet testus ar dalībniekiem, kuriem ir atļauta piekļuve, un darbvietas piekļuves pārbaudes.

Pielāgots OAuth klients

Vispirms izpildiet iepriekš minētos priekšnosacījumus. Izmantojiet šo iespēju, ja iebūvētais OAuth nav pieejams vai jūsu organizācija pieprasa izmantot savu OAuth klientu. Pēc iestatīšanas izpildiet tālāk sadaļās „Savienojiet un pārbaudiet” un „Pārvaldiet piekļuvi” sniegtos norādījumus.

Sāciet pielāgotā OAuth iestatīšanu pakalpojumā ChatGPT

1. Pakalpojumā ChatGPT pārslēdzieties uz kontu vai darbvietu, kurā lietotnei jābūt pieejamai.

2. Personīgai iestatīšanai atveriet Iestatījumi > Spraudņi, bet darbvietas iestatīšanai kā darbvietas administrators vai īpašnieks atveriet Administrēšanas konsole > Spraudņi.

3. Sadaļā Katalogs atlasiet Databricks Genie.

4. Atlasiet Pievienot lietotnes savienojumu.

5. Dialoglodziņā Savienot Databricks Genie atrodiet laukus OAuth klienta ID un OAuth klienta slepenā atslēga. Akreditācijas datu ievadīšana šajos redzamajos laukos ir pielāgotā klienta iestatīšanas process; atsevišķa izvēle nav jāveic.

6. Nokopējiet atzvanīšanas URL no ChatGPT. Atstājiet šo dialoglodziņu atvērtu.

Atzvanīšanas URL piemērs:

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

Neizņemiet atzvanīšanas ID, nepievienojiet slīpsvītru beigās un neaizstājiet šo URL ar vispārīgu ChatGPT URL. Pakalpojumā Databricks reģistrētajam URL precīzi jāatbilst ChatGPT redzamajam atzvanīšanas URL.

Izveidojiet pielāgotu OAuth lietotnes savienojumu pakalpojumā Databricks

1. Atveriet sava Databricks konta konsoli.

2. Kreisajā sānjoslā atveriet sadaļu Iestatījumi.

3. Atveriet cilni Lietotņu savienojumi.

4. Atlasiet Pievienot savienojumu.

   

5. Ievadiet lietotnes nosaukumu, piemēram, “ChatGPT Databricks savienotājs”.

6. Laukā Novirzīšanas URL ielīmējiet precīzu no ChatGPT nokopēto atzvanīšanas URL.

7. Sadaļā Piekļuves tvērumi izvēlieties lietotnei nepieciešamos tvērumus.

8. Ja jaunam Genie vai informācijas paneļu savienojumam pakalpojumā ChatGPT tiek rādīti tvērumi ai-gateway, dashboards un offline_access, atļaujiet tos pašus tvērumus Databricks OAuth lietotnē.

9. VISI API joprojām ir agrākā, plašākā alternatīva vispārīgai piekļuvei Databricks API. Šajā konfigurācijā pakalpojumā ChatGPT izmantojiet all-apis un offline_access un pārliecinieties, ka Databricks OAuth lietotnē ir atļauti abi. Jaunam Genie vai informācijas paneļu savienojumam dodiet priekšroku parādītajiem detalizētajiem tvērumiem.

10. Izmantojiet SQL tikai lietotnei, kas izmanto vienīgi Databricks SQL API. Piekļuve tikai SQL nav pietiekama Genie vai informācijas paneļu darbībām.

11. Pārliecinieties, ka šajā Databricks OAuth lietotnē ir iespējots katrs tvērums, ko vēlāk norādīsiet pakalpojumā ChatGPT. Lietotāja saskarnē izveidotām lietotnēm Databricks automātiski atļauj openid, email, profile un offline_access.

12. Ja vien jūsu organizācijā nav īpašas politikas, saglabājiet Databricks noklusējuma žetonu derīguma laikus (TTL): 60 minūtes piekļuves žetonam un 10080 minūtes atsvaidzināšanas žetonam.

13. Ieslēdziet Ģenerēt klienta slepeno atslēgu. Šim procesam ChatGPT nepieciešams konfidenciāls OAuth klients.

14. Izveidojiet savienojumu.

Nokopējiet akreditācijas datus no Databricks

1. Dialoglodziņā Savienojums izveidots nokopējiet klienta ID.

2. Nekavējoties nokopējiet klienta slepeno atslēgu un glabājiet to drošā vietā.

3. Ja aizverat dialoglodziņu pirms slepenās atslēgas nokopēšanas, izveidojiet vai nomainiet OAuth lietotnes akreditācijas datus un izmantojiet jauno slepeno atslēgu.

Databricks parāda slepeno atslēgu tikai vienu reizi. Rīkojieties ar to kā ar akreditācijas datiem un neiekļaujiet to ekrānuzņēmumos, atbalsta pieteikumos, komentāros vai tērzēšanā.

Pabeidziet pielāgotā OAuth iestatīšanu pakalpojumā ChatGPT

1. Atgriezieties dialoglodziņā Savienot Databricks Genie.

2. Laukā OAuth klienta ID ievadiet Databricks klienta ID.

3. Laukā OAuth klienta slepenā atslēga ievadiet Databricks klienta slepeno atslēgu.

   Ievadot šos akreditācijas datus, tiek izmantots jūsu pielāgotais OAuth klients; atsevišķa izvēle nav jāveic.

4. Laukā Tvērumi (neobligāti) ievadiet tvērumus, kas nepieciešami jūsu lietotnes Databricks galapunktam un iespējām. Tiem jāatbilst Databricks OAuth lietotnē iespējotajiem tvērumiem.

   Ja jaunam Genie vai informācijas paneļu savienojumam tiek rādīti tvērumi ai-gateway, dashboards un offline_access, saglabājiet tos. Pārliecinieties, ka Databricks OAuth lietotnē ir atļauti tie paši tvērumi. ai-gateway ļauj izveidot Genie MCP savienojumu darbvietas ietvaros, dashboards ļauj veikt darbības AI/BI informācijas paneļos, bet offline_access ļauj izmantot atsvaidzināšanas žetonus.

   Agrākā, plašākā alternatīva — all-apis un offline_access — joprojām tiek atbalstīta plašākai API piekļuvei, taču šim Genie vai informācijas paneļu savienojumam tā nav ieteicamā izvēle. Ja Databricks lietotnē ir atļauts tikai all-apis, atjauniniet vai izveidojiet to no jauna, lai atļautu ai-gateway, dashboards un offline_access. Ja detalizētie tvērumi nav pieejami, pakalpojumā ChatGPT apzināti iestatiet all-apis un offline_access un pārliecinieties, ka Databricks lietotnē ir atļauti abi. Nepieprasiet šos trīs detalizētos tvērumus pakalpojumā ChatGPT, ja Databricks lietotnē ir atļauts tikai all-apis.

5. Ievadiet katru tvērumu atsevišķā rindā vai atdaliet tvērumus ar komatiem. Katram pakalpojumā ChatGPT norādītajam tvērumam jābūt iespējotam Databricks OAuth lietotnē.

6. Laukā Darbvietas resursdatora nosaukums (obligāts) ievadiet nosaukumu bez https:// vai URL ceļa. Aizpildiet visus pārējos obligātos Databricks nodrošinātāja laukus, kas redzami iestatīšanas procesā.

   No šī resursdatora nosaukuma ChatGPT iegūst darbvietas lokālo Genie MCP galapunktu https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Atsevišķs reģionālais MCP galapunkts nav nepieciešams.

7. Atlasiet Turpināt.

ChatGPT pieprasa tieši tos tvērumus, kas ievadīti laukā Tvērumi (neobligāti). Plašāki veidnes tvērumi netiek pievienoti automātiski.

Savienošana un testēšana

Neatkarīgi no izvēlētā OAuth varianta veiciet tālāk norādītos savienojuma testus un piekļuves pārbaudes.

1. Pārskatiet savienotāja informāciju, darbības un autentifikācijas iestatījumus.

2. Ja esat darbvietas administrators, iespējojiet savienotāju darbvietai un atbilstoši darbvietas politikai konfigurējiet, kas to var izmantot.

3. Kā testa lietotājs ar atļautu piekļuvi sāciet savienošanas procesu pakalpojumā ChatGPT, pēc tam pierakstieties pakalpojumā Databricks.

4. Pārliecinieties, ka pārlūkā tiek atvērts paredzētais Databricks konts vai darbvieta.

5. Pārskatiet pieprasītos tvērumus, pēc tam atlasiet Autorizēt.

   

6. Pārbaudiet, vai pārlūks atgriežas pakalpojumā ChatGPT un savienotāja statuss ir “Savienots”.

7. Veiciet zema riska lasīšanas darbību, kas atbilst savienojuma iespējām. Genie savienojuma gadījumā nosūtiet Genie pieprasījumu par datiem, kuriem testa lietotājam ir atļauta piekļuve. Citu atbalstīto iespēju gadījumā iegūstiet informāciju par pašreizējo lietotāju vai veiciet vaicājumu apstiprinātam Databricks SQL resursam. Pārliecinieties, ka lietotājam ir nepieciešamās Databricks resursu atļaujas; OAuth tvērumi vien nepiešķir piekļuvi datiem.

8. Ja ir iespējotas rakstīšanas darbības, pirms plašākas ieviešanas veiciet testu ar nepārprotami zema riska Databricks darbplūsmu.

9. Ja iestatāt savienojumu darbvietai, lūdziet darbvietas dalībniekam, kuram ir atļauta piekļuve, bet nav administratora tiesību, izveidot savienojumu un atkārtot zema riska testu.

Pārvaldiet piekļuvi

Piekļuves kontroli nodrošina gan Databricks, gan ChatGPT.

ChatGPT darbvietas administratori nosaka, vai lietotne ir pieejama un kā dalībnieki to var izmantot. Business darbvietās administratori nosaka, vai lietotne ir iespējota visā darbvietā. Databricks lietotņu administratora vadīklās (Darbvietas iestatījumi > Lietotnes vai Administratora konsole > Spraudņi > Pārvaldīt mantotās lietotnes) pārskatiet šos iestatījumus:

• Lietotāju piekļuve — lai konfigurētu, kurām darbvietas lomām ir atļauts izmantot savienotāju atbalstītajās Enterprise un Edu darbvietās.

• Darbību kontrole — lai konfigurētu, kuras Databricks darbības ir iespējotas.

• Lietotnes atļaujas — lai konfigurētu, kad ChatGPT pirms savienotāja izmantošanas lūdz dalībnieku atļauju.

Šīs lietotnes atļaujas attiecas uz ChatGPT sarunām. Darbvietas aģenti izmanto katram aģentam atsevišķi tā veidotāja iestatītas vadīklas, kas nosaka, kuras lietotņu darbības ir pieejamas un kad galalietotājiem tiek lūgts tās apstiprināt. Par aģentu darbību skatiet rakstu ChatGPT darbvietas aģenti plāniem Enterprise un Business.

Databricks administratori nosaka, kuri lietotāji var autorizēt OAuth lietotni un kuriem Databricks resursiem šie lietotāji var piekļūt. Pakalpojuma sniedzēja atļaujas joprojām ir spēkā arī pēc lietotnes iespējošanas ChatGPT.

Par navigāciju darbvietā, piekļuvi lietotnēm un konkrētiem plāniem pieejamajām lietotņu vadīklām skatiet rakstu Administratora vadīklas, drošība un atbilstība lietotnēs.

Databricks savienotāja iestatīšanas problēmu novēršana

• Novirzīšanas URI neatbilstība: ja izmantojat pielāgotu OAuth klientu, pārliecinieties, ka Databricks lauka Novirzīšanas URL vērtība precīzi atbilst ChatGPT redzamajai lauka Atzvanīšanas URL vērtībai, tostarp ceļam un atzvanīšanas ID. Neizņemiet atzvanīšanas ID, nepievienojiet slīpsvītru beigās un neaizstājiet URL ar citu ChatGPT novirzīšanas URL.

• Trūkst slepenās atslēgas: ja izmantojat pielāgotu OAuth klientu, ņemiet vērā, ka Databricks slepenās atslēgas tiek parādītas tikai vienu reizi. Ja klienta slepenā atslēga netika nokopēta, ģenerējiet jaunu.

• OAuth lietotne nav pieejama uzreiz: Databricks norāda, ka OAuth lietotnes atjauninājumu apstrāde var ilgt līdz 30 minūtēm.

• Nepietiekams vai neatbilstošs tvērums: ja izmantojat pielāgotu OAuth klientu, salīdziniet ChatGPT lauku Tvērumi (neobligāti) ar Databricks OAuth lietotnes lauku Piekļuves tvērumi. Tajā jābūt iespējotam katram ChatGPT pieprasītajam tvērumam. Pārliecinieties, ka tvērumi atbalsta jūsu izmantoto galapunktu un iespējas.

  Ja jaunam Genie vai informācijas paneļu savienojumam tiek rādīti tvērumi ai-gateway, dashboards un offline_access, saglabājiet tos pakalpojumā ChatGPT un pārliecinieties, ka Databricks lietotnē ir atļauti visi trīs. Ja lietotnē ir atļauts tikai all-apis, atjauniniet vai izveidojiet to no jauna, lai atļautu šos trīs detalizētos tvērumus.

  Ja detalizētie tvērumi nav pieejami, izmantojiet atbalstīto plašāko alternatīvu: pakalpojumā ChatGPT iestatiet all-apis un offline_access un pārliecinieties, ka Databricks lietotnē ir atļauti abi. Lietotne, kurā ir atļauts tikai all-apis, neatbilst ChatGPT pieprasījumam pēc ai-gateway, dashboards un offline_access. Piekļuve tikai SQL ir piemērota vienīgi lietotnei, kas izmanto tikai Databricks SQL API; tā nav pietiekama Genie vai informācijas paneļu darbībām.

• SQL darbības neizdodas: ja lietotne izmanto tikai Databricks SQL API, pārbaudiet SQL tvērumu, datu noliktavas konfigurāciju un Databricks atļaujas.

• Nepareiza ChatGPT darbvieta: izveidojiet un iespējojiet savienotāju tajā pašā ChatGPT darbvietā, kurā lietotāji to savienos.

• Nepareizs Databricks konts vai darbvieta: pārbaudiet lauka Darbvietas resursdatora nosaukums (obligāts) vērtību, pēc tam atkārtojiet pierakstīšanos un pārliecinieties, ka Databricks atver paredzēto kontu vai darbvietu.

• Lietotāji nevar izveidot savienojumu: pārliecinieties, ka lietotājam ir piekļuve Databricks un atļauja autorizēt OAuth lietotni. Business plānā pārliecinieties, ka lietotne ir iespējota visā darbvietā. Atbalstītajās Enterprise un Edu darbvietās pārliecinieties arī, ka ChatGPT iestatījumā Lietotāju piekļuve savienotājs ir atļauts.

• Databricks tīkla politika bloķē savienotāju: ja Databricks atļauj tikai noteiktas avota IP adreses, Databricks administratoram jāatjaunina attiecīgā konta vai darbvietas IP piekļuves saraksti, kontekstā balstītā ienākošās datplūsmas kontrole, ugunsmūris vai citi klienta pārvaldīti tīkla noteikumi.

  • Atļaujiet ienākošos savienojumus no pašreizējiem ChatGPT savienotāju izejošās datplūsmas IP diapazoniem.

  • Konfigurējiet šo atļauto adrešu sarakstu pakalpojumā Databricks vai klienta pārvaldītajā tīkla slānī. Tas ir atsevišķs no ChatGPT darbvietas atļauto IP adrešu saraksta.

  • Publicētie diapazoni var mainīties. Ja iespējams, automatizējiet atjaunināšanu no JSON.

  • Nemēģiniet apiet tīkla bloķēšanu, nomainot klienta slepeno atslēgu vai mainot OAuth tvērumus. Vispirms pārbaudiet, vai Databricks noraida savienotāja avota IP adreses.

Atsauces

• Databricks dokumentācija: autentifikācija, izmantojot OAuth lietotāja–mašīnas plūsmu

• Databricks dokumentācija: OAuth lietotņu savienojumu pārvaldība

• Databricks dokumentācija: IP piekļuves sarakstu pārvaldība