DocumentationConnecter vos outils
Connecter un dépôt à un projet
Branches, commits et pull requests sur chaque ticket, incidents vers et depuis le dépôt, et Helpi Agent dans votre code.
Mis à jour 22 novembre 2026
Connectez un dépôt GitHub ou GitLab à un projet et chaque ticket affiche les branches, commits et pull requests qui le nomment. Les incidents peuvent venir du dépôt ou y partir, et Helpi Agent peut travailler sur des tickets dans votre code.
Connecter avec un jeton
- Ouvrez la page
Dépôtdu projet et cliquez surConnecter le dépôt. - Choisissez le fournisseur : GitHub ou GitLab.
- Collez l'adresse du dépôt, comme
https://github.com/acme/app. - Collez un jeton d'accès personnel créé dans vos réglages GitHub ou GitLab.
- Cliquez sur
Connecter le dépôt. Octopora vérifie le jeton sur le dépôt et confirme la connexion.
github.com et gitlab.com sont pris en charge. Un projet a un seul dépôt ; en connecter un autre le remplace.
L'accès dont un jeton a besoin
| Jeton | Pour lire l'activité | Pour que Helpi Agent pousse et ouvre des pull requests |
|---|---|---|
| GitHub, à granularité fine | Contents et Pull requests : read | Contents : write et Pull requests : write |
| GitHub, classique | repo | repo |
| GitLab | read_api | Rôle Developer, api et write_repository |
L'app GitHub Helpi (facultatif)
Avec un dépôt GitHub connecté, Paramètres > Helpi Agent > Dépôt propose Installer l'app GitHub Helpi. Installez-la sur le même dépôt : dès lors, pull requests, commits et commentaires apparaissent sous le nom de l'app plutôt que d'une personne.
Nommez votre travail d'après le ticket
Mettez la clé du ticket n'importe où dans une branche, un message de commit ou le titre d'une pull request et elle apparaît sur le ticket. La carte Workflow Git de chaque ticket donne des exemples à copier.
| Quoi | Exemple |
|---|---|
| Branche | feature/ML-13-login-screen |
| Commit | ML-13: add the login form |
| Pull request | [ML-13] Login screen |
- La casse ne compte pas, et ML-1 ne correspond pas à ML-10.
- Sur GitLab, les pull requests sont des merge requests ; les mêmes noms fonctionnent.
- Si votre dépôt utilise un autre préfixe, comme CP-12 pour ML-12, indiquez-le dans
Paramètres > Général > Préfixe des clés dans git.
Incidents
Sur la page Incidents, Importer les incidents GitHub (ou GitLab) liste les incidents du dépôt à faire venir : les ouverts arrivent comme Ouverts, les fermés comme Résolus. Depuis le menu d'un incident, Pousser vers un incident GitHub le crée dans le dépôt.
Déconnecter
Sur la page Dépôt, cliquez sur Déconnecter. La connexion et son jeton sont supprimés ; vous pouvez reconnecter plus tard. Helpi Agent demande alors un dépôt avant de pouvoir travailler.
Questions
Helpi Agent dit que le jeton ne peut pas pousser.
Le jeton ne peut pas écrire. Créez-en un avec l'accès en écriture ci-dessus et cliquez sur Reconnecter le dépôt.
Une branche n'apparaît pas sur son ticket.
Vérifiez que la clé est dans la branche, le commit ou le titre de la pull request, et qu'une clé renommée est indiquée comme préfixe git.
Puis-je connecter un GitLab auto-hébergé ?
Pas encore : github.com et gitlab.com uniquement.