Fes servir aquesta guia si ets administrador d'un espai de treball de ChatGPT o usuari de ChatGPT Plus o Pro i vols configurar l'aplicació Databricks Genie amb OAuth integrat o amb el client OAuth de la teva organització.
OAuth integrat: Si està disponible a ChatGPT i habilitat per al teu espai de treball de Databricks, fes servir la connexió preconfigurada. No cal que creïs una aplicació OAuth ni que introdueixis un ID de client o un secret de client. Segueix les instruccions de la secció OAuth integrat que trobaràs més avall.
Client OAuth personalitzat: Fes servir aquesta opció si OAuth integrat no està disponible o si la teva organització exigeix fer servir un client OAuth propi. Segueix les instruccions de la secció Client OAuth personalitzat que trobaràs més avall.
Què configuraràs
Crearàs una connexió amb l'aplicació Databricks per al teu compte o espai de treball de ChatGPT. Totes dues opcions requereixen les dades del proveïdor Databricks que es demanen a ChatGPT i permisos per als recursos que vols fer servir. Si fas servir un client OAuth personalitzat, prepara també:
Una connexió d'aplicació OAuth de Databricks creada a la consola del compte de Databricks.
L'ID de client i el secret de client OAuth de Databricks.
L'URL de retorn exacta copiada de ChatGPT.
Els àmbits de Databricks que corresponguin a les funcionalitats de l'aplicació que vols habilitar.
Totes les dades del proveïdor Databricks que demani el procés de configuració de ChatGPT, com ara l'amfitrió de l'espai de treball, l'amfitrió del compte, l'ID del compte o el magatzem.
Abans de començar
Per configurar un espai de treball, obre la consola d'administració, selecciona l'espai de treball de ChatGPT corresponent i obre Connectors. Selecciona Gestiona les aplicacions antigues per obrir la pàgina d'Aplicacions que es conserva. Per obtenir informació sobre la navegació per l'espai de treball i l'accés a les aplicacions antigues, consulta Controls d'administració, seguretat i compliment normatiu dels connectors i les aplicacions.
Necessites:
Accés d'administrador o de propietari de l'espai de treball de ChatGPT, o un compte de ChatGPT Plus o Pro.
Per a un client OAuth personalitzat, accés d'administrador del compte de Databricks. L'accés d'administrador de l'espai de treball pot ser suficient per a algunes tasques, però les connexions d'aplicacions personalitzades es configuren des de la consola del compte de Databricks. Per fer servir OAuth integrat, un administrador de Databricks ha de comprovar que l'aplicació ChatGPT estigui disponible i habilitada per al teu espai de treball.
Per a un client OAuth personalitzat, la consola del compte de Databricks oberta en una altra pestanya.
Per a un client OAuth personalitzat, la pantalla de connexió de Databricks Genie oberta a ChatGPT per poder copiar l'URL de retorn exacta.
Haver decidit quines funcionalitats necessita l'aplicació: Genie i taulers d'AI/BI, accés més ampli a les API de Databricks o una aplicació limitada a les API de Databricks SQL. L'accés només a SQL no és suficient per a les accions de Genie o dels taulers.
Per a un client OAuth personalitzat, un lloc segur on gestionar el secret de client de Databricks.
Si el teu compte o espai de treball de Databricks restringeix l'accés mitjançant una llista d'accés per IP, un control d'entrada basat en el context, un tallafoc o una altra política de xarxa, ajuda d'un administrador de Databricks que pugui permetre els intervals d'IP de sortida de les aplicacions de ChatGPT vigents.
Per a un client OAuth personalitzat, copia l'URL de retorn exacta que es mostra a ChatGPT.
Valors que cal preparar
Per a un client OAuth personalitzat, l'URL de retorn: copia-la del procés de configuració de l'aplicació a ChatGPT.
Per a un client OAuth personalitzat, l'ID de client OAuth de Databricks.
Per a un client OAuth personalitzat, el secret de client OAuth de Databricks.
Per a un client OAuth personalitzat, els àmbits d'accés de Databricks adequats per a les funcionalitats de l'aplicació. Si una connexió nova de Genie o de taulers mostra
ai-gateway,dashboardsioffline_access, prepara aquests àmbits. TOTES les API (all-apisamboffline_access) continua sent l'alternativa anterior, més àmplia. Fes servir SQL només per a una aplicació limitada a les API de Databricks SQL.Els camps del compte o de l'espai de treball de Databricks que demani el procés de configuració de ChatGPT.
OAuth integrat
Primer, compleix els requisits previs indicats més amunt. Utilitza aquesta via només si OAuth integrat està disponible a ChatGPT i habilitat per al teu espai de treball de Databricks.
Demana a un administrador de Databricks que comprovi que l'aplicació ChatGPT està disponible a la configuració d'integracions d'aplicacions de la consola del compte i habilitada per al teu espai de treball. Si l'aplicació ChatGPT no apareix a la consola del teu compte de Databricks, contacta amb el teu representant de compte de Databricks per preguntar si la funció està disponible per al teu compte.
A ChatGPT, canvia al compte o a l'espai de treball on ha d'estar disponible l'aplicació. Ves a Configuració > Complements per a una configuració personal, o a Consola d'administració > Complements com a administrador o propietari de l'espai de treball per configurar-lo per a aquest espai.
Selecciona Databricks Genie i, després, Afegeix una connexió d'aplicació.
Introdueix el Nom d'amfitrió de l'espai de treball (obligatori) sense
https://ni cap camí d'URL.ChatGPT obté el punt final MCP de Genie local de l'espai de treball,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, a partir d'aquest nom d'amfitrió. No cal cap punt final MCP regional addicional.Selecciona Continua, inicia la sessió a Databricks i revisa la sol·licitud de consentiment.
Continua amb els apartats Connexió i proves i Gestió de l'accés que trobaràs més avall, incloses les proves amb membres autoritzats i les comprovacions d'accés a l'espai de treball.
Client OAuth personalitzat
Primer, compleix els requisits previs indicats més amunt. Tria aquesta opció si OAuth integrat no està disponible o si la teva organització requereix un client OAuth propi. Després de la configuració, completa les seccions Connexió i proves i Gestió de l'accés que trobaràs més avall.
Inicia la configuració d'OAuth personalitzat a ChatGPT
A ChatGPT, canvia al compte o a l'espai de treball on ha d'estar disponible l'aplicació.
Ves a Configuració > Complements per a una configuració personal, o a Consola d'administració > Complements com a administrador o propietari de l'espai de treball per configurar-lo per a aquest espai.
Selecciona Databricks Genie a Directori.
Selecciona Afegeix una connexió d'aplicació.
Al quadre de diàleg Connecta Databricks Genie, cerca els camps ID de client d'OAuth i Secret de client d'OAuth. Per seguir el procés de configuració d'un client personalitzat, introdueix les credencials en aquests camps visibles; no cal cap selector addicional.
Copia l'URL de retorn de ChatGPT. Deixa aquest quadre de diàleg obert.
Exemple d'URL de retorn:
https://chatgpt.com/connector/oauth/<callback_id>
No eliminis l'ID de retorn, no hi afegeixis una barra al final ni el substitueixis per un URL genèric de ChatGPT. L'URL registrat a Databricks ha de coincidir exactament amb l'URL de retorn que es mostra a ChatGPT.
Crea una connexió d'aplicació OAuth personalitzada a Databricks
Obre la consola del teu compte de Databricks.
A la barra lateral esquerra, obre Configuració.
Obre la pestanya Connexions d'aplicacions.
Selecciona Afegeix una connexió.
Introdueix un nom per a l'aplicació, com ara ChatGPT Databricks.
A URL de redirecció, enganxa l'URL de retorn exacta que has copiat de ChatGPT.
A Àmbits d'accés, tria els àmbits que necessita l'aplicació.
Si una connexió nova de Genie o de taulers mostra
ai-gateway,dashboardsioffline_accessa ChatGPT, permet aquests mateixos àmbits a l'aplicació OAuth de Databricks.TOTES les API continua sent l'alternativa anterior, més àmplia, per a l'accés general a les API de Databricks. Per a aquesta configuració, fes servir
all-apisioffline_accessa ChatGPT i assegura't que l'aplicació OAuth de Databricks permeti tots dos àmbits. Per a una connexió nova de Genie o de taulers, dona preferència als àmbits granulars que es mostren.Fes servir SQL només per a una aplicació limitada a les API de Databricks SQL. L'accés només a SQL no és suficient per a les accions de Genie o dels taulers.
Assegura't que tots els àmbits que apareguin més endavant a ChatGPT estiguin habilitats en aquesta aplicació OAuth de Databricks. Databricks permet automàticament openid, email, profile i offline_access a les aplicacions creades des de la interfície d'usuari.
Mantén els temps de vida (TTL) dels testimonis predeterminats de Databricks, tret que la teva organització tingui una política específica: 60 minuts per al testimoni d'accés i 10080 minuts per al testimoni d'actualització.
Activa Genera un secret de client. ChatGPT necessita un client OAuth confidencial per a aquest procés.
Crea la connexió.
Copia les credencials de Databricks
Al quadre de diàleg Connexió creada, copia l'ID de client.
Copia el Secret de client immediatament i desa'l de manera segura.
Si tanques el quadre de diàleg abans de copiar el secret, crea o renova les credencials de l'aplicació OAuth i fes servir el secret nou.
Databricks només mostra el secret una vegada. Tracta'l com una credencial i no l'incloguis en captures de pantalla, tiquets d'assistència, comentaris ni xats.
Finalitza la configuració d'OAuth personalitzat a ChatGPT
Torna al quadre de diàleg Connecta Databricks Genie.
Introdueix l'ID de client de Databricks a ID de client d'OAuth.
Introdueix el secret de client de Databricks a Secret de client d'OAuth.
En introduir aquestes credencials, s'utilitza el teu client OAuth personalitzat; no cal cap selector addicional.
A Àmbits (opcional), introdueix els àmbits necessaris per al punt final de Databricks i les funcionalitats de la teva aplicació. Han de coincidir amb els àmbits habilitats a l'aplicació OAuth de Databricks.
Per a una connexió nova de Genie o de taulers que mostri
ai-gateway,dashboardsioffline_access, mantén aquests àmbits. Assegura't que l'aplicació OAuth de Databricks permeti els mateixos àmbits.ai-gatewayhabilita la connexió MCP de Genie local de l'espai de treball,dashboardshabilita les accions dels taulers d'IA/BI ioffline_accesshabilita els testimonis d'actualització.L'alternativa anterior i més àmplia,
all-apisioffline_access, continua sent compatible per a un accés més ampli a les API, però no és l'opció preferida per a aquesta connexió de Genie o de taulers. Si l'aplicació de Databricks només permetall-apis, actualitza-la o torna-la a crear perquè permetiai-gateway,dashboardsioffline_access. Si els àmbits granulars no estan disponibles, configura explícitament ChatGPT amball-apisioffline_accessi assegura't que l'aplicació de Databricks permeti tots dos. No sol·licitis els tres àmbits granulars a ChatGPT si l'aplicació de Databricks només permetall-apis.Introdueix un àmbit per línia o separa els àmbits amb comes. Tots els àmbits indicats a ChatGPT han d'estar habilitats a l'aplicació OAuth de Databricks.
Introdueix el Nom d'amfitrió de l'espai de treball (obligatori) sense https:// ni cap camí d'URL. Emplena els altres camps obligatoris del proveïdor Databricks que es mostrin durant el procés de configuració.
ChatGPT obté el punt final MCP de Genie local de l'espai de treball,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, a partir d'aquest nom d'amfitrió. No cal cap punt final MCP regional addicional.Selecciona Continua.
ChatGPT sol·licita exactament els àmbits introduïts a Àmbits (opcional). No afegeix automàticament àmbits més amplis de la plantilla.
Connecta i fes proves
Fes les proves de connexió i les comprovacions d'accés següents, sigui quina sigui l'opció OAuth que hagis triat.
Revisa les dades de l'aplicació, les accions i la configuració d'autenticació.
Si ets administrador de l'espai de treball, habilita-hi l'aplicació i configura qui la pot fer servir segons la política de l'espai de treball.
Inicia el procés de connexió des de ChatGPT amb un usuari de prova autoritzat i, a continuació, inicia sessió a Databricks.
Comprova que el navegador obri el compte o l'espai de treball de Databricks esperat.
Revisa els àmbits sol·licitats i selecciona Autoritza.
Verifica que el navegador torni a ChatGPT i que l'aplicació hi consti com a connectada.
Executa una acció de lectura de baix risc que s'ajusti a les funcionalitats de la connexió. Per a una connexió de Genie, envia una sol·licitud a Genie sobre dades a les quals l'usuari de prova tingui permís per accedir. Per a altres funcionalitats admeses, obtén la informació de l'usuari actual o consulta un recurs autoritzat de Databricks SQL. Comprova que l'usuari tingui els permisos necessaris sobre els recursos de Databricks; els àmbits OAuth, per si sols, no donen accés a les dades.
Si les accions d'escriptura estan habilitades, fes una prova amb un flux de treball de Databricks de risc clarament baix abans d'ampliar el desplegament.
Si configures un espai de treball, demana a un membre autoritzat que no sigui administrador que es connecti i repeteixi la prova de baix risc.
Gestiona l'accés
Tant Databricks com ChatGPT intervenen en el control d'accés.
A ChatGPT, els administradors de l'espai de treball gestionen si l'aplicació està disponible i com la poden fer servir els membres. A Business, els administradors gestionen si l'aplicació està habilitada a tot l'espai de treball. Revisa els controls d'administració de les aplicacions Databricks (Configuració de l'espai de treball > Aplicacions o Consola d'administració > Connectors > Gestiona les aplicacions antigues) per configurar:
Accés d'usuaris, per configurar quins rols de l'espai de treball poden fer servir l'aplicació als espais de treball Enterprise i Edu compatibles.
Control d'accions, per configurar quines accions de Databricks estan habilitades.
Permisos de l'aplicació, per configurar quan ChatGPT demana permís als membres abans de fer servir l'aplicació.
Aquests permisos de l'aplicació s'apliquen a les converses de ChatGPT. Els agents de l'espai de treball fan servir controls individuals configurats pel creador de cada agent per determinar quines accions de les aplicacions estan disponibles i quan es demana als usuaris finals que les aprovin. Per obtenir informació sobre el comportament dels agents, consulta: Agents de l'espai de treball de ChatGPT per a Enterprise i Business.
A Databricks, els administradors gestionen quins usuaris poden autoritzar l'aplicació OAuth i a quins recursos de Databricks poden accedir aquests usuaris. Els permisos del proveïdor continuen aplicant-se després d'habilitar l'aplicació a ChatGPT.
Per obtenir informació sobre la navegació per l'espai de treball, l'accés a les aplicacions i els controls d'aplicacions específics de cada pla, consulta: Controls d'administració, seguretat i compliment normatiu de les aplicacions.
Resolució de problemes de configuració de l'aplicació Databricks
L'URI de redirecció no coincideix: Si fas servir un client OAuth personalitzat, comprova que el valor d'URL de redirecció de Databricks coincideixi exactament amb l'URL de retorn que es mostra a ChatGPT, inclosos el camí i l'ID de retorn. No eliminis l'ID de retorn, no afegeixis una barra inclinada al final ni substitueixis l'URL per una altra URL de redirecció de ChatGPT.
Falta el secret: Si fas servir un client OAuth personalitzat, tingues en compte que els secrets de Databricks només es mostren una vegada. Genera un secret de client nou si no el vas copiar.
L'aplicació OAuth no està disponible immediatament: Databricks indica que les actualitzacions de les aplicacions OAuth poden trigar fins a 30 minuts a processar-se.
Àmbits insuficients o que no coincideixen: Si fas servir un client OAuth personalitzat, compara els Àmbits (opcional) de ChatGPT amb els Àmbits d'accés de l'aplicació OAuth de Databricks. Hi han d'estar habilitats tots els àmbits que sol·licita ChatGPT. Comprova que els àmbits admetin el punt final i les funcionalitats que fas servir.
Si una connexió nova de Genie o de taulers mostra
ai-gateway,dashboardsioffline_access, mantén aquests àmbits a ChatGPT i assegura't que l'aplicació Databricks els permeti tots tres. Si l'aplicació només permetall-apis, actualitza-la o torna-la a crear perquè permeti els tres àmbits granulars.Si els àmbits granulars no estan disponibles, fes servir l'alternativa més àmplia admesa: configura ChatGPT amb
all-apisioffline_access, i assegura't que l'aplicació Databricks permeti tots dos àmbits. Una aplicació que només permetall-apisno és compatible amb una sol·licitud de ChatGPT que demaniai-gateway,dashboardsioffline_access. L'accés només a SQL és adequat únicament per a una aplicació limitada a les API de Databricks SQL; no és suficient per a les accions de Genie o dels taulers.Les accions SQL fallen: Si l'aplicació està limitada a les API de Databricks SQL, comprova l'àmbit SQL, la configuració del magatzem i els permisos de Databricks.
Espai de treball de ChatGPT incorrecte: Crea i habilita l'aplicació al mateix espai de treball de ChatGPT on els usuaris la connectaran.
Compte o espai de treball de Databricks incorrecte: Comprova el valor de Nom d'amfitrió de l'espai de treball (obligatori), repeteix el procés d'inici de sessió i verifica que Databricks obri el compte o l'espai de treball esperat.
Els usuaris no es poden connectar: Comprova que l'usuari tingui accés a Databricks i permís per autoritzar l'aplicació OAuth. A Business, comprova que l'aplicació estigui habilitada a tot l'espai de treball. Als espais de treball Enterprise i Edu compatibles, comprova també que l'opció Accés d'usuaris de ChatGPT permeti fer servir l'aplicació.
La política de xarxa de Databricks bloqueja l'aplicació: Si Databricks només permet determinades IP d'origen, un administrador de Databricks ha d'actualitzar les llistes d'accés per IP del compte o de l'espai de treball corresponent, els controls d'entrada basats en el context, el tallafoc o altres regles de xarxa controlades pel client.
Permet les connexions entrants des dels intervals d'IP de sortida de les aplicacions de ChatGPT vigents.
Configura aquesta llista d'IP permeses a Databricks o a la capa de xarxa controlada pel client. Aquesta configuració és independent de la llista d'IP permeses de l'espai de treball de ChatGPT.
Els intervals publicats poden canviar. Automatitza les actualitzacions a partir del JSON sempre que sigui possible.
No renovis el secret de client ni canviïs els àmbits OAuth per intentar evitar un bloqueig de xarxa. Primer comprova si Databricks rebutja les IP d'origen de l'aplicació.