Koristite ovaj vodič ako ste administrator ChatGPT radnog prostora ili korisnik paketa ChatGPT Plus ili ChatGPT Pro i postavljate konektor Databricks Genie pomoću Databricks OAuth klijenta svoje organizacije.
Većina postavljanja za Databricks obavlja se u konzoli Databricks Account Console. Izradite prilagođenu vezu OAuth aplikacije, registrirajte URL za povratni poziv iz ChatGPT-a, kopirajte generirane klijentske vjerodajnice, a zatim unesite te vrijednosti tokom postavljanja konektora u ChatGPT-u.
Šta postavljate
Izrađujete vezu aplikacije Databricks za svoj ChatGPT račun ili radni prostor. Veza koristi:
Vezu Databricks OAuth aplikacije izrađenu u vašoj konzoli Databricks Account Console.
ID Databricks OAuth klijenta i tajnu klijenta.
Tačan URL za povratni poziv kopiran iz ChatGPT-a.
Databricks opsege pristupa koji odgovaraju funkcijama konektora koje želite omogućiti.
Sve podatke o pružatelju Databricks koje zatraži postupak postavljanja u ChatGPT-u, kao što su host radnog prostora, host računa, ID računa ili SQL skladište.
Prije nego što počnete
Potrebno vam je:
Administratorski ili vlasnički pristup ChatGPT radnom prostoru ili račun ChatGPT Plus ili ChatGPT Pro.
Administratorski pristup Databricks računu. Za neke zadatke može biti dovoljan administratorski pristup radnom prostoru, ali prilagođene veze aplikacija konfiguriraju se u konzoli Databricks Account Console.
Konzola Databricks Account Console otvorena u zasebnoj kartici.
Ekran za povezivanje s Databricks Genie otvoren u ChatGPT-u kako biste mogli kopirati tačan URL za povratni poziv.
Odluka o tome treba li aplikaciji opći pristup Databricks API-jima ili samo pristup usluzi Databricks SQL.
Sigurno mjesto za rukovanje tajnom Databricks klijenta.
Ako vaš Databricks račun ili radni prostor ograničava pristup pomoću liste dozvoljenih IP adresa, kontrole dolaznog saobraćaja zasnovane na kontekstu, vatrozida ili drugog mrežnog pravila, zatražite pomoć Databricks administratora koji može dozvoliti trenutne raspone izlaznih IP adresa ChatGPT konektora.
Napomena: morate kopirati tačan URL za povratni poziv prikazan u ChatGPT-u.
Vrijednosti koje trebate pripremiti
URL za povratni poziv: kopirajte ga tokom postavljanja konektora u ChatGPT-u.
ID Databricks OAuth klijenta.
Tajna Databricks OAuth klijenta.
Databricks opsezi pristupa, kao što su SVI API-JI ili SQL.
Polja Databricks radnog prostora ili računa koja zatraži postupak postavljanja u ChatGPT-u.
Pokrenite postavljanje aplikacije u ChatGPT-u
U ChatGPT-u se prebacite na račun ili radni prostor u kojem aplikacija treba biti dostupna.
Kao administrator ili vlasnik radnog prostora otvorite Postavke radnog prostora > Dodaci.
Odaberite Databricks Genie u Direktoriju.
Odaberite Dodaj vezu aplikacije.
U dijaloškom okviru Poveži Databricks Genie pronađite odjeljak za OAuth klijenta.
URL za povratni poziv iz ChatGPT-a. Ostavite ovaj dijaloški okvir otvoren.
Primjer URL-a za povratni poziv:
https://chatgpt.com/connector/oauth/<callback_id>
Nemojte uklanjati ID povratnog poziva, dodavati kosu crtu na kraj niti ga zamijeniti generičkim ChatGPT URL-om. URL registriran u Databricksu mora se potpuno podudarati s URL-om za povratni poziv prikazanim u ChatGPT-u.
Izradite vezu OAuth aplikacije u Databricksu
Otvorite konzolu Databricks Account Console za svoj Databricks račun.
Na liječnoj bočnoj traci otvorite Postavke.
Otvorite karticu Veze aplikacija.
Odaberite Dodaj vezu.
Unesite naziv aplikacije, na primjer ChatGPT Databricks Connector.
U polje URL-ovi za preusmjeravanje zalijepite tačan URL za povratni poziv kopiran iz ChatGPT-a.
U odjeljku Opsezi pristupa odaberite opsege koji su potrebni aplikaciji.
Koristite SVE API-JE za opću Databricks aplikaciju kojoj su osim SQL-a potrebni i drugi Databricks API-ji.
Koristite samo SQL za aplikaciju ograničenu na Databricks SQL API-je.
Provjerite je li svaki opseg pristupa koji kasnije navedete u ChatGPT-u omogućen u ovoj Databricks OAuth aplikaciji. Databricks automatski dozvoljava openid, email, profile i offline_access za aplikacije izrađene u korisničkom interfejsu.
Ostavite TTL vrijednosti tokena na zadanim Databricks postavkama, osim ako vaša organizacija nema posebno pravilo: 60 minuta za pristupni token i 10.080 minuta za token za osvježavanje.
Uključite Generiraj tajnu klijenta. ChatGPT za ovaj postupak zahtijeva povjerljivog OAuth klijenta.
Izradite vezu.
Kopirajte vjerodajnice 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 kopiranja tajne, izradite ili rotirajte vjerodajnice OAuth aplikacije i upotrijebite novu tajnu.
Databricks prikazuje tajnu samo jednom. Postupajte s njom kao s vjerodajnicom i nemojte je uključivati u snimke ekrana, zahtjeve za podršku, komentare ili razgovore.
Dovršite postavljanje u ChatGPT-u
Vratite se u dijaloški okvir Poveži Databricks Genie.
Unesite ID Databricks klijenta u polje ID OAuth klijenta.
Unesite tajnu Databricks klijenta u polje Tajna OAuth klijenta.
U polju Opsezi pristupa (neobavezno) zadržite all-apis i offline_access za opći pristup API-jima.
Unesite po jedan opseg pristupa u svaki red ili ih odvojite zarezima. Svaki opseg pristupa naveden u ChatGPT-u mora biti omogućen u Databricks OAuth aplikaciji.
Unesite Naziv hosta radnog prostora (obavezno) bez prefiksa https:// i putanje URL-a. Popunite sva druga obavezna polja pružatelja Databricks prikazana tokom postavljanja.
Odaberite Nastavi.
ChatGPT traži tačno one opsege pristupa koji su uneseni u polje Opsezi pristupa (neobavezno). Ne dodaje automatski šire opsege pristupa iz predloška.
Povežite i testirajte
Pregledajte podatke o konektoru, radnje i postavke provjere autentičnosti.
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 povezivanje iz ChatGPT-a kao ovlašteni testni korisnik, a zatim se prijavite u Databricks.
Potvrdite da preglednik otvara očekivani Databricks račun ili radni prostor.
Pregledajte zatražene opsege pristupa, a zatim odaberite Odobri.
Provjerite vraća li se preglednik u ChatGPT i prikazuje li se konektor kao povezan.
Prvo pokrenite radnju čitanja niskog rizika, kao što je dohvaćanje podataka o trenutnom korisniku ili slanje upita odobrenom Databricks SQL resursu.
Ako su omogućene radnje pisanja, prije šireg uvođenja testirajte ih pomoću Databricks radnog procesa koji je očigledno niskog rizika.
Ako postavljate radni prostor, zamolite ovlaštenog člana koji nije administrator da se poveže i ponovi test niskog rizika.
Upravljajte 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. Pregledajte administratorske kontrole za Databricks aplikacije (Postavke radnog prostora > Aplikacije) za:
Korisnički pristup, da biste odredili koje uloge u radnom prostoru mogu koristiti konektor.
Kontrolu radnji, da biste odredili koje su Databricks radnje omogućene.
Dozvole aplikacije, da biste odredili kada ChatGPT traži dopuštenje članova prije korištenja konektora.
Ove dozvole aplikacije primjenjuju se na razgovore u ChatGPT-u. Agenti radnog prostora koriste kontrole koje je autor postavio za svakog agenta kako bi odredili koje su radnje aplikacije dostupne i kada se od krajnjih korisnika traži da ih odobre. Više o ponašanju agenata potražite u članku: Agenti ChatGPT radnog prostora za Enterprise i Business.
U Databricksu administratori određuju koji korisnici mogu odobriti OAuth aplikaciju i kojim Databricks resursima mogu pristupiti. Dozvole pružatelja i dalje se primjenjuju nakon što se aplikacija omogući u ChatGPT-u.
Rješavanje problema pri postavljanju Databricks konektora
URI za preusmjeravanje se ne podudara: Provjerite podudara li se Databricks vrijednost URL-ovi za preusmjeravanje tačno s URL-om za povratni poziv prikazanim u ChatGPT-u, uključujući putanju i ID povratnog poziva. Nemojte uklanjati ID povratnog poziva, dodavati kosu crtu na kraj niti koristiti drugi ChatGPT URL za preusmjeravanje.
Tajna nedostaje: Databricks tajne prikazuju se samo jednom. Generirajte novu tajnu klijenta ako prethodna nije kopirana.
OAuth aplikacija nije odmah dostupna: Prema navodima Databricksa, obrada ažuriranja OAuth aplikacije može trajati do 30 minuta.
Nedovoljan ili neodgovarajući opseg pristupa: Uporedite Opsege pristupa (neobavezno) u ChatGPT-u s Opsezima pristupa u Databricks OAuth aplikaciji. Ondje mora biti omogućen svaki opseg pristupa koji ChatGPT zatraži. Za API-je koji nisu SQL provjerite je li all-apis omogućen u Databricksu i nalazi li se i dalje na listi opsega pristupa u ChatGPT-u.
SQL radnje ne uspijevaju: Provjerite opseg pristupa SQL, konfiguraciju SQL skladišta i Databricks dozvole.
Pogrešan ChatGPT radni prostor: Izradite i omogućite konektor u istom ChatGPT radnom prostoru u kojem će ga korisnici povezati.
Pogrešan Databricks račun ili radni prostor: Provjerite vrijednost Naziv hosta radnog prostora (obavezno), zatim ponovite prijavu 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 OAuth aplikaciju. Također provjerite dopušta li korisnikov ChatGPT Korisnički pristup 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 dozvoljenih IP adresa računa ili radnog prostora, kontrole dolaznog saobraćaja zasnovane na kontekstu, vatrozid ili druga mrežna pravila kojima upravlja korisnik.
Dozvolite dolazne veze iz trenutnih raspona izlaznih IP adresa ChatGPT konektora.
Ovu listu dozvoljenih adresa konfigurirajte u Databricksu ili mrežnom sloju kojim upravlja korisnik. Ona je odvojena od liste dozvoljenih IP adresa ChatGPT radnog prostora.
Objavljeni rasponi mogu se promijeniti. Kad god je moguće, automatizirajte ažuriranja iz JSON-a.
Nemojte rotirati tajnu klijenta niti mijenjati OAuth opsege pristupa da biste zaobišli mrežnu blokadu. Prvo provjerite odbija li Databricks izvorne IP adrese konektora.