Šis vadovas skirtas „ChatGPT“ darbo erdvės administratoriams ir „ChatGPT Plus“ ar „Pro“ naudotojams, nustatantiems „Databricks Genie“ programėlę 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 arba kliento slaptojo rakto. 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ūdais reikės „ChatGPT“ prašomų „Databricks“ teikėjo duomenų ir leidimų naudoti numatytus išteklius. Jei naudojate pasirinktinį „OAuth“ klientą, taip pat paruoškite:
„Databricks“ paskyros konsolėje sukurtą „Databricks OAuth“ programėlės ryšį.
„Databricks OAuth“ kliento ID ir kliento slaptąjį raktą.
Tikslų iš „ChatGPT“ nukopijuotą atgalinio iškvietimo URL.
„Databricks“ prieigos sritis, atitinkančias programėlės funkcijas, kurias norite įjungti.
Visus nustatant „ChatGPT“ prašomus „Databricks“ teikėjo duomenis, pvz., darbo erdvės pagrindinį kompiuterį, paskyros pagrindinį kompiuterį, paskyros ID arba duomenų saugyklą.
Prieš pradedant
Jei nustatote ryšį darbo erdvei, atidarykite administravimo konsolę, pasirinkite reikiamą „ChatGPT“ darbo erdvę ir atidarykite skiltį „Papildiniai“. Pasirinkite „Tvarkyti senąsias programėles“, kad atidarytumėte išsaugotą puslapį „Programėlės“. Apie naršymą darbo erdvėje ir prieigą prie senųjų programėlių skaitykite straipsnyje Papildinių ir programėlių administravimo valdikliai, sauga ir atitiktis.
Jums reikės:
„ChatGPT“ darbo erdvės administratoriaus arba savininko teisių arba „ChatGPT Plus“ ar „Pro“ paskyros.
Jei naudojate 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 naudojate integruotą „OAuth“, „Databricks“ administratorius turi patikrinti, ar „ChatGPT“ programėlė pasiekiama ir įjungta jūsų darbo erdvėje.
Jei naudojate pasirinktinį „OAuth“ klientą – atskirame skirtuke atidarytos „Databricks“ paskyros konsolės.
Jei naudojate pasirinktinį „OAuth“ klientą – „ChatGPT“ atidaryto „Databricks Genie“ prijungimo ekrano, kad galėtumėte nukopijuoti tikslų atgalinio iškvietimo URL.
Nuspręsti, kokių funkcijų reikia programėlei: „Genie“ ir AI/BI suvestinių, platesnės prieigos prie „Databricks“ API ar tik „Databricks SQL“ API. Vien SQL prieigos nepakanka „Genie“ ar suvestinių veiksmams.
Jei naudojate 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 grindžiamu įeinančio srauto valdymu, užkarda ar kita tinklo politika – „Databricks“ administratoriaus pagalbos, kad būtų leisti dabartiniai „ChatGPT“ programėlių išeinančio srauto IP adresų diapazonai.
Jei naudojate pasirinktinį „OAuth“ klientą, nukopijuokite tikslų „ChatGPT“ rodomą Atgalinio iškvietimo URL.
Reikšmės, kurias reikia paruošti
Jei naudojate pasirinktinį „OAuth“ klientą – Atgalinio iškvietimo URL: nukopijuokite jį iš „ChatGPT“ programėlės nustatymo lango.
Jei naudojate pasirinktinį „OAuth“ klientą – „Databricks OAuth“ kliento ID.
Jei naudojate pasirinktinį „OAuth“ klientą – „Databricks OAuth“ kliento slaptasis raktas.
Jei naudojate pasirinktinį „OAuth“ klientą – programėlės funkcijas atitinkančios „Databricks“ prieigos sritys. Jei nustatant naują „Genie“ ar suvestinių ryšį rodomos
ai-gateway,dashboardsiroffline_accessprieigos sritys, paruoškite jas. VISOS API (all-apiskartu suoffline_access) tebėra senesnė platesnės prieigos 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 nustatant „ChatGPT“.
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.
Pasirinktinio „OAuth“ programėlės ryšio kūrimas „Databricks“
Atidarykite savo „Databricks“ paskyros konsolę.
Kairiojoje šoninėje juostoje atidarykite Nustatymus.
Atidarykite skirtuką Programėlių ryšiai.
Pasirinkite Pridėti ryšį.
Įveskite programėlės pavadinimą, pvz., „ChatGPT Databricks“.
Į lauką Peradresavimo URL įklijuokite tikslų iš „ChatGPT“ nukopijuotą atgalinio iškvietimo URL.
Skiltyje Prieigos sritys pasirinkite programėlei reikalingas prieigos sritis.
Jei nustatant naują „Genie“ ar suvestinių ryšį „ChatGPT“ rodomos
ai-gateway,dashboardsiroffline_accessprieigos sritys, leiskite tas pačias sritis ir „Databricks OAuth“ programėlėje.VISOS API tebėra senesnė platesnės prieigos alternatyva bendrajai prieigai prie „Databricks“ API. Naudodami šią konfigūraciją, „ChatGPT“ nurodykite
all-apisiroffline_accessbei įsitikinkite, kad „Databricks OAuth“ programėlė leidžia abi prieigos sritis. Naujam „Genie“ ar suvestinių ryšiui pirmenybę teikite rodomoms detalesnėms prieigos sritims.SQL naudokite tik programėlei, naudojančiai vien „Databricks SQL“ API. Vien SQL prieigos nepakanka „Genie“ ar suvestinių veiksmams.
Įsitikinkite, kad šioje „Databricks OAuth“ programėlėje įjungta kiekviena prieigos sritis, kurią vėliau nurodysite „ChatGPT“. Per naudotojo sąsają sukurtoms programėlėms „Databricks“ automatiškai leidžia openid, email, profile ir offline_access.
Palikite numatytuosius „Databricks“ raktų galiojimo laikus (TTL), nebent jūsų organizacija taiko konkrečią politiką: 60 minučių prieigos raktui ir 10080 minučių atnaujinimo raktui.
Įjunkite parinktį Sugeneruoti kliento slaptąjį raktą. Šiai eigai „ChatGPT“ reikia konfidencialiojo „OAuth“ kliento.
Sukurkite ryšį.
Prisijungimo duomenų kopijavimas iš „Databricks“
Dialogo lange Ryšys sukurtas nukopijuokite Kliento ID.
Nedelsdami nukopijuokite Kliento slaptąjį raktą ir saugiai jį išsaugokite.
Jei uždarėte dialogo langą nenukopijavę slaptojo rakto, sukurkite arba pakeiskite „OAuth“ programėlės prisijungimo duomenis ir naudokite naują slaptąjį raktą.
„Databricks“ slaptąjį raktą parodo 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.
Prijungimas ir išbandymas
Kad ir kurį „OAuth“ būdą pasirinkote, atlikite toliau nurodytus ryšio bandymus ir prieigos patikras.
Peržiūrėkite programėlės informaciją, veiksmus ir autentifikavimo nustatymus.
Jei esate darbo erdvės administratorius, įjunkite programėlę darbo erdvėje ir pagal darbo erdvės politiką nustatykite, kas gali ją naudoti.
Naudodami leidimą turinčią bandomąją naudotojo paskyrą, pradėkite prijungimą „ChatGPT“, tada prisijunkite prie „Databricks“.
Patikrinkite, ar naršyklėje atidaroma numatyta „Databricks“ paskyra arba darbo erdvė.
Peržiūrėkite prašomas prieigos sritis, tada pasirinkite Suteikti prieigos teises.
Įsitikinkite, kad naršyklė grįžta į „ChatGPT“, o programėlė rodoma kaip prijungta.
Atlikite mažos rizikos skaitymo veiksmą, atitinkantį ryšio funkcijas. Jei naudojate „Genie“ ryšį, nusiųskite „Genie“ užklausą apie duomenis, kuriuos bandomajam naudotojui leidžiama pasiekti. Jei naudojate kitas palaikomas funkcijas, gaukite dabartinio naudotojo informaciją arba pateikite užklausą patvirtintam „Databricks SQL“ ištekliui. Patikrinkite, ar naudotojas turi reikiamus „Databricks“ išteklių leidimus; vien „OAuth“ prieigos sritys prieigos prie duomenų nesuteikia.
Jei įjungti rašymo veiksmai, prieš pradėdami naudoti plačiau išbandykite juos atlikdami aiškiai mažos rizikos „Databricks“ darbo eigą.
Jei nustatote ryšį darbo erdvei, paprašykite leidimą turinčio darbo erdvės nario be administratoriaus teisių prijungti programėlę ir pakartoti mažos rizikos bandymą.
Prieigos valdymas
Prieigą valdo ir „Databricks“, ir „ChatGPT“.
„ChatGPT“ darbo erdvės administratoriai nustato, ar programėlė pasiekiama ir kaip nariai gali ją naudoti. Naudojant „Business“, administratoriai nustato, ar programėlė įjungta visoje darbo erdvėje. Peržiūrėkite šiuos „Databricks“ programėlių administravimo valdiklius (Darbo erdvės nustatymai > Programėlės arba Administravimo konsolė > Papildiniai > Tvarkyti senąsias programėles):
Naudotojų prieiga – nustatykite, kokius vaidmenis turintys naudotojai gali naudoti programėlę palaikomose „Enterprise“ ir „Edu“ darbo erdvėse.
Veiksmų valdymas – nustatykite, kurie „Databricks“ veiksmai įjungti.
Programėlės leidimai – nustatykite, kada „ChatGPT“ prašo narių leidimo prieš naudodamas programėlę.
Šie programėlės leidimai taikomi „ChatGPT“ pokalbiams. Darbo erdvės agentai naudoja kiekvienam agentui jo kūrėjo parinktus valdymo nustatymus, 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, skirti „Enterprise“ ir „Business“.
„Databricks“ administratoriai nustato, kurie naudotojai gali suteikti prieigos teises „OAuth“ programėlei ir kokius „Databricks“ išteklius šie naudotojai gali pasiekti. Teikėjo leidimai taikomi ir įjungus programėlę „ChatGPT“.
Apie naršymą darbo erdvėje, prieigą prie programėlių ir konkrečių planų programėlių valdymo priemones skaitykite straipsnyje Programėlių administravimo valdikliai, sauga ir atitiktis.
„Databricks“ programėlės nustatymo trikčių šalinimas
Nesutampa peradresavimo URI: jei naudojate pasirinktinį „OAuth“ klientą, patikrinkite, ar „Databricks“ lauko Peradresavimo URL reikšmė tiksliai sutampa su „ChatGPT“ rodomu Atgalinio iškvietimo URL, įskaitant kelią ir atgalinio iškvietimo ID. Nepašalinkite atgalinio iškvietimo ID, nepridėkite pasvirojo brūkšnio pabaigoje ir nepakeiskite šio URL kitu „ChatGPT“ peradresavimo URL.
Trūksta slaptojo rakto: jei naudojate pasirinktinį „OAuth“ klientą, atminkite, kad „Databricks“ slaptieji raktai rodomi tik vieną kartą. Jei nenukopijavote kliento slaptojo rakto, sugeneruokite naują.
„OAuth“ programėlė pasiekiama ne iš karto: „Databricks“ nurodo, kad „OAuth“ programėlės atnaujinimų apdorojimas gali užtrukti iki 30 minučių.
Nepakankama arba nesutampanti prieigos sritis: jei naudojate pasirinktinį „OAuth“ klientą, palyginkite „ChatGPT“ lauką Prieigos sritys (neprivaloma) su „Databricks OAuth“ programėlės lauku Prieigos sritys. Ten turi būti įjungta kiekviena prieigos sritis, kurios prašo „ChatGPT“. Patikrinkite, ar prieigos sritys leidžia naudoti reikiamą prieigos tašką ir funkcijas.
Jei nustatant naują „Genie“ ar suvestinių ryšį rodomos
ai-gateway,dashboardsiroffline_accessprieigos sritys, palikite jas „ChatGPT“ ir įsitikinkite, kad „Databricks“ programėlė leidžia visas tris. Jei programėlė leidžia tikall-apis, atnaujinkite arba iš naujo sukurkite ją, kad leistų tas tris detalesnes prieigos sritis.Jei detalesnės prieigos sritys nepasiekiamos, naudokite palaikomą platesnės prieigos alternatyvą: „ChatGPT“ nustatykite
all-apisiroffline_accessbei įsitikinkite, kad „Databricks“ programėlė leidžia abi. Programėlė, leidžianti tikall-apis, neatitinka „ChatGPT“ užklausos, kurioje prašomaai-gateway,dashboardsiroffline_access. Vien SQL prieiga tinka tik programėlei, naudojančiai tik „Databricks SQL“ API; jos nepakanka „Genie“ ar suvestinių veiksmams.SQL veiksmai nepavyksta: jei programėlė naudoja tik „Databricks SQL“ API, patikrinkite SQL prieigos sritį, duomenų saugyklos konfigūraciją ir „Databricks“ leidimus.
Netinkama „ChatGPT“ darbo erdvė: sukurkite ir įjunkite programėlę 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 prisijunkite iš naujo ir įsitikinkite, kad „Databricks“ atidaro numatytą paskyrą arba darbo erdvę.
Naudotojai negali prisijungti: patikrinkite, ar naudotojas turi prieigą prie „Databricks“ ir jam leidžiama suteikti prieigos teises „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 programėlę.
„Databricks“ tinklo politika blokuoja programėlę: jei „Databricks“ leidžia tik konkrečius šaltinio IP adresus, „Databricks“ administratorius turi atnaujinti atitinkamus paskyros ar darbo erdvės IP prieigos sąrašus, kontekstu grindžiamas įeinančio srauto valdymo priemones, užkardą arba kitas kliento valdomas tinklo taisykles.
Leiskite įeinančius ryšius iš dabartinių „ChatGPT“ programėlių išeinančio srauto IP adresų diapazonų.
Sukonfigūruokite šį leidžiamųjų adresų sąrašą „Databricks“ arba kliento valdomame tinklo sluoksnyje. Jis yra atskiras nuo „ChatGPT“ darbo erdvės leidžiamųjų IP adresų sąrašo.
Skelbiami diapazonai gali keistis. Jei įmanoma, automatizuokite atnaujinimą pagal JSON duomenis.
Nebandykite apeiti tinklo blokavimo keisdami kliento slaptąjį raktą ar „OAuth“ prieigos sritis. Pirmiausia patikrinkite, ar „Databricks“ atmeta programėlės šaltinio IP adresus.