DocumentationLe travail au quotidien
Helpi Agents
Des agents de code qui prennent un ticket et ouvrent une pull request : ce qu'il leur faut, et comment lancer, suivre et relire une exécution.
Mis à jour 22 novembre 2026
Les Helpi Agents sont les agents de code d'Octopora. Confiez un ticket à l'un d'eux : il planifie le changement, l'écrit dans votre dépôt sur sa propre branche, lance vos vérifications et ouvre une pull request que vous relisez. Il ne fusionne jamais sa propre pull request.
Les agents et leurs rôles
Chaque projet démarre avec un agent, Helpi Engineer, désactivé. Le rôle change la façon dont l'agent travaille :
| Rôle | Ce qu'il fait |
|---|---|
| Ingénieur | Implémente le ticket et ouvre une pull request que quelqu'un relit. |
| Relecteur | Lit la pull request déjà ouverte pour un ticket et y publie ses observations. Il ne modifie ni ne pousse rien. |
| Designer | Fait le travail d'interface, en respectant le design system existant. |
| Testeur | Écrit des tests, sans modifier le code testé. |
| Documentation | Écrit uniquement de la documentation et des commentaires, jamais du comportement. |
Toute personne qui a Gérer Helpi Agent règle cela dans Paramètres > Helpi Agent du projet : Ajouter un agent, un interrupteur activé ou désactivé pour chaque agent, et Retirer. Dans Compétences, elle peut rédiger des règles maison qu'un agent lit quand elles s'appliquent, et assigner jusqu'à 16 compétences à chaque agent.
Ce qu'il faut pour une exécution
- L'offre Business ou Enterprise. Le propriétaire de l'espace peut la demander dans
Paramètres > Facturation. - Un dépôt connecté au projet avec accès en écriture. Voir Connecter un dépôt.
- Un agent activé.
- Le bon rôle.
Utiliser Helpi Agentpermet d'assigner un ticket, de lancer et d'annuler des exécutions et de répondre à l'agent.Approuver les plans Helpipermet d'approuver ses plans.Gérer Helpi Agentpermet de le configurer. Les rôles Propriétaire et Administrateur ont les trois ; Responsable peut lancer des exécutions.
La page Helpi Agent d'un projet n'apparaît que pour les rôles qui ont au moins une de ces permissions.
Ce que fait une exécution
- L'agent copie votre dépôt dans un environnement isolé.
- Il lit le ticket et soumet un plan.
- Vous approuvez le plan ou demandez des modifications.
- Il écrit le changement et lance vos commandes de validation.
- Il pousse une branche nommée
helpi/<clé du ticket>-<titre>et ouvre une pull request.
Relancez un agent sur le même ticket et il ajoute des commits à cette branche tant qu'elle existe. Repartir plutôt d'une nouvelle branche crée une branche distincte et ouvre une deuxième pull request.
Lancer une exécution
- Ouvrez le ticket.
- Choisissez
Assigner à Helpi Agentet sélectionnez l'agent. Seuls les agents activés sont proposés. - Dans la carte
Helpi Agentdu ticket, cliquez surLancer une exécution. Ajoutez des instructions si le ticket ne dit pas tout.
Lance LR-13 avec l'agent ingénieur
Helpi retrouve le ticket, choisit l'agent qui a ce rôle (sinon l'agent du ticket, sinon celui par défaut du projet), l'assigne et lance l'exécution, avec vos permissions. Elle démarre aussitôt, sans confirmation, et ne coûte aucune demande à Helpi. Quand il ne peut pas, il vous dit pourquoi : votre rôle, aucun agent, l'offre, aucun dépôt ou un dépôt où l'on ne peut pas pousser, ou les exécutions du mois épuisées.
Suivre une exécution
La carte Helpi Agent du ticket montre le statut, la Chronologie, les Journaux et les Exécutions précédentes. Sur la page Helpi Agent du projet, Aperçu montre l'exécution en cours et celles du mois, et Exécutions les liste toutes. Une exécution passe par En file d'attente, Provisionnement, Clonage, Analyse, En attente d'approbation du plan, Implémentation, Validation et Envoi, puis Pull request ouverte et Terminée. Elle peut aussi finir Annulée, Échouée ou Expirée.
Approuver le plan et répondre à ses questions
- Quand le statut est
En attente d'approbation du plan, cliquez surVoir le plan. - Lisez les fichiers qu'il compte créer, modifier ou supprimer, et pourquoi.
- Cliquez sur
Approuver le plan, ou surDemander des modificationsen disant ce qu'il faut faire autrement. L'agent révise son plan, un nombre limité de fois.
Si le ticket a changé après la rédaction du plan, demandez des modifications pour que l'agent replanifie. Quand une exécution s'arrête pour poser une question, le ticket affiche Helpi Agent a besoin de votre réponse : cliquez sur Continuer pour reprendre depuis la branche et les fichiers déjà écrits, ou sur Arrêter l'exécution. Approuver demande Approuver les plans Helpi ; répondre demande Utiliser Helpi Agent.
Relire la pull request
Ouvrez la pull request depuis le ticket et relisez-la comme n'importe quelle autre. C'est vous qui la fusionnez : l'agent ne le fait jamais.
- Dans la carte
Commentaires de la pull requestdu ticket,Voir les commentaires de la PRcharge les commentaires des relecteurs, seulement à votre demande.Appliquer la correctionsur un commentaire lance une exécutionCorrection d'un commentairequi pousse un correctif. - Pour un second avis, assignez le ticket à un agent Relecteur et lancez une exécution. Il lit la pull request ouverte et y publie ses remarques. Lancez d'abord un agent Ingénieur : sans pull request, il n'y a rien à relire. Ensuite,
Corriger les remarques de la revuedemande de les appliquer.
Limites
Les agents de code ne sont ni dans Starter ni dans Team. Business et Enterprise les incluent, avec l'approbation des plans et les journaux d'exécution. Une seule exécution travaille sur un ticket à la fois. Une personne qui a Gérer Helpi Agent règle les limites de chaque agent sous Politique de Helpi Agent :
| Réglage | Plage | Par défaut |
|---|---|---|
Exiger l'approbation du plan | Activé ou désactivé | Activé |
Durée maximale d'exécution (minutes) | 5 à 240 | 45 |
Exécutions par mois | 0 à 100 | 20 |
Exécutions simultanées | 1 à 3 | 1 |
Commandes de validation | Jusqu'à 10, une par ligne | Aucune |
Quand les exécutions du mois sont épuisées, la page affiche Limite mensuelle d'exécutions atteinte et le compte repart le mois suivant.
Questions
Je ne vois pas Helpi Agent dans la barre latérale.
Votre rôle n'a aucune des permissions Gérer Helpi Agent, Utiliser Helpi Agent et Approuver les plans Helpi. Demandez au propriétaire ou à un administrateur du projet.
Il dit que le jeton du dépôt ne peut pas pousser.
Le jeton du dépôt ne peut pas écrire. Reconnectez-le avec un accès en écriture : voir Connecter un dépôt.
Un agent peut-il écrire du code avant mon approbation ?
Pas tant que Exiger l'approbation du plan est activé, ce qui est le cas par défaut. L'agent attend que vous approuviez son plan.