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ôleCe qu'il fait
IngénieurImplémente le ticket et ouvre une pull request que quelqu'un relit.
RelecteurLit la pull request déjà ouverte pour un ticket et y publie ses observations. Il ne modifie ni ne pousse rien.
DesignerFait 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 Agent permet d'assigner un ticket, de lancer et d'annuler des exécutions et de répondre à l'agent. Approuver les plans Helpi permet d'approuver ses plans. Gérer Helpi Agent permet 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

  1. L'agent copie votre dépôt dans un environnement isolé.
  2. Il lit le ticket et soumet un plan.
  3. Vous approuvez le plan ou demandez des modifications.
  4. Il écrit le changement et lance vos commandes de validation.
  5. 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

  1. Ouvrez le ticket.
  2. Choisissez Assigner à Helpi Agent et sélectionnez l'agent. Seuls les agents activés sont proposés.
  3. Dans la carte Helpi Agent du ticket, cliquez sur Lancer une exécution. Ajoutez des instructions si le ticket ne dit pas tout.
Ou demandez à HelpiCollez ceci dans votre application d'IA.
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

  1. Quand le statut est En attente d'approbation du plan, cliquez sur Voir le plan.
  2. Lisez les fichiers qu'il compte créer, modifier ou supprimer, et pourquoi.
  3. Cliquez sur Approuver le plan, ou sur Demander des modifications en 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 request du ticket, Voir les commentaires de la PR charge les commentaires des relecteurs, seulement à votre demande. Appliquer la correction sur un commentaire lance une exécution Correction d'un commentaire qui 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 revue demande 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églagePlagePar défaut
Exiger l'approbation du planActivé ou désactivéActivé
Durée maximale d'exécution (minutes)5 à 24045
Exécutions par mois0 à 10020
Exécutions simultanées1 à 31
Commandes de validationJusqu'à 10, une par ligneAucune

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.

Voir la visiteLes agents de code en 40 secondes.