Ovaj je vodič namijenjen administratorima radnog prostora u ChatGPT-u i korisnicima pretplate ChatGPT Plus ili Pro koji postavljaju aplikaciju Databricks Genie pomoću ugrađenog otvorenog ovlaštenja ili klijenta za otvoreno ovlaštenje svoje organizacije.
Ugrađeno otvoreno ovlaštenje: Ako je dostupno u ChatGPT-u i omogućeno za vaš radni prostor u Databricksu, upotrijebite unaprijed konfiguriranu vezu. Ne morate izrađivati aplikaciju za otvoreno ovlaštenje ni unositi ID ili tajnu klijenta. Slijedite upute u odjeljku Ugrađeno otvoreno ovlaštenje u nastavku.
Prilagođeni klijent za otvoreno ovlaštenje: Odaberite ovaj način ako ugrađeno otvoreno ovlaštenje nije dostupno ili vaša organizacija zahtijeva vlastiti klijent za otvoreno ovlaštenje. Slijedite upute u odjeljku Prilagođeni klijent za otvoreno ovlaštenje u nastavku.
Što postavljate
Izrađujete vezu s aplikacijom Databricks za svoj račun ili radni prostor u ChatGPT-u. Za oba načina potrebni su podaci o pružatelju usluge Databricks koje ChatGPT traži te dozvole za resurse koje planirate upotrebljavati. Ako upotrebljavate prilagođeni klijent za otvoreno ovlaštenje, pripremite i sljedeće:
Vezu s aplikacijom za otvoreno ovlaštenje u Databricksu, izrađenu u konzoli računa Databricks.
ID i tajnu klijenta za otvoreno ovlaštenje u Databricksu.
Točan URL povratnog poziva kopiran iz ChatGPT-a.
Opsege u Databricksu koji odgovaraju mogućnostima aplikacije koje želite omogućiti.
Sve podatke o pružatelju usluge Databricks koji se traže tijekom postavljanja u ChatGPT-u, kao što su glavno računalo radnog prostora, glavno računalo računa, ID računa ili skladište.
Prije početka
Za postavljanje u radnom prostoru otvorite administratorsku konzolu, odaberite željeni radni prostor u ChatGPT-u i otvorite Dodatke. Odaberite Upravljanje naslijeđenim aplikacijama da biste otvorili zadržanu stranicu Aplikacije. Upute za navigaciju radnim prostorom i pristup naslijeđenim aplikacijama potražite u članku Administratorske kontrole, sigurnost i usklađenost za dodatke i aplikacije.
Potrebno vam je sljedeće:
Pristup s pravima administratora ili vlasnika radnog prostora u ChatGPT-u ili račun s pretplatom ChatGPT Plus ili Pro.
Za prilagođeni klijent za otvoreno ovlaštenje: administratorski pristup računu Databricks. Administratorski pristup radnom prostoru može biti dovoljan za neke zadatke, ali prilagođene veze s aplikacijama konfiguriraju se u konzoli računa Databricks. Za ugrađeno otvoreno ovlaštenje administrator Databricksa mora provjeriti je li aplikacija ChatGPT dostupna i omogućena za vaš radni prostor.
Za prilagođeni klijent za otvoreno ovlaštenje: konzola računa Databricks otvorena u zasebnoj kartici.
Za prilagođeni klijent za otvoreno ovlaštenje: zaslon za povezivanje s aplikacijom Databricks Genie otvoren u ChatGPT-u kako biste mogli kopirati točan URL povratnog poziva.
Odluka o mogućnostima koje aplikacija treba: Genie i AI/BI nadzorne ploče, širi pristup API-jima Databricksa ili aplikacija ograničena na API-je Databricks SQL-a. Pristup samo SQL-u nije dovoljan za radnje u servisu Genie ili na nadzornim pločama.
Za prilagođeni klijent za otvoreno ovlaštenje: sigurno mjesto za rukovanje tajnom klijenta Databricks.
Ako vaš račun ili radni prostor u Databricksu ograničava pristup putem popisa IP adresa za pristup, kontrole ulaznog prometa temeljene na kontekstu, vatrozida ili drugog mrežnog pravila, potrebna je pomoć administratora Databricksa koji može dopustiti trenutačne raspone izlaznih IP adresa aplikacija u ChatGPT-u.
Za prilagođeni klijent za otvoreno ovlaštenje kopirajte točan URL povratnog poziva prikazan u ChatGPT-u.
Vrijednosti koje trebate pripremiti
Za prilagođeni klijent za otvoreno ovlaštenje, URL povratnog poziva: kopirajte ga tijekom postupka postavljanja aplikacije u ChatGPT-u.
Za prilagođeni klijent za otvoreno ovlaštenje: ID klijenta za otvoreno ovlaštenje u Databricksu.
Za prilagođeni klijent za otvoreno ovlaštenje: tajna klijenta za otvoreno ovlaštenje u Databricksu.
Za prilagođeni klijent za otvoreno ovlaštenje: opsezi pristupa u Databricksu koji odgovaraju mogućnostima aplikacije. Za novu vezu za Genie ili nadzorne ploče koja prikazuje
ai-gateway,dashboardsioffline_access, pripremite te opsege. SVI API-ji (all-apisuzoffline_access) i dalje su starija, šira alternativa. Upotrijebite SQL samo za aplikaciju ograničenu na API-je Databricks SQL-a.Polja radnog prostora ili računa Databricks koja se traže tijekom postavljanja u ChatGPT-u.
Ugrađeno otvoreno ovlaštenje
Najprije ispunite prethodno navedene preduvjete. Ovaj postupak upotrijebite samo ako je ugrađeno otvoreno ovlaštenje dostupno u ChatGPT-u i omogućeno za vaš radni prostor u Databricksu.
Zamolite administratora Databricksa 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 računa za Databricks, obratite se predstavniku Databricksa zaduženom za vaš račun i pitajte je li značajka dostupna za vaš račun.
U ChatGPT-u prijeđite na račun ili radni prostor u kojem aplikacija treba biti dostupna. Za osobno postavljanje otvorite Postavke > Dodaci, a za postavljanje radnog prostora kao njegov administrator ili vlasnik otvorite Administratorska konzola > Dodaci.
Odaberite Databricks Genie, a zatim Dodaj vezu s aplikacijom.
Unesite Naziv glavnog računala radnog prostora (obavezno) bez
https://ili putanje URL-a.ChatGPT iz tog naziva glavnog računala izvodi krajnju točku Genie MCP-a unutar radnog prostora:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Nije potrebna zasebna regionalna krajnja točka MCP-a.Odaberite Nastavi, zatim se prijavite u Databricks i pregledajte zahtjev za pristanak.
Nastavite s odjeljcima Povezivanje i testiranje te Upravljanje pristupom u nastavku, uključujući testove s članovima kojima je dopušten pristup i provjere pristupa radnom prostoru.
Prilagođeni klijent za otvoreno ovlaštenje
Najprije ispunite prethodno navedene preduvjete. Odaberite ovu mogućnost ako ugrađeno otvoreno ovlaštenje nije dostupno ili vaša organizacija zahtijeva vlastitog klijenta za otvoreno ovlaštenje. Nakon postavljanja provedite korake iz odjeljaka „Povezivanje i testiranje” i „Upravljanje pristupom” u nastavku.
Započnite postavljanje prilagođenog otvorenog ovlaštenja u ChatGPT-u
U ChatGPT-u prijeđite na račun ili radni prostor u kojem aplikacija treba biti dostupna.
Za osobno postavljanje otvorite Postavke > Dodaci, a za postavljanje radnog prostora kao njegov administrator ili vlasnik otvorite Administratorska konzola > Dodaci.
U odjeljku Imenik odaberite Databricks Genie.
Odaberite Dodaj vezu s aplikacijom.
U dijaloškom okviru Poveži Databricks Genie pronađite polja ID klijenta za otvoreno ovlaštenje i Tajni ključ klijenta za otvoreno ovlaštenje. Unos vjerodajnica u ta vidljiva polja postupak je za prilagođeni klijent; nije ga potrebno zasebno odabrati.
Kopirajte URL povratnog poziva iz ChatGPT-a. Ostavite taj dijaloški okvir otvoren.
Primjer URL-a povratnog poziva:
https://chatgpt.com/connector/oauth/<callback_id>
Nemojte uklanjati ID povratnog poziva, dodavati završnu kosu crtu ni zamjenjivati URL generičkim URL-om ChatGPT-a. URL registriran u Databricksu mora se točno podudarati s vrijednošću URL povratnog poziva prikazanom u ChatGPT-u.
Izrada prilagođene veze s aplikacijom za otvoreno ovlaštenje u Databricksu
Otvorite konzolu računa Databricks za svoj račun Databricks.
Na lijevoj bočnoj traci otvorite Postavke.
Otvorite karticu Veze s aplikacijama.
Odaberite Dodaj vezu.
Unesite naziv aplikacije, primjerice ChatGPT Databricks.
U polje URL-ovi za preusmjeravanje zalijepite točan URL povratnog poziva kopiran iz ChatGPT-a.
U odjeljku Opsezi pristupa odaberite opsege potrebne aplikaciji.
Za novu vezu za Genie ili nadzorne ploče koja u ChatGPT-u prikazuje
ai-gateway,dashboardsioffline_access, dopustite iste opsege u aplikaciji za otvoreno ovlaštenje u Databricksu.SVI API-ji i dalje su starija, šira alternativa za opći pristup API-jima Databricksa. Za tu konfiguraciju u ChatGPT-u upotrijebite
all-apisioffline_accesste provjerite dopušta li aplikacija za otvoreno ovlaštenje u Databricksu oba opsega. Za novu vezu za Genie ili nadzorne ploče dajte prednost prikazanim preciznijim opsezima.Upotrijebite SQL samo za aplikaciju ograničenu na API-je Databricks SQL-a. Pristup samo SQL-u nije dovoljan za radnje u servisu Genie ili na nadzornim pločama.
Provjerite je li u ovoj aplikaciji za otvoreno ovlaštenje u Databricksu omogućen svaki opseg koji će kasnije biti naveden u ChatGPT-u. Databricks automatski dopušta openid, email, profile i offline_access za aplikacije izrađene u korisničkom sučelju.
Zadržite zadana vremena valjanosti tokena (TTL) u Databricksu, osim ako vaša organizacija ima posebno pravilo: 60 minuta za pristupni token i 10080 minuta za token za osvježavanje.
Uključite opciju Generiraj tajnu klijenta. Za ovaj postupak ChatGPT treba povjerljivi klijent za otvoreno ovlaštenje.
Izradite vezu.
Kopiranje vjerodajnica iz Databricksa
U dijaloškom okviru Veza je izrađena kopirajte ID klijenta.
Odmah kopirajte Tajnu klijenta i pohranite je na sigurno mjesto.
Ako zatvorite dijaloški okvir prije nego što kopirate tajnu, izradite ili zamijenite vjerodajnice aplikacije za otvoreno ovlaštenje i upotrijebite novu tajnu.
Databricks prikazuje tajnu samo jednom. Postupajte s njom kao s vjerodajnicom i nemojte je uključivati u snimke zaslona, zahtjeve za podršku, komentare ni razgovore.
Dovršite postavljanje prilagođenog otvorenog ovlaštenja u ChatGPT-u
Vratite se u dijaloški okvir Poveži Databricks Genie.
Unesite ID klijenta iz Databricksa u polje ID klijenta za otvoreno ovlaštenje.
Unesite tajni ključ klijenta iz Databricksa u polje Tajni ključ klijenta za otvoreno ovlaštenje.
Unosom tih vjerodajnica upotrebljavate svoj prilagođeni klijent za otvoreno ovlaštenje; nije ga potrebno zasebno odabrati.
U polje Opsezi (neobavezno) unesite opsege potrebne za krajnju točku Databricksa i mogućnosti vaše aplikacije. Uskladite ih s opsezima omogućenima u aplikaciji za otvoreno ovlaštenje u Databricksu.
Za novu vezu za Genie / nadzorne ploče koja prikazuje
ai-gateway,dashboardsioffline_accesszadržite te opsege. Provjerite dopušta li aplikacija za otvoreno ovlaštenje u Databricksu iste opsege.ai-gatewayomogućuje vezu s Genie MCP-om unutar radnog prostora,dashboardsomogućuje radnje na AI/BI nadzornim pločama, aoffline_accessomogućuje tokene za osvježavanje.Starija alternativa sa širim opsegom,
all-apisioffline_access, i dalje je podržana za širi pristup API-ju, ali nije preporučena za ovu vezu za Genie / nadzorne ploče. Ako aplikacija u Databricksu dopušta samoall-apis, ažurirajte je ili ponovno izradite kako bi dopuštalaai-gateway,dashboardsioffline_access. Ako precizniji opsezi nisu dostupni, izričito postavite ChatGPT naall-apisioffline_accesste provjerite dopušta li aplikacija u Databricksu oba opsega. Nemojte tražiti ta tri preciznija opsega u ChatGPT-u ako aplikacija u Databricksu dopušta samoall-apis.Unesite svaki opseg u zaseban redak ili ih odvojite zarezima. Svaki opseg naveden u ChatGPT-u mora biti omogućen u aplikaciji za otvoreno ovlaštenje u Databricksu.
Unesite Naziv glavnog računala radnog prostora (obavezno) bez https:// ili putanje URL-a. Ispunite sva ostala obavezna polja za davatelja Databricks prikazana tijekom postavljanja.
ChatGPT iz tog naziva glavnog računala izvodi krajnju točku Genie MCP-a unutar radnog prostora:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Nije potrebna zasebna regionalna krajnja točka MCP-a.Odaberite Nastavi.
ChatGPT traži točno one opsege koji su uneseni u polje Opsezi (neobavezno). Ne dodaje automatski šire opsege iz predloška.
Povezivanje i testiranje
Neovisno o odabranom načinu otvorenog ovlaštenja, provedite sljedeće testove veze i provjere pristupa.
Pregledajte pojedinosti aplikacije, radnje i postavke autentifikacije.
Ako ste administrator radnog prostora, omogućite aplikaciju za radni prostor i odredite tko je može upotrebljavati u skladu s pravilima radnog prostora.
Kao testni korisnik s dopuštenim pristupom pokrenite postupak povezivanja iz ChatGPT-a, a zatim se prijavite u Databricks.
Provjerite otvara li preglednik očekivani račun ili radni prostor u Databricksu.
Pregledajte zatražene opsege, a zatim odaberite Autoriziraj.
Provjerite vraća li se preglednik u ChatGPT i prikazuje li se aplikacija kao povezana.
Pokrenite niskorizičnu radnju čitanja koja odgovara mogućnostima veze. Za vezu sa servisom Genie pošaljite zahtjev tom servisu za podatke kojima testni korisnik smije pristupiti. Za druge podržane mogućnosti dohvatite podatke o trenutačnom korisniku ili pošaljite upit odobrenom resursu Databricks SQL-a. Provjerite ima li korisnik potrebne dozvole za resurse u Databricksu; sami opsezi otvorenog ovlaštenja ne daju pristup podacima.
Ako su omogućene radnje pisanja, prije šireg uvođenja provedite test s radnim procesom u Databricksu za koji je jasno da je niskorizičan.
Pri postavljanju u radnom prostoru zamolite člana s dopuštenim pristupom, ali bez administratorskih prava, da se poveže i ponovi niskorizični test.
Upravljanje pristupom
U kontroli pristupa sudjeluju i Databricks i ChatGPT.
U ChatGPT-u administratori radnog prostora određuju je li aplikacija dostupna i kako je članovi mogu upotrebljavati. U planu Business administratori određuju je li aplikacija omogućena u cijelom radnom prostoru. U administratorskim kontrolama za aplikacije Databricks (Postavke radnog prostora > Aplikacije ili Administratorska konzola > Dodaci > Upravljanje naslijeđenim aplikacijama) pregledajte sljedeće:
Korisnički pristup, za određivanje uloga koje mogu upotrebljavati aplikaciju u podržanim radnim prostorima Enterprise i Edu.
Kontrola radnji, za određivanje radnji u Databricksu koje su omogućene.
Dozvole aplikacije, za određivanje kada ChatGPT traži odobrenje članova prije upotrebe aplikacije.
Te dozvole aplikacije primjenjuju se na razgovore u ChatGPT-u. Agenti radnog prostora upotrebljavaju pojedinačne kontrole koje postavlja autor agenta kako bi odredio koje su radnje aplikacije dostupne i kada se od krajnjih korisnika traži njihovo odobrenje. Informacije o ponašanju agenata potražite u članku Agenti radnog prostora u ChatGPT-u za Enterprise i Business.
U Databricksu administratori određuju koji korisnici mogu autorizirati aplikaciju za otvoreno ovlaštenje i kojim resursima Databricksa ti korisnici mogu pristupiti. Dozvole pružatelja usluge vrijede i nakon što se aplikacija omogući u ChatGPT-u.
Informacije o navigaciji radnim prostorom, pristupu aplikacijama i kontrolama aplikacija za pojedine planove potražite u članku Administratorske kontrole, sigurnost i usklađenost u aplikacijama.
Rješavanje problema pri postavljanju aplikacije Databricks
Nepodudaranje URI-ja za preusmjeravanje: Ako upotrebljavate prilagođeni klijent za otvoreno ovlaštenje, provjerite podudara li se vrijednost polja URL-ovi za preusmjeravanje u Databricksu toč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 ni unositi drugi URL za preusmjeravanje u ChatGPT.
Nedostaje tajna: Ako upotrebljavate prilagođeni klijent za otvoreno ovlaštenje, imajte na umu da se tajne u Databricksu prikazuju samo jednom. Generirajte novu tajnu klijenta ako prethodna nije kopirana.
Aplikacija za otvoreno ovlaštenje nije odmah dostupna: Prema Databricksu, obrada ažuriranja aplikacija za otvoreno ovlaštenje može potrajati do 30 minuta.
Nedostatan ili nepodudaran opseg: Ako upotrebljavate prilagođeni klijent za otvoreno ovlaštenje, usporedite Opsege (neobavezno) u ChatGPT-u s Opsezima pristupa u aplikaciji za otvoreno ovlaštenje u Databricksu. Ondje mora biti omogućen svaki opseg koji ChatGPT zatraži. Provjerite podržavaju li opsezi krajnju točku i mogućnosti koje upotrebljavate.
Za novu vezu za Genie ili nadzorne ploče koja prikazuje
ai-gateway,dashboardsioffline_access, zadržite te opsege u ChatGPT-u i provjerite dopušta li aplikacija Databricks sva tri. Ako aplikacija dopušta samoall-apis, ažurirajte je ili ponovno izradite tako da dopušta ta tri preciznija opsega.Ako precizniji opsezi nisu dostupni, upotrijebite podržanu širu alternativu: u ChatGPT-u postavite
all-apisioffline_accesste provjerite dopušta li aplikacija Databricks oba opsega. Aplikacija koja dopušta samoall-apisne odgovara zahtjevu ChatGPT-a za opsegeai-gateway,dashboardsioffline_access. Pristup samo SQL-u prikladan je isključivo za aplikaciju ograničenu na API-je Databricks SQL-a; nije dovoljan za radnje u servisu Genie ili na nadzornim pločama.SQL radnje ne uspijevaju: Za aplikaciju ograničenu na API-je Databricks SQL-a provjerite opseg SQL, konfiguraciju skladišta i dozvole u Databricksu.
Pogrešan radni prostor u ChatGPT-u: Izradite i omogućite aplikaciju u istom radnom prostoru u ChatGPT-u u kojem će je korisnici povezivati.
Pogrešan račun ili radni prostor u Databricksu: Provjerite vrijednost polja Naziv glavnog računala 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 smije li autorizirati aplikaciju za otvoreno ovlaštenje. U planu Business provjerite je li aplikacija omogućena u cijelom radnom prostoru. U podržanim radnim prostorima Enterprise i Edu provjerite i dopušta li postavka Korisnički pristup u ChatGPT-u upotrebu aplikacije.
Mrežno pravilo Databricksa blokira aplikaciju: Ako Databricks dopušta samo određene izvorišne IP adrese, administrator Databricksa mora ažurirati odgovarajuće popise IP adresa za pristup računu ili radnom prostoru, kontrole ulaznog prometa temeljene na kontekstu, vatrozid ili druga mrežna pravila kojima upravlja klijent.
Dopustite dolazne veze iz trenutačnih raspona izlaznih IP adresa aplikacija u ChatGPT-u.
Taj popis dopuštenih adresa konfigurirajte u Databricksu ili u mrežnom sloju kojim upravlja klijent. To je odvojeno od popisa dopuštenih IP adresa radnog prostora u ChatGPT-u.
Objavljeni rasponi mogu se promijeniti. Kad je moguće, automatizirajte ažuriranja na temelju JSON-a.
Nemojte zamjenjivati tajnu klijenta ni mijenjati opsege otvorenog ovlaštenja kako biste zaobišli mrežnu blokadu. Najprije provjerite odbija li Databricks izvorišne IP adrese aplikacije.