Ovaj vodič namijenjen je administratorima ChatGPT radnog prostora i korisnicima planova ChatGPT Plus ili Pro koji postavljaju aplikaciju Databricks Genie pomoću ugrađenog OAuth protokola ili OAuth klijenta svoje organizacije.
Ugrađeni OAuth: Kada je dostupan u ChatGPT-u i omogućen za vaš Databricks radni prostor, koristite unaprijed konfiguriranu vezu. Ne morate kreirati OAuth aplikaciju niti unositi ID klijenta ili tajni ključ klijenta. Slijedite upute u odjeljku Ugrađeni OAuth u nastavku.
Prilagođeni OAuth klijent: Odaberite ovu opciju ako ugrađeni OAuth nije dostupan ili vaša organizacija zahtijeva vlastiti OAuth klijent. Slijedite upute u odjeljku Prilagođeni OAuth klijent u nastavku.
Šta postavljate
Kreirate vezu s aplikacijom Databricks za svoj ChatGPT račun ili radni prostor. Obje opcije zahtijevaju podatke o pružaocu usluge Databricks koje ChatGPT traži i dozvole za resurse koje planirate koristiti. Ako koristite prilagođeni OAuth klijent, pripremite i sljedeće:
Vezu s Databricks OAuth aplikacijom kreiranu u konzoli Databricks računa.
ID i tajni ključ Databricks OAuth klijenta.
Tačan URL povratnog poziva kopiran iz ChatGPT-a.
Databricks opsege koji odgovaraju funkcijama aplikacije koje želite omogućiti.
Sve podatke o pružaocu usluge Databricks koji se traže tokom postavljanja u ChatGPT-u, kao što su host radnog prostora, host računa, ID računa ili skladište.
Prije početka
Za postavljanje u radnom prostoru otvorite administratorsku konzolu, odaberite željeni ChatGPT radni prostor i otvorite Dodatke. Odaberite Upravljanje starijim aplikacijama da biste otvorili zadržanu stranicu Aplikacije. Za navigaciju kroz radni prostor i pristup starijim aplikacijama pogledajte Administratorske kontrole, sigurnost i usklađenost za dodatke i aplikacije.
Potrebno vam je sljedeće:
Pristup s ovlastima administratora ili vlasnika ChatGPT radnog prostora ili račun za ChatGPT Plus ili Pro.
Za prilagođeni OAuth klijent: pristup s ovlastima administratora Databricks računa. Administratorski pristup radnom prostoru može biti dovoljan za neke zadatke, ali prilagođene veze s aplikacijama konfiguriraju se u konzoli Databricks računa. Za ugrađeni OAuth administrator Databricksa mora provjeriti je li aplikacija ChatGPT dostupna i omogućena za vaš radni prostor.
Za prilagođeni OAuth klijent: konzola Databricks računa otvorena u zasebnoj kartici.
Za prilagođeni OAuth klijent: ekran za povezivanje s aplikacijom Databricks Genie otvoren u ChatGPT-u kako biste mogli kopirati tačan URL povratnog poziva.
Odluka o potrebnim funkcijama aplikacije: Genie i AI/BI kontrolne ploče, širi pristup Databricks API-jima ili aplikacija ograničena na Databricks SQL API-je. Pristup samo SQL-u nije dovoljan za radnje u servisu Genie ili na kontrolnim pločama.
Za prilagođeni OAuth klijent: sigurno mjesto za rukovanje tajnim ključem Databricks klijenta.
Ako vaš Databricks račun ili radni prostor ograničava pristup pomoću liste IP adresa za pristup, kontrole ulaznog saobraćaja zasnovane na kontekstu, zaštitnog zida ili drugih mrežnih pravila, potrebna je pomoć administratora Databricksa koji može dopustiti trenutne raspone izlaznih IP adresa ChatGPT aplikacija.
Za prilagođeni OAuth klijent kopirajte tačan URL povratnog poziva prikazan u ChatGPT-u.
Vrijednosti koje treba pripremiti
Za prilagođeni OAuth klijent, URL povratnog poziva: kopirajte ga iz postupka postavljanja aplikacije u ChatGPT-u.
Za prilagođeni OAuth klijent: ID Databricks OAuth klijenta.
Za prilagođeni OAuth klijent: tajni ključ Databricks OAuth klijenta.
Za prilagođeni OAuth klijent: Databricks opsezi pristupa koji odgovaraju funkcijama aplikacije. Za novu vezu za Genie ili kontrolne ploče koja prikazuje
ai-gateway,dashboardsioffline_access, pripremite te opsege. SVI API-ji (all-apisuzoffline_access) ostaju starija, šira alternativa. Koristite SQL samo za aplikaciju ograničenu na Databricks SQL API-je.Polja za Databricks radni prostor ili račun koja se traže tokom postavljanja u ChatGPT-u.
Ugrađeni OAuth
Prvo ispunite prethodno navedene preduslove. Koristite ovaj postupak samo kada je ugrađeni OAuth dostupan u ChatGPT-u i omogućen za vaš Databricks radni prostor.
Zamolite Databricks administratora da provjeri je li aplikacija ChatGPT dostupna u postavkama integracije aplikacija u konzoli računa i omogućena za vaš radni prostor. Ako aplikacija ChatGPT nije navedena u konzoli vašeg Databricks računa, obratite se predstavniku Databricksa zaduženom za vaš račun i pitajte je li ta funkcija dostupna za vaš račun.
U ChatGPT-u se prebacite na račun ili radni prostor u kojem aplikacija treba biti dostupna. Za lično podešavanje idite na Postavke > Dodaci, a za podešavanje radnog prostora, kao njegov administrator ili vlasnik, idite na Administratorska konzola > Dodaci.
Odaberite Databricks Genie, a zatim Dodaj vezu s aplikacijom.
Unesite Naziv hosta radnog prostora (obavezno) bez
https://ili URL putanje.ChatGPT iz ovog naziva hosta izvodi lokalnu Genie MCP krajnju tačku radnog prostora,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Zasebna regionalna MCP krajnja tačka nije potrebna.Odaberite Nastavi, zatim se prijavite u Databricks i pregledajte zahtjev za pristanak.
Nastavite s odjeljcima Povezivanje i testiranje i Upravljanje pristupom u nastavku, uključujući testove s ovlaštenim članovima i provjere pristupa radnom prostoru.
Prilagođeni OAuth klijent
Prvo ispunite prethodno navedene preduslove. Koristite ovaj način ako ugrađeni OAuth nije dostupan ili vaša organizacija zahtijeva vlastitog OAuth klijenta. Nakon postavljanja dovršite korake iz odjeljaka Povezivanje i testiranje te Upravljanje pristupom u nastavku.
Započnite prilagođeno podešavanje OAuth-a u ChatGPT-u
U ChatGPT-u se prebacite na račun ili radni prostor u kojem aplikacija treba biti dostupna.
Za lično podešavanje idite na Postavke > Dodaci, a za podešavanje radnog prostora, kao njegov administrator ili vlasnik, idite na Administratorska konzola > Dodaci.
U odjeljku Katalog odaberite Databricks Genie.
Odaberite Dodaj vezu s aplikacijom.
U dijaloškom okviru Povežite Databricks Genie pronađite polja ID OAuth klijenta i Tajni ključ OAuth klijenta. Unos vjerodajnica u ova vidljiva polja predstavlja postupak za prilagođeni klijent; nije potreban zaseban odabir.
Kopirajte URL povratnog poziva iz ChatGPT-a. Ostavite ovaj dijaloški okvir otvoren.
Primjer URL-a povratnog poziva:
https://chatgpt.com/connector/oauth/<callback_id>
Nemojte uklanjati ID povratnog poziva, dodavati kosu crtu na kraju niti zamjenjivati ovaj URL generičkim ChatGPT URL-om. URL registrovan u Databricksu mora se tačno podudarati s vrijednošću polja URL povratnog poziva prikazanom u ChatGPT-u.
Kreiranje prilagođene veze s OAuth aplikacijom u Databricksu
Otvorite konzolu računa za svoj Databricks račun.
Na lijevoj bočnoj traci otvorite Postavke.
Otvorite karticu Veze s aplikacijama.
Odaberite Dodaj vezu.
Unesite naziv aplikacije, naprimjer ChatGPT Databricks.
U polje URL-ovi za preusmjeravanje zalijepite tačan URL povratnog poziva kopiran iz ChatGPT-a.
U odjeljku Opsezi pristupa odaberite opsege potrebne aplikaciji.
Za novu vezu za Genie ili kontrolne ploče koja u ChatGPT-u prikazuje
ai-gateway,dashboardsioffline_access, dopustite te iste opsege u Databricks OAuth aplikaciji.SVI API-ji ostaju starija, šira alternativa za opći pristup Databricks API-jima. Za ovu konfiguraciju koristite
all-apisioffline_accessu ChatGPT-u te provjerite dopušta li Databricks OAuth aplikacija oba opsega. Za novu vezu za Genie ili kontrolne ploče dajte prednost prikazanim precizno definiranim opsezima.Koristite SQL samo za aplikaciju ograničenu na Databricks SQL API-je. Pristup samo SQL-u nije dovoljan za radnje u servisu Genie ili na kontrolnim pločama.
Provjerite je li svaki opseg koji se kasnije navede u ChatGPT-u omogućen u ovoj Databricks OAuth aplikaciji. Databricks automatski dopušta openid, email, profile i offline_access za aplikacije kreirane u korisničkom interfejsu.
Ostavite vrijeme važenja tokena (TTL) na zadanim vrijednostima Databricksa, osim ako vaša organizacija ima posebna pravila: 60 minuta za pristupni token i 10080 minuta za token za osvježavanje.
Uključite opciju Generiraj tajni ključ klijenta. Za ovaj postupak ChatGPT-u je potreban povjerljivi OAuth klijent.
Kreirajte vezu.
Kopiranje pristupnih podataka iz Databricksa
U dijaloškom okviru Veza je kreirana kopirajte ID klijenta.
Odmah kopirajte Tajni ključ klijenta i pohranite ga na sigurno mjesto.
Ako zatvorite dijaloški okvir prije nego što kopirate tajni ključ, kreirajte ili zamijenite pristupne podatke OAuth aplikacije i koristite novi tajni ključ.
Databricks prikazuje tajni ključ samo jednom. Postupajte s njim kao s pristupnim podatkom i nemojte ga uključivati u snimke ekrana, zahtjeve za podršku, komentare ili razgovore.
Dovršite prilagođeno podešavanje OAuth-a u ChatGPT-u
Vratite se u dijaloški okvir Povežite Databricks Genie.
Unesite ID Databricks klijenta u polje ID OAuth klijenta.
Unesite tajni ključ Databricks klijenta u polje Tajni ključ OAuth klijenta.
Unosom ovih vjerodajnica koristi se vaš prilagođeni OAuth klijent; nije potreban zaseban odabir.
U polje Opsezi pristupa (opcionalno) unesite opsege potrebne za Databricks krajnju tačku i mogućnosti vaše aplikacije. Uskladite ih s opsezima pristupa omogućenim u Databricks OAuth aplikaciji.
Za novu vezu s uslugom Genie/kontrolnim pločama koja prikazuje
ai-gateway,dashboardsioffline_accesszadržite te opsege pristupa. Provjerite dopušta li Databricks OAuth aplikacija iste opsege pristupa.ai-gatewayomogućava lokalnu Genie MCP vezu unutar radnog prostora,dashboardsomogućava radnje na AI/BI kontrolnim pločama, aoffline_accessomogućava tokene za osvježavanje.Starija, šira alternativa,
all-apisioffline_access, i dalje je podržana za širi pristup API-ju, ali se ne preporučuje za ovu vezu s uslugom Genie/kontrolnim pločama. Ako Databricks aplikacija dopušta samoall-apis, ažurirajte je ili ponovo kreirajte tako da dopuštaai-gateway,dashboardsioffline_access. Ako precizno definisani opsezi pristupa nisu dostupni, izričito postaviteall-apisioffline_accessu ChatGPT-u i provjerite dopušta li Databricks aplikacija oba. Nemojte tražiti ta tri precizno definisana opsega pristupa u ChatGPT-u dok Databricks aplikacija dopušta samoall-apis.Unesite po jedan opseg pristupa u svaki red ili ih razdvojite zarezima. Svaki opseg pristupa naveden u ChatGPT-u mora biti omogućen u Databricks OAuth aplikaciji.
Unesite Naziv hosta radnog prostora (obavezno) bez https:// ili URL putanje. Popunite sva ostala obavezna polja za pružaoca usluge Databricks prikazana tokom podešavanja.
ChatGPT iz ovog naziva hosta izvodi lokalnu Genie MCP krajnju tačku radnog prostora,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Zasebna regionalna MCP krajnja tačka nije potrebna.Odaberite Nastavi.
ChatGPT traži tačno one opsege pristupa koji su uneseni u polje Opsezi pristupa (opcionalno). Ne dodaje automatski šire opsege pristupa iz predloška.
Povezivanje i testiranje
Za obje OAuth opcije provedite sljedeće testove povezivanja i provjere pristupa.
Pregledajte detalje aplikacije, radnje i postavke autentifikacije.
Ako ste administrator radnog prostora, omogućite aplikaciju za radni prostor i odredite ko je može koristiti u skladu s pravilima radnog prostora.
Pokrenite postupak povezivanja iz ChatGPT-a kao testni korisnik s dozvoljenim pristupom, a zatim se prijavite u Databricks.
Provjerite otvara li preglednik očekivani Databricks račun ili radni prostor.
Pregledajte tražene opsege, a zatim odaberite Autoriziraj.
Provjerite vraća li se preglednik u ChatGPT i prikazuje li se aplikacija kao povezana.
Pokrenite radnju čitanja niskog rizika koja odgovara funkcijama veze. Za vezu sa servisom Genie pošaljite Genie zahtjev o podacima kojima testni korisnik smije pristupiti. Za druge podržane funkcije dohvatite podatke o trenutnom korisniku ili izvršite upit nad odobrenim Databricks SQL resursom. Provjerite ima li korisnik potrebne dozvole za Databricks resurse; sami OAuth opsezi ne daju pristup podacima.
Ako su radnje pisanja omogućene, prije šire primjene provedite test koristeći Databricks radni tok koji je očigledno niskog rizika.
Za postavljanje u radnom prostoru zamolite člana s dozvoljenim pristupom koji nije administrator da se poveže i ponovi test niskog rizika.
Upravljanje pristupom
I Databricks i ChatGPT učestvuju u kontroli pristupa.
U ChatGPT-u administratori radnog prostora određuju je li aplikacija dostupna i kako je članovi mogu koristiti. U planu Business administratori određuju je li aplikacija omogućena za cijeli radni prostor. Pregledajte administratorske kontrole za Databricks aplikacije (Postavke radnog prostora > Aplikacije ili Administratorska konzola > Dodaci > Upravljanje starijim aplikacijama) za:
Korisnički pristup, da odredite koje uloge u radnom prostoru mogu koristiti aplikaciju u podržanim Enterprise i Edu radnim prostorima.
Kontrolu radnji, da odredite koje su Databricks radnje omogućene.
Dozvole aplikacije, da odredite kada ChatGPT traži odobrenje članova prije korištenja aplikacije.
Ove dozvole aplikacije primjenjuju se na ChatGPT razgovore. Agenti radnog prostora koriste zasebne kontrole koje za svakog agenta postavlja njegov kreator kako bi odredio koje su radnje aplikacije dostupne i kada se od krajnjih korisnika traži da ih odobre. Za ponašanje agenata pogledajte: Agenti ChatGPT radnog prostora za Enterprise i Business.
U Databricksu administratori određuju koji korisnici mogu autorizirati OAuth aplikaciju i kojim Databricks resursima ti korisnici mogu pristupiti. Dozvole pružaoca usluge i dalje važe nakon što se aplikacija omogući u ChatGPT-u.
Za navigaciju kroz radni prostor, pristup aplikacijama i kontrole aplikacija specifične za pojedini plan pogledajte: Administratorske kontrole, sigurnost i usklađenost u aplikacijama.
Rješavanje problema pri postavljanju aplikacije Databricks
URI za preusmjeravanje se ne podudara: Ako koristite prilagođeni OAuth klijent, provjerite podudara li se vrijednost polja URL-ovi za preusmjeravanje u Databricksu tačno s vrijednošću polja URL povratnog poziva prikazanom u ChatGPT-u, uključujući putanju i ID povratnog poziva. Nemojte uklanjati ID povratnog poziva, dodavati kosu crtu na kraju niti koristiti neki drugi ChatGPT URL za preusmjeravanje.
Nedostaje tajni ključ: Ako koristite prilagođeni OAuth klijent, imajte na umu da se tajni ključevi u Databricksu prikazuju samo jednom. Generirajte novi tajni ključ klijenta ako prethodni nije kopiran.
OAuth aplikacija nije odmah dostupna: Prema navodima Databricksa, obrada ažuriranja OAuth aplikacija može potrajati do 30 minuta.
Nedovoljan ili neusklađen opseg pristupa: Ako koristite prilagođeni OAuth klijent, uporedite Opsege (opcionalno) u ChatGPT-u s Opsezima pristupa u Databricks OAuth aplikaciji. Svaki opseg koji ChatGPT zatraži mora tamo biti omogućen. Provjerite podržavaju li opsezi krajnju tačku i funkcije koje koristite.
Za novu vezu za Genie ili kontrolne ploče koja prikazuje
ai-gateway,dashboardsioffline_access, zadržite te opsege u ChatGPT-u i provjerite dopušta li Databricks aplikacija sva tri. Ako aplikacija dopušta samoall-apis, ažurirajte je ili ponovo kreirajte kako bi dopuštala ta tri precizno definirana opsega.Ako precizno definirani opsezi nisu dostupni, koristite podržanu širu alternativu: postavite ChatGPT na
all-apisioffline_accesste provjerite dopušta li Databricks aplikacija oba opsega. Aplikacija koja dopušta samoall-apisne odgovara ChatGPT zahtjevu za opsegeai-gateway,dashboardsioffline_access. Pristup samo SQL-u prikladan je jedino za aplikaciju ograničenu na Databricks SQL API-je; nije dovoljan za radnje u servisu Genie ili na kontrolnim pločama.SQL radnje ne uspijevaju: Za aplikaciju ograničenu na Databricks SQL API-je provjerite opseg SQL, konfiguraciju skladišta i dozvole u Databricksu.
Pogrešan ChatGPT radni prostor: Kreirajte i omogućite aplikaciju u istom ChatGPT radnom prostoru u kojem će je korisnici povezivati.
Pogrešan Databricks račun ili radni prostor: Provjerite vrijednost polja Naziv hosta radnog prostora (obavezno), zatim ponovite postupak prijave i provjerite otvara li Databricks očekivani račun ili radni prostor.
Korisnici se ne mogu povezati: Provjerite ima li korisnik pristup Databricksu i dozvolu za autorizaciju OAuth aplikacije. U planu Business provjerite je li aplikacija omogućena za cijeli radni prostor. U podržanim Enterprise i Edu radnim prostorima provjerite i dopušta li postavka Korisnički pristup u ChatGPT-u korištenje aplikacije.
Mrežna pravila Databricksa blokiraju aplikaciju: Ako Databricks dopušta samo određene izvorne IP adrese, administrator Databricksa mora ažurirati odgovarajuće liste IP adresa za pristup računu ili radnom prostoru, kontrole ulaznog saobraćaja zasnovane na kontekstu, zaštitni zid ili druga mrežna pravila kojima upravlja korisnička organizacija.
Dopustite dolazne veze iz trenutnih raspona izlaznih IP adresa ChatGPT aplikacija.
Konfigurirajte ovu listu dopuštenih adresa u Databricksu ili na mrežnom sloju kojim upravlja korisnička organizacija. Ona je odvojena od liste dopuštenih IP adresa ChatGPT radnog prostora.
Objavljeni rasponi mogu se promijeniti. Kad god je moguće, automatizirajte ažuriranja na osnovu JSON datoteke.
Nemojte mijenjati tajni ključ klijenta niti OAuth opsege da biste zaobišli mrežnu blokadu. Prvo provjerite odbija li Databricks izvorne IP adrese aplikacije.