Folosește acest ghid dacă ești administrator al unui spațiu de lucru ChatGPT sau utilizator ChatGPT Plus ori Pro și configurezi aplicația Databricks Genie folosind OAuth integrat sau clientul OAuth al organizației tale.
OAuth integrat: Folosește conexiunea preconfigurată atunci când este disponibilă în ChatGPT și activată pentru spațiul tău de lucru Databricks. Nu trebuie să creezi o aplicație OAuth sau să introduci un ID de client ori un secret de client. Urmează instrucțiunile din secțiunea OAuth integrat de mai jos.
Client OAuth personalizat: Alege această variantă dacă OAuth integrat nu este disponibil sau dacă organizația ta impune folosirea propriului client OAuth. Urmează instrucțiunile din secțiunea Client OAuth personalizat de mai jos.
Ce configurezi
Creezi o conexiune la aplicația Databricks pentru contul sau spațiul tău de lucru ChatGPT. Ambele variante necesită detaliile furnizorului Databricks solicitate în ChatGPT și permisiuni pentru resursele pe care intenționezi să le folosești. Dacă folosești un client OAuth personalizat, pregătește și:
O conexiune la o aplicație OAuth Databricks, creată în consola contului Databricks.
ID-ul și secretul clientului OAuth Databricks.
URL-ul exact de callback, copiat din ChatGPT.
Domenii de acces Databricks care corespund funcționalităților aplicației pe care vrei să le activezi.
Toate detaliile furnizorului Databricks solicitate în procesul de configurare ChatGPT, precum gazda spațiului de lucru, gazda contului, ID-ul contului sau depozitul de date.
Înainte de a începe
Pentru configurarea unui spațiu de lucru, deschide consola de administrare, selectează spațiul de lucru ChatGPT dorit și deschide Pluginuri. Selectează Gestionează aplicațiile vechi pentru a deschide pagina Aplicații păstrată pentru acestea. Pentru navigarea în spațiul de lucru și accesul la aplicațiile vechi, consultă Controale de administrare, securitate și conformitate pentru pluginuri și aplicații.
Ai nevoie de:
Acces de administrator sau de proprietar al spațiului de lucru ChatGPT ori un cont ChatGPT Plus sau Pro.
Pentru un client OAuth personalizat, acces de administrator al contului Databricks. Accesul de administrator al spațiului de lucru poate fi suficient pentru unele sarcini, dar conexiunile la aplicații personalizate se configurează din consola contului Databricks. Pentru OAuth integrat, un administrator Databricks trebuie să verifice dacă aplicația ChatGPT este disponibilă și activată pentru spațiul tău de lucru.
Pentru un client OAuth personalizat, consola contului Databricks deschisă într-o filă separată.
Pentru un client OAuth personalizat, ecranul de conectare Databricks Genie deschis în ChatGPT, pentru a putea copia URL-ul exact de callback.
O decizie privind funcționalitățile necesare aplicației: Genie și tablouri de bord AI/BI, acces mai larg la API-urile Databricks sau o aplicație limitată la API-urile SQL Databricks. Accesul exclusiv SQL nu este suficient pentru acțiuni în Genie sau în tablouri de bord.
Pentru un client OAuth personalizat, un loc sigur în care să gestionezi secretul clientului Databricks.
Dacă accesul la contul sau spațiul tău de lucru Databricks este restricționat printr-o listă de acces IP, un control de acces de intrare bazat pe context, un firewall sau o altă politică de rețea, ajutorul unui administrator Databricks care poate permite intervalele actuale de IP-uri de ieșire ale aplicațiilor ChatGPT.
Pentru un client OAuth personalizat, copiază exact valoarea URL de callback afișată în ChatGPT.
Valori de pregătit
Pentru un client OAuth personalizat, URL de callback: copiază-l din procesul de configurare a aplicației în ChatGPT.
Pentru un client OAuth personalizat, ID-ul clientului OAuth Databricks.
Pentru un client OAuth personalizat, secretul clientului OAuth Databricks.
Pentru un client OAuth personalizat, domenii de acces Databricks adecvate funcționalităților aplicației. Pentru o conexiune nouă la Genie sau la tablouri de bord care afișează
ai-gateway,dashboardsșioffline_access, pregătește aceste domenii de acces. TOATE API-urile (all-apisîmpreună cuoffline_access) rămâne alternativa mai veche, cu acces mai larg. Folosește SQL doar pentru o aplicație limitată la API-urile SQL Databricks.Câmpurile pentru spațiul de lucru sau contul Databricks solicitate în procesul de configurare ChatGPT.
OAuth integrat
Îndeplinește mai întâi cerințele preliminare de mai sus. Folosește această metodă doar dacă OAuth integrat este disponibil în ChatGPT și activat pentru spațiul tău de lucru Databricks.
Cere unui administrator Databricks să verifice dacă aplicația ChatGPT este disponibilă în setările de integrare a aplicațiilor din consola contului și dacă este activată pentru spațiul tău de lucru. Dacă aplicația ChatGPT nu apare în consola contului Databricks, contactează reprezentantul Databricks responsabil de contul tău pentru a afla dacă funcția este disponibilă pentru acesta.
În ChatGPT, comută la contul sau spațiul de lucru în care ar trebui să fie disponibilă aplicația. Accesează Setări > Pluginuri pentru o configurare personală sau Consola de administrare > Pluginuri, ca administrator sau proprietar al spațiului de lucru, pentru configurarea la nivel de spațiu de lucru.
Selectează Databricks Genie, apoi Adaugă o conexiune la aplicație.
Completează câmpul Numele gazdei spațiului de lucru (obligatoriu) fără
https://sau o cale URL.ChatGPT determină punctul final MCP Genie local al spațiului de lucru,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, pe baza acestui nume de gazdă. Nu este necesar un punct final MCP regional separat.Selectează Continuă, apoi conectează-te la Databricks și examinează solicitarea de consimțământ.
Continuă cu secțiunile Conectare și testare și Gestionarea accesului de mai jos, inclusiv testele cu membri autorizați și verificările accesului la spațiul de lucru.
Client OAuth personalizat
Mai întâi, asigură-te că îndeplinești cerințele preliminare de mai sus. Alege această variantă dacă OAuth integrat nu este disponibil sau dacă organizația ta impune folosirea propriului client OAuth. După configurare, parcurge secțiunile Conectează și testează și Gestionează accesul de mai jos.
Începe configurarea OAuth personalizată în ChatGPT
În ChatGPT, comută la contul sau spațiul de lucru în care ar trebui să fie disponibilă aplicația.
Accesează Setări > Pluginuri pentru o configurare personală sau Consola de administrare > Pluginuri, ca administrator sau proprietar al spațiului de lucru, pentru configurarea la nivel de spațiu de lucru.
Selectează Databricks Genie în Catalog.
Selectează Adaugă o conexiune la aplicație.
În caseta de dialog Conectează Databricks Genie, găsește câmpurile ID client OAuth și Secret client OAuth. Pentru a configura un client personalizat, introdu credențialele în aceste câmpuri vizibile; nu este necesară o selecție separată.
Copiază valoarea URL de callback din ChatGPT. Lasă această casetă de dialog deschisă.
Exemplu de URL de callback:
https://chatgpt.com/connector/oauth/<callback_id>
Nu elimina ID-ul de callback, nu adăuga o bară oblică la final și nu înlocui adresa cu un URL ChatGPT generic. URL-ul înregistrat în Databricks trebuie să corespundă exact cu URL de callback afișat în ChatGPT.
Creează o conexiune la o aplicație OAuth personalizată în Databricks
Deschide consola contului Databricks pentru contul tău Databricks.
În bara laterală din stânga, deschide Setări.
Deschide fila Conexiuni la aplicații.
Selectează Adaugă o conexiune.
Introdu un nume pentru aplicație, de exemplu ChatGPT Databricks.
În URL-uri de redirecționare, lipește URL-ul exact de callback copiat din ChatGPT.
În Domenii de acces, alege domeniile de acces de care are nevoie aplicația.
Pentru o conexiune nouă la Genie sau la tablouri de bord care afișează
ai-gateway,dashboardsșioffline_accessîn ChatGPT, permite aceleași domenii de acces în aplicația OAuth Databricks.TOATE API-urile rămâne alternativa mai veche, cu acces mai larg, pentru acces general la API-urile Databricks. Pentru această configurație, folosește
all-apisșioffline_accessîn ChatGPT și asigură-te că aplicația OAuth Databricks le permite pe ambele. Pentru o conexiune nouă la Genie sau la tablouri de bord, alege de preferință domeniile de acces granulare afișate.Folosește SQL doar pentru o aplicație limitată la API-urile SQL Databricks. Accesul exclusiv SQL nu este suficient pentru acțiuni în Genie sau în tablouri de bord.
Asigură-te că fiecare domeniu de acces afișat ulterior în ChatGPT este activat în această aplicație OAuth Databricks. Databricks permite automat openid, email, profile și offline_access pentru aplicațiile create în interfața de utilizare.
Păstrează duratele de valabilitate (TTL) implicite din Databricks pentru tokenuri, dacă organizația ta nu are o politică specifică: 60 de minute pentru tokenul de acces și 10080 de minute pentru tokenul de reîmprospătare.
Activează Generează un secret de client. ChatGPT are nevoie de un client OAuth confidențial pentru acest proces.
Creează conexiunea.
Copiază datele de autentificare din Databricks
În caseta de dialog Conexiune creată, copiază valoarea din ID client.
Copiază imediat valoarea din Secret client și păstreaz-o în siguranță.
Dacă închizi caseta de dialog înainte de a copia secretul, creează sau înlocuiește datele de autentificare ale aplicației OAuth și folosește noul secret.
Databricks afișează secretul o singură dată. Protejează-l ca pe orice dată de autentificare și nu îl include în capturi de ecran, tichete de asistență, comentarii sau conversații.
Finalizează configurarea OAuth personalizată în ChatGPT
Revino la caseta de dialog Conectează Databricks Genie.
Introdu ID-ul clientului Databricks în ID client OAuth.
Introdu secretul clientului Databricks în Secret client OAuth.
Introducerea acestor credențiale activează utilizarea clientului tău OAuth personalizat; nu este necesară o selecție separată.
În Domenii de acces (opțional), introdu domeniile de acces necesare pentru punctul final Databricks și funcționalitățile aplicației tale. Asigură-te că acestea corespund domeniilor de acces activate în aplicația OAuth Databricks.
Pentru o conexiune nouă la Genie/tablouri de bord care afișează
ai-gateway,dashboardsșioffline_access, păstrează aceste domenii de acces. Asigură-te că aplicația OAuth Databricks permite aceleași domenii de acces.ai-gatewaypermite conexiunea MCP Genie locală a spațiului de lucru,dashboardspermite acțiuni pentru tablourile de bord AI/BI, iaroffline_accesspermite utilizarea tokenurilor de reîmprospătare.Alternativa mai veche și mai extinsă,
all-apisșioffline_access, este în continuare acceptată pentru acces API mai larg, dar nu este opțiunea preferată pentru această conexiune la Genie/tablouri de bord. Dacă aplicația Databricks permite doarall-apis, actualizeaz-o sau creeaz-o din nou pentru a permiteai-gateway,dashboardsșioffline_access. Dacă domeniile de acces granulare nu sunt disponibile, configurează explicit ChatGPT să foloseascăall-apisșioffline_accessși asigură-te că aplicația Databricks le permite pe ambele. Nu solicita cele trei domenii de acces granulare în ChatGPT dacă aplicația Databricks permite doarall-apis.Introdu câte un domeniu de acces pe fiecare rând sau separă domeniile de acces prin virgule. Fiecare domeniu de acces specificat în ChatGPT trebuie să fie activat în aplicația OAuth Databricks.
Completează câmpul Numele gazdei spațiului de lucru (obligatoriu) fără https:// sau o cale URL. Completează orice alte câmpuri obligatorii pentru furnizorul Databricks afișate în procesul de configurare.
ChatGPT determină punctul final MCP Genie local al spațiului de lucru,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, pe baza acestui nume de gazdă. Nu este necesar un punct final MCP regional separat.Selectează Continuă.
ChatGPT solicită exact domeniile de acces introduse în Domenii de acces (opțional). Nu adaugă automat domenii de acces mai extinse din șablon.
Conectează și testează
Efectuează următoarele teste de conexiune și verificări ale accesului, indiferent de varianta OAuth aleasă.
Verifică detaliile aplicației, acțiunile și setările de autentificare.
Dacă ești administrator al spațiului de lucru, activează aplicația pentru acesta și stabilește cine o poate folosi, conform politicii spațiului de lucru.
Începe procesul de conectare din ChatGPT cu un utilizator de test care are acces, apoi autentifică-te în Databricks.
Verifică dacă browserul deschide contul sau spațiul de lucru Databricks dorit.
Verifică domeniile de acces solicitate, apoi selectează Autorizează.
Verifică dacă browserul revine la ChatGPT și dacă aplicația apare ca fiind conectată.
Execută o acțiune de citire cu risc scăzut, care corespunde funcționalităților conexiunii. Pentru o conexiune Genie, trimite o solicitare Genie despre date la care utilizatorul de test are permisiunea de acces. Pentru alte funcționalități acceptate, preia informațiile utilizatorului curent sau interoghează o resursă SQL Databricks aprobată. Verifică dacă utilizatorul are permisiunile necesare pentru resursele Databricks; domeniile de acces OAuth nu acordă, prin ele însele, acces la date.
Dacă sunt activate acțiuni de scriere, testează un flux de lucru Databricks cu risc evident scăzut înainte de a extinde utilizarea.
Pentru configurarea unui spațiu de lucru, roagă un membru al acestuia care are acces, dar nu este administrator, să se conecteze și să repete testul cu risc scăzut.
Gestionează accesul
Atât Databricks, cât și ChatGPT contribuie la controlul accesului.
În ChatGPT, administratorii spațiului de lucru stabilesc dacă aplicația este disponibilă și cum o pot folosi membrii. În Business, administratorii stabilesc dacă aplicația este activată în întregul spațiu de lucru. Verifică următoarele controale de administrare pentru aplicațiile Databricks (Setările spațiului de lucru > Aplicații sau Consola de administrare > Pluginuri > Gestionează aplicațiile vechi):
Accesul utilizatorilor, pentru a stabili ce roluri din spațiul de lucru pot folosi aplicația în spațiile de lucru Enterprise și Edu compatibile.
Controlul acțiunilor, pentru a stabili ce acțiuni Databricks sunt activate.
Permisiunile aplicației, pentru a stabili când le cere ChatGPT acordul membrilor înainte de a folosi aplicația.
Aceste permisiuni ale aplicației se aplică în conversațiile ChatGPT. Agenții spațiului de lucru folosesc controale individuale, configurate de creatorul fiecărui agent, pentru a stabili ce acțiuni ale aplicațiilor sunt disponibile și când li se cere utilizatorilor finali să le aprobe. Pentru comportamentul agenților, consultă: Agenții spațiului de lucru ChatGPT pentru Enterprise și Business.
În Databricks, administratorii stabilesc ce utilizatori pot autoriza aplicația OAuth și ce resurse Databricks pot accesa aceștia. Permisiunile furnizorului se aplică în continuare după activarea aplicației în ChatGPT.
Pentru navigarea în spațiul de lucru, accesul la aplicații și controalele aplicațiilor specifice fiecărui plan, consultă: Controale de administrare, securitate și conformitate în aplicații.
Depanarea configurării aplicației Databricks
URI de redirecționare necorespunzător: Dacă folosești un client OAuth personalizat, verifică dacă valoarea din URL-uri de redirecționare din Databricks corespunde exact cu URL de callback afișat în ChatGPT, inclusiv calea și ID-ul de callback. Nu elimina ID-ul de callback, nu adăuga o bară oblică la final și nu folosi un alt URL de redirecționare ChatGPT.
Secret lipsă: Dacă folosești un client OAuth personalizat, reține că secretele Databricks sunt afișate o singură dată. Generează un nou secret de client dacă nu l-ai copiat.
Aplicația OAuth nu este disponibilă imediat: Databricks precizează că procesarea actualizărilor aplicațiilor OAuth poate dura până la 30 de minute.
Domeniu de acces insuficient sau necorespunzător: Dacă folosești un client OAuth personalizat, compară Domenii de acces (opțional) din ChatGPT cu Domenii de acces din aplicația OAuth Databricks. Fiecare domeniu de acces solicitat de ChatGPT trebuie să fie activat acolo. Verifică dacă domeniile de acces permit utilizarea punctului final și a funcționalităților pe care le folosești.
Pentru o conexiune nouă la Genie sau la tablouri de bord care afișează
ai-gateway,dashboardsșioffline_access, păstrează aceste domenii de acces în ChatGPT și asigură-te că aplicația Databricks le permite pe toate trei. Dacă aplicația permite doarall-apis, actualizeaz-o sau creeaz-o din nou pentru a permite cele trei domenii de acces granulare.Dacă domeniile de acces granulare nu sunt disponibile, folosește alternativa acceptată, cu acces mai larg: setează
all-apisșioffline_accessîn ChatGPT și asigură-te că aplicația Databricks le permite pe ambele. O aplicație care permite doarall-apisnu corespunde unei solicitări ChatGPT pentruai-gateway,dashboardsșioffline_access. Accesul exclusiv SQL este adecvat doar pentru o aplicație limitată la API-urile SQL Databricks; nu este suficient pentru acțiuni în Genie sau în tablouri de bord.Acțiunile SQL eșuează: Pentru o aplicație limitată la API-urile SQL Databricks, verifică domeniul de acces SQL, configurația depozitului de date și permisiunile Databricks.
Spațiu de lucru ChatGPT greșit: Creează și activează aplicația în același spațiu de lucru ChatGPT în care utilizatorii o vor conecta.
Cont sau spațiu de lucru Databricks greșit: Verifică valoarea din Numele gazdei spațiului de lucru (obligatoriu), apoi repetă procesul de autentificare și verifică dacă Databricks deschide contul sau spațiul de lucru dorit.
Utilizatorii nu se pot conecta: Verifică dacă utilizatorul are acces la Databricks și are permisiunea de a autoriza aplicația OAuth. În Business, verifică dacă aplicația este activată în întregul spațiu de lucru. În spațiile de lucru Enterprise și Edu compatibile, verifică și dacă setarea Accesul utilizatorilor din ChatGPT permite utilizarea aplicației.
Politica de rețea Databricks blochează aplicația: Dacă Databricks permite doar anumite IP-uri sursă, un administrator Databricks trebuie să actualizeze listele de acces IP ale contului sau spațiului de lucru respectiv, controalele de acces de intrare bazate pe context, firewallul sau alte reguli de rețea gestionate de client.
Permite conexiunile de intrare din intervalele actuale de IP-uri de ieșire ale aplicațiilor ChatGPT.
Configurează această listă de IP-uri permise în Databricks sau la nivelul rețelei gestionate de client. Aceasta este separată de lista de IP-uri permise pentru spațiul de lucru ChatGPT.
Intervalele publicate se pot schimba. Automatizează actualizările pe baza fișierului JSON, dacă este posibil.
Nu înlocui secretul clientului și nu modifica domeniile de acces OAuth pentru a ocoli un blocaj de rețea. Verifică mai întâi dacă Databricks respinge IP-urile sursă ale aplicației.