GitLab en ChatGPT y Codex está actualmente en versión beta.
Descripción general
Usa la plantilla de app de GitLab Self-Managed para crear un borrador de app específico para tu Espacio de trabajo, destinado a una instancia de GitLab Self-Managed o GitLab Dedicated. Proporciona el nombre de host de GitLab y las credenciales de la aplicación OAuth, revisa el borrador de la app y luego publícala para los miembros del Espacio de trabajo que cumplan los requisitos. Después de publicarla, las acciones habilitadas de la app estarán disponibles en las conversaciones de ChatGPT y las sesiones de Codex.
Para obtener una descripción general de las funciones de GitLab compatibles, la disponibilidad, los permisos, el uso de datos y los requisitos de red, consulta: cómo conectar GitLab a ChatGPT y Codex.
Qué vas a configurar
Vas a crear una app específica para tu Espacio de trabajo a partir de la plantilla de app de GitLab Self-Managed. La app usa:
Una aplicación OAuth de GitLab registrada en tu host de GitLab Self-Managed o GitLab Dedicated.
El ID de la aplicación y el Secreto de OAuth de GitLab para la autorización de usuarios.
Los alcances OAuth requeridos: api, write_repository y openid.
Tu nombre de host de GitLab, como gitlab.example.com, para determinar los endpoints web, de API, de autorización y de tokens.
Antes de comenzar
Necesitas:
Acceso de administrador o propietario al Espacio de trabajo de ChatGPT.
Permiso de GitLab para crear la aplicación OAuth: acceso de propietario del grupo para una app que pertenezca a un grupo, o acceso de administrador de la instancia para una app que abarque toda la instancia.
Solo el nombre de host de GitLab, sin https://, puerto ni ruta. Usa un host de GitLab Self-Managed o GitLab Dedicated, no gitlab.com.
Decidir qué acciones de GitLab deben admitir ChatGPT y Codex, como búsquedas en repositorios, flujos de trabajo con solicitudes de fusión o incidencias, edición de archivos o flujos de trabajo más amplios de Codex.
Mantén ChatGPT y GitLab abiertos en pestañas separadas. Copia el URI de redireccionamiento exacto que se muestra en ChatGPT; no crees uno ni lo modifiques.
Para abrir la página Apps desde la Consola de administración, selecciona el Espacio de trabajo de ChatGPT que corresponda, abre Complementos y selecciona Administrar apps heredadas.
Valores que debes preparar
Nombre de host de GitLab: por ejemplo, gitlab.example.com.
URI de redireccionamiento: cópialo del flujo de configuración de la plantilla en ChatGPT.
ID de la aplicación OAuth de GitLab.
Secreto de OAuth de GitLab.
Alcances OAuth: cópialos del flujo de configuración de la plantilla en ChatGPT.
Start the template setup in ChatGPT
In ChatGPT, switch to the workspace where the app should be available.
Go to Workspace settings > Apps.
In Directory, find GitLab, open its GitLab Self-Managed app template, and select Enable.
Enter a clear app name and description.
Enter the GitLab hostname, such as gitlab.example.com.
Copy the Redirect URI shown in ChatGPT, and keep this tab open.
Example: https://chatgpt.com/connector/oauth/<redirect_id>. Do not remove the redirect ID, add a trailing slash, or replace the URI with a generic ChatGPT URL.
Crea la aplicación OAuth de GitLab en GitLab
Elige dónde crear la aplicación
Abre tu host de GitLab, como https://gitlab.example.com.
Elige si quieres crear una aplicación para toda la instancia o una que pertenezca a un grupo. Esta elección determina quién administra la aplicación; el acceso a los proyectos sigue dependiendo de los permisos de GitLab del usuario que otorga la autorización y de los alcances OAuth concedidos.
Para una aplicación que abarque toda la instancia, ve a Administración > Aplicaciones. Para una aplicación que pertenezca a un grupo, ve a Configuración > Aplicaciones del grupo.
Agrega los detalles de la aplicación
Selecciona Nueva aplicación o Agregar nueva aplicación.
Ingresa un nombre claro para la app, como GitLab Self-Managed o GitLab Dedicated.
En URI de redireccionamiento, pega el URI exacto que copiaste de ChatGPT.
Mantén habilitada la opción Confidencial para esta aplicación OAuth del lado del servidor.
Configura el acceso y guarda
Para una aplicación que abarque toda la instancia, GitLab recomienda seleccionar De confianza. Esto omite la solicitud de autorización al usuario.
Selecciona los alcances api, write_repository y openid.
Revisa quién puede administrar la aplicación y confirma que los usuarios de GitLab que otorguen la autorización tengan los permisos adecuados de grupo y proyecto.
Guarda la aplicación.
Requisitos de alcances OAuth
La plantilla solicita los siguientes alcances OAuth para las acciones de GitLab habilitadas en ChatGPT y Codex:
api: requerido para las operaciones de la API de GitLab que ofrece la app, incluidas las acciones de solicitudes de fusión, incidencias y CI/CD.
write_repository: requerido para las operaciones de escritura en repositorios mediante Git.
openid: requerido para la información de identidad y pertenencia de OpenID Connect.
Copia las credenciales OAuth de GitLab
En la aplicación de GitLab guardada, copia el ID de la aplicación y el Secreto. Trata el Secreto como una credencial. Si queda expuesto, renuévalo en GitLab y crea una nueva app para el Espacio de trabajo.
Completa la configuración en ChatGPT
Vuelve a la pestaña de configuración de la plantilla en ChatGPT.
Pega el ID de la aplicación de GitLab en ID de cliente de OAuth.
Pega el Secreto de GitLab en Secreto de cliente de OAuth.
Confirma que el campo de nombre de host de GitLab contenga únicamente el nombre de host, como gitlab.example.com.
Selecciona Crear borrador.
Abre los detalles del borrador de la app y revisa Acceso por rol y Configurar acciones.
Publica y administra la app para ChatGPT y Codex
Crear el borrador de la app no la pone automáticamente a disposición de los miembros. Después de revisar el borrador:
Selecciona Publicar en el borrador de la app.
Ve a la Consola de administración, selecciona el Espacio de trabajo de ChatGPT que corresponda y abre Complementos. Luego, confirma que GitLab esté disponible para los roles previstos.
Revisa Acceso por rol para los roles que deban usar la app.
En Configurar acciones, revisa las acciones de lectura y escritura disponibles.
En Configurar aprobaciones, elige cuándo los usuarios deben aprobar una acción antes de que ChatGPT o Codex use la app.
Pide a un usuario de prueba con acceso que abra GitLab desde el Directorio de complementos o desde Configuración > Complementos. Confirma que el usuario pueda instalar el complemento y conectarse a la app creada a partir de la plantilla de GitLab Self-Managed.
Esta configuración de aprobación de la app se aplica a las conversaciones de ChatGPT y a los hilos de Codex.
Configura la actividad de GitLab para la revisión de código de Codex
Después de publicar la app, configura la actividad de GitLab en Codex si planeas usar la revisión de código de Codex. Al configurar esta actividad, se configuran los eventos de webhook necesarios.
Abre la configuración de conectores de Codex.
Configura una cuenta de servicio del Espacio de trabajo. Deja que Codex cree la cuenta o proporciona un token de acceso personal para una cuenta de servicio existente.
Habilita Actividad de GitLab para el proyecto o uno de sus grupos superiores.
Si Codex necesita ejecutar tareas de programación o usar una configuración específica del proyecto, crea un entorno de proyecto.
La app de GitLab usa la autorización OAuth del usuario para las lecturas y las acciones habilitadas en ChatGPT y Codex. Para las operaciones de escritura de las revisiones de Codex en GitLab Self-Managed o GitLab Dedicated, el token de la cuenta de servicio administrada por el Espacio de trabajo determina con qué identidad y en qué proyectos Codex puede comentar o reaccionar.
Más información: revisar solicitudes de fusión de GitLab con Codex.
Conecta y prueba la app de GitLab
Como usuario con acceso, abre GitLab desde el Directorio de complementos o desde Configuración > Complementos. Selecciona Instalar complemento y luego Conectar.
Si tu Espacio de trabajo tiene más de una app de GitLab, elige la que corresponda a este host de GitLab Self-Managed o GitLab Dedicated.
Autoriza la aplicación OAuth de GitLab cuando se te solicite.
Primero ejecuta una acción de lectura sencilla en ChatGPT o Codex, como listar los proyectos accesibles u obtener una solicitud de fusión conocida.
Si las acciones de escritura están habilitadas, pruébalas en un proyecto de bajo riesgo y en cada producto en el que planees usarlas antes de ampliar su implementación.
Nombre de host y funcionamiento de OAuth
La app usa el nombre de host para determinar los endpoints de GitLab. Ingresa solo el host, como gitlab.example.com. No incluyas https://, una ruta de API o de repositorio, un puerto ni gitlab.com. Esta plantilla es para GitLab Self-Managed o GitLab Dedicated. Para GitLab.com (SaaS), usa la app de GitLab.
Solución de problemas de configuración de la app de GitLab Self-Managed
El URI de redireccionamiento no coincide: confirma que el URI de redireccionamiento de la aplicación OAuth de GitLab coincida exactamente con el que se muestra en ChatGPT.
ChatGPT no puede crear ni guardar el borrador de la app: confirma que se hayan ingresado el nombre de host, el ID de la aplicación, el secreto y el URI de redireccionamiento.
La autenticación se realiza correctamente, pero las llamadas al proyecto fallan: confirma que el usuario de GitLab que otorga la autorización pueda acceder al proyecto y que la aplicación OAuth tenga los alcances de la plantilla.
La API devuelve un error 403 o de permisos insuficientes: confirma que la cuenta de GitLab conectada tenga los permisos necesarios de proyecto o grupo y que la aplicación OAuth incluya los alcances requeridos por la plantilla.
No se puede acceder a ningún proyecto: confirma que el usuario tenga acceso a los proyectos, esté conectado a la instancia de GitLab prevista y haya seleccionado la app de GitLab correcta en ChatGPT o Codex.