Ta vodnik je namenjen skrbnikom delovnega prostora ChatGPT ter uporabnikom paketov ChatGPT Plus ali ChatGPT Pro, ki nastavljajo povezovalnik Databricks Genie z odjemalcem OAuth Databricks svoje organizacije.
Pri storitvi Databricks večina nastavitev poteka v konzoli za račun Databricks. Ustvarite povezavo z aplikacijo OAuth po meri, registrirajte URL za povratni klic ChatGPT, kopirajte ustvarjene poverilnice odjemalca in nato te vrednosti vnesite v postopek nastavitve povezovalnika ChatGPT.
Kaj nastavljate
Ustvarjate povezavo z aplikacijo Databricks za svoj račun ali delovni prostor ChatGPT. Povezava uporablja:
Povezavo z aplikacijo OAuth Databricks, ustvarjeno v konzoli za račun Databricks.
ID odjemalca in skrivnost odjemalca OAuth Databricks.
Točen URL za povratni klic, kopiran iz ChatGPT.
Obsege dostopa Databricks, ki ustrezajo funkcijam povezovalnika, ki jih želite omogočiti.
Vse podatke ponudnika Databricks, ki jih zahteva postopek nastavitve v ChatGPT, kot so gostitelj delovnega prostora, gostitelj računa, ID računa ali skladišče.
Preden začnete
Potrebujete:
Skrbniški ali lastniški dostop do delovnega prostora ChatGPT oziroma račun ChatGPT Plus ali ChatGPT Pro.
Skrbniški dostop do računa Databricks. Za nekatera opravila morda zadošča skrbniški dostop do delovnega prostora, vendar se povezave z aplikacijami po meri konfigurirajo v konzoli za račun Databricks.
Konzolo za račun Databricks, odprto v ločenem zavihku.
Zaslon za povezavo Databricks Genie, odprt v ChatGPT, da lahko kopirate točen URL za povratni klic.
Odločitev, ali aplikacija potrebuje splošen dostop do API-jev Databricks ali samo dostop do storitve Databricks SQL.
Varno mesto za ravnanje s skrivnostjo odjemalca Databricks.
Če vaš račun ali delovni prostor Databricks omejuje dostop s seznamom dovoljenih naslovov IP, nadzorom dohodnega prometa na podlagi konteksta, požarnim zidom ali drugim omrežnim pravilnikom, potrebujete pomoč skrbnika Databricks, ki lahko dovoli trenutne obsege izhodnih naslovov IP povezovalnika ChatGPT.
Opomba: kopirati morate točen URL za povratni klic, prikazan v ChatGPT.
Vrednosti, ki jih morate pripraviti
URL za povratni klic: kopirajte ga iz postopka nastavitve povezovalnika ChatGPT.
ID odjemalca OAuth Databricks.
Skrivnost odjemalca OAuth Databricks.
Obsege dostopa Databricks, kot sta VSI API-JI ali SQL.
Polja delovnega prostora ali računa Databricks, ki jih zahteva postopek nastavitve v ChatGPT.
Začetek nastavitve aplikacije v ChatGPT
V ChatGPT preklopite na račun ali delovni prostor, v katerem naj bo aplikacija na voljo.
Kot skrbnik ali lastnik delovnega prostora odprite Nastavitve delovnega prostora > Vtičniki.
V razdelku Imenik izberite Databricks Genie.
Izberite Dodaj povezavo z aplikacijo.
V pogovornem oknu Poveži Databricks Genie poiščite razdelek odjemalca OAuth.
URL za povratni klic iz ChatGPT. To pogovorno okno pustite odprto.
Primer URL-ja za povratni klic:
https://chatgpt.com/connector/oauth/<callback_id>
Ne odstranite ID-ja povratnega klica, ne dodajte končne poševnice in ga ne zamenjajte s splošnim URL-jem ChatGPT. URL, registriran v storitvi Databricks, se mora natančno ujemati z URL-jem za povratni klic, prikazanim v ChatGPT.
Ustvarjanje povezave z aplikacijo OAuth v storitvi Databricks
Odprite konzolo za svoj račun Databricks.
V levi stranski vrstici odprite Nastavitve.
Odprite zavihek Povezave z aplikacijami.
Izberite Dodaj povezavo.
Vnesite ime aplikacije, na primer Povezovalnik ChatGPT za Databricks.
V polje URL-ji za preusmeritev prilepite točen URL za povratni klic, kopiran iz ChatGPT.
V razdelku Obsegi dostopa izberite obsege, ki jih aplikacija potrebuje.
Za splošno aplikacijo Databricks, ki poleg API-jev SQL potrebuje tudi druge API-je Databricks, uporabite VSI API-JI.
Za aplikacijo, omejeno na API-je Databricks SQL, uporabite samo SQL.
Prepričajte se, da je vsak obseg, ki bo pozneje naveden v ChatGPT, omogočen v tej aplikaciji OAuth Databricks. Databricks za aplikacije, ustvarjene v uporabniškem vmesniku, samodejno dovoli openid, email, profile in offline_access.
Čas veljavnosti žetonov pustite na privzetih vrednostih Databricks, razen če ima vaša organizacija poseben pravilnik: 60 minut za žeton za dostop in 10080 minut za žeton za osvežitev.
Vklopite Ustvari skrivnost odjemalca. ChatGPT za ta postopek potrebuje zaupnega odjemalca OAuth.
Ustvarite povezavo.
Kopiranje poverilnic iz storitve Databricks
V pogovornem oknu Povezava je ustvarjena kopirajte ID odjemalca.
Takoj kopirajte skrivnost odjemalca in jo varno shranite.
Če pogovorno okno zaprete, preden kopirate skrivnost, ustvarite ali zamenjajte poverilnice aplikacije OAuth ter uporabite novo skrivnost.
Databricks skrivnost prikaže samo enkrat. Obravnavajte jo kot poverilnico in je ne vključujte v posnetke zaslona, zahtevke za podporo, komentarje ali klepete.
Dokončanje nastavitve v ChatGPT
Vrnite se v pogovorno okno Poveži Databricks Genie.
V polje ID odjemalca OAuth vnesite ID odjemalca Databricks.
V polje Skrivnost odjemalca OAuth vnesite skrivnost odjemalca Databricks.
V polju Obsegi (izbirno) za splošen dostop do API-jev ohranite all-apis in offline_access.
V vsako vrstico vnesite en obseg ali pa obsege ločite z vejicami. Vsak obseg, naveden v ChatGPT, mora biti omogočen v aplikaciji OAuth Databricks.
Vnesite ime gostitelja delovnega prostora (obvezno) brez https:// ali poti URL-ja. Izpolnite vsa druga zahtevana polja ponudnika Databricks, prikazana med nastavitvijo.
Izberite Nadaljuj.
ChatGPT zahteva natanko tiste obsege, ki so vneseni v polje Obsegi (izbirno). Širših obsegov iz predloge ne doda samodejno.
Povezovanje in preskus
Preglejte podatke o povezovalniku, dejanja in nastavitve preverjanja pristnosti.
Če ste skrbnik delovnega prostora, omogočite povezovalnik za delovni prostor in skladno s pravilnikom delovnega prostora določite, kdo ga lahko uporablja.
Kot uporabnik z dovoljenjem za preskušanje začnite postopek povezovanja v ChatGPT in se nato prijavite v Databricks.
Preverite, ali brskalnik odpre pričakovani račun ali delovni prostor Databricks.
Preglejte zahtevane obsege in nato izberite Pooblasti.
Preverite, ali se brskalnik vrne v ChatGPT in ali je povezovalnik prikazan kot povezan.
Najprej izvedite dejanje branja z majhnim tveganjem, na primer pridobivanje podatkov o trenutnem uporabniku ali poizvedovanje po odobrenem viru Databricks SQL.
Če so omogočena dejanja pisanja, jih pred širšo uvedbo preskusite z očitno nizkotveganim potekom dela Databricks.
Pri nastavitvi delovnega prostora prosite člana z dovoljenjem, ki ni skrbnik, naj se poveže in ponovi nizkotvegani preskus.
Upravljanje dostopa
K nadzoru dostopa prispevata tako Databricks kot ChatGPT.
V ChatGPT skrbniki delovnega prostora določajo, ali je aplikacija na voljo in kako jo lahko člani uporabljajo. V skrbniških kontrolnikih za aplikacije Databricks (Nastavitve delovnega prostora > Aplikacije) preglejte:
Uporabniški dostop, kjer določite, katere vloge v delovnem prostoru lahko uporabljajo povezovalnik.
Nadzor dejanj, kjer določite, katera dejanja Databricks so omogočena.
Dovoljenja aplikacije, kjer določite, kdaj ChatGPT člane pred uporabo povezovalnika prosi za dovoljenje.
Ta dovoljenja aplikacije veljajo za pogovore v ChatGPT. Agenti delovnega prostora z nastavitvami za posameznega agenta, ki jih določi njegov ustvarjalec, ugotavljajo, katera dejanja aplikacije so na voljo in kdaj morajo končni uporabniki ta dejanja odobriti. Več o delovanju agentov: Agenti delovnega prostora ChatGPT za Enterprise in Business.
V storitvi Databricks skrbniki določajo, kateri uporabniki lahko pooblastijo aplikacijo OAuth in do katerih virov Databricks lahko ti uporabniki dostopajo. Dovoljenja ponudnika veljajo tudi po tem, ko je aplikacija omogočena v ChatGPT.
Odpravljanje težav pri nastavitvi povezovalnika Databricks
URI za preusmeritev se ne ujema: Preverite, ali se vrednost URL-ji za preusmeritev v storitvi Databricks natančno ujema z URL-jem za povratni klic, prikazanim v ChatGPT, vključno s potjo in ID-jem povratnega klica. Ne odstranite ID-ja povratnega klica, ne dodajte končne poševnice in ne uporabite drugega URL-ja ChatGPT za preusmeritev.
Manjkajoča skrivnost: Databricks skrivnosti prikaže samo enkrat. Če skrivnosti niste kopirali, ustvarite novo skrivnost odjemalca.
Aplikacija OAuth ni takoj na voljo: Po navedbah Databricks lahko obdelava posodobitev aplikacije OAuth traja do 30 minut.
Nezadosten ali neujemajoč se obseg: Primerjajte Obsege (izbirno) v ChatGPT z Obsegi dostopa v aplikaciji OAuth Databricks. Tam mora biti omogočen vsak obseg, ki ga zahteva ChatGPT. Za API-je, ki niso SQL, preverite, ali je all-apis omogočen v storitvi Databricks in ostaja na seznamu obsegov v ChatGPT.
Dejanja SQL ne uspejo: Preverite obseg SQL, konfiguracijo skladišča in dovoljenja Databricks.
Napačen delovni prostor ChatGPT: Povezovalnik ustvarite in omogočite v istem delovnem prostoru ChatGPT, v katerem ga bodo uporabniki povezali.
Napačen račun ali delovni prostor Databricks: Preverite vrednost Ime gostitelja delovnega prostora (obvezno), nato ponovite prijavo in preverite, ali Databricks odpre pričakovani račun ali delovni prostor.
Uporabniki se ne morejo povezati: Preverite, ali ima uporabnik dostop do storitve Databricks in dovoljenje za pooblastitev aplikacije OAuth. Preverite tudi, ali uporabniški dostop uporabnika v ChatGPT dovoljuje uporabo povezovalnika.
Omrežni pravilnik Databricks blokira povezovalnik: Če Databricks dovoljuje samo določene izvorne naslove IP, mora skrbnik Databricks posodobiti ustrezne sezname dovoljenih naslovov IP za račun ali delovni prostor, nadzor dohodnega prometa na podlagi konteksta, požarni zid ali druga omrežna pravila, ki jih upravlja stranka.
Dovolite dohodne povezave iz trenutnih obsegov izhodnih naslovov IP povezovalnika ChatGPT.
Ta seznam dovoljenih naslovov konfigurirajte v storitvi Databricks ali omrežni plasti, ki jo upravlja stranka. To ni povezano s seznamom dovoljenih naslovov IP delovnega prostora ChatGPT.
Objavljeni obsegi se lahko spremenijo. Če je mogoče, avtomatizirajte posodobitve iz datoteke JSON.
Omrežne blokade ne poskušajte zaobiti z zamenjavo skrivnosti odjemalca ali spreminjanjem obsegov OAuth. Najprej preverite, ali Databricks zavrača izvorne naslove IP povezovalnika.