Koristite ovaj vodič ako ste administrator radnog prostora u ChatGPT-u ili korisnik paketa ChatGPT Plus ili Pro koji postavlja konektor Databricks Genie pomoću ugrađenog OAuth-a ili OAuth klijenta svoje organizacije.
Ugrađeni OAuth: Kada je dostupan u ChatGPT-u i omogućen za vaš radni prostor u Databricksu, 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: Koristite ovaj način ako ugrađeni OAuth nije dostupan ili vaša organizacija zahtijeva vlastitog OAuth klijenta. Slijedite upute u odjeljku Prilagođeni OAuth klijent u nastavku.
Šta postavljate
Kreirate vezu s aplikacijom Databricks za svoj račun ili radni prostor u ChatGPT-u. Oba načina zahtijevaju podatke o pružaocu usluge Databricks koje ChatGPT traži i dozvole za resurse koje planirate koristiti. Ako koristite prilagođenog OAuth klijenta, pripremite i sljedeće:
Vezu s OAuth aplikacijom Databricks kreiranu u konzoli vašeg Databricks računa.
ID i tajni ključ OAuth klijenta iz Databricksa.
Tačan URL povratnog poziva kopiran iz ChatGPT-a.
Opsege pristupa u Databricksu koji odgovaraju funkcijama konektora koje želite omogućiti.
Sve podatke o pružaocu usluge Databricks koje ChatGPT traži tokom postavljanja, kao što su host radnog prostora, host računa, ID računa ili skladište.
Prije nego što počnete
Za podešavanje radnog prostora otvorite administratorsku konzolu, odaberite željeni ChatGPT radni prostor i otvorite Dodatke. Odaberite Upravljanje starim aplikacijama da otvorite zadržanu stranicu Aplikacije. Za navigaciju kroz radni prostor i pristup starim aplikacijama pogledajte Administratorske kontrole, sigurnost i usklađenost za dodatke i aplikacije.
Potrebno vam je:
Pristup s ovlaštenjima administratora ili vlasnika ChatGPT radnog prostora ili račun ChatGPT Plus ili Pro.
Za prilagođeni OAuth klijent: administratorski pristup Databricks računu. Administratorski pristup radnom prostoru može biti dovoljan za neke zadatke, ali prilagođene veze s aplikacijama podešavaju se u konzoli Databricks računa. Za ugrađeni OAuth, Databricks administrator 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 uslugom Databricks Genie otvoren u ChatGPT-u kako biste mogli kopirati tačan URL povratnog poziva.
Odluka o mogućnostima koje su aplikaciji potrebne: Genie i AI/BI kontrolne ploče, širi pristup Databricks API-ju ili aplikacija ograničena na Databricks SQL API-je. Pristup samo SQL-u nije dovoljan za radnje u usluzi 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 putem liste IP adresa za pristup, kontrole ulaznog saobraćaja zasnovane na kontekstu, zaštitnog zida ili drugog mrežnog pravila: pomoć Databricks administratora koji može dopustiti trenutne raspone izlaznih IP adresa ChatGPT konektora.
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 podešavanja konektora 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 mogućnostima aplikacije. Za novu vezu s uslugom Genie/kontrolnim pločama koja prikazuje
ai-gateway,dashboardsioffline_accesspripremite te opsege pristupa. SVI API-ji (all-apisuzoffline_access) ostaju starija, šira alternativa. Koristite SQL samo za aplikaciju ograničenu na Databricks SQL API-je.Polja Databricks radnog prostora ili računa koja se traže tokom podešavanja 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.
Kreirajte prilagođenu OAuth vezu s 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 konektor.
U polje URL-ovi za preusmjeravanje zalijepite tačan URL povratnog poziva kopiran iz ChatGPT-a.
U odjeljku Opsezi pristupa odaberite opsege koji su aplikaciji potrebni.
Za novu vezu s uslugom Genie/kontrolnim pločama koja u ChatGPT-u prikazuje
ai-gateway,dashboardsioffline_accessdopustite iste opsege pristupa u Databricks OAuth aplikaciji.SVI API-ji ostaju starija, šira alternativa za opći pristup Databricks API-ju. Za ovu konfiguraciju koristite
all-apisioffline_accessu ChatGPT-u i provjerite dopušta li Databricks OAuth aplikacija oba. Za novu vezu s uslugom Genie/kontrolnim pločama dajte prednost prikazanim precizno definisanim opsezima pristupa.Koristite SQL samo za aplikaciju ograničenu na Databricks SQL API-je. Pristup samo SQL-u nije dovoljan za radnje u usluzi Genie ili na kontrolnim pločama.
Provjerite je li svaki opseg pristupa koji kasnije navedete u ChatGPT-u omogućen u ovoj Databricks OAuth aplikaciji. Databricks automatski dopušta openid, email, profile i offline_access za aplikacije kreirane putem korisničkog interfejsa.
Ostavite vrijeme važenja tokena (TTL) na zadanim Databricks vrijednostima, osim ako vaša organizacija ima posebno pravilo: 60 minuta za pristupni token i 10080 minuta za token za osvježavanje.
Uključite Generiši tajni ključ klijenta. ChatGPT-u je za ovaj postupak potreban povjerljivi OAuth klijent.
Kreirajte vezu.
Kopirajte vjerodajnice 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 kopiranja tajnog ključa, kreirajte ili zamijenite vjerodajnice OAuth aplikacije i koristite novi tajni ključ.
Databricks prikazuje tajni ključ samo jednom. Postupajte s njim kao s vjerodajnicom 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
Obavite sljedeće testove povezivanja i provjere pristupa bez obzira na odabrani OAuth postupak.
Pregledajte detalje konektora, radnje i postavke autentifikacije.
Ako ste administrator radnog prostora, omogućite konektor za radni prostor i odredite ko ga može koristiti u skladu s pravilima radnog prostora.
Pokrenite postupak povezivanja iz ChatGPT-a kao ovlašteni testni korisnik, a zatim se prijavite u Databricks.
Provjerite otvara li preglednik očekivani Databricks račun ili radni prostor.
Pregledajte tražene opsege pristupa, a zatim odaberite Odobri pristup.
Provjerite vraća li se preglednik u ChatGPT i prikazuje li se konektor kao povezan.
Pokrenite radnju čitanja niskog rizika koja odgovara mogućnostima veze. Za vezu s uslugom Genie pošaljite Genie zahtjev o podacima kojima testni korisnik smije pristupiti. Za druge podržane mogućnosti dohvatite informacije o trenutnom korisniku ili pošaljite upit odobrenom Databricks SQL resursu. Provjerite ima li korisnik potrebne dozvole za Databricks resurse; sami OAuth opsezi pristupa ne daju pristup podacima.
Ako su omogućene radnje pisanja, prije šire primjene testirajte radni tok u Databricksu koji je očigledno niskog rizika.
Pri podešavanju radnog prostora zamolite ovlaštenog člana radnog prostora bez administratorskih ovlaštenja 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 paketu Business administratori određuju je li aplikacija omogućena u cijelom radnom prostoru. Pregledajte administratorske kontrole za aplikacije Databricks (Postavke radnog prostora > Aplikacije ili Administratorska konzola > Dodaci > Upravljanje starijim aplikacijama) za sljedeće:
Korisnički pristup, da biste odredili koje uloge u radnom prostoru mogu koristiti konektor u podržanim radnim prostorima Enterprise i Edu.
Kontrola radnji, da biste odredili koje su radnje u Databricksu omogućene.
Dozvole aplikacije, da biste odredili kada ChatGPT traži odobrenje članova prije korištenja konektora.
Ove dozvole aplikacije primjenjuju se na razgovore u ChatGPT-u. Agenti radnog prostora koriste kontrole koje njihov autor postavlja za svakog agenta pojedinačno 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 radnog prostora u ChatGPT-u za Enterprise i Business.
U Databricksu administratori određuju koji korisnici mogu autorizirati OAuth aplikaciju i kojim resursima u Databricksu ti korisnici mogu pristupiti. Dozvole pružaoca usluge i dalje važe nakon što se aplikacija omogući u ChatGPT-u.
Za navigaciju radnim prostorom, pristup aplikacijama i kontrole aplikacija specifične za pojedine pakete pogledajte: Administratorske kontrole, sigurnost i usklađenost u aplikacijama.
Rješavanje problema pri podešavanju Databricks konektora
Nepodudaranje URI-ja za preusmjeravanje: 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 unositi drugi ChatGPT URL za preusmjeravanje.
Nedostaje tajni ključ: Ako koristite prilagođeni OAuth klijent, imajte na umu da se Databricks tajni ključevi prikazuju samo jednom. Generišite novi tajni ključ klijenta ako ga niste kopirali.
OAuth aplikacija nije odmah dostupna: Databricks navodi da obrada ažuriranja OAuth aplikacije može potrajati do 30 minuta.
Nedovoljan ili neusklađen opseg pristupa: Ako koristite prilagođeni OAuth klijent, uporedite polje Opsezi pristupa (opcionalno) u ChatGPT-u s poljem Opsezi pristupa u Databricks OAuth aplikaciji. Svaki opseg pristupa koji ChatGPT traži mora tamo biti omogućen. Provjerite podržavaju li opsezi pristupa krajnju tačku i mogućnosti koje koristite.
Za novu vezu s uslugom Genie/kontrolnim pločama koja prikazuje
ai-gateway,dashboardsioffline_accesszadržite te opsege pristupa u ChatGPT-u i provjerite dopušta li Databricks aplikacija sva tri. Ako aplikacija dopušta samoall-apis, ažurirajte je ili ponovo kreirajte tako da dopušta ta tri precizno definisana opsega pristupa.Ako precizno definisani opsezi pristupa nisu dostupni, koristite podržanu širu alternativu: postavite
all-apisioffline_accessu ChatGPT-u i provjerite dopušta li Databricks aplikacija oba. 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 usluzi Genie ili na kontrolnim pločama.SQL radnje ne uspijevaju: Za aplikaciju ograničenu na Databricks SQL API-je provjerite opseg pristupa SQL, konfiguraciju skladišta podataka i dozvole u Databricksu.
Pogrešan ChatGPT radni prostor: Kreirajte i omogućite konektor u istom ChatGPT radnom prostoru u kojem će ga 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 smije li odobriti pristup OAuth aplikaciji. U planu Business provjerite je li aplikacija omogućena za cijeli radni prostor. U podržanim Enterprise i Edu radnim prostorima također provjerite dopušta li postavka Korisnički pristup u ChatGPT-u upotrebu konektora.
Mrežna pravila Databricksa blokiraju konektor: Ako Databricks dopušta samo određene izvorne IP adrese, Databricks administrator 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 pod kontrolom korisničke organizacije.
Dopustite dolazne veze iz trenutnih raspona izlaznih IP adresa ChatGPT konektora.
Podesite ovu listu dopuštenih adresa u Databricksu ili na mrežnom sloju pod kontrolom korisničke organizacije. Ona je odvojena od liste dopuštenih IP adresa ChatGPT radnog prostora.
Objavljeni rasponi mogu se mijenjati. Automatizirajte ažuriranja iz JSON-a kada je to moguće.
Nemojte zamjenjivati tajni ključ klijenta niti mijenjati OAuth opsege pristupa da biste zaobišli mrežnu blokadu. Prvo provjerite odbija li Databricks izvorne IP adrese konektora.