Cómo conectar GitHub a un agente de IA paso a paso

· DoubleX

Respuesta rápida

Para conectar GitHub a un agente de IA, crea la conexión en la pantalla Conectores, autoriza tu cuenta, elige si es personal, del equipo o de la empresa, y define qué acciones puede hacer el agente (solo lectura o también comentar y abrir PRs). En DoubleX Agentes, luego pruebas con una consulta y revisas el historial.

Conectar GitHub a un agente de IA permite que consulte repositorios, issues y pull requests sin que tengas que copiar y pegar información. Lo más importante no es solo ligar la cuenta, sino decidir quién puede usar la conexión y qué puede hacer el agente con ella. Esta guía se centra en la configuración y en la primera prueba.

¿Qué puede hacer el agente con el conector de GitHub?#

Con el conector de GitHub, el agente puede leer repositorios, issues y pull requests, y también abrir y comentar PRs. Todo depende de las acciones que habilites: puedes dejarlo solo en lectura o permitirle escribir.

En la práctica, eso cubre cosas como:

  • Leer el estado de un repositorio o de un issue.
  • Revisar los cambios de un pull request.
  • Dejar un comentario en un PR.
  • Abrir un PR cuando tú lo pides.

Para ver ejemplos de pedidos y rutinas ya armadas, consulta la guía GitHub con agente de IA: ejemplos de pedidos y rutinas. Aquí nos quedamos en la conexión.

¿Qué necesito tener antes de conectar?#

Necesitas una cuenta en DoubleX Agentes, una cuenta de GitHub con acceso a los repositorios que quieres usar y, si vas a compartir la conexión, el rol adecuado en tu empresa. Crear la cuenta es gratis y no pide tarjeta.

Antes de empezar, ten claro:

RequisitoPara qué sirve
Cuenta en DoubleX AgentesCrear el agente y la conexión
Cuenta de GitHub con acceso a los repositoriosAutorizar lo que el agente podrá ver
Un agente creado (o el diagnóstico hecho)Tener a quién asignarle el conector
Rol de administrador o dueñoCompartir la conexión con el equipo o la empresa

Si aún no tienes agentes, puedes hacer el diagnóstico (una conversación de 5 a 10 minutos) y convertirlo en un equipo de agentes con un clic. El Inicio rápido explica ese recorrido.

¿Cómo conectar GitHub en la pantalla Conectores?#

La conexión se crea en la pantalla Conectores, eligiendo GitHub y autorizando tu cuenta. Después, asignas el conector al agente que lo va a usar.

  1. Entra a DoubleX Agentes y abre la pantalla Conectores.
  2. Busca GitHub en la lista (está en la categoría de desarrollo).
  3. Inicia la conexión y autoriza tu cuenta de GitHub cuando se te pida.
  4. Elige el alcance de la conexión: personal, del equipo o de la empresa (lo vemos en la siguiente sección).
  5. Abre la pantalla Agentes y selecciona el agente que usará GitHub.
  6. Agrega el conector de GitHub a ese agente.
  7. Define qué acciones puede ejecutar (lectura, comentarios, apertura de PRs).
  8. Guarda y haz una prueba.

Las credenciales de las conexiones se guardan cifradas con AES-256-GCM. Para más detalle técnico sobre conectores, revisa la documentación de Conectores.

¿Conexión personal, del equipo o de la empresa: cuál elegir?#

Elige personal si el acceso debe ser solo tuyo, del equipo si lo usa un grupo concreto y de la empresa si varias áreas necesitan los mismos repositorios. Una conexión personal solo vale para la persona que la creó.

AlcanceCuándo convieneQué considerar
PersonalPruebas, o cuando el agente debe actuar con tu accesoSolo tú puedes usarla
Del equipoUn equipo de desarrollo comparte los mismos repositoriosLos miembros del equipo usan la misma conexión
De la empresaVarias áreas necesitan la misma integraciónConviene limitar bien las acciones

Como regla práctica, para la primera prueba usa una conexión personal. Cuando todo funcione, evalúa pasarla al equipo. Recuerda que las rutinas corren con los permisos de quien las creó, así que piensa bien a nombre de quién queda la conexión.

¿Cómo limitar las acciones del agente (solo lectura o con escritura)?#

Para cada agente eliges 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.

Dos configuraciones típicas:

  • Solo lectura: el agente consulta repositorios, issues y pull requests, pero no cambia nada. Es la opción más segura para empezar.
  • Lectura y escritura: además de leer, puede comentar en PRs y abrirlos. Actívala cuando ya confíes en el comportamiento del agente.

Además, antes de enviar, borrar o modificar algo en los sistemas, el agente pide confirmación y muestra el paso a paso de lo que hizo. Así, aunque habilites la escritura, tú sigues teniendo la última palabra.

¿Cómo hacer la primera prueba y revisar el historial en Tareas?#

Haz un pedido simple de lectura al agente y revisa en la pantalla Tareas qué herramientas usó y qué resultado entregó. Cada pedido queda como una tarea con historial completo.

Pedidos que puedes copiar para probar:

  • "Lista los pull requests abiertos del repositorio y dime cuál lleva más tiempo sin revisión."
  • "Resume los últimos issues creados en este repositorio."
  • "Explícame qué cambios incluye este pull request y qué debería revisar primero."
  • "Prepara un comentario para este PR con tus observaciones, pero no lo publiques todavía."

Después, abre Tareas y comprueba tres cosas: quién hizo el pedido, qué herramientas de GitHub usó el agente y cuál fue el resultado. Si algo no funcionó, revisa que el conector esté asignado al agente y que la acción necesaria esté habilitada. Cuando todo esté bien, pasa a las rutinas con la guía de ejemplos de pedidos y rutinas de GitHub.

Preguntas frecuentes#

¿Necesito saber programar para conectar GitHub?#

No. La conexión se hace desde la pantalla Conectores y el agente se configura describiendo lo que necesitas con tus propias palabras. Quien quiera ir más allá puede usar la API REST, la CLI o el servidor MCP.

¿Puedo dejar que el agente solo lea y no modifique nada?#

Sí. Para cada agente puedes elegir qué acciones ejecuta en GitHub y dejar desactivadas las que modifican datos, de modo que trabaje en solo lectura.

¿El agente puede abrir o comentar pull requests?#

Sí, el conector de GitHub permite abrir y comentar PRs, siempre que habilites esas acciones. Antes de alterar algo, el agente pide confirmación.

¿Mi código se usa 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. También puedes activar la retención cero en la pantalla Modelos.

¿Cómo sé qué hizo el agente en GitHub?#

En la pantalla Tareas. Cada pedido queda registrado con el historial completo: quién lo pidió, cada herramienta que el agente usó y el resultado.

Guías relacionadas

Más guías de GitHub