Šis vadovas skirtas „ChatGPT“ darbo erdvės administratoriams ir „ChatGPT Plus“ ar „Pro“ naudotojams, nustatantiems „Databricks Genie“ jungtį su integruotu „OAuth“ arba savo organizacijos „OAuth“ klientu.
Integruotas „OAuth“: jei ši parinktis pasiekiama „ChatGPT“ ir įjungta jūsų „Databricks“ darbo erdvėje, naudokite iš anksto sukonfigūruotą ryšį. Jums nereikia kurti „OAuth“ programėlės ar įvesti kliento ID bei kliento slaptosios reikšmės. Vadovaukitės toliau pateiktu skyriumi „Integruotas „OAuth““.
Pasirinktinis „OAuth“ klientas: rinkitės šį būdą, jei integruotas „OAuth“ nepasiekiamas arba jūsų organizacija reikalauja naudoti savo „OAuth“ klientą. Vadovaukitės toliau pateiktu skyriumi „Pasirinktinis „OAuth“ klientas“.
Ką nustatote
Kuriate „Databricks“ programėlės ryšį savo „ChatGPT“ paskyrai arba darbo erdvei. Abiem būdams reikia „ChatGPT“ prašomų „Databricks“ teikėjo duomenų ir leidimų naudotis numatytais ištekliais. Jei naudojate pasirinktinį „OAuth“ klientą, taip pat paruoškite:
„Databricks OAuth“ programėlės ryšį, sukurtą jūsų „Databricks“ paskyros konsolėje.
„Databricks OAuth“ kliento ID ir kliento slaptąją reikšmę.
Tikslų atgalinio iškvietimo URL, nukopijuotą iš „ChatGPT“.
„Databricks“ prieigos sritis, atitinkančias norimas įjungti jungties funkcijas.
Visus „ChatGPT“ nustatymo metu prašomus „Databricks“ teikėjo duomenis, pvz., darbo erdvės pagrindinį kompiuterį, paskyros pagrindinį kompiuterį, paskyros ID ar duomenų saugyklą.
Prieš pradedant
Jei sąranką atliekate darbo erdvei, atverkite administravimo konsolę, pasirinkite reikiamą „ChatGPT“ darbo erdvę ir atverkite „Papildiniai“. Pasirinkite „Tvarkyti senąsias programėles“, kad atvertumėte išsaugotą programėlių puslapį. Apie naršymą darbo erdvėje ir prieigą prie senųjų programėlių skaitykite straipsnyje Papildinių ir programėlių administravimo valdikliai, saugumas ir atitiktis.
Jums reikės:
„ChatGPT“ darbo erdvės administratoriaus ar savininko teisių arba „ChatGPT Plus“ ar „Pro“ paskyros.
Jei naudosite pasirinktinį „OAuth“ klientą – „Databricks“ paskyros administratoriaus teisių. Kai kurioms užduotims gali pakakti darbo erdvės administratoriaus teisių, tačiau pasirinktiniai programėlių ryšiai konfigūruojami „Databricks“ paskyros konsolėje. Jei naudosite integruotąjį „OAuth“, „Databricks“ administratorius turi patikrinti, ar „ChatGPT“ programėlė pasiekiama ir įjungta jūsų darbo erdvėje.
Jei naudosite pasirinktinį „OAuth“ klientą – atskirame skirtuke atvertos „Databricks“ paskyros konsolės.
Jei naudosite pasirinktinį „OAuth“ klientą – „ChatGPT“ atverto „Databricks Genie“ prijungimo lango, kad galėtumėte tiksliai nukopijuoti grįžtamojo iškvietimo URL.
Nuspręsti, kokių funkcijų reikia programėlei: „Genie“ ir AI/BI ataskaitų sričių, platesnės „Databricks“ API prieigos ar tik „Databricks SQL“ API. Vien SQL prieigos nepakanka „Genie“ ar ataskaitų sričių veiksmams.
Jei naudosite pasirinktinį „OAuth“ klientą – saugios vietos „Databricks“ kliento slaptajam raktui tvarkyti.
Jei jūsų „Databricks“ paskyroje ar darbo erdvėje prieiga ribojama IP prieigos sąrašu, kontekstu pagrįsta įeinančio srauto valdymo priemone, užkarda ar kita tinklo politika – „Databricks“ administratoriaus pagalbos, kad jis leistų dabartinius „ChatGPT“ jungčių išeinančio srauto IP adresų diapazonus.
Jei naudojate pasirinktinį „OAuth“ klientą, tiksliai nukopijuokite „ChatGPT“ rodomą grįžtamojo iškvietimo URL.
Reikšmės, kurias reikia paruošti
Pasirinktiniam „OAuth“ klientui – grįžtamojo iškvietimo URL: nukopijuokite jį iš „ChatGPT“ jungties sąrankos.
Pasirinktiniam „OAuth“ klientui – „Databricks OAuth“ kliento ID.
Pasirinktiniam „OAuth“ klientui – „Databricks OAuth“ kliento slaptasis raktas.
Pasirinktiniam „OAuth“ klientui – programėlės funkcijas atitinkančios „Databricks“ prieigos sritys. Jei kuriant naują „Genie“ ir ataskaitų sričių ryšį rodomos
ai-gateway,dashboardsiroffline_accessprieigos sritys, paruoškite jas. VISOS API (all-apissuoffline_access) tebėra senesnė, platesnę prieigą suteikianti alternatyva. SQL naudokite tik programėlei, naudojančiai vien „Databricks SQL“ API.„Databricks“ darbo erdvės arba paskyros laukų reikšmės, kurių prašoma atliekant „ChatGPT“ sąranką.
Integruotasis „OAuth“
Pirmiausia įvykdykite pirmiau nurodytas būtinas sąlygas. Šį būdą naudokite tik tada, kai integruotasis „OAuth“ pasiekiamas „ChatGPT“ ir įjungtas jūsų „Databricks“ darbo erdvėje.
Paprašykite „Databricks“ administratoriaus patikrinti, ar „ChatGPT“ programėlė pasiekiama paskyros konsolės programėlių integravimo nustatymuose ir įjungta jūsų darbo erdvėje. Jei „ChatGPT“ programėlės nėra jūsų „Databricks“ paskyros konsolės sąraše, kreipkitės į jūsų paskyrą aptarnaujantį „Databricks“ atstovą ir paklauskite, ar ši funkcija pasiekiama jūsų paskyrai.
„ChatGPT“ perjunkite į paskyrą arba darbo erdvę, kurioje programėlė turėtų būti pasiekiama. Jei sąranką atliekate sau, eikite į Nustatymai > Papildiniai. Jei ją atliekate darbo erdvei kaip jos administratorius ar savininkas, eikite į Administravimo konsolė > Papildiniai.
Pasirinkite „Databricks Genie“, tada – „Pridėti programėlės ryšį“.
Įveskite darbo erdvės pagrindinio kompiuterio vardą (privaloma) be
https://ar URL kelio.Pagal šį pagrindinio kompiuterio vardą „ChatGPT“ nustato vietinį darbo erdvės „Genie MCP“ prieigos tašką:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Atskiro regioninio MCP prieigos taško nereikia.Pasirinkite „Tęsti“, tada prisijunkite prie „Databricks“ ir peržiūrėkite sutikimo užklausą.
Toliau atlikite veiksmus, aprašytus toliau esančiuose skyriuose „Prijunkite ir išbandykite“ bei „Valdykite prieigą“, įskaitant bandymus su leidimą turinčiais nariais ir darbo erdvės prieigos patikras.
Pasirinktinis „OAuth“ klientas
Pirmiausia įvykdykite pirmiau nurodytas būtinas sąlygas. Rinkitės šį būdą, jei integruotas „OAuth“ nepasiekiamas arba jūsų organizacija reikalauja naudoti savo „OAuth“ klientą. Baigę nustatymą, atlikite toliau pateiktų skyrių „Prijunkite ir išbandykite“ bei „Valdykite prieigą“ veiksmus.
Pradėkite pasirinktinio „OAuth“ kliento sąranką „ChatGPT“
„ChatGPT“ perjunkite į paskyrą arba darbo erdvę, kurioje programėlė turėtų būti pasiekiama.
Jei sąranką atliekate sau, eikite į Nustatymai > Papildiniai. Jei ją atliekate darbo erdvei kaip jos administratorius ar savininkas, eikite į Administravimo konsolė > Papildiniai.
Kataloge pasirinkite „Databricks Genie“.
Pasirinkite „Pridėti programėlės ryšį“.
Dialogo lange „Prijungti Databricks Genie“ raskite laukus „OAuth“ kliento ID ir „OAuth“ kliento slaptasis raktas. Įvedus prisijungimo duomenis šiuose matomuose laukuose, atliekama pasirinktinio kliento sąranka; atskirai jo pasirinkti nereikia.
Nukopijuokite grįžtamojo iškvietimo URL iš „ChatGPT“. Palikite šį dialogo langą atvertą.
Grįžtamojo iškvietimo URL pavyzdys:
https://chatgpt.com/connector/oauth/<callback_id>
Nepašalinkite grįžtamojo iškvietimo ID, nepridėkite pasvirojo brūkšnio pabaigoje ir nepakeiskite šio adreso bendruoju „ChatGPT“ URL. „Databricks“ užregistruotas URL turi tiksliai atitikti „ChatGPT“ rodomą grįžtamojo iškvietimo URL.
Sukurkite pasirinktinį „OAuth“ programėlės ryšį „Databricks“
Atverkite savo „Databricks“ paskyros konsolę.
Kairėje šoninėje juostoje atverkite nustatymus.
Atverkite skirtuką Programėlių ryšiai.
Pasirinkite „Pridėti ryšį“.
Įveskite programėlės pavadinimą, pvz., „ChatGPT Databricks jungtis“.
Lauke Peradresavimo URL įklijuokite tikslų grįžtamojo iškvietimo URL, nukopijuotą iš „ChatGPT“.
Skiltyje Prieigos sritys pasirinkite programėlei reikalingas sritis.
Jei kuriant naują „Genie“ ir ataskaitų sričių ryšį „ChatGPT“ rodomos
ai-gateway,dashboardsiroffline_accessprieigos sritys, leiskite tas pačias sritis „Databricks OAuth“ programėlėje.VISOS API tebėra senesnė, platesnę prieigą suteikianti alternatyva bendrajai „Databricks“ API prieigai. Pasirinkę šią konfigūraciją, „ChatGPT“ naudokite
all-apisiroffline_accessir įsitikinkite, kad „Databricks OAuth“ programėlėje leidžiamos abi. Naujam „Genie“ ir ataskaitų sričių ryšiui pirmenybę teikite rodomoms detalioms prieigos sritims.SQL naudokite tik programėlei, naudojančiai vien „Databricks SQL“ API. Vien SQL prieigos nepakanka „Genie“ ar ataskaitų sričių veiksmams.
Įsitikinkite, kad kiekviena vėliau „ChatGPT“ nurodyta prieigos sritis įjungta šioje „Databricks OAuth“ programėlėje. Naudotojo sąsajoje sukurtoms programėlėms „Databricks“ automatiškai leidžia openid, email, profile ir offline_access.
Jei jūsų organizacija neturi konkrečios politikos, palikite numatytąsias „Databricks“ prieigos raktų galiojimo trukmes (TTL): 60 minučių prieigos raktui ir 10080 minučių atnaujinimo prieigos raktui.
Įjunkite „Sugeneruoti kliento slaptąjį raktą“. Šiam procesui „ChatGPT“ reikia konfidencialiojo „OAuth“ kliento.
Sukurkite ryšį.
Nukopijuokite prisijungimo duomenis iš „Databricks“
Dialogo lange „Ryšys sukurtas“ nukopijuokite kliento ID.
Nedelsdami nukopijuokite kliento slaptąjį raktą ir saugiai jį išsaugokite.
Jei uždarysite dialogo langą nenukopijavę slaptojo rakto, sukurkite arba pakeiskite „OAuth“ programėlės prisijungimo duomenis ir naudokite naują slaptąjį raktą.
„Databricks“ slaptąjį raktą rodo tik vieną kartą. Saugokite jį kaip prisijungimo duomenis ir neįtraukite į ekrano kopijas, pagalbos užklausas, komentarus ar pokalbius.
Užbaikite pasirinktinio „OAuth“ kliento sąranką „ChatGPT“
Grįžkite į dialogo langą „Prijungti Databricks Genie“.
Lauke „OAuth“ kliento ID įveskite „Databricks“ kliento ID.
Lauke „OAuth“ kliento slaptasis raktas įveskite „Databricks“ kliento slaptąjį raktą.
Įvedus šiuos prisijungimo duomenis, naudojamas jūsų pasirinktinis „OAuth“ klientas; atskirai jo pasirinkti nereikia.
Lauke Prieigos sritys (neprivaloma) įveskite prieigos sritis, reikalingas jūsų programėlės „Databricks“ prieigos taškui ir funkcijoms. Jos turi atitikti „Databricks OAuth“ programėlėje įjungtas prieigos sritis.
Jei kuriant naują „Genie“ ir ataskaitų sričių ryšį rodomos
ai-gateway,dashboardsiroffline_accessprieigos sritys, jas palikite. Įsitikinkite, kad „Databricks OAuth“ programėlėje leidžiamos tos pačios prieigos sritys.ai-gatewayleidžia naudoti vietinį darbo erdvės „Genie MCP“ ryšį,dashboards– atlikti AI/BI ataskaitų sričių veiksmus, ooffline_access– naudoti atnaujinimo prieigos raktus.Senesnė, platesnę prieigą suteikianti alternatyva –
all-apisiroffline_access– tebepalaikoma platesnei API prieigai, tačiau šiam „Genie“ ir ataskaitų sričių ryšiui ji nerekomenduojama. Jei „Databricks“ programėlėje leidžiama tikall-apis, atnaujinkite arba iš naujo sukurkite programėlę, kad joje būtų leidžiamosai-gateway,dashboardsiroffline_access. Jei detalios prieigos sritys neprieinamos, „ChatGPT“ aiškiai nustatykiteall-apisiroffline_accessir įsitikinkite, kad „Databricks“ programėlėje leidžiamos abi. Neprašykite trijų detalių prieigos sričių „ChatGPT“, jei „Databricks“ programėlėje leidžiama tikall-apis.Kiekvieną prieigos sritį įveskite atskiroje eilutėje arba atskirkite jas kableliais. Kiekviena „ChatGPT“ nurodyta prieigos sritis turi būti įjungta „Databricks OAuth“ programėlėje.
Įveskite darbo erdvės pagrindinio kompiuterio vardą (privaloma) be https:// ar URL kelio. Užpildykite visus kitus privalomus „Databricks“ teikėjo laukus, rodomus sąrankos metu.
Pagal šį pagrindinio kompiuterio vardą „ChatGPT“ nustato vietinį darbo erdvės „Genie MCP“ prieigos tašką:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Atskiro regioninio MCP prieigos taško nereikia.Pasirinkite „Tęsti“.
„ChatGPT“ prašo tik tų prieigos sričių, kurios įvestos lauke Prieigos sritys (neprivaloma). Platesnę prieigą suteikiančių šablono sričių automatiškai nepridedama.
Prijunkite ir išbandykite
Pasirinkę bet kurį „OAuth“ būdą, atlikite toliau nurodytus ryšio bandymus ir prieigos patikras.
Peržiūrėkite jungties informaciją, veiksmus ir autentifikavimo nustatymus.
Jei esate darbo erdvės administratorius, įjunkite jungtį darbo erdvėje ir pagal jos politiką nustatykite, kas gali ją naudoti.
Naudodami leidimą turinčią bandomąją naudotojo paskyrą, „ChatGPT“ pradėkite prijungimo procesą, tada prisijunkite prie „Databricks“.
Patikrinkite, ar naršyklėje atveriama numatyta „Databricks“ paskyra arba darbo erdvė.
Peržiūrėkite prašomas prieigos sritis, tada pasirinkite „Suteikti įgaliojimą“.
Įsitikinkite, kad naršyklė grįžta į „ChatGPT“, o jungtis rodoma kaip prijungta.
Atlikite mažos rizikos skaitymo veiksmą, atitinkantį ryšio galimybes. Jei naudojate „Genie“ ryšį, nusiųskite „Genie“ užklausą apie duomenis, prie kurių bandomoji naudotojo paskyra turi prieigą. Jei naudojate kitas palaikomas funkcijas, gaukite dabartinio naudotojo informaciją arba pateikite užklausą patvirtintam „Databricks SQL“ ištekliui. Patikrinkite, ar naudotojas turi reikiamas „Databricks“ išteklių naudojimo teises; vien „OAuth“ prieigos sritys nesuteikia prieigos prie duomenų.
Jei įjungti rašymo veiksmai, prieš pradėdami naudoti plačiau, išbandykite juos atlikdami aiškiai mažos rizikos „Databricks“ darbo eigą.
Jei sąranką atliekate darbo erdvei, paprašykite leidimą turinčio darbo erdvės nario be administratoriaus teisių prisijungti ir pakartoti mažos rizikos bandymą.
Valdykite prieigą
Prieigą valdo tiek „Databricks“, tiek „ChatGPT“.
„ChatGPT“ darbo erdvės administratoriai nustato, ar programėlė pasiekiama ir kaip nariai gali ja naudotis. Naudojant „Business“, administratoriai nustato, ar programėlė įjungta visoje darbo erdvėje. Peržiūrėkite „Databricks“ programėlių administravimo valdiklius („Darbo erdvės nustatymai > Programėlės“ arba „Administravimo konsolė > Įskiepiai > Tvarkyti senąsias programėles“):
„Naudotojų prieiga“ – nustatyti, kuriuos darbo erdvės vaidmenis turintys nariai gali naudoti jungtį palaikomose „Enterprise“ ir „Edu“ darbo erdvėse.
„Veiksmų valdymas“ – nustatyti, kurie „Databricks“ veiksmai įjungti.
„Programėlės leidimai“ – nustatyti, kada „ChatGPT“ prašo narių leidimo prieš naudodamas jungtį.
Šie programėlės leidimai taikomi „ChatGPT“ pokalbiams. Darbo erdvės agentams taikomi kiekvieno agento kūrėjo nustatyti valdikliai, pagal kuriuos nustatoma, kokie programėlės veiksmai pasiekiami ir kada galutinių naudotojų prašoma juos patvirtinti. Apie agentų veikimą skaitykite straipsnyje „ChatGPT“ darbo erdvės agentai „Enterprise“ ir „Business“ planams.
„Databricks“ administratoriai nustato, kurie naudotojai gali suteikti leidimą „OAuth“ programėlei ir kokius „Databricks“ išteklius tie naudotojai gali pasiekti. Teikėjo leidimai galioja ir įjungus programėlę „ChatGPT“.
Apie naršymą darbo erdvėje, prieigą prie programėlių ir konkretiems planams skirtus programėlių valdiklius skaitykite straipsnyje „Programėlių administravimo valdikliai, sauga ir atitiktis“.
„Databricks“ jungties sąrankos trikčių šalinimas
Nesutampa peradresavimo URI: jei naudojate pasirinktinį „OAuth“ klientą, patikrinkite, ar „Databricks“ lauko Peradresavimo URL reikšmė tiksliai atitinka „ChatGPT“ rodomą grįžtamojo iškvietimo URL, įskaitant jo kelią ir grįžtamojo iškvietimo ID. Nepašalinkite grįžtamojo iškvietimo ID, nepridėkite pasvirojo brūkšnio pabaigoje ir nenaudokite kito „ChatGPT“ peradresavimo URL.
Trūksta slaptojo rakto: jei naudojate pasirinktinį „OAuth“ klientą, atminkite, kad „Databricks“ slaptieji raktai rodomi tik vieną kartą. Jei kliento slaptojo rakto nenukopijavote, sugeneruokite naują.
„OAuth“ programėlė pasiekiama ne iš karto: „Databricks“ nurodo, kad „OAuth“ programėlės atnaujinimai gali būti apdorojami iki 30 minučių.
Nepakankama arba nesutampanti prieigos sritis: jei naudojate pasirinktinį „OAuth“ klientą, palyginkite „ChatGPT“ lauko Prieigos sritys (neprivaloma) reikšmes su „Databricks OAuth“ programėlės prieigos sritimis. Ten turi būti įjungta kiekviena „ChatGPT“ prašoma prieigos sritis. Patikrinkite, ar prieigos sritys leidžia naudoti reikiamą prieigos tašką ir funkcijas.
Jei kuriant naują „Genie“ ir ataskaitų sričių ryšį rodomos
ai-gateway,dashboardsiroffline_accessprieigos sritys, palikite jas „ChatGPT“ ir įsitikinkite, kad „Databricks“ programėlėje leidžiamos visos trys. Jei programėlėje leidžiama tikall-apis, atnaujinkite arba iš naujo sukurkite programėlę, kad joje būtų leidžiamos trys detalios prieigos sritys.Jei detalios prieigos sritys neprieinamos, naudokite palaikomą platesnės prieigos alternatyvą: „ChatGPT“ nustatykite
all-apisiroffline_accessir įsitikinkite, kad „Databricks“ programėlėje leidžiamos abi. Programėlė, kurioje leidžiama tikall-apis, neatitinka „ChatGPT“ užklausos, kuria prašomaai-gateway,dashboardsiroffline_access. Tik SQL prieiga tinka tik programėlei, naudojančiai vien „Databricks SQL“ API; jos nepakanka „Genie“ ar ataskaitų sričių veiksmams.SQL veiksmai nepavyksta: jei programėlė naudoja tik „Databricks SQL“ API, patikrinkite SQL prieigos sritį, duomenų saugyklos konfigūraciją ir „Databricks“ teises.
Netinkama „ChatGPT“ darbo erdvė: sukurkite ir įjunkite jungtį toje pačioje „ChatGPT“ darbo erdvėje, kurioje naudotojai ją prijungs.
Netinkama „Databricks“ paskyra arba darbo erdvė: patikrinkite lauko Darbo erdvės pagrindinio kompiuterio vardas (privaloma) reikšmę, tada iš naujo prisijunkite ir įsitikinkite, kad „Databricks“ atveria numatytą paskyrą arba darbo erdvę.
Naudotojai negali prisijungti: patikrinkite, ar naudotojas turi prieigą prie „Databricks“ ir ar jam leidžiama suteikti įgaliojimą „OAuth“ programėlei. Jei naudojate „Business“, patikrinkite, ar programėlė įjungta visoje darbo erdvėje. Palaikomose „Enterprise“ ir „Edu“ darbo erdvėse taip pat patikrinkite, ar „ChatGPT“ nustatymas Naudotojų prieiga leidžia naudoti jungtį.
„Databricks“ tinklo politika blokuoja jungtį: jei „Databricks“ leidžia ryšius tik iš konkrečių šaltinio IP adresų, „Databricks“ administratorius turi atnaujinti atitinkamus paskyros ar darbo erdvės IP prieigos sąrašus, kontekstu pagrįstas įeinančio srauto valdymo priemones, užkardą ar kitas kliento valdomas tinklo taisykles.
Leiskite įeinančius ryšius iš dabartinių „ChatGPT“ jungčių išeinančio srauto IP adresų diapazonų.
Šį leidžiamųjų adresų sąrašą sukonfigūruokite „Databricks“ arba kliento valdomame tinklo sluoksnyje. Jis yra atskiras nuo „ChatGPT“ darbo erdvės leidžiamųjų IP adresų sąrašo.
Paskelbti diapazonai gali keistis. Jei įmanoma, automatizuokite atnaujinimą pagal JSON duomenis.
Nekeiskite kliento slaptojo rakto ar „OAuth“ prieigos sričių bandydami apeiti tinklo blokavimą. Pirmiausia patikrinkite, ar „Databricks“ atmeta jungties šaltinio IP adresus.