Iestatiet Databricks lietotnes veidni ChatGPT

Izmantojiet šo ceļvedi, ja esat ChatGPT darbvietas administrators vai ChatGPT Plus vai Pro lietotājs un iestatāt lietotni Databricks Genie, 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ā informācija par Databricks pakalpojuma sniedzēju un atļaujas resursiem, kurus plānojat izmantot. 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 no ChatGPT nokopētu atzvana URL.

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

• Visu ChatGPT iestatīšanas procesā pieprasīto informāciju par Databricks pakalpojuma sniedzēju, piemēram, darbvietas resursdatoru, konta resursdatoru, konta ID vai datu noliktavu.

Pirms sākat

Lai veiktu iestatīšanu darbvietā, atveriet administratora konsoli, atlasiet vajadzīgo ChatGPT darbvietu un atveriet sadaļu “Spraudņi”. Atlasiet “Pārvaldīt mantotās lietotnes”, lai atvērtu saglabāto lapu “Lietotnes”. Informāciju par navigāciju darbvietā un piekļuvi mantotajām lietotnēm skatiet rakstā Administratora vadīklas, drošība un atbilstība spraudņiem un lietotnēm.

Jums nepieciešams:

• ChatGPT darbvietas administratora vai īpašnieka piekļuves tiesības vai ChatGPT Plus vai Pro konts.

• Pielāgotam OAuth klientam — Databricks konta administratora piekļuves tiesības. Dažiem uzdevumiem var pietikt ar darbvietas administratora piekļuves tiesībām, taču pielāgoti 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 darbvietā.

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

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

• Lēmums par lietotnei vajadzīgajā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. Ar piekļuvi tikai SQL nepietiek Genie vai informācijas paneļu darbībām.

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

• Ja jūsu Databricks kontā vai darbvietā piekļuve tiek ierobežota ar IP piekļuves sarakstu, kontekstā balstītu ienākošās piekļuves kontroli, ugunsmūri vai citu tīkla politiku — palīdzība no Databricks administratora, kurš var atļaut pašreizējos ChatGPT lietotņu izejošo savienojumu IP diapazonus.

Pielāgotam OAuth klientam nokopējiet precīzu ChatGPT parādīto atzvana URL.

Sagatavojamās vērtības

• Pielāgotam OAuth klientam — atzvana URL: nokopējiet to ChatGPT lietotnes iestatīšanas procesā.

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

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

• Pielāgotam OAuth klientam — Databricks piekļuves tvērumi, kas atbilst lietotnes iespējām. Ja jaunam Genie/informācijas paneļu savienojumam tiek rādīti tvērumi ai-gateway, dashboards un offline_access, sagatavojiet šos tvērumus. VISAS 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 lauku vērtības, kas tiek pieprasītas 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.

Pielāgota OAuth lietotnes savienojuma izveide 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.

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

7. Sadaļā Piekļuves tvērumi izvēlieties lietotnei vajadzīgos tvērumus.

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

9. VISAS API joprojām ir agrākā, plašākā alternatīva vispārīgai piekļuvei Databricks API. Šai konfigurācijai ChatGPT izmantojiet all-apis un offline_access un pārliecinieties, ka Databricks OAuth lietotne atļauj abus. Jaunam Genie/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. Ar piekļuvi tikai SQL nepietiek Genie vai informācijas paneļu darbībām.

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

12. Atstājiet Databricks noklusējuma pilnvaru derīguma termiņus (TTL), ja vien jūsu organizācijai nav īpašas politikas: 60 minūtes piekļuves pilnvarai un 10080 minūtes atsvaidzināšanas pilnvarai.

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

14. Izveidojiet savienojumu.

Akreditācijas datu kopēšana 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.

Savienojuma izveide un pārbaude

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

1. Pārskatiet informāciju par lietotni, tās darbības un autentifikācijas iestatījumus.

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

3. Sāciet savienojuma izveidi ChatGPT kā testa lietotājs ar piekļuves atļauju un pēc tam pierakstieties Databricks.

4. Pārbaudiet, vai pārlūkprogrammā tiek atvērts paredzētais Databricks konts vai darbvieta.

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

   

6. Pārliecinieties, ka pārlūkprogramma atgriežas ChatGPT un lietotne tiek rādīta kā pievienota.

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. Lai pārbaudītu citas atbalstītās iespējas, izgūstiet informāciju par pašreizējo lietotāju vai veiciet vaicājumu apstiprinātā Databricks SQL resursā. Pārbaudiet, vai lietotājam ir nepieciešamās Databricks resursu atļaujas; OAuth tvērumi paši par sevi nepiešķir piekļuvi datiem.

8. Ja ir iespējotas rakstīšanas darbības, pirms plašākas ieviešanas pārbaudiet tās ar Databricks darbplūsmu, kurai nepārprotami ir zems risks.

9. Ja veicat iestatīšanu darbvietā, lūdziet darbvietas dalībniekam ar piekļuves atļauju, bet bez administratora tiesībām, izveidot savienojumu un atkārtot zema riska pārbaudi.

Piekļuves pārvaldība

Piekļuves kontrolē ir iesaistīti gan Databricks, gan ChatGPT.

ChatGPT darbvietu administratori pārvalda lietotnes pieejamību un to, kā dalībnieki var to izmantot. Business plānā administratori pārvalda to, vai lietotne ir iespējota visā darbvietā. Pārskatiet šādas Databricks lietotņu administratora vadīklas (Darbvietas iestatījumi > Lietotnes vai Administratora konsole > Spraudņi > Pārvaldīt mantotās lietotnes):

• Lietotāju piekļuve — lai konfigurētu, kuru darbvietas lomu lietotāji var izmantot lietotni 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 lietotnes izmantošanas lūdz dalībniekiem 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 pieejamās lietotnes darbības un to, kad galalietotājiem tiek lūgts tās apstiprināt. Informāciju par aģentu darbību skatiet rakstā ChatGPT darbvietas aģenti Enterprise un Business plānos.

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

Informāciju par navigāciju darbvietā, piekļuvi lietotnēm un katram plānam pieejamajām lietotņu vadīklām skatiet rakstā Administratora vadīklas, drošība un atbilstība lietotnēs.

Databricks lietotnes iestatīšanas problēmu novēršana

• Novirzīšanas URI neatbilstība: ja izmantojat pielāgotu OAuth klientu, pārbaudiet, vai Databricks lauka Novirzīšanas URL vērtība precīzi atbilst ChatGPT parādītajai lauka Atzvana URL vērtībai, tostarp ceļam un atzvana ID. Nenoņemiet atzvana 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 lietotņu 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. Tur jābūt iespējotam katram tvērumam, ko pieprasa ChatGPT. Pārbaudiet, vai tvērumi atbalsta jūsu izmantoto galapunktu un iespējas.

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

  Ja detalizētie tvērumi nav pieejami, izmantojiet atbalstīto plašāko alternatīvu: iestatiet ChatGPT tvērumus all-apis un offline_access un pārliecinieties, ka Databricks lietotne atļauj abus. Lietotne, kas atļauj 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; ar to nepietiek Genie vai informācijas paneļu darbībām.

• SQL darbības neizdodas: lietotnei, kas 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 lietotni tajā pašā ChatGPT darbvietā, kurā lietotāji to pievienos.

• 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ārbaudiet, vai lietotājam ir piekļuve Databricks un atļauja autorizēt OAuth lietotni. Business plānā pārbaudiet, vai lietotne ir iespējota visā darbvietā. Atbalstītajās Enterprise un Edu darbvietās pārbaudiet arī, vai ChatGPT iestatījums Lietotāju piekļuve atļauj lietotnes izmantošanu.

• Databricks tīkla politika bloķē lietotni: 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ās ienākošās piekļuves vadīklas, ugunsmūris vai citi klienta pārvaldītie tīkla noteikumi.

  • Atļaujiet ienākošos savienojumus no pašreizējiem ChatGPT lietotņu izejošo savienojumu IP diapazoniem.

  • Konfigurējiet šo atļauto adrešu sarakstu 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.

  • Lai apietu tīkla bloķēšanu, nenomainiet klienta slepeno atslēgu un nemainiet OAuth tvērumus. Vispirms pārbaudiet, vai Databricks noraida lietotnes 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