Ta vodnik je namenjen skrbnikom delovnega prostora ChatGPT in uporabnikom paketov ChatGPT Plus ali Pro, ki nastavljajo povezovalnik Databricks Genie z vgrajenim OAuth ali odjemalcem OAuth svoje organizacije.
Vgrajeni OAuth: Če je na voljo v ChatGPT in omogočen za vaš delovni prostor Databricks, uporabite vnaprej konfigurirano povezavo. Ni vam treba ustvariti aplikacije OAuth ali vnesti ID-ja oziroma skrivnega ključa odjemalca. Upoštevajte navodila v spodnjem razdelku Vgrajeni OAuth.
Lastni odjemalec OAuth: To možnost uporabite, če vgrajeni OAuth ni na voljo ali vaša organizacija zahteva lastnega odjemalca OAuth. Upoštevajte navodila v spodnjem razdelku Lastni odjemalec OAuth.
Kaj nastavljate
Ustvarjate povezavo z aplikacijo Databricks za svoj račun ali delovni prostor ChatGPT. Pri obeh možnostih potrebujete podatke o ponudniku Databricks, ki jih zahteva ChatGPT, in dovoljenja za vire, ki jih nameravate uporabljati. Če uporabljate lastnega odjemalca OAuth, pripravite tudi:
Povezavo z aplikacijo OAuth v Databricks, ustvarjeno v konzoli za upravljanje računa Databricks.
ID in skrivni ključ odjemalca OAuth za Databricks.
Točen URL povratnega klica, kopiran iz ChatGPT.
Obsege Databricks, ki ustrezajo zmožnostim povezovalnika, ki jih želite omogočiti.
Vse podatke o ponudniku 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
Za nastavitev delovnega prostora odprite skrbniško konzolo, izberite želeni delovni prostor ChatGPT in odprite Vtičnike. Izberite Upravljanje starejših aplikacij, da odprete ohranjeno stran Aplikacije. Za krmarjenje po delovnem prostoru in dostop do starejših aplikacij glejte Skrbniški kontrolniki, varnost in skladnost za vtičnike in aplikacije.
Potrebujete:
Dostop skrbnika ali lastnika delovnega prostora ChatGPT ali račun ChatGPT Plus ali Pro.
Za lastnega odjemalca OAuth dostop skrbnika računa Databricks. Za nekatera opravila lahko zadostuje dostop skrbnika delovnega prostora, vendar se povezave z lastnimi aplikacijami nastavljajo v konzoli računa Databricks. Pri vgrajenem OAuth mora skrbnik storitve Databricks preveriti, ali je aplikacija ChatGPT na voljo in omogočena za vaš delovni prostor.
Za lastnega odjemalca OAuth konzolo računa Databricks, odprto v ločenem zavihku.
Za lastnega odjemalca OAuth zaslon za povezavo z Databricks Genie, odprt v ChatGPT, da lahko kopirate točen URL povratnega klica.
Odločitev o zmožnostih, ki jih aplikacija potrebuje: Genie in nadzorne plošče AI/BI, širši dostop do API-jev Databricks ali aplikacija, omejena na API-je Databricks SQL. Dostop samo do SQL ne zadostuje za dejanja v Genie ali na nadzornih ploščah.
Za lastnega odjemalca OAuth varno mesto za ravnanje s skrivnim ključem odjemalca Databricks.
Če vaš račun ali delovni prostor Databricks omejuje dostop s seznamom dovoljenih naslovov IP, nadzorom vhodnega prometa na podlagi konteksta, požarnim zidom ali drugim omrežnim pravilnikom, pomoč skrbnika storitve Databricks, ki lahko dovoli trenutne obsege izhodnih naslovov IP povezovalnikov ChatGPT.
Za lastnega odjemalca OAuth kopirajte točen URL povratnega klica, prikazan v ChatGPT.
Vrednosti, ki jih morate pripraviti
Za lastnega odjemalca OAuth URL povratnega klica: kopirajte ga iz postopka nastavitve povezovalnika v ChatGPT.
Za lastnega odjemalca OAuth ID odjemalca OAuth v Databricks.
Za lastnega odjemalca OAuth skrivni ključ odjemalca OAuth v Databricks.
Za lastnega odjemalca OAuth obsege dostopa Databricks, ki ustrezajo zmožnostim aplikacije. Pri novi povezavi za Genie ali nadzorne plošče, ki prikazuje
ai-gateway,dashboardsinoffline_access, pripravite te obsege dostopa. Vsi API-ji (all-apiszoffline_access) ostajajo starejša, širša možnost. SQL uporabite le za aplikacijo, omejeno na API-je Databricks SQL.Polja delovnega prostora ali računa Databricks, ki jih zahteva postopek nastavitve v ChatGPT.
Vgrajeni OAuth
Najprej izpolnite zgornje predpogoje. Ta postopek uporabite le, če je vgrajeni OAuth na voljo v ChatGPT in omogočen za vaš delovni prostor Databricks.
Prosite skrbnika storitve Databricks, naj preveri, ali je aplikacija ChatGPT na voljo v nastavitvah integracij aplikacij v konzoli računa in omogočena za vaš delovni prostor. Če aplikacije ChatGPT ni na seznamu v konzoli računa Databricks, se obrnite na svojega zastopnika za Databricks in vprašajte, ali je funkcija na voljo za vaš račun.
V ChatGPT preklopite na račun ali delovni prostor, v katerem naj bo aplikacija na voljo. Za osebno nastavitev odprite Nastavitve > Vtičniki, za nastavitev delovnega prostora pa kot njegov skrbnik ali lastnik odprite Skrbniška konzola > Vtičniki.
Izberite Databricks Genie in nato Dodaj povezavo z aplikacijo.
Vnesite Ime gostitelja delovnega prostora (obvezno) brez
https://ali poti URL-ja.ChatGPT iz tega imena gostitelja določi končno točko Genie MCP znotraj delovnega prostora:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Ločena regionalna končna točka MCP ni potrebna.Izberite Nadaljuj, nato se prijavite v Databricks in preglejte zahtevo za soglasje.
Nadaljujte s spodnjima razdelkoma Povezava in preizkus ter Upravljanje dostopa, vključno s preizkusi s člani z dovoljenjem za uporabo in preverjanjem dostopa do delovnega prostora.
Lastni odjemalec OAuth
Najprej izpolnite zgoraj navedene predpogoje. To možnost uporabite, če vgrajeni OAuth ni na voljo ali vaša organizacija zahteva lastnega odjemalca OAuth. Po nastavitvi izvedite še korake iz spodnjih razdelkov Povezava in preizkus ter Upravljanje dostopa.
Začnite nastavitev lastnega odjemalca OAuth v ChatGPT
V ChatGPT preklopite na račun ali delovni prostor, v katerem naj bo aplikacija na voljo.
Za osebno nastavitev odprite Nastavitve > Vtičniki, za nastavitev delovnega prostora pa kot njegov skrbnik ali lastnik odprite Skrbniška konzola > Vtičniki.
V razdelku Imenik izberite Databricks Genie.
Izberite Dodaj povezavo z aplikacijo.
V pogovornem oknu Poveži Databricks Genie poiščite polji ID odjemalca OAuth in Skrivni ključ odjemalca OAuth. Z vnosom poverilnic v ti vidni polji uporabite postopek za lastnega odjemalca; ločena izbira ni potrebna.
Kopirajte URL povratnega klica iz ChatGPT. To pogovorno okno pustite odprto.
Primer URL-ja povratnega klica:
https://chatgpt.com/connector/oauth/<callback_id>
Ne odstranite ID-ja povratnega klica, ne dodajajte poševnice na koncu in URL-ja ne zamenjajte s splošnim URL-jem ChatGPT. URL, registriran v Databricks, se mora natančno ujemati z vrednostjo URL povratnega klica, prikazano v ChatGPT.
Ustvarite povezavo z lastno aplikacijo OAuth v Databricks
Odprite konzolo računa Databricks 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 Preusmeritveni URL-ji prilepite točen URL povratnega klica, kopiran iz ChatGPT.
V razdelku Obsegi dostopa izberite obsege dostopa, ki jih aplikacija potrebuje.
Pri novi povezavi za Genie ali nadzorne plošče, ki v ChatGPT prikazuje
ai-gateway,dashboardsinoffline_access, dovolite iste obsege dostopa v aplikaciji OAuth v Databricks.Vsi API-ji ostajajo starejša, širša možnost za splošen dostop do API-jev Databricks. Pri tej konfiguraciji v ChatGPT uporabite
all-apisinoffline_accesster poskrbite, da aplikacija OAuth v Databricks dovoljuje oba. Za novo povezavo za Genie ali nadzorne plošče raje uporabite prikazane natančneje omejene obsege dostopa.SQL uporabite le za aplikacijo, omejeno na API-je Databricks SQL. Dostop samo do SQL ne zadostuje za dejanja v Genie ali na nadzornih ploščah.
Poskrbite, da je v tej aplikaciji OAuth v Databricks omogočen vsak obseg dostopa, ki ga boste pozneje navedli v ChatGPT. Databricks za aplikacije, ustvarjene v uporabniškem vmesniku, samodejno dovoli openid, email, profile in offline_access.
Čase veljavnosti žetonov (TTL) pustite na privzetih vrednostih Databricks, razen če ima vaša organizacija poseben pravilnik: 60 minut za žeton za dostop in 10080 minut za osvežitveni žeton.
Vklopite možnost Ustvari skrivni ključ odjemalca. ChatGPT za ta postopek potrebuje zaupnega odjemalca OAuth.
Ustvarite povezavo.
Kopirajte poverilnice iz Databricks
V pogovornem oknu Povezava je ustvarjena kopirajte ID odjemalca.
Takoj kopirajte Skrivni ključ odjemalca in ga varno shranite.
Če pogovorno okno zaprete, preden kopirate skrivni ključ, ustvarite ali zamenjajte poverilnice aplikacije OAuth in uporabite novi skrivni ključ.
Databricks skrivni ključ prikaže le enkrat. Z njim ravnajte kot s poverilnico in ga ne vključujte v posnetke zaslona, zahtevke za podporo, komentarje ali klepete.
Dokončajte nastavitev lastnega odjemalca OAuth v ChatGPT
Vrnite se v pogovorno okno Poveži Databricks Genie.
V polje ID odjemalca OAuth vnesite ID odjemalca Databricks.
V polje Skrivni ključ odjemalca OAuth vnesite skrivni ključ odjemalca Databricks.
Z vnosom teh poverilnic uporabite svojega odjemalca OAuth; ločena izbira ni potrebna.
V polje Obsegi dostopa (izbirno) vnesite obsege dostopa, potrebne za končno točko Databricks in zmožnosti vaše aplikacije. Uskladite jih z obsegi dostopa, omogočenimi v aplikaciji OAuth v Databricks.
Pri novi povezavi za Genie ali nadzorne plošče, ki prikazuje
ai-gateway,dashboardsinoffline_access, ohranite te obsege dostopa. Prepričajte se, da aplikacija OAuth v Databricks dovoljuje iste obsege dostopa.ai-gatewayomogoča povezavo Genie MCP znotraj delovnega prostora,dashboardsomogoča dejanja na nadzornih ploščah AI/BI,offline_accesspa omogoča osvežitvene žetone.Starejša, širša možnost,
all-apisinoffline_access, je še vedno podprta za širši dostop do API-jev, vendar ni priporočena za to povezavo za Genie ali nadzorne plošče. Če aplikacija v Databricks dovoljuje leall-apis, jo posodobite ali ustvarite znova, da bo dovoljevalaai-gateway,dashboardsinoffline_access. Če natančneje omejeni obsegi dostopa niso na voljo, v ChatGPT izrecno nastaviteall-apisinoffline_accesster poskrbite, da aplikacija v Databricks dovoljuje oba. V ChatGPT ne zahtevajte treh natančneje omejenih obsegov dostopa, če aplikacija v Databricks dovoljuje leall-apis.Vsak obseg dostopa vnesite v svojo vrstico ali pa jih ločite z vejicami. Vsak obseg dostopa, naveden v ChatGPT, mora biti omogočen v aplikaciji OAuth v Databricks.
Vnesite Ime gostitelja delovnega prostora (obvezno) brez https:// ali poti URL-ja. Izpolnite vsa druga obvezna polja ponudnika Databricks, prikazana med nastavitvijo.
ChatGPT iz tega imena gostitelja določi končno točko Genie MCP znotraj delovnega prostora:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Ločena regionalna končna točka MCP ni potrebna.Izberite Nadaljuj.
ChatGPT zahteva natanko tiste obsege dostopa, ki so vneseni v polje Obsegi dostopa (izbirno). Širših obsegov dostopa iz predloge ne doda samodejno.
Povezava in preizkus
Pri obeh postopkih OAuth opravite naslednje preizkuse povezave in preverjanja dostopa.
Preglejte podrobnosti povezovalnika, dejanja in nastavitve preverjanja pristnosti.
Če ste skrbnik delovnega prostora, zanj omogočite povezovalnik in v skladu s pravilnikom delovnega prostora določite, kdo ga lahko uporablja.
Kot preizkusni uporabnik z dovoljenjem za uporabo v ChatGPT začnite postopek povezovanja in se nato prijavite v Databricks.
Preverite, ali brskalnik odpre pričakovani račun ali delovni prostor Databricks.
Preglejte zahtevane obsege dostopa in nato izberite Odobri.
Preverite, ali se brskalnik vrne v ChatGPT in ali je povezovalnik prikazan kot povezan.
Izvedite dejanje branja z majhnim tveganjem, ki ustreza zmožnostim povezave. Pri povezavi z Genie pošljite zahtevo Genie o podatkih, do katerih ima preizkusni uporabnik dovoljen dostop. Za druge podprte zmožnosti pridobite podatke o trenutnem uporabniku ali izvedite poizvedbo v odobrenem viru Databricks SQL. Preverite, ali ima uporabnik zahtevana dovoljenja za vire Databricks; sami obsegi dostopa OAuth ne zagotavljajo dostopa do podatkov.
Če so omogočena dejanja pisanja, pred širšo uvedbo izvedite preizkus s potekom dela v Databricks, pri katerem je tveganje očitno majhno.
Pri nastavitvi delovnega prostora prosite člana z dovoljenjem za uporabo, ki ni skrbnik, naj vzpostavi povezavo in ponovi preizkus z majhnim tveganjem.
Upravljanje dostopa
Pri nadzoru dostopa sodelujeta tako Databricks kot ChatGPT.
V ChatGPT skrbniki delovnega prostora določajo, ali je aplikacija na voljo in kako jo člani lahko uporabljajo. Pri paketu Business skrbniki določajo, ali je aplikacija omogočena v celotnem delovnem prostoru. Preglejte skrbniške nastavitve aplikacij Databricks (Nastavitve delovnega prostora > Aplikacije ali Skrbniška konzola > Vtičniki > Upravljanje starejših aplikacij) za:
Uporabniški dostop, kjer določite, katere vloge v delovnem prostoru lahko uporabljajo povezovalnik v podprtih delovnih prostorih Enterprise in Edu.
Nadzor dejanj, kjer določite, katera dejanja Databricks so omogočena.
Dovoljenja aplikacije, kjer določite, kdaj ChatGPT pred uporabo povezovalnika vpraša člane za dovoljenje.
Ta dovoljenja aplikacije veljajo za pogovore v ChatGPT. Agenti delovnega prostora uporabljajo nastavitve, ki jih za vsakega agenta določi njegov ustvarjalec. Te določajo, katera dejanja aplikacij so na voljo in kdaj morajo končni uporabniki odobriti njihovo izvedbo. Za informacije o delovanju agentov glejte: Agenti delovnega prostora ChatGPT za Enterprise in Business.
V Databricks skrbniki določajo, kateri uporabniki lahko odobrijo dostop aplikaciji OAuth in do katerih virov Databricks lahko ti uporabniki dostopajo. Dovoljenja ponudnika še naprej veljajo tudi po tem, ko je aplikacija omogočena v ChatGPT.
Za navodila o krmarjenju po delovnem prostoru, dostopu do aplikacij in nastavitvah aplikacij za posamezne pakete glejte: Skrbniške nastavitve, varnost in skladnost v aplikacijah.
Odpravljanje težav pri nastavitvi povezovalnika Databricks
Neujemanje preusmeritvenega URI-ja: Če uporabljate lastnega odjemalca OAuth, preverite, ali se vrednost Preusmeritveni URL-ji v Databricks natančno ujema z vrednostjo URL povratnega klica v ChatGPT, vključno s potjo in ID-jem povratnega klica. Ne odstranite ID-ja povratnega klica, ne dodajajte poševnice na koncu in ne uporabite drugega preusmeritvenega URL-ja ChatGPT.
Manjkajoči skrivni ključ: Če uporabljate lastnega odjemalca OAuth, upoštevajte, da Databricks skrivne ključe prikaže le enkrat. Če skrivnega ključa odjemalca niste kopirali, ustvarite novega.
Aplikacija OAuth ni takoj na voljo: Po navedbah Databricks lahko obdelava posodobitev aplikacije OAuth traja do 30 minut.
Nezadosten ali neujemajoč se obseg dostopa: Če uporabljate lastnega odjemalca OAuth, primerjajte polje Obsegi dostopa (izbirno) v ChatGPT s poljem Obsegi dostopa v aplikaciji OAuth v Databricks. Tam mora biti omogočen vsak obseg dostopa, ki ga zahteva ChatGPT. Preverite, ali obsegi dostopa podpirajo končno točko in zmožnosti, ki jih uporabljate.
Pri novi povezavi za Genie ali nadzorne plošče, ki prikazuje
ai-gateway,dashboardsinoffline_access, ohranite te obsege dostopa v ChatGPT in poskrbite, da aplikacija v Databricks dovoljuje vse tri. Če aplikacija dovoljuje leall-apis, jo posodobite ali ustvarite znova, da bo dovoljevala tri natančneje omejene obsege dostopa.Če natančneje omejeni obsegi dostopa niso na voljo, uporabite podprto širšo možnost: v ChatGPT nastavite
all-apisinoffline_accesster poskrbite, da aplikacija v Databricks dovoljuje oba. Aplikacija, ki dovoljuje leall-apis, ne ustreza zahtevi ChatGPT zaai-gateway,dashboardsinoffline_access. Dostop samo do SQL je primeren le za aplikacijo, omejeno na API-je Databricks SQL; za dejanja v Genie ali na nadzornih ploščah ne zadostuje.Dejanja SQL ne uspejo: Pri aplikaciji, omejeni na API-je Databricks SQL, preverite obseg dostopa SQL, konfiguracijo podatkovnega skladišča in dovoljenja v 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 postopek prijave in preverite, ali Databricks odpre pričakovani račun ali delovni prostor.
Uporabniki ne morejo vzpostaviti povezave: Preverite, ali ima uporabnik dostop do Databricks in dovoljenje za odobritev aplikacije OAuth. Pri paketu Business preverite, ali je aplikacija omogočena za celoten delovni prostor. V podprtih delovnih prostorih Enterprise in Edu preverite tudi, ali nastavitev Uporabniški dostop v ChatGPT dovoljuje povezovalnik.
Omrežni pravilnik Databricks blokira povezovalnik: Če Databricks dovoljuje le določene izvorne naslove IP, mora skrbnik storitve Databricks posodobiti ustrezne sezname dovoljenih naslovov IP računa ali delovnega prostora, nadzor vhodnega prometa na podlagi konteksta, požarni zid ali druga omrežna pravila, ki jih upravlja stranka.
Dovolite vhodne povezave iz trenutnih obsegov izhodnih naslovov IP povezovalnikov ChatGPT.
Ta seznam dovoljenih naslovov nastavite v Databricks ali na omrežni plasti, ki jo upravlja stranka. Ta nastavitev je ločena od seznama dovoljenih naslovov IP delovnega prostora ChatGPT.
Objavljeni obsegi se lahko spremenijo. Če je mogoče, avtomatizirajte posodobitve na podlagi datoteke JSON.
Omrežne blokade ne poskušajte obiti z zamenjavo skrivnega ključa odjemalca ali spreminjanjem obsegov dostopa OAuth. Najprej preverite, ali Databricks zavrača izvorne naslove IP povezovalnika.