GitHub

3 min de lectura

GitHub permite que un agente reciba actividad de repositorios y actúe sobre código, incidencias y pull requests. La configuración combina la instalación de la GitHub App y la identidad con la que el agente publica.

Conectar repositorios

1. En la ficha del agente, abre Canales y selecciona GitHub.
2. Conecta o selecciona una instalación de GitHub App.
3. Autoriza la instalación en la cuenta u organización correspondiente y elige los repositorios disponibles.
4. De vuelta en Kujira, selecciona esa instalación para el canal.

La instalación determina los repositorios a los que puede acceder el agente. Gestiona sus permisos y repositorios desde GitHub.

Configuración de un canal

Un canal reúne el alcance de repositorios, los eventos que recibe, su modo de escucha y la identidad con la que puede publicar. Revísalos juntos antes de activarlo.

Filtrar eventos

Elige los repositorios y eventos que debe recibir: pull requests, revisiones, comentarios, cambios de código, incidencias o workflows. También puedes limitar la recepción a eventos que impliquen al agente, como una mención, asignación o solicitud de revisión.

Añade instrucciones al canal para definir qué debe hacer cuando llegue cada evento.

Revisiones de pull requests

Cuando se le pide una revisión al agente, aparece sola como una actividad en su ficha y como una comprobación <agente> · revisión junto al CI del pull request. Se cierra cuando el agente envía su revisión o cuando el pull request se cierra. Si el agente no puede atenderla (parado, sin cuota o con la credencial rechazada), lo indica en lugar de aparentar que está revisando.

Permiso para la comprobación

La comprobación del pull request necesita el permiso Checks: lectura y escritura de la GitHub App. Si GitHub te pide aceptar un cambio de permisos de la instalación, acéptalo: sin él la actividad aparece igual, pero la comprobación no.

Autorizar la identidad del agente

Autoriza una cuenta de GitHub en el detalle del canal para que el agente pueda publicar con esa identidad. Revisa por separado los permisos de la instalación y de la cuenta autorizada.

Los filtros no reducen permisos

Filtrar qué eventos recibe el agente no limita por sí mismo el alcance de la instalación ni de la cuenta con la que actúa.

Verificar la configuración

Genera un evento incluido en los filtros. Si no llega, revisa el repositorio, la instalación y el tipo de evento. Si llega pero el agente no puede actuar, revisa la autorización de su identidad.

Eliminar una instalación en Kujira no desinstala la GitHub App; esa operación se realiza desde GitHub.