API GitLab : ce qu'on peut faire et comment l'utiliser avec des agents IA
L'API GitLab couvre les projets, dépôts, issues, merge requests, pipelines CI/CD, groupes et utilisateurs, en REST et en GraphQL. Elle sert aux équipes d'ingénierie et DevOps, sur GitLab.com comme sur des instances auto-hébergées. L'accès se fait par jeton personnel, de projet ou de groupe, ou par OAuth.
Ce que propose l’API GitLab
Projets et dépôts
Fichiers, branches, commits, tags et comparaisons.
Issues
Création, étiquettes, jalons, responsables et commentaires.
Merge requests
Ouverture, discussions, approbations et merge.
Pipelines et jobs
Exécutions CI/CD, journaux, artefacts et relance.
Groupes et membres
Structure des groupes, membres et niveaux d'accès.
Webhooks
Événements de push, de MR, d'issue et de pipeline.
Comment accéder à l’API GitLab
- API publiqueJeton d'accès personnel, de projet ou de groupe avec des scopes (par exemple api ou read_api), ou OAuth 2.0. Sur les instances self-managed, l'URL de base est celle du serveur de l'entreprise.
- Les limites de requêtes varient entre GitLab.com et les instances auto-hébergées.
- Les jetons avec le scope api donnent un accès large ; préférez read_api quand cela suffit.
- Les variables de CI et les journaux peuvent contenir des secrets : l'agent ne doit pas les transmettre.
Documentation officielle: docs.gitlab.com/api
Ce qu’un agent iTeam fait avec l’API GitLab
Pipeline rouge expliqué
L'agent lit le journal du job en échec, résume la cause probable et commente la merge request, en mentionnant l'auteur du commit.
Merge requests oubliées
L'agent liste les MR sans relecture depuis des jours et relance les relecteurs dans Slack ou Teams.
Issue de support bien décrite
Les tickets techniques du support deviennent des issues avec étapes de reproduction, environnement et priorité, dans le bon projet.
Changelog du sprint
À la clôture du jalon, l'agent rassemble les MR fusionnées et rédige le changelog pour relecture.
De l’identifiant à l’agent au travail, avec validation
Créer un jeton de projet ou de groupe
Utilisez des scopes minimaux et le rôle le plus bas qui convient ; en self-managed, indiquez l'URL de l'instance.
Enregistrer dans le coffre d'iTeam
Le jeton est conservé dans le coffre et chaque agent a ses propres droits ; le tri ne fait pas de merge.
Tester avec validation
Merges, relance de déploiements et modifications de configuration passent par une validation humaine.
Équipes IA prêtes à l’emploi pour ce travail
Analyse de données
Posez une question métier dans Slack ou Teams : l'équipe écrit la requête, vérifie le résultat et vous répond avec le chiffre et sa source.
Support informatique interne
Mot de passe, accès, matériel : la demande est posée dans Slack ou Teams, l'agent répond ou ouvre un ticket Jira complet.
Questions sur l’API GitLab
L'API GitLab est-elle gratuite ?
En général, oui : l'API est disponible dans toutes les offres ; certaines fonctions qu'elle expose dépendent de l'offre.
Faut-il programmer pour utiliser l'API GitLab avec iTeam ?
Pas nécessairement. GitLab figure dans le catalogue d'apps, et l'équipe de déploiement configure les flux.
Cela fonctionne-t-il avec GitLab self-managed ?
Oui, à condition que l'instance soit accessible à iTeam, par le réseau ou par un tunnel approuvé par la DSI.
