Usa esta guía si eres administrador de un área de trabajo de ChatGPT y vas a configurar la plantilla de aplicación de Databricks para tu organización. Una plantilla no es la aplicación final que usan los miembros. Es un flujo de configuración que crea un borrador de aplicación específico del área de trabajo después de que proporciones la configuración requerida de Databricks.
En Databricks, la mayor parte de la configuración se realiza en Databricks Account Console. Creas una conexión de aplicación OAuth personalizada, registras la URL de devolución de llamada de ChatGPT, copias las credenciales de cliente generadas y, después, pegas esos valores en el flujo de configuración de la plantilla de ChatGPT. Después de que ChatGPT cree el borrador de aplicación, puedes publicarlo y gestionarlo como otras aplicaciones del área de trabajo.
Lo que vas a configurar
Vas a crear una aplicación de Databricks específica del área de trabajo en ChatGPT. La aplicación usa:
Una conexión de aplicación OAuth de Databricks creada en Databricks Account Console.
El ID de cliente y el secreto de cliente de OAuth de Databricks.
La URL de devolución de llamada exacta copiada de ChatGPT.
Ámbitos de Databricks que coincidan con las funciones del conector que quieres activar.
Cualquier detalle de proveedor de Databricks que solicite el flujo de configuración de ChatGPT, como el host del área de trabajo, el host de la cuenta, el ID de cuenta o el warehouse.
Antes de empezar
Necesitas:
Acceso de administrador o propietario del área de trabajo de ChatGPT.
Acceso de administrador de cuenta de Databricks. El acceso de administrador del área de trabajo puede bastar para algunas tareas, pero las conexiones de aplicaciones personalizadas se configuran desde Databricks Account Console.
Databricks Account Console abierta en una pestaña aparte.
La pantalla de configuración de la plantilla de aplicación de Databricks abierta en ChatGPT para poder copiar la URL de devolución de llamada exacta.
Una decisión sobre si la aplicación necesita acceso general a la API de Databricks o solo acceso a Databricks SQL.
Un lugar seguro para gestionar el secreto de cliente de Databricks.
No inventes la URL de devolución de llamada. Copia la URL de devolución de llamada exacta que se muestra en ChatGPT.
Valores que preparar
URL de devolución de llamada: cópiala del flujo de configuración de la plantilla de ChatGPT.
ID de cliente OAuth de Databricks.
Secreto de cliente OAuth de Databricks.
Ámbitos de acceso de Databricks, como ALL APIs o SQL.
Campos de cuenta o área de trabajo de Databricks solicitados por el flujo de configuración de ChatGPT.
Publicar y gestionar la aplicación en ChatGPT
Crear el borrador de aplicación no lo pone automáticamente a disposición de los miembros. Después de revisar el borrador:
Publica el borrador de aplicación.
Confirma que la aplicación aparece en Configuración del área de trabajo > Aplicaciones > Habilitadas.
Configura el acceso de usuarios para los roles que deben usarla.
Revisa el control de acciones para las acciones de Databricks que expone la aplicación.
Revisa los permisos de la aplicación para elegir cuándo ChatGPT pide confirmación a los miembros antes de usar la aplicación.
Pide a un usuario de prueba autorizado que abra Aplicaciones en ChatGPT y confirme que la aplicación aparece.
Estos permisos de aplicación se aplican a las conversaciones de ChatGPT. Los agentes del área de trabajo usan controles por agente definidos por el creador del agente para determinar qué acciones de aplicación están disponibles y cuándo se pide a los usuarios finales que las aprueben. Para el comportamiento de los agentes, consulta: Agentes de área de trabajo de ChatGPT para Enterprise y Business.
Iniciar la configuración de la plantilla en ChatGPT
En ChatGPT, cambia al área de trabajo donde la aplicación debe estar disponible.
Abre Configuración del área de trabajo > Aplicaciones.
Selecciona Directorio.
Busca Databricks.
Selecciona la plantilla de aplicación de Databricks e inicia la configuración.
Introduce un nombre y una descripción claros para la aplicación, como Databricks o Databricks - Data Platform.
En la sección de cliente OAuth, copia la URL de devolución de llamada de ChatGPT. Mantén esta pestaña abierta.
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 añadas una barra final ni lo sustituyas por una URL genérica de ChatGPT.
Crear la conexión de aplicación OAuth en Databricks
Abre Databricks Account Console para tu cuenta de Databricks.
En la barra lateral izquierda, abre Configuración.
Abre la pestaña Conexiones de aplicaciones.
Selecciona Añadir conexión.
Introduce un nombre de aplicación, como ChatGPT Databricks Connector.
En URL de redirección, pega la URL de devolución de llamada exacta copiada de ChatGPT.
En Ámbitos de acceso, elige los ámbitos que necesita la aplicación.
Usa ALL APIs para una aplicación general de Databricks que necesite API de Databricks más allá de SQL.
Usa solo SQL para una aplicación limitada a las API de Databricks SQL.
Deja los TTL de token con los valores predeterminados de Databricks a menos que tu organización tenga una política específica.
Activa Generar un secreto de cliente. ChatGPT necesita un cliente OAuth confidencial para este flujo.
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 inmediatamente 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 aplicación OAuth y usa el nuevo secreto.
Databricks muestra el secreto solo una vez. Trátalo como una credencial y no lo incluyas en capturas de pantalla, tickets, comentarios ni chats.
Finalizar la configuración en ChatGPT
Vuelve a la pestaña de configuración de la plantilla de ChatGPT.
Pega el ID de cliente de Databricks en ID de cliente OAuth.
Pega el secreto de cliente de Databricks en Secreto de cliente OAuth.
Deja los ámbitos sin cambios a menos que necesites reemplazar intencionadamente los valores predeterminados de la plantilla.
Rellena los campos de proveedor de Databricks que requiera el flujo de configuración, como host del área de trabajo, host de la cuenta, ID de cuenta, warehouse u otros valores específicos de Databricks.
Crea el borrador de aplicación.
Probar la aplicación como usuario
Inicia el flujo de conexión desde ChatGPT como usuario de prueba autorizado.
Confirma que el navegador abre la cuenta o el área de trabajo de Databricks esperados.
Aprueba los ámbitos solicitados.
Comprueba que el navegador vuelve a ChatGPT y que la aplicación aparece como conectada.
Ejecuta primero una acción de lectura de bajo riesgo, como obtener la información del usuario actual o consultar un recurso aprobado de Databricks SQL.
Si las acciones de escritura están habilitadas, haz una prueba con un flujo de trabajo de Databricks claramente de bajo riesgo antes de una implementación más amplia.
Gestionar el acceso
Databricks y ChatGPT contribuyen al control de acceso.
En ChatGPT, los administradores del área de trabajo gestionan si la aplicación publicada está disponible, qué roles del área de trabajo pueden usarla, qué acciones están habilitadas y cuándo ChatGPT pregunta a los usuarios antes de usar la aplicación.
En Databricks, los administradores gestionan qué usuarios pueden autorizar la aplicación OAuth y a qué recursos de Databricks pueden acceder esos usuarios. Los permisos del proveedor siguen aplicándose después de habilitar la aplicación en ChatGPT.
Solución de problemas
URI de redirección no coincidente: confirma que la URL de redirección de Databricks coincide exactamente con la URL de devolución de llamada mostrada en ChatGPT, incluidos la ruta y el ID de devolución de llamada.
Falta el secreto: los secretos de Databricks se muestran una sola vez. Genera un nuevo secreto de cliente si no se copió.
La aplicación OAuth no está disponible de inmediato: Databricks indica que las actualizaciones de aplicaciones OAuth pueden tardar hasta 30 minutos en procesarse.
Ámbito insuficiente: si ChatGPT puede autenticarse pero las llamadas a la API de Databricks fallan, confirma que la aplicación de Databricks tiene ALL APIs cuando necesita API que no sean SQL.
Las acciones de SQL fallan: confirma el ámbito SQL, la configuración del warehouse y los permisos de Databricks.
Área de trabajo incorrecta: crea y publica la aplicación en la misma área de trabajo de ChatGPT donde los usuarios la conectarán.
Los usuarios no pueden conectarse: confirma que el usuario tiene acceso a Databricks y permiso para autorizar la aplicación OAuth.