Exécutions d'agent

Normalement, tu envoies un message à Pia et il te répond. En mode Agent, tu lui donnes plutôt un objectif : Pia rédige un plan, le déroule étape par étape, utilise des outils en chemin, puis vérifie lui-même son résultat à la fin. Un panneau au-dessus du chat montre exactement où il en est et te permet de le piloter.

Passer en mode Agent

En bas de la zone de message se trouve un sélecteur à deux positions : Chat et Agent. Clique sur Agent, tape ton objectif, puis appuie sur Entrée.

Quelques points à connaître avant de basculer :

Le sélecteur est grisé si ton persona actuel a les outils désactivés — “Agent mode needs a persona with tools.” Choisis un persona avec accès aux outils, et il redevient disponible.
Si ton fournisseur n’est pas un bon planificateur, Pia t’avertit avant de démarrer : “This provider may not plan reliably”. Tu peux quand même Continuer, Choisir un fournisseur…, ou Rester dans le chat.
Un objectif a besoin d’un minimum de substance. Envoie quelque chose de très court, et Pia te dit “This looks too short to run as a goal. Add a few more words so it can be planned.”
Le sélecteur appartient à cette conversation. Le basculer ici ne change pas sur quoi démarre ta prochaine nouvelle discussion — c’est Démarrer les nouvelles discussions en mode agent, sous Paramètres → Assistant → Exécutions d’agent.
Une question reçoit une réponse, elle n’est pas planifiée. Pose-en une avec le sélecteur sur Agent, et Pia répond en un seul tour et marque la réponse Réponse directe, plutôt que d’élaborer un plan pour elle.

Emporter la conversation avec l’exécution

Une exécution démarrée dans une discussion peut emporter cette conversation avec elle, si bien qu’une relance comme “le fichier n’est pas dans le dossier de travail” est planifiée en tenant compte de ce qui a déjà été dit.

Une barre au-dessus de la zone de message demande une fois par discussion, et retient l’envoi jusqu’à ce que tu choisisses :

Choix	Ce que reçoit l’exécution
Envoyer un résumé	Un court résumé de la conversation jusqu’ici.
Envoyer la conversation	La conversation elle-même, mot pour mot.
Ne rien envoyer	Seulement ton objectif, comme si la discussion n’existait pas.

La barre ne s’interpose pas si une exécution est déjà en cours, et elle n’apparaît pas pour une exécution qui ne va pas se lancer.

Le panneau d’exécution

Une fois qu’une exécution démarre, un panneau apparaît en haut du chat. Son en-tête affiche l’état de l’exécution :

État	Ce que ça veut dire
Planification	Pia élabore les étapes.
En cours	Il déroule le plan.
Délégation	Il a confié une partie du travail à des sous-agents et attend leur retour.
Vous attend	Il a besoin d’une réponse, d’une approbation ou d’une décision de ta part.
En pause	Tu l’as mis en pause.
Completed	Il a terminé.
Échouée	Il n’a pas pu terminer.

Sous l’état, une ligne en direct indique ce qui se passe en ce moment — Building a plan…, Working…, Checking the work…, Waiting for your approval to use write_file — ainsi que sa progression (step 3 of 7), le temps écoulé et les jetons utilisés jusqu’ici.

Le plan lui-même est présenté sous forme d’étapes. Celle en cours est marquée en cours, les étapes terminées se trouvent au-dessus, et les plans longs replient le milieu (4 earlier steps — all done, 3 later steps — pending) pour que l’étape actuelle reste visible.

Le chronomètre tourne pendant que l’exécution réfléchit. Élaborer un plan peut prendre une trentaine de secondes, et le panneau continue de compter pendant ce temps plutôt que de sembler figé. Il s’arrête volontairement pendant qu’une exécution attend ta réponse.

Voir ce que fait une étape en ce moment

Une étape n’écrit sa réponse qu’une fois terminée, si bien que la conversation restait immobile pendant de longues minutes. Pendant qu’une étape travaille, le panneau et la conversation en dessous affichent maintenant combien d’outils elle a utilisés et lequel en dernier — pour que tu puisses distinguer un travail en cours d’un blocage.

Quand Pia ne parvient pas à construire un plan

Deux choses peuvent se produire à la place d’un plan, et toutes deux te le disent plutôt que de te laisser une case vide :

Une étape que Pia ne peut pas lire est abandonnée seule, et le reste du plan tient bon. Une seule étape nommant deux fichiers suffisait auparavant à faire tomber tout le plan.
Si aucun plan ne peut être construit du tout, l’exécution affiche “could not build a plan — working through the goal in one turn”, ce qui est exactement ce qu’elle fait.

Approuver le plan

Quand Pia propose un plan, il le publie dans la discussion — Proposed plan — review the steps below, then Approve or Reject in the run panel — et attend.

Lis les étapes, puis clique sur Approuver ou Rejeter dans le panneau. Rejeter abandonne l’exécution et laisse une note dans la discussion.

Piloter une exécution

Tu gardes la main une fois qu’elle est lancée.

Mettre en pause arrête l’exécution au prochain point sûr. Il arrive qu’elle ait déjà continué — Pia te le signale, et tu peux réessayer.

Continuer relance une exécution en pause ou qui a atteint l’une de ses limites (Stopped at budget — continue?). Avant de continuer, tu peux ajouter une Remarque pour la suite de cette exécution — par exemple “garde le résumé sous 200 mots”. La note accompagne chaque étape restante, ses vérifications, et toute replanification. Elle n’est pas enregistrée et ne survit pas à un redémarrage.

Change the plan. Mets d’abord en pause (Pause the run to change its plan), puis chaque étape reçoit un menu :

Modifier l’étape — modifie son titre court et ce qui est réellement demandé à l’assistant
Insérer une étape en dessous
Déplacer l’étape vers le haut / Déplacer l’étape vers le bas
Ignorer l’étape

Continue ensuite, et l’exécution reprend le plan tel que tu l’as laissé.

Activité des outils

Déplie Activité des outils pour voir chaque outil que l’exécution a utilisé, groupé par étape, avec ce qui lui est arrivé :

Décision	Signification
Approuvé	Tu l’as autorisé sur la carte.
Approuvé automatiquement	Il s’est exécuté sans demander — tu l’avais déjà accordé, ou l’autonomie de l’agent le couvre. Voir Permissions des outils.
Refusé	Tu as dit non.
Bloqué	Pia l’a refusé — ce n’était pas autorisé dans cette exécution.
En attente d’autorisation	Il attend ta décision en ce moment.

Tool activity comptabilise ce qui s’est passé, pas combien de fois cela a été demandé. Approuver un appel est enregistré une fois, et comme venant de toi plutôt que comme automatique.

Les exécutions très longues n’enregistrent que le premier segment de décisions, et le signalent (Trace shortened).

Si l’exécution a réparti le travail entre des sous-agents, ceux-ci ont leur propre section avec un compteur 2 of 3 finished et une chronologie chacun.

Les notes de travail ne te sont pas soumises pour approbation

Pia rédige ses propres notes de travail dans un dossier .scratch/, qui n’est jamais publié. Ces écritures s’exécutent sans carte de confirmation, et n’apparaissent pas comme un second lien de fichier à côté du livrable dont elles étaient les notes.

Une exécution efface ses notes de travail une fois terminée. Normalement, elles partent avec la copie privée de ton dossier propre à l’exécution ; une exécution qui n’a pas pu en créer une les écrit directement dans le dossier lui-même, et celles-ci sont effacées aussi. Seuls les fichiers réellement écrits par l’exécution sont supprimés.

Où vont les fichiers

Une exécution d’agent ne modifie pas directement ton dossier pendant qu’elle travaille — elle travaille dans sa propre copie, si bien qu’une exécution inachevée ne peut jamais laisser tes fichiers dans le désordre.

Si ton dossier assistant est un dépôt git (et que les outils git sont activés), l’exécution obtient sa propre branche. Une fois stabilisée, le panneau t’indique Output is on branch pia/run-….
Sinon, Pia prend une copie limitée et rapatrie le travail une fois l’exécution stabilisée.

Le dossier dans lequel une exécution écrit est le dossier de travail de la discussion, et une routine écrit dans le sien. Cela reste vrai même quand le dossier est trop volumineux pour être mis de côté pour l’exécution — ces exécutions déposent alors leurs fichiers directement à la racine de ton dossier de fichiers assistant.

Si des fichiers restent dans l’espace de travail de l’exécution, le panneau indique This run’s files are still in its workspace et propose un bouton Publier les fichiers. Clique dessus, et Pia les transfère, puis indique combien sont arrivés.

Exécuter en arrière-plan

En mode Agent, un bouton Exécuter en arrière-plan se trouve à côté de Envoyer. Il détache l’exécution pour que tu puisses continuer autre chose — elle poursuit son travail, continue d’écrire dans la discussion, et te prévient une fois terminée via Flow.

Pendant qu’une exécution détachée écrit dans une discussion, la zone de message affiche A run is writing to this chat. Sending resumes when it finishes.

Fermer la fenêtre pendant qu’une exécution est en cours

Fermer une fenêtre Pia avec la croix n’arrête pas une exécution. La croix masque la fenêtre et laisse Pia tourner dans la zone de notification, si bien que l’exécution continue exactement comme avant, et atterrit dans Flow quand elle se termine ou quand elle a besoin de quelque chose de ta part. Rouvre la fenêtre avec l’icône de la zone de notification ou le raccourci Ctrl+Alt+P, et le panneau d’exécution est là où tu l’as laissé.

Ce qui arrête une exécution, c’est Quitter dans le menu contextuel de l’icône de la zone de notification — cela ferme Pia proprement, et une exécution interactive se termine avec lui. Si tu es sur le point de quitter et que tu veux que le travail survive, détache-le d’abord avec Exécuter en arrière-plan, ou place-le sur une routine.

Une exécution interrompue ne laisse pas tes fichiers à moitié modifiés : elle travaille dans sa propre copie, donc tout ce qu’elle n’avait pas publié n’est tout simplement pas appliqué. Voir Où vont les fichiers.

Les exécutions en arrière-plan bénéficient de limites plus généreuses que les exécutions interactives, car personne ne surveille. Tu préfères une exécution programmée ? Voir Routines.

Limites et paramètres

Ouvre Paramètres → Assistant → Exécutions d’agent. Ce sont les murs auxquels une exécution s’arrête, pour qu’elle ne s’emballe jamais. Une exécution qui en atteint un se met en pause et t’attend.

Setting	Par défaut	Ce que ça fait
Étapes maximales	24	Combien d’étapes une exécution peut effectuer.
Nombre maximal de tours d’outils par étape	24	Combien de fois le modèle peut appeler des outils et se reconsulter à l’intérieur d’une même étape.
Limite de temps	20 min	Combien de temps une exécution peut durer.
Replanifications en cas d’échec	2	Combien de fois une exécution peut réviser son plan après l’échec d’une étape.

Planification

Réfléchir avant de planifier (désactivé) — ajoute un court tour de réflexion sans outils avant la rédaction du plan, afin que le modèle puisse raisonner au niveau d’effort que tu as configuré. Utile chez les fournisseurs qui désactivent le raisonnement lorsque des outils sont attachés, et double le coût de l’étape de planification.

Autonomie

Approuver automatiquement les outils d’écriture de Pia pendant une exécution d’agent et en mode vocal (désactivé) — permet à Pia de créer et modifier des fichiers, notes, tâches, rappels et routines sans demander à chaque fois. La suppression de quoi que ce soit, les commandes git et les outils externes (MCP) ne sont jamais couverts. Voir Permissions des outils.

Spécialistes d’étape

Choisis jusqu’à six personas que le planificateur peut assigner à des étapes individuelles. Une étape assignée s’exécute alors avec le prompt et le fournisseur propres à ce persona — un persona de développeur pour l’étape de code, un persona de rédacteur pour le résumé. Laisse vide, et chaque étape s’exécute sur ton assistant par défaut.

Exécutions en arrière-plan et planifiées

Des limites séparées, plus généreuses, pour les exécutions détachées et planifiées : 24 étapes, 45 min, 2 replanifications, et 2 exécutions en arrière-plan simultanées. Les exécutions supplémentaires démarrent quand même — elles attendent simplement une place libre.

Prochaines étapes

Permissions des outils — décider ce qui s’exécute sans demander
Routines — programmer une exécution d’agent sur une minuterie
Coding Tools & @Files — le dossier dans lequel travaille une exécution