Folosiți acest ghid dacă sunteți administrator al unui spațiu de lucru ChatGPT și configurați șablonul aplicației Databricks pentru organizația dvs. Un șablon nu este aplicația finală pe care o folosesc membrii. Este un flux de configurare care creează o aplicație ciornă specifică spațiului de lucru după ce furnizați configurația Databricks necesară.
Pentru Databricks, cea mai mare parte a configurării are loc în Databricks Account Console. Creați o conexiune de aplicație OAuth personalizată, înregistrați URL-ul de callback ChatGPT, copiați acreditările de client generate, apoi lipiți aceste valori în fluxul de configurare a șablonului ChatGPT. După ce ChatGPT creează aplicația ciornă, o puteți publica și gestiona la fel ca pe alte aplicații din spațiul de lucru.
Ce configurați
Creați în ChatGPT o aplicație Databricks specifică spațiului de lucru. Aplicația folosește:
O conexiune de aplicație OAuth Databricks creată în Databricks Account Console.
ID-ul de client și secretul de client OAuth Databricks.
URL-ul de callback exact copiat din ChatGPT.
Domenii Databricks care corespund capabilităților conectorului pe care doriți să le activați.
Orice detalii despre furnizorul Databricks solicitate de fluxul de configurare ChatGPT, cum ar fi gazda spațiului de lucru, gazda contului, ID-ul contului sau depozitul.
Înainte de a începe
Aveți nevoie de:
Acces de administrator sau proprietar al spațiului de lucru ChatGPT.
Acces de administrator al contului Databricks. Accesul de administrator al spațiului de lucru poate fi suficient pentru unele sarcini, dar conexiunile de aplicații personalizate se configurează din Databricks Account Console.
Databricks Account Console deschisă într-o filă separată.
Ecranul de configurare a șablonului aplicației Databricks deschis în ChatGPT, ca să puteți copia URL-ul de callback exact.
O decizie privind necesitatea ca aplicația să aibă acces general la API-urile Databricks sau doar acces la Databricks SQL.
Un loc securizat pentru gestionarea secretului de client Databricks.
Nu inventați URL-ul de callback. Copiați URL-ul de callback exact afișat în ChatGPT.
Valori de pregătit
URL de callback: copiați-l din fluxul de configurare a șablonului ChatGPT.
ID de client OAuth Databricks.
Secret de client OAuth Databricks.
Domenii de acces Databricks, cum ar fi ALL APIs sau SQL.
Câmpurile spațiului de lucru sau ale contului Databricks solicitate de fluxul de configurare ChatGPT.
Publicați și gestionați aplicația în ChatGPT
Crearea aplicației ciornă nu o face disponibilă automat pentru membri. După examinarea ciornei:
Publicați aplicația ciornă.
Confirmați că aplicația apare în Setări spațiu de lucru > Aplicații > Activate.
Configurați Acces utilizator pentru rolurile care ar trebui să o folosească.
Examinați Control acțiuni pentru acțiunile Databricks expuse de aplicație.
Examinați Permisiuni aplicație pentru a alege când ChatGPT le cere membrilor acordul înainte de a folosi aplicația.
Cereți unui utilizator de testare permis să deschidă Aplicații în ChatGPT și să confirme că aplicația apare.
Aceste permisiuni ale aplicației se aplică conversațiilor ChatGPT. Agenții din spațiul de lucru folosesc controale per agent, setate de constructorul agentului, pentru a determina ce acțiuni ale aplicației sunt disponibile și când li se cere utilizatorilor finali să le aprobe. Pentru comportamentul agentului, consultați: Agenți ChatGPT din spațiul de lucru pentru Enterprise și Business.
Începeți configurarea șablonului în ChatGPT
În ChatGPT, comutați la spațiul de lucru în care aplicația ar trebui să fie disponibilă.
Deschideți Setări spațiu de lucru > Aplicații.
Selectați Director.
Căutați Databricks.
Selectați șablonul aplicației Databricks și începeți configurarea.
Introduceți un nume și o descriere clare pentru aplicație, cum ar fi Databricks sau Databricks - Data Platform.
În secțiunea client OAuth, copiați URL-ul de callback din ChatGPT. Păstrați această filă deschisă.
Exemplu de URL de callback: https://chatgpt.com/connector/oauth/<callback_id>
Nu eliminați ID-ul de callback, nu adăugați o bară oblică finală și nu îl înlocuiți cu un URL ChatGPT generic.
Creați conexiunea de aplicație OAuth în Databricks
Deschideți Databricks Account Console pentru contul dvs. Databricks.
În bara laterală din stânga, deschideți Setări.
Deschideți fila Conexiuni de aplicații.
Selectați Adăugați conexiune.
Introduceți un nume de aplicație, cum ar fi ChatGPT Databricks Connector.
În URL-uri de redirecționare, lipiți URL-ul de callback exact copiat din ChatGPT.
Sub Domenii de acces, alegeți domeniile de care are nevoie aplicația.
Folosiți ALL APIs pentru o aplicație Databricks generală care are nevoie de API-uri Databricks dincolo de SQL.
Folosiți doar SQL pentru o aplicație limitată la API-urile Databricks SQL.
Lăsați valorile TTL pentru token la valorile implicite Databricks, cu excepția cazului în care organizația dvs. are o politică specifică.
Activați Generați un secret de client. ChatGPT are nevoie de un client OAuth confidențial pentru acest flux.
Creați conexiunea.
Copiați acreditările din Databricks
În dialogul Conexiune creată, copiați ID-ul clientului.
Copiați imediat secretul clientului și stocați-l în siguranță.
Dacă închideți dialogul înainte de a copia secretul, creați sau rotiți acreditările aplicației OAuth și folosiți noul secret.
Databricks afișează secretul o singură dată. Tratați-l ca pe o acreditare și nu îl includeți în capturi de ecran, tichete, comentarii sau chaturi.
Finalizați configurarea în ChatGPT
Reveniți la fila de configurare a șablonului ChatGPT.
Lipiți ID-ul de client Databricks în ID client OAuth.
Lipiți secretul de client Databricks în secret client OAuth.
Lăsați Domeniile neschimbate, cu excepția cazului în care trebuie intenționat să suprascrieți valorile implicite ale șablonului.
Completați toate câmpurile de furnizor Databricks cerute de fluxul de configurare, cum ar fi gazda spațiului de lucru, gazda contului, ID-ul contului, depozitul sau alte valori specifice Databricks.
Creați aplicația ciornă.
Testați aplicația ca utilizator
Porniți fluxul de conectare din ChatGPT ca utilizator de testare permis.
Confirmați că browserul deschide contul sau spațiul de lucru Databricks așteptat.
Aprobați domeniile solicitate.
Verificați că browserul revine la ChatGPT și că aplicația este afișată ca fiind conectată.
Rulați mai întâi o acțiune de citire cu risc scăzut, cum ar fi preluarea informațiilor despre utilizatorul curent sau interogarea unei resurse Databricks SQL aprobate.
Dacă acțiunile de scriere sunt activate, testați cu un flux de lucru Databricks clar cu risc scăzut înainte de o lansare mai amplă.
Gestionați accesul
Databricks și ChatGPT contribuie ambele la controlul accesului.
În ChatGPT, administratorii spațiului de lucru gestionează dacă aplicația publicată este disponibilă, ce roluri din spațiul de lucru o pot folosi, ce acțiuni sunt activate și când ChatGPT le cere utilizatorilor acordul înainte de a folosi aplicația.
În Databricks, administratorii gestionează ce utilizatori pot autoriza aplicația OAuth și ce resurse Databricks pot accesa acei utilizatori. Permisiunile furnizorului se aplică în continuare după activarea aplicației în ChatGPT.
Depanare
Nepotrivire URI de redirecționare: confirmați că URL-ul de redirecționare Databricks corespunde exact URL-ului de callback afișat în ChatGPT, inclusiv calea și ID-ul de callback.
Secret lipsă: secretele Databricks sunt afișate o singură dată. Generați un nou secret de client dacă acesta nu a fost copiat.
Aplicația OAuth nu este disponibilă imediat: Databricks spune că procesarea actualizărilor aplicațiilor OAuth poate dura până la 30 de minute.
Domeniu insuficient: dacă ChatGPT se poate autentifica, dar apelurile API Databricks eșuează, confirmați că aplicația Databricks are ALL APIs când aplicația are nevoie de API-uri non-SQL.
Acțiunile SQL eșuează: confirmați domeniul SQL, configurația depozitului și permisiunile Databricks.
Spațiu de lucru greșit: creați și publicați aplicația în același spațiu de lucru ChatGPT în care utilizatorii o vor conecta.
Utilizatorii nu se pot conecta: confirmați că utilizatorul are acces Databricks și i se permite să autorizeze aplicația OAuth.