Cómo conectar GitLab a un agente de IA paso a paso
· DoubleX
Respuesta rápida
Para conectar GitLab a un agente de IA, abre la pantalla Conectores del DoubleX Agentes, elige GitLab, autoriza el acceso con tu cuenta y define si la conexión es personal, del equipo o de la empresa. Luego habilita al agente solo las acciones necesarias y prueba con un pedido de lectura.
Conectar GitLab a un agente de IA permite que tu equipo consulte proyectos, issues, merge requests y pipelines con solo pedirlo, sin abrir cada pantalla. Lo importante es hacerlo con control: que el agente vea únicamente lo que necesita y que no cambie nada sin que lo sepas. Este guía recorre la conexión completa y una prueba de lectura al final.
¿Qué puede hacer el agente con el conector de GitLab?#
Con el conector de GitLab, el agente puede consultar proyectos, issues, merge requests y pipelines. Eso cubre las preguntas más comunes de un equipo técnico y de quien coordina el trabajo sin vivir dentro de GitLab.
Un conector es un sistema conectado a la plataforma cuyas herramientas los agentes pueden usar. Algunos usos concretos:
| Tarea | Cómo ayuda el agente | Dato que consulta |
|---|---|---|
| Revisar el estado de un release | Resume qué merge requests siguen abiertos | Merge requests |
| Preparar la reunión semanal | Lista las issues abiertas por proyecto | Issues |
| Investigar una entrega bloqueada | Revisa el último pipeline y su resultado | Pipelines |
| Responder a un gerente | Explica en lenguaje simple en qué está un proyecto | Proyectos |
Si quieres ver ejemplos más completos de qué pedirle, consulta el guía GitLab con agente de IA: merge requests, issues y pipelines.
¿Qué necesito tener antes de conectar?#
Necesitas una cuenta en DoubleX Agentes, una cuenta de GitLab con acceso a los proyectos que quieres consultar y un agente que vaya a usar el conector. Crear la cuenta es gratis y no requiere tarjeta.
Antes de empezar, ten claro:
- Qué proyectos importan. El agente verá lo que la cuenta autorizada pueda ver, así que conviene usar una cuenta con el alcance adecuado.
- Quién usará la conexión. Solo tú, un equipo o toda la empresa. Lo decides más abajo.
- Qué quieres que haga. Si al principio solo quieres consultar, trabajaremos en modo lectura.
Si aún no tienes un agente, puedes hacer el diagnóstico: una conversación de 5 a 10 minutos con la consultora de IA del producto sobre tu rutina. Con un clic, el resultado se convierte en un equipo de agentes listo para probar. La guía de inicio rápido explica ese recorrido.
¿Cómo conectar GitLab en la pantalla Conectores?#
Se conecta desde la pantalla Conectores: eliges GitLab, autorizas el acceso y el conector queda disponible para tus agentes. Estos son los pasos en el DoubleX Agentes:
- Inicia sesión en tu cuenta de DoubleX Agentes (o créala gratis, sin tarjeta).
- Abre la pantalla Conectores y busca GitLab, en la categoría de desarrollo.
- Inicia la conexión y autoriza el acceso con tu cuenta de GitLab.
- Elige el tipo de conexión: personal, del equipo o de la empresa (lo detallamos en la siguiente sección).
- Ve a la pantalla Agentes, abre el agente que usará GitLab y activa el conector en su configuración.
- Define qué acciones puede ejecutar en GitLab (ver más abajo) y guarda.
Las contraseñas, los tokens y las claves de las conexiones se guardan cifrados con AES-256-GCM. Para más detalle técnico sobre el tema, revisa la documentación de Conectores.
Conexión personal, del equipo o de la empresa: ¿cuál elegir?#
Elige personal si solo tú vas a usar GitLab con el agente, del equipo si un grupo comparte el mismo acceso y de la empresa si varias áreas lo necesitan. La decisión define quién se beneficia de la conexión.
| Tipo de conexión | Cuándo conviene | Ejemplo |
|---|---|---|
| Personal | Solo vale para ti, con tus permisos | Tu líder técnico revisa sus propios proyectos |
| Del equipo | Un grupo comparte el acceso | El equipo de desarrollo consulta pipelines a diario |
| De la empresa | Varias áreas usan la misma conexión | Producto y operaciones consultan el estado de los proyectos |
Una regla práctica: empieza por la conexión personal para probar y pasa a una del equipo o de la empresa cuando el flujo esté validado. La empresa también puede organizar el acceso con roles de dueño, administrador y miembro, y compartir por persona, equipo o empresa.
¿Cómo limito las acciones del agente y lo dejo en solo lectura?#
Para cada agente, la empresa elige qué sistemas usa y, dentro de cada sistema, qué acciones puede ejecutar. Las acciones que modifican datos pueden quedar desactivadas, de modo que el agente solo lea.
Para un primer uso con GitLab, lo más sensato es:
- Dejar activadas únicamente las acciones de consulta (ver proyectos, issues, merge requests y pipelines).
- Mantener desactivadas las acciones que cambian algo.
- Revisar esa configuración cuando el agente asuma tareas nuevas.
Además, antes de enviar, borrar o modificar algo en tus sistemas, el agente pide confirmación y muestra el paso a paso de lo que hizo.
¿Cómo pruebo con un primer pedido y reviso el historial de la tarea?#
Prueba con un pedido de lectura simple y luego abre la tarea en la pantalla Tareas. Cada pedido queda con su historial completo: qué pediste, qué herramientas usó el agente y cuál fue el resultado.
Pedidos que puedes copiar para la primera prueba:
- "Muéstrame los merge requests abiertos del proyecto de la tienda online."
- "Lista las issues abiertas de este proyecto y agrúpalas por tema."
- "Revisa el último pipeline del proyecto principal y dime si terminó bien."
- "Hazme un resumen del estado de los proyectos que consulté esta semana."
Después, abre la tarea y comprueba que el agente usó las herramientas de GitLab esperadas y que la respuesta coincide con lo que ves en GitLab. Si algo no cuadra, ajusta las instrucciones del agente o las acciones permitidas.
Cuando la prueba esté bien, puedes programar una rutina, por ejemplo un resumen cada lunes con los merge requests abiertos. Los disparadores permiten que el agente trabaje en un horario definido, con los permisos de quien creó la rutina.
Preguntas frecuentes#
¿Necesito saber programar para conectar GitLab?#
No. La conexión se hace desde la pantalla Conectores, autorizando el acceso con tu cuenta. Quien quiera ir más allá tiene API REST, CLI y servidor MCP.
¿El agente puede modificar mis proyectos de GitLab?#
Solo si tú lo permites. Puedes dejar el agente en solo lectura y, cuando una acción modifica algo, el agente pide confirmación antes de ejecutarla.
¿Mis datos se usan para entrenar modelos?#
No. El contenido de la empresa no se usa para entrenar modelos y los pedidos solo van a proveedores de IA que no usan lo que reciben para entrenamiento. Cada empresa tiene además su propia base de datos, separada de las demás.
¿Puedo conectar otros sistemas además de GitLab?#
Sí. Hay conectores para correo, calendario, hojas de cálculo, CRM y más. Por ejemplo, puedes ver cómo se hace con Box o con Jam.
¿Cómo sé qué hizo el agente?#
Cada pedido queda como una tarea en la pantalla Tareas, con el pedido, cada herramienta usada y el resultado. Así puedes saber quién lo pidió, qué se hizo y cuándo.
Guías relacionadas
- Cómo conectar Box a un agente de IA paso a pasoAprende cómo conectar Box a un agente de IA: desde la cuenta hasta el primer pedido, con permisos por agente, solo lectura e historial de cada tarea.
- Cómo conectar Jam a un agente de IA paso a pasoAprende cómo conectar Jam a un agente de IA: crea la cuenta, usa la pantalla Conectores, elige el tipo de conexión, limita permisos y haz una primera prueba.