GitLab en ChatGPT y Codex está actualmente en versión beta.
Descripción general
Usa la plantilla de la aplicación GitLab Self-Managed para crear un borrador de aplicación específico del Espacio de trabajo para 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 aplicación y publícalo para los miembros elegibles del Espacio de trabajo. Después de publicarla, las acciones habilitadas de la aplicación estarán disponibles en las conversaciones de ChatGPT y las sesiones de Codex.
Para consultar una descripción general del comportamiento compatible de GitLab, la disponibilidad, los permisos, el uso de datos y los requisitos de red, consulta: Conectar GitLab con ChatGPT y Codex.
Qué vas a configurar
Vas a crear una aplicación específica del Espacio de trabajo a partir de la plantilla de la aplicación GitLab Self-Managed. La aplicación 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 autorizar usuarios.
Los alcances de OAuth requeridos: api, write_repository y openid.
Tu nombre de host de GitLab, como gitlab.example.com, para derivar los endpoints web, de API, de autorización y de token.
Antes de comenzar
Necesitas:
Acceso de administrador o propietario del Espacio de trabajo de ChatGPT.
Permiso de GitLab para crear la aplicación OAuth: acceso de propietario del grupo para una aplicación propiedad de un grupo o acceso de administrador de la instancia para una aplicación disponible en toda la instancia.
Solo el nombre de host de GitLab, sin https://, puertos ni rutas. Usa un host de GitLab Self-Managed o GitLab Dedicated, no gitlab.com.
Una decisión sobre las acciones de GitLab que deben admitir ChatGPT y Codex, como búsquedas en repositorios, flujos de trabajo de solicitudes de fusión y problemas, edición de archivos o flujos de trabajo más amplios de Codex.
Mantén ChatGPT y GitLab abiertos en pestañas separadas. Copia la URI de redireccionamiento exacta que aparece en ChatGPT; no la crees ni la modifiques.
Valores que debes preparar
Nombre de host de GitLab: por ejemplo, gitlab.example.com.
URI de redireccionamiento: cópiala del flujo de configuración de la plantilla de ChatGPT.
ID de la aplicación OAuth de GitLab.
Secreto de OAuth de GitLab.
Alcances de OAuth: cópialos del flujo de configuración de la plantilla de ChatGPT.
Start the template setup in ChatGPT
In ChatGPT, switch to the workspace where the app should be available.
Go to Workspace settings > Plugins.
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.
Crear la aplicación OAuth de GitLab en GitLab
Elegir 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 seguirá dependiendo de los permisos de GitLab del usuario que autoriza y de los alcances de OAuth concedidos.
Para crear una aplicación para toda la instancia, ve a Administración > Aplicaciones. Para crear una aplicación que pertenezca a un grupo, ve a Configuración > Aplicaciones en el grupo.
Agregar los detalles de la aplicación
Selecciona Nueva aplicación o Agregar nueva aplicación.
Ingresa un nombre claro para la aplicación, como GitLab Self-Managed o GitLab Dedicated.
En URI de redireccionamiento, pega la URI exacta que copiaste de ChatGPT.
Mantén habilitada la opción Confidencial para esta aplicación OAuth del lado del servidor.
Configurar el acceso y guardar
Para una aplicación disponible en toda la instancia, GitLab recomienda seleccionar De confianza. Esto omite el prompt de autorización del 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 autoricen tengan los permisos adecuados para grupos y proyectos.
Guarda la aplicación.
Requisitos de los alcances de OAuth
La plantilla solicita los siguientes alcances de OAuth para las acciones de GitLab habilitadas en ChatGPT y Codex:
api: necesario para las operaciones de la API de GitLab disponibles mediante la aplicación, incluidas las acciones de solicitudes de fusión, problemas y CI/CD.
write_repository: necesario para las operaciones de escritura en repositorios mediante Git.
openid: necesario para la identidad y la información de membresía de OpenID Connect.
Copiar 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 aplicación para el Espacio de trabajo.
Finalizar la configuración en ChatGPT
Regresa a la pestaña de configuración de la plantilla de 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 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 aplicación y revisa Acceso por rol y Configurar acciones.
Publicar y administrar la aplicación para ChatGPT y Codex
Crear el borrador de la aplicación no la pone automáticamente a disposición de los miembros. Después de revisar el borrador:
Selecciona Publicar en el borrador de la aplicación.
Ve a Configuración del Espacio de trabajo > Plugins y confirma que GitLab esté disponible para los roles previstos.
Revisa Acceso por rol para los roles que deben usar la aplicación.
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 usen la aplicación.
Pide a un usuario de prueba con acceso que abra GitLab desde el Directorio de plugins o desde Configuración > Plugins. Confirma que el usuario pueda instalar el plugin y conectarse a la aplicación creada a partir de la plantilla Self-Managed de GitLab.
Estas opciones de aprobación de la aplicación se aplican a las conversaciones de ChatGPT y los hilos de Codex.
Configurar la actividad de GitLab para la revisión de código de Codex
Después de publicar la aplicación, configura la actividad de GitLab en Codex si planeas usar la revisión de código de Codex. Esta configuración de actividad configura los eventos de webhook requeridos.
Abre la configuración de conectores de Codex.
Configura una cuenta de servicio del Espacio de trabajo. Permite 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 principales.
Si Codex necesita ejecutar tareas de programación o usar una configuración específica del proyecto, crea un entorno del proyecto.
La aplicación de GitLab usa OAuth de usuario para las lecturas y las acciones habilitadas en ChatGPT y Codex. Para las escrituras de revisión de Codex en GitLab Self-Managed o GitLab Dedicated, el token de la cuenta de servicio administrada por el Espacio de trabajo determina la identidad y los proyectos donde Codex puede comentar o reaccionar.
Más información: Revisar solicitudes de fusión de GitLab con Codex.
Conectar y probar la aplicación de GitLab
Como usuario con acceso, abre GitLab desde el Directorio de plugins o desde Configuración > Plugins. Selecciona Instalar plugin y luego Conectar.
Si tu Espacio de trabajo tiene más de una aplicación de GitLab, elige la correspondiente a este host de GitLab Self-Managed o GitLab Dedicated.
Autoriza la aplicación OAuth de GitLab cuando se te solicite.
Primero ejecuta una pequeña acción de lectura en ChatGPT o Codex, como enumerar 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 donde planees usarlas antes de implementarlas de forma más amplia.
Comportamiento del nombre de host y OAuth
La aplicación usa el nombre de host para derivar los endpoints de GitLab. Ingresa solo el host, como gitlab.example.com. No incluyas https://, una ruta de API o repositorio, un puerto ni gitlab.com. Esta plantilla es para GitLab Self-Managed o GitLab Dedicated. Para GitLab.com (SaaS), usa la aplicación de GitLab.
Solucionar problemas de configuración de la aplicación GitLab Self-Managed
La URI de redireccionamiento no coincide: confirma que la URI de redireccionamiento de la aplicación OAuth de GitLab coincida exactamente con la que se muestra en ChatGPT.
ChatGPT no puede crear ni guardar el borrador de la aplicación: confirma que estén presentes el nombre de host, el ID de la aplicación, el secreto y la URI de redireccionamiento.
La autenticación se completa, pero fallan las llamadas al proyecto: confirma que el usuario de GitLab que autoriza pueda acceder al proyecto y que la aplicación OAuth tenga los alcances de la plantilla.
La API devuelve 403 o indica que los permisos son insuficientes: confirma que la cuenta de GitLab conectada tenga los permisos necesarios para el proyecto o grupo y que la aplicación OAuth incluya los alcances requeridos por la plantilla.
No hay proyectos accesibles: confirma que el usuario tenga acceso al proyecto, esté conectado a la instancia de GitLab prevista y haya seleccionado la aplicación de GitLab correcta en ChatGPT o Codex.