Përdoreni këtë udhëzues nëse jeni administrator i një hapësire pune në ChatGPT ose përdorues i ChatGPT Plus apo Pro dhe po konfiguroni aplikacionin Databricks Genie me OAuth të integruar ose me klientin OAuth të organizatës suaj.
OAuth i integruar: Kur është i disponueshëm në ChatGPT dhe i aktivizuar për hapësirën tuaj të punës në Databricks, përdorni lidhjen e parakonfiguruar. Nuk keni nevojë të krijoni një aplikacion OAuth apo të vendosni një ID klienti ose sekret klienti. Ndiqni udhëzimet në seksionin OAuth i integruar më poshtë.
Klient OAuth i personalizuar: Përdorni këtë mënyrë nëse OAuth i integruar nuk është i disponueshëm ose organizata juaj kërkon klientin e vet OAuth. Ndiqni udhëzimet në seksionin Klient OAuth i personalizuar më poshtë.
Çfarë po konfiguroni
Po krijoni një lidhje me aplikacionin Databricks për llogarinë ose hapësirën tuaj të punës në ChatGPT. Të dyja mënyrat kërkojnë të dhënat e ofruesit Databricks që kërkohen në ChatGPT dhe lejet për burimet që planifikoni të përdorni. Nëse përdorni një klient OAuth të personalizuar, përgatitni gjithashtu:
Një lidhje aplikacioni OAuth të Databricks, të krijuar në Konsolën e llogarisë suaj në Databricks.
ID-në dhe sekretin e klientit OAuth të Databricks.
URL-në e saktë të kthimit, të kopjuar nga ChatGPT.
Fushat e autorizimit të Databricks që përputhen me funksionalitetet e aplikacionit që dëshironi të aktivizoni.
Çdo të dhënë të ofruesit Databricks që kërkohet gjatë konfigurimit në ChatGPT, si hosti i hapësirës së punës, hosti i llogarisë, ID-ja e llogarisë ose magazina e të dhënave.
Para se të filloni
Për konfigurimin e një hapësire pune, hapni konsolën e administrimit, zgjidhni hapësirën përkatëse të punës në ChatGPT dhe hapni Shtojcat. Zgjidhni Menaxho aplikacionet e vjetra për të hapur faqen Aplikacionet, e cila është ruajtur. Për lundrimin në hapësirën e punës dhe aksesin në aplikacionet e vjetra, shihni Kontrollet e administratorit, siguria dhe pajtueshmëria për shtojcat dhe aplikacionet.
Ju duhen:
Akses si administrator ose pronar i hapësirës së punës në ChatGPT, ose një llogari ChatGPT Plus apo Pro.
Për një klient OAuth të personalizuar, akses si administrator i llogarisë Databricks. Aksesi si administrator i hapësirës së punës mund të mjaftojë për disa detyra, por lidhjet e personalizuara të aplikacioneve konfigurohen nga Konsola e llogarisë në Databricks. Për OAuth të integruar, një administrator i Databricks duhet të kontrollojë që aplikacioni ChatGPT të jetë i disponueshëm dhe i aktivizuar për hapësirën tuaj të punës.
Për një klient OAuth të personalizuar, Konsola e llogarisë në Databricks e hapur në një skedë më vete.
Për një klient OAuth të personalizuar, ekrani i lidhjes me Databricks Genie i hapur në ChatGPT, që të mund të kopjoni URL-në e saktë të kthimit.
Një vendim për funksionalitetet që i nevojiten aplikacionit: Genie dhe panelet AI/BI, akses më i gjerë në API-të e Databricks ose një aplikacion i kufizuar në API-të SQL të Databricks. Aksesi vetëm në SQL nuk mjafton për veprimet me Genie ose panelet.
Për një klient OAuth të personalizuar, një vend i sigurt për të menaxhuar sekretin e klientit Databricks.
Nëse llogaria ose hapësira juaj e punës në Databricks kufizon aksesin përmes një liste aksesi sipas IP-së, kontrollit të trafikut hyrës sipas kontekstit, një muri mbrojtës ose një politike tjetër rrjeti, ndihma e një administratori të Databricks që mund të lejojë intervalet aktuale të IP-ve dalëse të aplikacioneve të ChatGPT.
Për një klient OAuth të personalizuar, kopjoni saktësisht URL-në e kthimit që shfaqet në ChatGPT.
Vlerat që duhen përgatitur
Për një klient OAuth të personalizuar, URL-ja e kthimit: kopjojeni nga procesi i konfigurimit të aplikacionit në ChatGPT.
Për një klient OAuth të personalizuar, ID-ja e klientit OAuth të Databricks.
Për një klient OAuth të personalizuar, sekreti i klientit OAuth të Databricks.
Për një klient OAuth të personalizuar, fushat e aksesit të Databricks që i përshtaten funksionaliteteve të aplikacionit. Për një lidhje të re me Genie/panelet që shfaq
ai-gateway,dashboardsdheoffline_access, përgatitni këto fusha autorizimi. TË GJITHA API-të (all-apismeoffline_access) mbetet alternativa më e vjetër dhe më e gjerë. Përdorni SQL vetëm për një aplikacion të kufizuar në API-të SQL të Databricks.Fushat e hapësirës së punës ose llogarisë në Databricks që kërkohen gjatë konfigurimit në ChatGPT.
OAuth i integruar
Së pari, plotësoni kushtet paraprake të mësipërme. Përdoreni këtë mënyrë vetëm kur OAuth i integruar është i disponueshëm në ChatGPT dhe i aktivizuar për hapësirën tuaj të punës në Databricks.
Kërkojini një administratori të Databricks të kontrollojë që aplikacioni ChatGPT është i disponueshëm te cilësimet e integrimeve të aplikacioneve në Konsolën e llogarisë dhe i aktivizuar për hapësirën tuaj të punës. Nëse aplikacioni ChatGPT nuk është i listuar në Konsolën e llogarisë suaj Databricks, kontaktoni përfaqësuesin përgjegjës për llogarinë tuaj Databricks për të pyetur nëse veçoria është e disponueshme për llogarinë tuaj.
Në ChatGPT, kaloni te llogaria ose hapësira e punës ku duhet të jetë i disponueshëm aplikacioni. Shkoni te Cilësimet > Shtojcat për konfigurim personal ose te Konsola e administratorit > Shtojcat si administrator apo zotërues i hapësirës së punës për të konfiguruar hapësirën e punës.
Zgjidhni Databricks Genie, pastaj zgjidhni Shto lidhje aplikacioni.
Vendosni Emrin e hostit të hapësirës së punës (i detyrueshëm) pa
https://dhe pa shteg URL-je.Nga ky emër hosti, ChatGPT përcakton pikën fundore Genie MCP lokale të hapësirës së punës,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Nuk nevojitet një pikë fundore MCP rajonale më vete.Zgjidhni Vazhdo, pastaj hyni në Databricks dhe shqyrtoni kërkesën për pëlqim.
Vazhdoni me seksionet Lidhni dhe testoni dhe Menaxhoni aksesin më poshtë, përfshirë testet me anëtarët e lejuar dhe kontrollet e aksesit në hapësirën e punës.
Klient OAuth i personalizuar
Së pari, përmbushni parakushtet e mësipërme. Përdorni këtë mënyrë nëse OAuth i integruar nuk ofrohet ose organizata juaj kërkon klientin e vet OAuth. Pas konfigurimit, plotësoni hapat në seksionet «Lidhni dhe testoni» dhe «Menaxhoni qasjen» më poshtë.
Filloni konfigurimin e OAuth të personalizuar në ChatGPT
Në ChatGPT, kaloni te llogaria ose hapësira e punës ku duhet të jetë i disponueshëm aplikacioni.
Shkoni te Cilësimet > Shtojcat për konfigurim personal ose te Konsola e administratorit > Shtojcat si administrator apo zotërues i hapësirës së punës për të konfiguruar hapësirën e punës.
Zgjidhni Databricks Genie te Katalogu.
Zgjidhni Shto lidhje aplikacioni.
Në kutinë e dialogut Lidh Databricks Genie, gjeni fushat ID-ja e klientit OAuth dhe Sekreti i klientit OAuth. Vendosja e kredencialeve në këto fusha të dukshme përbën procesin për klientin e personalizuar; nuk nevojitet një përzgjedhës më vete.
Kopjoni URL-në e kthimit nga ChatGPT. Mbajeni të hapur këtë kuti dialogu.
Shembull URL-je kthimi:
https://chatgpt.com/connector/oauth/<callback_id>
Mos e hiqni ID-në e kthimit, mos shtoni vijë të pjerrët në fund dhe mos e zëvendësoni me një URL të përgjithshme të ChatGPT. URL-ja e regjistruar në Databricks duhet të përputhet saktësisht me URL-në e kthimit të shfaqur në ChatGPT.
Krijoni një lidhje të personalizuar aplikacioni OAuth në Databricks
Hapni Konsolën e llogarisë në Databricks për llogarinë tuaj Databricks.
Në shiritin anësor majtas, hapni Cilësimet.
Hapni skedën Lidhjet e aplikacioneve.
Zgjidhni Shto lidhje.
Vendosni një emër aplikacioni, si p.sh. ChatGPT Databricks.
Te URL-të e ridrejtimit, ngjitni URL-në e saktë të kthimit që keni kopjuar nga ChatGPT.
Te Fushat e aksesit, zgjidhni fushat e autorizimit që i nevojiten aplikacionit.
Për një lidhje të re me Genie/panelet që shfaq
ai-gateway,dashboardsdheoffline_accessnë ChatGPT, lejoni të njëjtat fusha autorizimi në aplikacionin OAuth të Databricks.TË GJITHA API-të mbetet alternativa më e vjetër dhe më e gjerë për akses të përgjithshëm në API-të e Databricks. Për këtë konfigurim, përdorni
all-apisdheoffline_accessnë ChatGPT dhe sigurohuni që aplikacioni OAuth i Databricks t'i lejojë të dyja. Për një lidhje të re me Genie/panelet, jepuni përparësi fushave specifike të autorizimit që shfaqen.Përdorni SQL vetëm për një aplikacion të kufizuar në API-të SQL të Databricks. Aksesi vetëm në SQL nuk mjafton për veprimet me Genie ose panelet.
Sigurohuni që çdo fushë autorizimi e renditur më pas në ChatGPT të jetë e aktivizuar në këtë aplikacion OAuth të Databricks. Databricks lejon automatikisht openid, email, profile dhe offline_access për aplikacionet e krijuara në ndërfaqen e përdoruesit.
Mbajini afatet e vlefshmërisë (TTL) të tokenëve në vlerat e parazgjedhura të Databricks, përveçse kur organizata juaj ka një politikë të posaçme: 60 minuta për tokenin e aksesit dhe 10080 minuta për tokenin e rifreskimit.
Aktivizoni Gjenero një sekret klienti. ChatGPT ka nevojë për një klient OAuth konfidencial për këtë proces.
Krijoni lidhjen.
Kopjoni kredencialet nga Databricks
Në kutinë e dialogut Lidhja u krijua, kopjoni ID-në e klientit.
Kopjoni menjëherë Sekretin e klientit dhe ruajeni në mënyrë të sigurt.
Nëse e mbyllni kutinë e dialogut para se të kopjoni sekretin, krijoni ose zëvendësoni kredencialet e aplikacionit OAuth dhe përdorni sekretin e ri.
Databricks e shfaq sekretin vetëm një herë. Trajtojeni si kredencial dhe mos e përfshini në pamje ekrani, kërkesa për mbështetje, komente ose biseda.
Përfundoni konfigurimin e OAuth të personalizuar në ChatGPT
Kthehuni te kutia e dialogut Lidh Databricks Genie.
Vendosni ID-në e klientit Databricks te ID-ja e klientit OAuth.
Vendosni sekretin e klientit Databricks te Sekreti i klientit OAuth.
Duke vendosur këto kredenciale, përdorni klientin tuaj të personalizuar OAuth; nuk nevojitet një përzgjedhës më vete.
Te Fushat e autorizimit (opsionale), vendosni fushat e autorizimit që kërkohen për pikën fundore Databricks dhe funksionalitetet e aplikacionit tuaj. Sigurohuni që ato të përputhen me fushat e autorizimit të aktivizuara në aplikacionin OAuth të Databricks.
Për një lidhje të re me Genie/panelet që shfaq
ai-gateway,dashboardsdheoffline_access, mbajini këto fusha autorizimi. Sigurohuni që aplikacioni OAuth i Databricks të lejojë të njëjtat fusha autorizimi.ai-gatewaymundëson lidhjen Genie MCP lokale të hapësirës së punës,dashboardsmundëson veprimet në panelet AI/BI dheoffline_accessmundëson tokenët e rifreskimit.Alternativa më e vjetër dhe më e gjerë,
all-apisdheoffline_access, vazhdon të mbështetet për akses më të gjerë në API, por nuk parapëlqehet për këtë lidhje me Genie/panelet. Nëse aplikacioni Databricks lejon vetëmall-apis, përditësojeni ose rikrijojeni që të lejojëai-gateway,dashboardsdheoffline_access. Nëse fushat e hollësishme të autorizimit nuk janë të disponueshme, zgjidhni qëllimishtall-apisdheoffline_accessnë ChatGPT dhe sigurohuni që aplikacioni Databricks t'i lejojë të dyja. Mos i kërkoni tri fushat e hollësishme të autorizimit në ChatGPT kur aplikacioni Databricks lejon vetëmall-apis.Vendosni nga një fushë autorizimi për rresht ose ndajini me presje. Çdo fushë autorizimi e listuar në ChatGPT duhet të jetë e aktivizuar në aplikacionin OAuth të Databricks.
Vendosni Emrin e hostit të hapësirës së punës (i detyrueshëm) pa https:// dhe pa shteg URL-je. Plotësoni çdo fushë tjetër të detyrueshme të ofruesit Databricks që shfaqet gjatë konfigurimit.
Nga ky emër hosti, ChatGPT përcakton pikën fundore Genie MCP lokale të hapësirës së punës,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Nuk nevojitet një pikë fundore MCP rajonale më vete.Zgjidhni Vazhdo.
ChatGPT kërkon pikërisht fushat e autorizimit të vendosura te Fushat e autorizimit (opsionale). Ai nuk shton automatikisht fusha më të gjera autorizimi nga shablloni.
Lidhuni dhe testoni
Kryeni testet e mëposhtme të lidhjes dhe kontrollet e aksesit, pavarësisht mënyrës së zgjedhur të OAuth.
Shqyrtoni të dhënat e aplikacionit, veprimet dhe cilësimet e autentikimit.
Nëse jeni administrator i hapësirës së punës, aktivizojeni aplikacionin për të dhe konfiguroni kush mund ta përdorë, sipas politikës së hapësirës së punës.
Nisni procesin e lidhjes nga ChatGPT si përdorues testues me lejet përkatëse, pastaj hyni në Databricks.
Sigurohuni që shfletuesi të hapë llogarinë ose hapësirën e punës në Databricks që prisni.
Shqyrtoni fushat e kërkuara të autorizimit, pastaj zgjidhni Autorizo.
Verifikoni që shfletuesi të kthehet në ChatGPT dhe aplikacioni të shfaqet si i lidhur.
Ekzekutoni një veprim leximi me rrezik të ulët që përputhet me funksionalitetet e lidhjes. Për një lidhje me Genie, dërgoni një kërkesë në Genie për të dhëna ku përdoruesi testues ka leje aksesi. Për funksionalitete të tjera që mbështeten, merrni informacionin e përdoruesit aktual ose ekzekutoni një pyetje në një burim të miratuar SQL të Databricks. Sigurohuni që përdoruesi të ketë lejet e nevojshme për burimet e Databricks; vetëm fushat e autorizimit OAuth nuk japin akses në të dhëna.
Nëse veprimet e shkrimit janë të aktivizuara, testoni me një rrjedhë pune në Databricks që ka qartësisht rrezik të ulët, përpara se ta vini në përdorim më gjerësisht.
Për konfigurimin e një hapësire pune, kërkojini një anëtari me lejet përkatëse, por pa rol administratori, të lidhet dhe të përsërisë testin me rrezik të ulët.
Menaxhoni aksesin
Si Databricks, ashtu edhe ChatGPT kontribuojnë në kontrollin e aksesit.
Në ChatGPT, administratorët e hapësirës së punës menaxhojnë nëse aplikacioni është i disponueshëm dhe si mund ta përdorin anëtarët. Në Business, administratorët menaxhojnë nëse aplikacioni është i aktivizuar për të gjithë hapësirën e punës. Shqyrtoni kontrollet e administratorit për aplikacionet Databricks (Cilësimet e hapësirës së punës > Aplikacionet ose Konsola e administrimit > Shtojcat > Menaxho aplikacionet e vjetra) për:
Aksesin e përdoruesve, për të konfiguruar se cilat role në hapësirën e punës mund ta përdorin aplikacionin në hapësirat e punës Enterprise dhe Edu ku mbështetet kjo veçori.
Kontrollin e veprimeve, për të konfiguruar se cilat veprime të Databricks janë të aktivizuara.
Lejet e aplikacionit, për të konfiguruar se kur ChatGPT i pyet anëtarët para se ta përdorë aplikacionin.
Këto leje të aplikacionit zbatohen për bisedat në ChatGPT. Agjentët e hapësirës së punës përdorin kontrolle të veçanta për secilin agjent, të caktuara nga krijuesi i tij, për të përcaktuar cilat veprime të aplikacionit janë të disponueshme dhe kur përdoruesve fundorë u kërkohet t'i miratojnë ato. Për sjelljen e agjentëve, shihni: Agjentët e hapësirës së punës në ChatGPT për Enterprise dhe Business.
Në Databricks, administratorët menaxhojnë se cilët përdorues mund ta autorizojnë aplikacionin OAuth dhe në cilat burime të Databricks mund të kenë akses këta përdorues. Lejet e ofruesit vazhdojnë të zbatohen edhe pasi aplikacioni aktivizohet në ChatGPT.
Për lundrimin në hapësirën e punës, aksesin në aplikacione dhe kontrollet e aplikacioneve sipas planit, shihni: Kontrollet e administratorit, siguria dhe pajtueshmëria në aplikacione.
Zgjidhja e problemeve gjatë konfigurimit të aplikacionit Databricks
Mospërputhje e URI-së së ridrejtimit: Nëse përdorni një klient OAuth të personalizuar, sigurohuni që vlera te URL-të e ridrejtimit në Databricks të përputhet saktësisht me URL-në e kthimit që shfaqet në ChatGPT, përfshirë shtegun dhe ID-në e kthimit. Mos e hiqni ID-në e kthimit, mos shtoni një vijë të pjerrët në fund dhe mos e zëvendësoni URL-në me një URL tjetër ridrejtimi të ChatGPT.
Mungon sekreti: Nëse përdorni një klient OAuth të personalizuar, sekretet e Databricks shfaqen vetëm një herë. Gjeneroni një sekret të ri klienti nëse nuk e keni kopjuar.
Aplikacioni OAuth nuk është i disponueshëm menjëherë: Sipas Databricks, përpunimi i përditësimeve të aplikacionit OAuth mund të zgjasë deri në 30 minuta.
Fusha autorizimi të pamjaftueshme ose që nuk përputhen: Nëse përdorni një klient OAuth të personalizuar, krahasoni Fushat e autorizimit (opsionale) në ChatGPT me Fushat e aksesit në aplikacionin OAuth të Databricks. Çdo fushë autorizimi që kërkon ChatGPT duhet të jetë e aktivizuar aty. Sigurohuni që fushat e autorizimit të mbështesin pikën fundore dhe funksionalitetet që përdorni.
Për një lidhje të re me Genie/panelet që shfaq
ai-gateway,dashboardsdheoffline_access, mbajini këto fusha autorizimi në ChatGPT dhe sigurohuni që aplikacioni Databricks t'i lejojë të tria. Nëse aplikacioni lejon vetëmall-apis, përditësojeni ose krijojeni sërish që të lejojë të tria fushat specifike të autorizimit.Nëse fushat specifike të autorizimit nuk janë të disponueshme, përdorni alternativën më të gjerë që mbështetet: caktoni
all-apisdheoffline_accessnë ChatGPT dhe sigurohuni që aplikacioni Databricks t'i lejojë të dyja. Një aplikacion që lejon vetëmall-apisnuk përputhet me një kërkesë të ChatGPT përai-gateway,dashboardsdheoffline_access. Aksesi vetëm në SQL është i përshtatshëm vetëm për një aplikacion të kufizuar në API-të SQL të Databricks; ai nuk mjafton për veprimet me Genie ose panelet.Veprimet SQL dështojnë: Për një aplikacion të kufizuar në API-të SQL të Databricks, kontrolloni fushën e autorizimit SQL, konfigurimin e magazinës së të dhënave dhe lejet në Databricks.
Hapësirë pune e gabuar në ChatGPT: Krijojeni dhe aktivizojeni aplikacionin në të njëjtën hapësirë pune të ChatGPT ku përdoruesit do ta lidhin.
Llogari ose hapësirë pune e gabuar në Databricks: Kontrolloni vlerën te Emri i hostit të hapësirës së punës (i detyrueshëm), pastaj përsëritni procesin e hyrjes dhe verifikoni që Databricks hap llogarinë ose hapësirën e punës që prisni.
Përdoruesit nuk mund të lidhen: Sigurohuni që përdoruesi të ketë akses në Databricks dhe të ketë leje të autorizojë aplikacionin OAuth. Në Business, sigurohuni që aplikacioni të jetë i aktivizuar për të gjithë hapësirën e punës. Në hapësirat e punës Enterprise dhe Edu ku mbështetet kjo veçori, sigurohuni gjithashtu që cilësimi Aksesi i përdoruesve në ChatGPT ta lejojë aplikacionin.
Politika e rrjetit të Databricks bllokon aplikacionin: Nëse Databricks lejon vetëm IP të caktuara burimore, një administrator i Databricks duhet të përditësojë listat përkatëse të aksesit sipas IP-së për llogarinë ose hapësirën e punës, kontrollet e trafikut hyrës sipas kontekstit, murin mbrojtës ose rregulla të tjera të rrjetit që kontrollohen nga klienti.
Lejoni lidhjet hyrëse nga intervalet aktuale të IP-ve dalëse të aplikacioneve të ChatGPT.
Konfigurojeni këtë listë lejimi në Databricks ose në shtresën e rrjetit që kontrollohet nga klienti. Ajo është e veçantë nga lista e IP-ve të lejuara për hapësirën e punës në ChatGPT.
Intervalet e publikuara mund të ndryshojnë. Automatizoni përditësimet nga JSON kur është e mundur.
Mos e zëvendësoni sekretin e klientit dhe mos ndryshoni fushat e autorizimit OAuth për të anashkaluar një bllokim të rrjetit. Së pari kontrolloni nëse Databricks po refuzon IP-të burimore të aplikacionit.