Usa esta guía si eres administrador de un área de trabajo de ChatGPT o usuario de ChatGPT Plus o Pro y vas a configurar la app de Databricks Genie con OAuth integrado o con el cliente OAuth de tu organización.
OAuth integrado: cuando esté disponible en ChatGPT y habilitado para tu área de trabajo de Databricks, usa la conexión preconfigurada. No necesitas crear una app OAuth ni introducir un ID de cliente o un secreto de cliente. Sigue las instrucciones de la sección OAuth integrado que aparece más abajo.
Cliente OAuth personalizado: usa esta opción si OAuth integrado no está disponible o si tu organización exige usar su propio cliente OAuth. Sigue las instrucciones de la sección Cliente OAuth personalizado que aparece más abajo.
Qué vas a configurar
Vas a crear una conexión con la app de Databricks para tu cuenta o área de trabajo de ChatGPT. Ambas opciones requieren los datos del proveedor Databricks que se solicitan en ChatGPT y permisos para los recursos que tengas previsto usar. Si usas un cliente OAuth personalizado, prepara también:
Una conexión de app OAuth de Databricks creada en la consola de cuentas de Databricks.
El ID de cliente y el secreto de cliente OAuth de Databricks.
La URL de retorno exacta copiada de ChatGPT.
Los ámbitos de Databricks que correspondan a las funciones de la app que quieras habilitar.
Los datos del proveedor Databricks que solicite el proceso de configuración de ChatGPT, como el host del área de trabajo, el host de la cuenta, el ID de la cuenta o el almacén.
Antes de empezar
Para configurar un área de trabajo, abre la consola de administración, selecciona el área de trabajo de ChatGPT que corresponda y abre Plugins. Selecciona Gestionar apps heredadas para abrir la página de Apps que se ha conservado. Para obtener información sobre la navegación por el área de trabajo y el acceso a las apps heredadas, consulta Controles de administración, seguridad y cumplimiento normativo para plugins y apps.
Necesitas:
Acceso de administrador o propietario del área de trabajo de ChatGPT, o una cuenta de ChatGPT Plus o Pro.
Para un cliente OAuth personalizado, acceso de administrador de la cuenta de Databricks. El acceso de administrador del área de trabajo puede bastar para algunas tareas, pero las conexiones de apps personalizadas se configuran desde la consola de cuentas de Databricks. Para OAuth integrado, un administrador de Databricks debe comprobar que la aplicación de ChatGPT esté disponible y habilitada para tu área de trabajo.
Para un cliente OAuth personalizado, la consola de cuentas de Databricks abierta en otra pestaña.
Para un cliente OAuth personalizado, la pantalla de conexión de Databricks Genie abierta en ChatGPT para poder copiar la URL de retorno exacta.
Haber decidido qué funciones necesita la app: Genie y paneles de AI/BI, acceso más amplio a las API de Databricks o una app limitada a las API de Databricks SQL. El acceso solo a SQL no basta para las acciones de Genie o de paneles.
Para un cliente OAuth personalizado, un lugar seguro donde gestionar el secreto de cliente de Databricks.
Si tu cuenta o área de trabajo de Databricks restringe el acceso mediante una lista de acceso por IP, un control de entrada basado en el contexto, un cortafuegos u otra política de red, la ayuda de un administrador de Databricks que pueda permitir los intervalos de IP de salida de las apps de ChatGPT actuales.
Para un cliente OAuth personalizado, copia la URL de retorno exacta que aparece en ChatGPT.
Valores que debes preparar
Para un cliente OAuth personalizado, la URL de retorno: cópiala del proceso de configuración de la app en ChatGPT.
Para un cliente OAuth personalizado, el ID de cliente OAuth de Databricks.
Para un cliente OAuth personalizado, el secreto de cliente OAuth de Databricks.
Para un cliente OAuth personalizado, los ámbitos de acceso de Databricks adecuados para las funciones de la app. Si una nueva conexión de Genie o de paneles muestra
ai-gateway,dashboardsyoffline_access, prepara esos ámbitos. TODAS las API (all-apisconoffline_access) sigue siendo la alternativa anterior y más amplia. Usa SQL solo para una app limitada a las API de Databricks SQL.Los campos del área de trabajo o de la cuenta de Databricks que solicite el proceso de configuración de ChatGPT.
OAuth integrado
Primero, cumple los requisitos previos indicados arriba. Usa esta opción solo si OAuth integrado está disponible en ChatGPT y habilitado para tu área de trabajo de Databricks.
Pide a un administrador de Databricks que compruebe que la aplicación ChatGPT esté disponible en los ajustes de integración de aplicaciones de la consola de la cuenta y habilitada para tu área de trabajo. Si la aplicación ChatGPT no aparece en la consola de tu cuenta de Databricks, ponte en contacto con tu representante de cuenta de Databricks para preguntar si la función está disponible para tu cuenta.
En ChatGPT, cambia a la cuenta o al área de trabajo en la que deba estar disponible la aplicación. Ve a Configuración > Plugins para una configuración personal, o a Consola de administración > Plugins como administrador o propietario del área de trabajo para configurarla en ella.
Selecciona Databricks Genie y, después, Añadir conexión de aplicación.
Introduce el Nombre de host del área de trabajo (obligatorio) sin
https://ni una ruta de URL.ChatGPT obtiene el punto de acceso MCP de Genie local del área de trabajo,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, a partir de este nombre de host. No se necesita un punto de acceso MCP regional independiente.Selecciona Continuar, inicia sesión en Databricks y revisa la solicitud de consentimiento.
Continúa con las secciones «Conectar y probar» y «Gestionar el acceso» que aparecen más abajo, incluidas las pruebas con miembros autorizados y las comprobaciones de acceso al área de trabajo.
Cliente OAuth personalizado
Primero, cumple los requisitos previos indicados más arriba. Usa esta opción si OAuth integrado no está disponible o si tu organización exige usar su propio cliente OAuth. Tras la configuración, completa las secciones Conectar y probar y Gestionar el acceso que aparecen más abajo.
Iniciar la configuración de OAuth personalizado en ChatGPT
En ChatGPT, cambia a la cuenta o al área de trabajo en la que deba estar disponible la aplicación.
Ve a Configuración > Plugins para una configuración personal, o a Consola de administración > Plugins como administrador o propietario del área de trabajo para configurarla en ella.
Selecciona Databricks Genie en Directorio.
Selecciona Añadir conexión de aplicación.
En el cuadro de diálogo Conectar Databricks Genie, busca los campos ID de cliente de OAuth y Secreto de cliente de OAuth. Para usar un cliente personalizado, introduce las credenciales en estos campos visibles; no necesitas un selector adicional.
Copia la URL de retorno de ChatGPT. Mantén abierto este cuadro de diálogo.
Ejemplo de URL de retorno:
https://chatgpt.com/connector/oauth/<callback_id>
No elimines el ID de retorno, no añadas una barra al final ni sustituyas la URL por una URL genérica de ChatGPT. La URL registrada en Databricks debe coincidir exactamente con la URL de retorno que se muestra en ChatGPT.
Crear una conexión de app OAuth personalizada en Databricks
Abre la consola de cuentas de Databricks correspondiente a tu cuenta de Databricks.
En la barra lateral izquierda, abre Configuración.
Abre la pestaña Conexiones de apps.
Selecciona Añadir conexión.
Introduce un nombre para la aplicación, como ChatGPT Databricks.
En URL de redirección, pega la URL de retorno exacta copiada de ChatGPT.
En Ámbitos de acceso, elige los ámbitos que necesita la app.
Si una nueva conexión de Genie o de paneles muestra
ai-gateway,dashboardsyoffline_accessen ChatGPT, permite esos mismos ámbitos en la app OAuth de Databricks.TODAS las API sigue siendo la alternativa anterior y más amplia para el acceso general a las API de Databricks. Para esta configuración, usa
all-apisyoffline_accessen ChatGPT y asegúrate de que la app OAuth de Databricks permita ambos. Para una nueva conexión de Genie o de paneles, da preferencia a los ámbitos granulares que se muestran.Usa SQL solo para una app limitada a las API de Databricks SQL. El acceso solo a SQL no basta para las acciones de Genie o de paneles.
Asegúrate de que todos los ámbitos que aparezcan después en ChatGPT estén habilitados en esta app OAuth de Databricks. Databricks permite automáticamente openid, email, profile y offline_access para las apps creadas en la interfaz de usuario.
Mantén los tiempos de vida (TTL) de los tokens predeterminados de Databricks, salvo que tu organización tenga una política específica: 60 minutos para el token de acceso y 10 080 minutos para el token de actualización.
Activa Generar un secreto de cliente. ChatGPT necesita un cliente OAuth confidencial para este proceso.
Crea la conexión.
Copiar las credenciales de Databricks
En el cuadro de diálogo Conexión creada, copia el ID de cliente.
Copia el Secreto de cliente de inmediato y guárdalo de forma segura.
Si cierras el cuadro de diálogo antes de copiar el secreto, crea o rota las credenciales de la app OAuth y usa el nuevo secreto.
Databricks solo muestra el secreto una vez. Trátalo como una credencial y no lo incluyas en capturas de pantalla, solicitudes de asistencia, comentarios ni chats.
Finalizar la configuración de OAuth personalizado en ChatGPT
Vuelve al cuadro de diálogo Conectar Databricks Genie.
Introduce el ID de cliente de Databricks en ID de cliente de OAuth.
Introduce el secreto de cliente de Databricks en Secreto de cliente de OAuth.
Al introducir estas credenciales, se utiliza tu cliente de OAuth personalizado; no necesitas un selector adicional.
En Ámbitos (opcional), introduce los ámbitos necesarios para el punto de acceso de Databricks y las funciones de tu aplicación. Asegúrate de que coincidan con los ámbitos habilitados en la aplicación OAuth de Databricks.
Si una nueva conexión de Genie o de paneles muestra
ai-gateway,dashboardsyoffline_access, conserva esos ámbitos. Asegúrate de que la aplicación OAuth de Databricks permita los mismos ámbitos.ai-gatewayhabilita la conexión MCP de Genie local del área de trabajo,dashboardshabilita las acciones de los paneles AI/BI yoffline_accesspermite usar tokens de actualización.La alternativa anterior, de mayor alcance,
all-apisyoffline_access, sigue siendo compatible para un acceso más amplio a las API, pero no es la opción recomendada para esta conexión de Genie o de paneles. Si la aplicación de Databricks solo permiteall-apis, actualízala o vuelve a crearla para que permitaai-gateway,dashboardsyoffline_access. Si los ámbitos granulares no están disponibles, configura expresamente ChatGPT conall-apisyoffline_accessy asegúrate de que la aplicación de Databricks permita ambos. No solicites los tres ámbitos granulares en ChatGPT si la aplicación de Databricks solo permiteall-apis.Introduce un ámbito por línea o sepáralos con comas. Todos los ámbitos indicados en ChatGPT deben estar habilitados en la aplicación OAuth de Databricks.
Introduce el Nombre de host del área de trabajo (obligatorio) sin https:// ni una ruta de URL. Completa los demás campos obligatorios del proveedor Databricks que aparezcan durante la configuración.
ChatGPT obtiene el punto de acceso MCP de Genie local del área de trabajo,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp, a partir de este nombre de host. No se necesita un punto de acceso MCP regional independiente.Selecciona Continuar.
ChatGPT solicita exactamente los ámbitos introducidos en Ámbitos (opcional). No añade automáticamente ámbitos de mayor alcance de la plantilla.
Conectar y probar
Realiza las siguientes pruebas de conexión y comprobaciones de acceso para cualquiera de las dos opciones de OAuth.
Revisa los detalles, las acciones y los ajustes de autenticación de la app.
Si eres administrador de un área de trabajo, habilita la app para el área de trabajo y configura quién puede usarla según la política del área de trabajo.
Inicia el proceso de conexión desde ChatGPT con un usuario de prueba autorizado y, después, inicia sesión en Databricks.
Confirma que el navegador abra la cuenta o el área de trabajo de Databricks esperada.
Revisa los ámbitos solicitados y selecciona Autorizar.
Verifica que el navegador vuelva a ChatGPT y que la app aparezca como conectada.
Ejecuta una acción de lectura de bajo riesgo que se ajuste a las funciones de la conexión. Para una conexión de Genie, envía una solicitud a Genie sobre datos a los que el usuario de prueba tenga permiso para acceder. Para otras funciones compatibles, obtén información del usuario actual o consulta un recurso de Databricks SQL autorizado. Confirma que el usuario tenga los permisos necesarios sobre los recursos de Databricks; los ámbitos OAuth por sí solos no conceden acceso a los datos.
Si las acciones de escritura están habilitadas, haz una prueba con un flujo de trabajo de Databricks de riesgo claramente bajo antes de ampliar el despliegue.
Si configuras un área de trabajo, pide a un miembro autorizado que no sea administrador que se conecte y repita la prueba de bajo riesgo.
Gestionar el acceso
Tanto Databricks como ChatGPT intervienen en el control de acceso.
En ChatGPT, los administradores del área de trabajo gestionan la disponibilidad de la app y cómo pueden usarla los miembros. En Business, los administradores gestionan si la app está habilitada para toda el área de trabajo. Revisa los controles de administración de las apps de Databricks (Configuración del área de trabajo > Apps o Consola de administración > Plugins > Gestionar apps heredadas) para configurar:
Acceso de usuarios, para definir qué roles del área de trabajo pueden usar la app en las áreas de trabajo de Enterprise y Edu compatibles.
Control de acciones, para configurar qué acciones de Databricks están habilitadas.
Permisos de la app, para configurar cuándo ChatGPT pide permiso a los miembros antes de usar la app.
Estos permisos de la app se aplican a las conversaciones de ChatGPT. Los agentes del área de trabajo usan controles específicos para cada agente, definidos por su creador, para determinar qué acciones de las apps están disponibles y cuándo se pide a los usuarios finales que las aprueben. Para obtener información sobre el comportamiento de los agentes, consulta Agentes del área de trabajo de ChatGPT para Enterprise y Business.
En Databricks, los administradores gestionan qué usuarios pueden autorizar la app OAuth y a qué recursos de Databricks pueden acceder esos usuarios. Los permisos del proveedor siguen aplicándose después de habilitar la app en ChatGPT.
Para obtener información sobre la navegación por el área de trabajo, el acceso a las apps y los controles de las apps específicos de cada plan, consulta Controles de administración, seguridad y cumplimiento normativo en las apps.
Solución de problemas de configuración de la app de Databricks
El URI de redirección no coincide: si usas un cliente OAuth personalizado, confirma que el valor de URL de redirección en Databricks coincida exactamente con la URL de retorno que aparece en ChatGPT, incluida la ruta y el ID de retorno. No elimines el ID de retorno, no añadas una barra al final ni lo sustituyas por otra URL de redirección de ChatGPT.
Falta el secreto: si usas un cliente OAuth personalizado, ten en cuenta que los secretos de Databricks solo se muestran una vez. Genera un nuevo secreto de cliente si no lo copiaste.
La app OAuth no está disponible de inmediato: Databricks indica que las actualizaciones de las aplicaciones OAuth pueden tardar hasta 30 minutos en procesarse.
Ámbitos insuficientes o que no coinciden: si usas un cliente OAuth personalizado, compara Ámbitos (opcional) en ChatGPT con Ámbitos de acceso en la app OAuth de Databricks. Todos los ámbitos que solicite ChatGPT deben estar habilitados allí. Confirma que los ámbitos sean compatibles con el punto de acceso y las funciones que usas.
Si una nueva conexión de Genie o de paneles muestra
ai-gateway,dashboardsyoffline_access, mantén esos ámbitos en ChatGPT y asegúrate de que la app de Databricks permita los tres. Si la app solo permiteall-apis, actualízala o vuelve a crearla para permitir los tres ámbitos granulares.Si los ámbitos granulares no están disponibles, usa la alternativa compatible más amplia: configura ChatGPT con
all-apisyoffline_access, y asegúrate de que la app de Databricks permita ambos. Una app que solo permiteall-apisno cumple los requisitos de una solicitud de ChatGPT que incluyaai-gateway,dashboardsyoffline_access. El acceso solo a SQL es adecuado únicamente para una app limitada a las API de Databricks SQL; no basta para las acciones de Genie o de paneles.Las acciones SQL fallan: si la app está limitada a las API de Databricks SQL, comprueba el ámbito SQL, la configuración del almacén y los permisos de Databricks.
Área de trabajo de ChatGPT incorrecta: crea y habilita la app en la misma área de trabajo de ChatGPT en la que los usuarios la conectarán.
Cuenta o área de trabajo de Databricks incorrecta: confirma el valor de Nombre de host del área de trabajo (obligatorio), repite el proceso de inicio de sesión y verifica que Databricks abra la cuenta o el área de trabajo esperada.
Los usuarios no pueden conectarse: confirma que el usuario tenga acceso a Databricks y permiso para autorizar la app OAuth. En Business, confirma que la app esté habilitada para toda el área de trabajo. En las áreas de trabajo de Enterprise y Edu compatibles, confirma también que Acceso de usuarios en ChatGPT permita usar la app.
La política de red de Databricks bloquea la app: si Databricks solo permite determinadas IP de origen, un administrador de Databricks debe actualizar las listas de acceso por IP de la cuenta o del área de trabajo, los controles de entrada basados en el contexto, el cortafuegos u otras reglas de red controladas por el cliente, según corresponda.
Permite las conexiones entrantes desde los intervalos de IP de salida de las apps de ChatGPT actuales.
Configura esta lista de permitidos en Databricks o en la capa de red controlada por el cliente. Es independiente de la lista de IP permitidas del área de trabajo de ChatGPT.
Los intervalos publicados pueden cambiar. Automatiza las actualizaciones a partir del JSON siempre que sea posible.
No rotes el secreto de cliente ni cambies los ámbitos OAuth para sortear un bloqueo de red. Primero confirma si Databricks está rechazando las IP de origen de la app.