Aller au contenu
Documentation

Sous-agents, tâches en arrière-plan et boucles

L’agent peut diviser une requête volumineuse en plusieurs parties, les exécuter en parallèle et poursuivre le traitement en arrière-plan pendant que vous continuez à travailler. Tout ce qui est décrit ici s’exécute au sein de votre session de terminal et s’arrête lorsque la session prend fin.

Un sous-agent est un agent distinct disposant de son propre contexte, de ses propres instructions et de sa propre liste d’outils. Eve lance des sous-agents lorsqu’une tâche peut bénéficier du parallélisme, par exemple pour effectuer des recherches dans plusieurs modules d’une base de code volumineuse, lancer des tests de performance ou exécuter simultanément des refactorisations indépendantes. Seule la réponse finale du sous-agent est renvoyée à la conversation principale, ce qui permet de conserver une fenêtre de contexte principale compacte.

  • Les sous-agents s’exécutent en parallèle, jusqu’à 32 à la fois par défaut. Eve peut lancer des lots de tâches parallèles en un seul tour pour un débit maximal.
  • Un sous-agent peut lancer ses propres sous-agents, jusqu’à deux niveaux de profondeur.
  • Les sous-agents ne disposent jamais de droits supérieurs à ceux de votre session. Leurs demandes d’autorisation s’affichent dans votre terminal, accompagnées du nom du sous-agent, une à la fois.
  • Les workflows de plusieurs heures et les suspensions de tour complexes sont pris en charge jusqu’à 2 000 cycles de tour.
  • Chaque tour d’un sous-agent est considéré comme un tour d’agent normal et est pris en compte dans vos limites.

AgentOutilsUtiliser
generalChaque outilCHAMPREP local et dont dispose la sessionÉléments autonomes d’une tâche plus vaste.
exploreOutils locaux en lecture seuleRecherche rapide dans le code source qui renvoie des conclusions.
planEn lecture seuleUn plan de mise en œuvre étape par étape.
reviewLecture seule, plus lecture seule gitExamen d’un diff, d’une branche ou d’une demande de fusion.
platformCHAMPREP Outils uniquement ; pas de fichiers ni de commandes locauxWork sur l’ensemble de vos servicesCHAMPREP.

/agents
/agents run explore where is the invoice total calculated?
@explore where is the invoice total calculated?

@agent-name prompt lance l’agent en tant que tâche en arrière-plan et renvoie sa réponse une fois l’opération terminée. Créez vos propres agents avec /agents create NAME; voir Agents personnalisés.

Pour les requêtes en plusieurs étapes, Eve tient à jour une liste de tâches comprenant les éléments en attente, en cours et terminés. Appuyez sur Ctrl+T pour l’afficher ou le masquer, ou pour l’exécuter /todos.

Eve peut lancer des commandes de longue durée, telles qu’un serveur de développement, un surveillant de fichiers, un compilateur ou de longues suites de tests, dans un shell en arrière-plan tout en continuant à fonctionner. Elle surveille les sorties de manière asynchrone et peut attendre l’apparition de motifs tels que server listening ou FAIL avant de continuer.

  • Jusqu’à 64 shells en arrière-plan peuvent s’exécuter simultanément.
  • L’activité en arrière-plan en temps réel est suivie sur la ligne d’état (par exemple 🐚 2 shells) et activez le résumé d’état (⚡ 2 shell(s), 3 agent(s) active).
  • Utilisez /shells ou /procs pour ouvrir l’inspecteur de shells dédié affichant les PID, les lignes de commande, les codes de sortie et les sorties en continu.

Afficher une invite de commande de manière répétée au cours de la session en cours :

/loop 5m check whether the deploy finished and summarise any errors
/loop --max 10 30m run the test suite and fix new failures
/loop keep improving test coverage for src/billing
/loop stop
  • Avec un intervalle entre 30s et 24h, l’invite s’exécute selon cette planification.
  • En l’absence d’intervalle, la boucle s’exécute à son propre rythme : l’agent décide du moment de la prochaine exécution, entre une minute et une heure plus tard.
  • Une boucle s’arrête par défaut après 50 exécutions ; modifiez ce paramètre à l’aide de --max N. Il s’ arrête également avec /loop stop [id] ou lorsque vous quittez l’application.

Chaque exécution correspond à un tour normal : elle utilise vos limites et demande votre autorisation comme n’importe quel autre tour.

/tasks répertorie tout ce qui s’exécute en arrière-plan — sous-agents, shells en arrière-plan et boucles — avec le temps écoulé. /shells (ou /procs) se concentre spécifiquement sur les processus de shell actifs et terminés.

/tasks
/tasks tail ID
/tasks attach ID
/tasks stop ID
/tasks stop all
/shells
/procs

La ligne d’état indique le nombre de tâches et de shells actifs. /exit vous avertit avant de quitter tant que des processus ou des tâches en arrière-plan sont encore en cours d’exécution.

Les tâches en arrière-plan, les sous-agents et le nombre de sous-agents parallèles sont des fonctionnalités du forfait. Voir Formules et limites.

Un arborescence de travail Git attribue à la session son propre checkout, de sorte que les sessions parallèles ou les sous-agents ne modifient jamais les mêmes fichiers.

Fenêtre de terminal
champrep ai --worktree
champrep ai --worktree fix-rounding
/worktree fix-rounding
/worktree exit

L’arborescence de travail est créée sous .champrep/worktrees/NAME sur une nouvelle branche ai/NAME. Lorsque vous quittez l’application, un arborescence de travail sans modifications est supprimée ; celle comportant des modifications est conservée et signalée afin que vous puissiez les valider ou les rejeter. Un agent personnalisé peut également définir isolation: worktree pour toujours travailler dans son propre arborescence de travail.

/review
/review main
/review !42
/security-review
  • Sans argument, /review passe en revue vos modifications non validées et mises en attente.
  • Avec une branche ou une référence, il compare cette branche à la version actuelle HEAD.
  • Avec !NUMBER ou une URL de demande de fusion, cette commande examine une demande de fusion de codeCHAMPREP via vos outilsCHAMPREP.

/security-review recherche les vulnérabilités exploitables telles que les injections, les failles d’autorisation, les secrets exposés et les traversées de chemin. Ces deux commandes exécutent l’agent en lecture seule review l’agent et rend compte des résultats par niveau de gravité, avec indication du fichier et de la ligne.