Ovaj vodič namijenjen je administratorima radnog prostora ChatGPT te korisnicima usluge ChatGPT Plus ili Pro koji postavljaju poveznik Databricks Genie s pomoću klijenta otvorenog ovlaštenja Databricks svoje organizacije.
Većina postavljanja za Databricks obavlja se u konzoli računa Databricks. Izradite prilagođenu vezu aplikacije za otvoreno ovlaštenje, registrirajte URL za povratni poziv usluge ChatGPT, kopirajte generirane vjerodajnice klijenta, a zatim unesite te vrijednosti tijekom postavljanja poveznika u usluzi ChatGPT.
Što postavljate
Izrađujete vezu aplikacije Databricks za svoj račun ili radni prostor ChatGPT. Za povezivanje se upotrebljavaju:
Veza aplikacije Databricks za otvoreno ovlaštenje izrađena u konzoli računa Databricks.
ID i tajna klijenta otvorenog ovlaštenja Databricks.
Točan URL za povratni poziv kopiran iz usluge ChatGPT.
Opsezi usluge Databricks koji odgovaraju mogućnostima poveznika koje želite omogućiti.
Svi podaci o davatelju Databricks koji se traže tijekom postavljanja u usluzi ChatGPT, kao što su glavno računalo radnog prostora, glavno računalo računa, ID računa ili SQL skladište.
Prije početka
Potrebno vam je sljedeće:
Administratorski ili vlasnički pristup radnom prostoru ChatGPT ili račun ChatGPT Plus ili Pro.
Administratorski pristup računu Databricks. Administratorski pristup radnom prostoru može biti dovoljan za neke zadatke, ali prilagođene veze aplikacija konfiguriraju se u konzoli računa Databricks.
Konzola računa Databricks otvorena u zasebnoj kartici.
Zaslon za povezivanje s uslugom Databricks Genie otvoren u usluzi ChatGPT kako biste mogli kopirati točan URL za povratni poziv.
Odluka o tome treba li aplikacija opći pristup API-jima usluge Databricks ili samo pristup usluzi Databricks SQL.
Sigurno mjesto za pohranu tajne klijenta Databricks.
Ako vaš račun ili radni prostor Databricks ograničava pristup popisom dopuštenih IP adresa, kontekstualnom kontrolom ulaznog prometa, vatrozidom ili drugim mrežnim pravilima, zatražite pomoć administratora usluge Databricks koji može dopustiti trenutačne raspone izlaznih IP adresa poveznika ChatGPT.
Napomena: morate kopirati točan URL za povratni poziv prikazan u usluzi ChatGPT.
Vrijednosti koje trebate pripremiti
URL za povratni poziv: kopirajte ga tijekom postavljanja poveznika u usluzi ChatGPT.
ID klijenta otvorenog ovlaštenja Databricks.
Tajna klijenta otvorenog ovlaštenja Databricks.
Opsezi pristupa usluzi Databricks, primjerice SVI API-ji ili SQL.
Polja radnog prostora ili računa Databricks koja se traže tijekom postavljanja u usluzi ChatGPT.
Pokrenite postavljanje aplikacije u usluzi ChatGPT
U usluzi ChatGPT prijeđite na račun ili radni prostor u kojem aplikacija treba biti dostupna.
Kao administrator ili vlasnik radnog prostora otvorite Postavke radnog prostora > Dodaci.
U Imeniku odaberite Databricks Genie.
Odaberite Dodaj vezu aplikacije.
U dijaloškom okviru Poveži Databricks Genie pronađite odjeljak klijenta otvorenog ovlaštenja.
URL za povratni poziv iz usluge ChatGPT. Ostavite taj dijaloški okvir otvoren.
Primjer URL-a za povratni poziv:
https://chatgpt.com/connector/oauth/<callback_id>
Nemojte ukloniti ID povratnog poziva, dodati završnu kosu crtu ni zamijeniti URL generičkim URL-om usluge ChatGPT. URL registriran u usluzi Databricks mora se potpuno podudarati s URL-om za povratni poziv prikazanim u usluzi ChatGPT.
Izradite vezu aplikacije za otvoreno ovlaštenje u usluzi Databricks
Otvorite konzolu računa Databricks za svoj račun Databricks.
Na liječnoj bočnoj traci otvorite Postavke.
Otvorite karticu Veze aplikacija.
Odaberite Dodaj vezu.
Unesite naziv aplikacije, primjerice Poveznik ChatGPT za Databricks.
U polje URL-ovi za preusmjeravanje zalijepite točan URL za povratni poziv kopiran iz usluge ChatGPT.
U odjeljku Opsezi pristupa odaberite opsege potrebne aplikaciji.
Odaberite SVI API-ji za opću aplikaciju Databricks kojoj su osim SQL-a potrebni i drugi API-ji usluge Databricks.
Odaberite samo SQL za aplikaciju ograničenu na SQL API-je usluge Databricks.
Provjerite je li svaki opseg koji će poslije biti naveden u usluzi ChatGPT omogućen u ovoj aplikaciji Databricks za otvoreno ovlaštenje. Databricks automatski dopušta opsege openid, email, profile i offline_access za aplikacije izrađene u korisničkom sučelju.
Zadržite zadane vrijednosti trajanja tokena u usluzi Databricks, osim ako vaša organizacija nema posebna pravila: 60 minuta za pristupni token i 10080 minuta za token za osvježavanje.
Uključite Generiraj tajnu klijenta. Za ovaj postupak ChatGPT treba povjerljivog klijenta otvorenog ovlaštenja.
Izradite vezu.
Kopirajte vjerodajnice iz usluge Databricks
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 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 u usluzi ChatGPT
Vratite se u dijaloški okvir Poveži Databricks Genie.
Unesite ID klijenta Databricks u polje ID klijenta otvorenog ovlaštenja.
Unesite tajnu klijenta Databricks u polje Tajna klijenta otvorenog ovlaštenja.
U polju Opsezi (neobavezno) zadržite all-apis i offline_access za opći pristup API-jima.
Unesite po jedan opseg u svaki redak ili ih odvojite zarezima. Svaki opseg naveden u usluzi ChatGPT mora biti omogućen u aplikaciji Databricks za otvoreno ovlaštenje.
Unesite Naziv glavnog računala radnog prostora (obavezno) bez prefiksa https:// i putanje URL-a. Ispunite sva ostala obavezna polja davatelja Databricks prikazana tijekom postavljanja.
Odaberite Nastavi.
ChatGPT traži upravo one opsege koji su uneseni u polje Opsezi (neobavezno). Ne dodaje automatski šire opsege iz predloška.
Povezivanje i testiranje
Pregledajte pojedinosti poveznika, radnje i postavke provjere autentičnosti.
Ako ste administrator radnog prostora, omogućite poveznik za radni prostor i u skladu s pravilima radnog prostora odredite tko ga može upotrebljavati.
Kao ovlašteni testni korisnik pokrenite povezivanje iz usluge ChatGPT, a zatim se prijavite u Databricks.
Potvrdite da preglednik otvara očekivani račun ili radni prostor Databricks.
Pregledajte zatražene opsege, a zatim odaberite Odobri.
Provjerite vraća li se preglednik u ChatGPT i prikazuje li se poveznik kao povezan.
Najprije pokrenite radnju čitanja niskog rizika, primjerice dohvaćanje podataka o trenutačnom korisniku ili slanje upita odobrenom SQL resursu usluge Databricks.
Ako su omogućene radnje pisanja, prije šire primjene testirajte radni proces Databricks koji nedvojbeno predstavlja nizak rizik.
Pri postavljanju radnog prostora zamolite ovlaštenog člana radnog prostora koji nije administrator da se poveže i ponovi test niskog rizika.
Upravljanje pristupom
I Databricks i ChatGPT sudjeluju u kontroli pristupa.
U usluzi ChatGPT administratori radnog prostora određuju je li aplikacija dostupna i kako je članovi mogu upotrebljavati. Pregledajte administratorske kontrole aplikacija Databricks (Postavke radnog prostora > Aplikacije) za sljedeće:
Korisnički pristup za određivanje uloga u radnom prostoru koje mogu upotrebljavati poveznik.
Kontrola radnji za određivanje omogućenih radnji usluge Databricks.
Dopuštenja aplikacije za određivanje kada ChatGPT traži dopuštenje članova prije upotrebe poveznika.
Ta dopuštenja aplikacije primjenjuju se na razgovore u usluzi ChatGPT. Agenti radnog prostora primjenjuju kontrole za pojedinačne agente koje je postavio njihov autor kako bi odredili dostupne radnje aplikacije i kada krajnji korisnici moraju odobriti te radnje. Više o ponašanju agenata potražite u članku: Agenti radnog prostora ChatGPT za Enterprise i Business.
U usluzi Databricks administratori određuju koji korisnici mogu odobriti aplikaciju za otvoreno ovlaštenje i kojim resursima usluge Databricks ti korisnici mogu pristupiti. Dopuštenja davatelja primjenjuju se i nakon omogućivanja aplikacije u usluzi ChatGPT.
Otklanjanje poteškoća pri postavljanju poveznika Databricks
URI za preusmjeravanje ne podudara se: provjerite podudara li se vrijednost URL-ovi za preusmjeravanje u usluzi Databricks potpuno s URL-om za povratni poziv prikazanim u usluzi ChatGPT, uključujući putanju i ID povratnog poziva. Nemojte ukloniti ID povratnog poziva, dodati završnu kosu crtu ni upotrijebiti drugi URL usluge ChatGPT za preusmjeravanje.
Nedostaje tajna: Databricks prikazuje tajne samo jednom. Ako tajna nije kopirana, generirajte novu tajnu klijenta.
Aplikacija za otvoreno ovlaštenje nije odmah dostupna: prema navodima usluge Databricks obrada izmjena aplikacije za otvoreno ovlaštenje može potrajati do 30 minuta.
Nedovoljan ili nepodudaran opseg: usporedite Opsege (neobavezno) u usluzi ChatGPT s Opsezima pristupa u aplikaciji Databricks za otvoreno ovlaštenje. Ondje mora biti omogućen svaki opseg koji ChatGPT traži. Za API-je koji nisu SQL provjerite je li all-apis omogućen u usluzi Databricks i nalazi li se i dalje na popisu opsega u usluzi ChatGPT.
SQL radnje ne uspijevaju: provjerite opseg SQL, konfiguraciju SQL skladišta i dopuštenja usluge Databricks.
Pogrešan radni prostor ChatGPT: izradite i omogućite poveznik u istom radnom prostoru ChatGPT u kojem će ga korisnici povezivati.
Pogrešan račun ili radni prostor Databricks: provjerite vrijednost Naziv glavnog računala 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 usluzi Databricks i smije li odobriti aplikaciju za otvoreno ovlaštenje. Provjerite i dopušta li Korisnički pristup tog korisnika u usluzi ChatGPT upotrebu poveznika.
Mrežna pravila usluge Databricks blokiraju poveznik: ako Databricks dopušta samo određene izvorišne IP adrese, administrator usluge Databricks mora ažurirati odgovarajuće popise dopuštenih IP adresa računa ili radnog prostora, kontekstualne kontrole ulaznog prometa, vatrozid ili druga mrežna pravila kojima upravlja korisnik.
Dopustite dolazne veze iz trenutačnih raspona izlaznih IP adresa poveznika ChatGPT.
Taj popis dopuštenih adresa konfigurirajte u usluzi Databricks ili na mrežnom sloju kojim upravlja korisnik. To je odvojeno od popisa dopuštenih IP adresa radnog prostora ChatGPT.
Objavljeni rasponi mogu se promijeniti. Kad god je moguće, automatizirajte ažuriranja iz JSON-a.
Nemojte rotirati tajnu klijenta ni mijenjati opsege otvorenog ovlaštenja kako biste zaobišli mrežnu blokadu. Najprije provjerite odbija li Databricks izvorišne IP adrese poveznika.