Travailler dans Plan Studio

Ce guide explique comment travailler avec les plans dans Plan Studio. Pour savoir ce que sont les orchestrations et les documents de plan, consultez Orchestration et Utiliser le mode plan.

Ouvrir un plan

Un plan appartient à la conversation qui l’a produit; c’est donc là que vous y accédez normalement : la ligne du plan dans la conversation comporte une action Ouvrir, et Plan Studio s’ouvre dans un onglet d’éditeur à côté de la conversation.

La page centrale comporte trois sections :

Plans actifs — les orchestrations, les propositions en premier, avec leur statut, leur nombre d’étapes et leur numéro de révision.
Documents de plan — les plans qu’un agent unique a soumis avec submit_plan en mode plan, tant qu’ils sont proposés ou approuvés.
Playbooks — des modèles de plan paramétrés et enregistrés.

Cliquez sur une carte pour l’ouvrir dans Plan Studio. La route est /workspaces/<workspace-id>/plans/<kind>/<plan-id>, où kind vaut orchestration ou document, ce qui vous permet aussi de créer un lien profond vers un plan unique.

Si vous avez ouvert une orchestration, vous obtenez le canevas modifiable, la chronologie des versions et la barre d’approbation. Si vous avez ouvert un document de plan, le même graphe s’affiche en lecture seule — les documents de plan sont rédigés par un agent; vous les examinez, les estimez et les approuvez ou les rejetez, et un document approuvé affiche l’état d’exécution en direct de chaque nœud de l’orchestration dans laquelle il a été compilé.

Modifier le DAG

Les modifications sont possibles sur une orchestration tant qu’elle est proposed. Toutes les modifications du canevas se font au clavier :

Cliquez sur le canevas, puis déplacez la sélection avec les flèches directionnelles.
Appuyez sur n pour ajouter une étape. Elle apparaît sélectionnée sous le nom « Nouvelle étape »; renommez-la dans l’inspecteur à droite.
Appuyez sur e sur l’étape qui doit s’exécuter en premier, puis cliquez sur l’étape dépendante (ou sélectionnez-la et appuyez sur Entrée) pour relier une dépendance. Appuyez sur Échap pour abandonner une connexion en attente.
Appuyez sur x pour supprimer la plus récente dépendance de l’étape sélectionnée, ou basculez les dépendances exactes dans l’éditeur de dépendances de l’inspecteur.
Appuyez sur Suppr pour retirer l’étape sélectionnée; les références à celle-ci sont retirées des dépendances des étapes restantes.

Dans l’inspecteur, vous pouvez aussi modifier la description, le rôle et le schéma de sortie de l’étape. Les modifications sont enregistrées automatiquement comme une nouvelle révision après une courte pause; une erreur de validation (affichée dans la barre d’approbation) bloque l’enregistrement jusqu’à ce que vous la corrigiez.

Seules les étapes de travail sont modifiables. Les nœuds structurels — recherche, discussion et synthèse — sont en lecture seule, tout comme toute étape dont le travail s’est déjà exécuté (elle est marquée « déjà exécuté », car la modifier bifurquerait le plan).

L’enregistrement se fait par concurrence optimiste sur la révision à partir de laquelle vous avez commencé. Si l’orchestrateur replanifie sous vos pieds, votre enregistrement est refusé avec « le plan a évolué » plutôt que fusionné ou écrasé en silence; relisez la révision actuelle et refaites votre modification. Les replanifications amorcées par un agent sont elles-mêmes limitées à une toutes les deux minutes, ce qui rend ce cas rare.

Lire les estimations de coût, de temps et de risque

Appuyez sur Estimer dans la barre d’approbation.

Chaque étape du canevas reçoit une pastille avec une fourchette de coût et la taille de l’échantillon qui la sous-tend, ou « Pas encore d’historique » lorsque le rôle de l’étape ne s’est jamais exécuté. Sélectionnez une étape pour obtenir le détail complet dans l’inspecteur : fourchette de coût avec taille de l’échantillon, fourchette de durée et rayon d’impact (fichiers et symboles) dérivé de la provenance de l’étape — ou « inconnu » lorsque l’étape ne porte aucune provenance.
La barre d’approbation affiche le total du plan : une fourchette de coût globale, une fourchette de durée pour le chemin critique (les branches parallèles se chevauchent, ce n’est donc pas la somme) et le plafond de budget lorsque le plan en définit un.
Si seulement certaines étapes ont un historique, le total est marqué partiel et ne couvre que les étapes estimables. Si le haut de la fourchette dépasse le plafond de budget, le total devient rouge avec un avertissement de dépassement de budget.

Les estimations sont honnêtes ou absentes : une étape dont le rôle n’a aucun historique d’exécutions terminées indique une taille d’échantillon nulle, sans aucune fourchette, et est présentée comme inconnue plutôt que devinée. Traitez « Pas encore d’historique » comme « personne ne sait », et non comme « pas cher ».

Le plafond de budget est une comparaison d’affichage par rapport à cette estimation. Rien ne le fait respecter une fois le plan lancé — consultez Gérer les coûts pour les contrôles qui arrêtent réellement les dépenses.

Comparer une révision à une proposition antérieure

Chaque modification et chaque replanification par l’orchestrateur s’ajoute à une chronologie de révisions en ajout seul, affichée dans le panneau Versions à gauche d’un plan d’orchestration.

Cliquez sur une révision pour la comparer à la proposition actuelle. Sans sélection, le panneau compare la révision précédente à la révision actuelle.
Lisez le diff dans la moitié inférieure du panneau : les étapes ajoutées, retirées ou modifiées entre les deux révisions.
Si le plan est encore proposed, cliquez sur l’icône de rembobinage d’une révision pour y revenir. Le retour en arrière enregistre cette proposition comme une nouvelle révision — rien n’est perdu.

propose_orchestration et l’éditeur refusent tous deux les modifications dès que le plan n’est plus proposed, de sorte qu’une exécution en cours n’adopte pas une replanification en pleine exécution.

Approuver, rejeter ou élargir un plan

Depuis l’application, un plan proposé est une seule décision, prise en bloc : Approuver le plan ou Rejeter dans la barre d’approbation. Approuver le plan approuve toujours toutes les étapes — il n’y a aucun moyen de sélectionner d’abord un sous-ensemble. L’approbation est bloquée tant que la proposition comporte des erreurs de validation, qui sont affichées à côté des boutons.

L’approbation est réservée aux opérateurs. Il n’existe aucun outil MCP pour cela; un agent peut donc proposer et réviser un plan, mais jamais l’approuver.

Une fois une orchestration en cours d’exécution, la barre change :

Si une étape s’est arrêtée pour poser une question en cours d’exécution, sélectionnez-la et appuyez sur Continuer le nœud pour la reprendre.
Appuyez sur Approuver la sélection pour élargir une approbation partielle à l’étape sélectionnée et à tout ce dont elle dépend transitivement (une étape ne peut jamais être approuvée sans ses dépendances). Le contrôle se trouve sur la barre d’exécution de toutes les orchestrations; il est sans effet lorsque le plan a été approuvé en bloc.
Appuyez sur Annuler l’exécution pour arrêter toute l’orchestration.

Les étapes qui ne font pas partie d’un ensemble partiellement approuvé s’affichent en attente et ne s’exécutent pas avant que vous élargissiez l’ensemble.

Exécuter un playbook avec des paramètres

Un playbook est un modèle de plan enregistré comportant des espaces réservés {{param}} typés dans son objectif, ses titres d’étapes, ses descriptions et ses prompts. La substitution est littérale — il n’y a pas de langage d’expressions; si vous avez besoin de logique, utilisez plutôt un pipeline.

Dans la section Playbooks de la page centrale, appuyez sur Exécuter pour le playbook (ou ouvrez la palette ⌘K et choisissez-y le playbook).
Remplissez les paramètres. Les paramètres d’énumération s’affichent sous forme de listes déroulantes; les paramètres de dépôt et d’agent prennent une référence de dépôt ou d’agent; les paramètres facultatifs reprennent leur valeur par défaut.
Choisissez le ticket d’ancrage contre lequel le plan est proposé, puis confirmez.

L’exécution d’un playbook ne fait que proposer un plan — l’orchestration instanciée s’ouvre dans Plan Studio à l’état proposed et rien ne s’exécute avant que vous l’approuviez à cet endroit. Pour supprimer un playbook, appuyez sur l’icône de corbeille de sa carte.

Les agents créent et exécutent des playbooks avec les outils MCP create_playbook et run_playbook; consultez la référence des outils MCP.

Guides connexes

Utiliser le mode plan : comment un agent produit un document de plan avec submit_plan
Lancer une orchestration : le cycle de vie à approbation unique du côté de la conversation
Créer un modèle de pipeline : quand vous avez besoin d’une logique qu’un playbook ne peut pas exprimer
Surveiller les exécutions de pipeline : la vue du moteur sur un plan approuvé

Concepts connexes

Orchestration