L'integrazione GitHub offre alle tue pipeline una lettura dell'attività di sviluppo: commit, pull request, review ed esecuzioni GitHub Actions — per repository e per sviluppatore. È in sola lettura: nulla viene scritto sui tuoi repository.
Cosa puoi farci
- Report di output del team — chi ha rilasciato cosa nel periodo: commit, righe aggiunte / rimosse, PR aperte e unite, numero di review.
- Salute della CI — numero di esecuzioni GitHub Actions riuscite, fallite e in corso, per repository.
- Alimentare un agent — un agent che sintetizza la settimana tecnica (consulta Casi d'uso → CTO IA).
Connessione
In Impostazioni → Servizi → GitHub, scheda Account, due metodi:
- Connetti con GitHub — OAuth tramite l'applicazione della piattaforma (quando l'operatore l'ha configurata), poi selezione dei repository da seguire. Nessun token da copiare.
- Incolla un token (BYO) — un access token GitHub in lettura (idealmente un fine-grained PAT limitato ai repository pertinenti), l'elenco dei repository da seguire (
owner/repo) e, per GitHub Enterprise, una base API. Il token è archiviato lato server e non viene mai più mostrato.
Il nodo github_report
Il nodo github_report recupera l'attività in una finestra temporale (24h, 7d o 30d) e la pubblica nel contesto: suddivisione per sviluppatore (by_developer) e per repository (by_repo), registro dei commit (commit_log), totali, sintesi della CI (ci) e l'elenco dei repository che non è stato possibile leggere (unreadable_repos). Un agent a valle la trasforma in un report leggibile.
Le letture vengono lanciate in parallelo (con un limite) sui repository, per restare veloci su un'organizzazione GitHub molto attiva.
Strumenti dell'agent (lettura): github.report, github.list_commits, github.list_pull_requests.
Buone pratiche
- Preferisci un token dedicato per l'integrazione anziché un token personale condiviso.
- Limita gli scope allo stretto necessario (lettura di repository, pull request e actions).
- Combina con il canale Schedule per un report ricorrente (ad es. ogni sera alle 18).