Usa esta guía si administras un Espacio de trabajo de ChatGPT o usas 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 espacio de trabajo de Databricks, usa la conexión preconfigurada. No necesitas crear una app OAuth ni ingresar un ID de cliente o un secreto de cliente. Sigue las instrucciones de la sección OAuth integrado más abajo.
Cliente OAuth personalizado: usa esta opción si OAuth integrado no está disponible o si tu organización requiere su propio cliente OAuth. Sigue las instrucciones de la sección Cliente OAuth personalizado más abajo.
Qué vas a configurar
Vas a crear una conexión con la app de Databricks para tu cuenta o Espacio de trabajo de ChatGPT. Ambas opciones requieren los datos del proveedor Databricks que solicita ChatGPT y permisos para los recursos que planeas usar. Si usas un cliente OAuth personalizado, también prepara:
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 exacta de devolución de llamada copiada de ChatGPT.
Los alcances de Databricks que correspondan a las capacidades de la app que quieres habilitar.
Todos los datos del proveedor Databricks que solicite el proceso de configuración de ChatGPT, como el host del espacio de trabajo, el host de la cuenta, el ID de la cuenta o el almacén.
Antes de empezar
Para configurar un Espacio de trabajo, abre la consola de administración, selecciona el Espacio de trabajo de ChatGPT correspondiente y abre Plugins. Selecciona Administrar apps heredadas para abrir la página de Apps que se conserva para estas aplicaciones. Para obtener información sobre cómo navegar por el Espacio de trabajo y acceder a las apps heredadas, consulta Controles de administración, seguridad y cumplimiento para plugins y apps.
Necesitas:
Acceso de administrador o propietario de un Espacio 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 espacio de trabajo puede ser suficiente 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 verificar que la aplicación de ChatGPT esté disponible y habilitada para tu espacio 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 que puedas copiar la URL exacta de devolución de llamada.
Haber decidido qué capacidades necesita la app: Genie y paneles AI/BI, acceso más amplio a las API de Databricks o una app limitada a las API de Databricks SQL. El acceso exclusivo a SQL no es suficiente para las acciones de Genie o de paneles.
Para un cliente OAuth personalizado, un lugar seguro donde manejar el secreto de cliente de Databricks.
Si tu cuenta o espacio de trabajo de Databricks restringe el acceso mediante una lista de acceso de IP, un control de entrada basado en el contexto, un firewall u otra política de red, la ayuda de un administrador de Databricks que pueda permitir los rangos de IP de salida de las apps de ChatGPT vigentes.
Para un cliente OAuth personalizado, copia la URL de devolución de llamada exacta que aparece en ChatGPT.
Valores que debes preparar
Para un cliente OAuth personalizado, la URL de devolución de llamada: 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 alcances de acceso de Databricks adecuados para las capacidades de la app. Para una nueva conexión de Genie o de paneles que muestre
ai-gateway,dashboardsyoffline_access, prepara esos alcances. 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 espacio 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 espacio de trabajo de Databricks.
Pídele a un administrador de Databricks que verifique que la aplicación ChatGPT esté disponible en la configuración de integraciones de apps de la consola de la cuenta y habilitada para tu espacio 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 espacio de trabajo donde deba estar disponible la app. Ve a Configuración > Plugins para una configuración personal o, como administrador o propietario del espacio de trabajo, a Consola de administración > Plugins para configurar un espacio de trabajo.
Selecciona Databricks Genie y luego Agregar conexión de app.
Ingresa el Nombre de host del espacio de trabajo (obligatorio) sin
https://ni una ruta de URL.A partir de este nombre de host, ChatGPT determina el punto de acceso MCP de Genie local al espacio de trabajo:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. No se necesita un punto de acceso MCP regional independiente.Selecciona Continuar, luego inicia sesión en Databricks y revisa la solicitud de consentimiento.
Continúa con las secciones Conectar y probar y Administrar el acceso que aparecen más abajo, incluidas las pruebas con miembros autorizados y las verificaciones de acceso al espacio de trabajo.
Cliente OAuth personalizado
Primero, cumple los requisitos previos indicados arriba. Usa esta opción si OAuth integrado no está disponible o tu organización requiere su propio cliente OAuth. Después de la configuración, completa los pasos de las secciones Conectar y probar y Administrar el acceso que aparecen más abajo.
Iniciar la configuración de OAuth personalizado en ChatGPT
En ChatGPT, cambia a la cuenta o al espacio de trabajo donde deba estar disponible la app.
Ve a Configuración > Plugins para una configuración personal o, como administrador o propietario del espacio de trabajo, a Consola de administración > Plugins para configurar un espacio de trabajo.
Selecciona Databricks Genie en Directorio.
Selecciona Agregar conexión de app.
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, basta con ingresar las credenciales en estos campos visibles; no necesitas un selector adicional.
Copia la URL de devolución de llamada de ChatGPT. Mantén abierto este cuadro de diálogo.
Ejemplo de URL de devolución de llamada:
https://chatgpt.com/connector/oauth/<callback_id>
No elimines el ID de devolución de llamada, no agregues una barra al final ni reemplaces la URL por una URL genérica de ChatGPT. La URL registrada en Databricks debe coincidir exactamente con la URL de devolución de llamada que aparece 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 Agregar conexión.
Ingresa un nombre para la aplicación, como ChatGPT Databricks.
En URL de redirección, pega la URL exacta de devolución de llamada que copiaste de ChatGPT.
En Alcances de acceso, elige los alcances que necesita la app.
Para una nueva conexión de Genie o de paneles que muestre
ai-gateway,dashboardsyoffline_accessen ChatGPT, permite esos mismos alcances 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 alcances granulares que se muestran.Usa SQL solo para una app limitada a las API de Databricks SQL. El acceso exclusivo a SQL no es suficiente para las acciones de Genie o de paneles.
Asegúrate de que todos los alcances que se indiquen 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, a menos 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 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 muestra el secreto una sola vez. Trátalo como una credencial y no lo incluyas en capturas de pantalla, tickets, comentarios ni chats.
Completar la configuración de OAuth personalizado en ChatGPT
Vuelve al cuadro de diálogo Conectar Databricks Genie.
Ingresa el ID de cliente de Databricks en ID de cliente de OAuth.
Ingresa el secreto de cliente de Databricks en Secreto de cliente de OAuth.
Al ingresar estas credenciales, se usa tu cliente de OAuth personalizado; no necesitas un selector adicional.
En Ámbitos (opcional), ingresa los ámbitos necesarios para el punto de acceso de Databricks y las capacidades de tu app. Deben coincidir con los ámbitos habilitados en la app de OAuth de Databricks.
Para una nueva conexión de Genie o de paneles que muestre
ai-gateway,dashboardsyoffline_access, conserva esos ámbitos. Asegúrate de que la app de OAuth de Databricks permita los mismos ámbitos.ai-gatewayhabilita la conexión MCP de Genie local al espacio de trabajo,dashboardshabilita las acciones de paneles de AI/BI yoffline_accesshabilita los tokens de actualización.La alternativa anterior, más amplia, de
all-apisyoffline_accesssigue siendo compatible para un acceso más amplio a las API, pero no se recomienda para esta conexión de Genie o de paneles. Si la app de Databricks solo permiteall-apis, actualízala o vuelve a crearla para permitirai-gateway,dashboardsyoffline_access. Si los ámbitos granulares no están disponibles, configura explícitamente ChatGPT conall-apisyoffline_access, y asegúrate de que la app de Databricks permita ambos. No solicites los tres ámbitos granulares en ChatGPT si la app de Databricks solo permiteall-apis.Ingresa un ámbito por línea o sepáralos con comas. Todos los ámbitos indicados en ChatGPT deben estar habilitados en la app de OAuth de Databricks.
Ingresa el Nombre de host del espacio de trabajo (obligatorio) sin https:// ni una ruta de URL. Completa los demás campos obligatorios del proveedor Databricks que aparezcan en el proceso de configuración.
A partir de este nombre de host, ChatGPT determina el punto de acceso MCP de Genie local al espacio de trabajo:
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. No se necesita un punto de acceso MCP regional independiente.Selecciona Continuar.
ChatGPT solicita exactamente los ámbitos ingresados en Ámbitos (opcional). No agrega automáticamente ámbitos más amplios de la plantilla.
Conectar y probar
Completa las siguientes pruebas de conexión y verificaciones de acceso para cualquiera de las dos opciones de OAuth.
Revisa los detalles, las acciones y la configuración de autenticación de la app.
Si administras un Espacio de trabajo, habilita la app para ese Espacio de trabajo y configura quién puede usarla según su política.
Inicia el proceso de conexión desde ChatGPT con un usuario de prueba autorizado y luego inicia sesión en Databricks.
Confirma que el navegador abra la cuenta o el espacio de trabajo de Databricks esperados.
Revisa los alcances solicitados y luego selecciona Autorizar.
Verifica que el navegador regrese a ChatGPT y que la app aparezca como conectada.
Ejecuta una acción de lectura de bajo riesgo que corresponda a las capacidades 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 de acceder. Para otras capacidades compatibles, obtén la información del usuario actual o consulta un recurso aprobado de Databricks SQL. Confirma que el usuario tenga los permisos necesarios para los recursos de Databricks; los alcances de OAuth por sí solos no otorgan acceso a los datos.
Si las acciones de escritura están habilitadas, haz una prueba con un flujo de trabajo de Databricks de bajo riesgo comprobado antes de ampliar la implementación.
Para la configuración de un Espacio de trabajo, pídele a un miembro autorizado que no sea administrador que se conecte y repita la prueba de bajo riesgo.
Administrar el acceso
Tanto Databricks como ChatGPT contribuyen al control de acceso.
En ChatGPT, los administradores del Espacio 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 todo el Espacio de trabajo. Revisa los controles de administración de las apps de Databricks (Configuración del Espacio de trabajo > Apps o Consola de administración > Plugins > Administrar apps heredadas) para configurar lo siguiente:
Acceso de usuarios, para configurar qué roles del Espacio de trabajo pueden usar la app en los Espacios de trabajo 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 autorización a los miembros antes de usar la app.
Estos permisos de la app se aplican a las conversaciones de ChatGPT. Los agentes del Espacio de trabajo usan controles individuales definidos por quien crea cada agente para determinar qué acciones de las apps están disponibles y cuándo se solicita la aprobación de los usuarios finales. Para obtener información sobre el comportamiento de los agentes, consulta: agentes del Espacio 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 Espacio de trabajo, el acceso a las apps y los controles de apps específicos de cada plan, consulta: controles de administración, seguridad y cumplimiento 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 devolución de llamada que aparece en ChatGPT, incluidos la ruta y el ID de devolución de llamada. No elimines el ID de devolución de llamada, no agregues una barra al final ni lo reemplaces 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 se muestran una sola 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.
Alcance insuficiente o que no coincide: si usas un cliente OAuth personalizado, compara Alcances (opcional) en ChatGPT con Alcances de acceso en la app OAuth de Databricks. Todos los alcances que solicite ChatGPT deben estar habilitados allí. Confirma que los alcances sean compatibles con el punto de acceso y las capacidades que usas.
Para una nueva conexión de Genie o de paneles que muestre
ai-gateway,dashboardsyoffline_access, conserva esos alcances 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 alcances granulares.Si los alcances 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 satisface una solicitud de ChatGPT que incluyaai-gateway,dashboardsyoffline_access. El acceso exclusivo a SQL solo es adecuado para una app limitada a las API de Databricks SQL; no es suficiente para las acciones de Genie o de paneles.Las acciones de SQL fallan: para una app limitada a las API de Databricks SQL, confirma el alcance SQL, la configuración del almacén y los permisos de Databricks.
Espacio de trabajo de ChatGPT incorrecto: crea y habilita la app en el mismo Espacio de trabajo de ChatGPT donde los usuarios la conectarán.
Cuenta o espacio de trabajo de Databricks incorrectos: confirma el valor de Nombre de host del espacio de trabajo (obligatorio). Luego, repite el proceso de inicio de sesión y verifica que Databricks abra la cuenta o el espacio de trabajo esperados.
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 todo el Espacio de trabajo. En los Espacios de trabajo Enterprise y Edu compatibles, confirma también que la configuración de Acceso de usuarios de 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 de IP de la cuenta o del espacio de trabajo correspondientes, los controles de entrada basados en el contexto, el firewall u otras reglas de red controladas por el cliente.
Permite conexiones entrantes desde los rangos de IP de salida de las apps de ChatGPT vigentes.
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 Espacio de trabajo de ChatGPT.
Los rangos publicados pueden cambiar. Automatiza las actualizaciones a partir del JSON cuando sea posible.
No rotes el secreto de cliente ni cambies los alcances de OAuth para eludir un bloqueo de red. Primero, confirma si Databricks está rechazando las IP de origen de la app.