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 habituellement. La ligne du plan dans la conversation comporte une action Ouvrir, et Plan Studio s’ouvre comme un onglet d’éditeur à côté de la conversation.

Le hub présente trois sections :

Plans actifs — les orchestrations, les propositions d’abord, avec leur statut, leur nombre d’étapes et leur numéro de révision.
Documents de plan — les plans qu’un seul agent a soumis avec submit_plan en mode plan, tant qu’ils sont proposés ou approuvés.
Playbooks — des modèles de plan enregistrés et paramétré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 : vous pouvez donc aussi créer un lien profond vers un plan précis.

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 produits 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, nœud par 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 touches fléchées.
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 créer une dépendance. Appuyez sur Échap pour abandonner une connexion en attente.
Appuyez sur x pour couper la dépendance la plus récente de l’étape sélectionnée, ou activez ou désactivez les dépendances exactes dans l’éditeur de dépendances de l’inspecteur.
Appuyez sur Suppr pour supprimer l’étape sélectionnée ; les références à cette étape 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 ferait bifurquer le plan).

L’enregistrement utilise un contrôle de 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 message « The plan moved on » plutôt que fusionné ou écrasé en silence ; relisez la révision courante et refaites votre modification. Les replanifications déclenchées par un agent sont elles-mêmes limitées à une toutes les deux minutes, ce cas reste donc rare.

Lire les estimations de coût, de durée et de risque

Appuyez sur Estimer dans la barre d’approbation.

Chaque étape du canevas reçoit un badge avec une plage de coût et la taille d’échantillon associée, ou « Pas encore d’historique » lorsque le rôle de l’étape ne s’est jamais exécuté. Sélectionnez une étape pour afficher tous les détails dans l’inspecteur : plage de coût avec taille d’échantillon, plage de durée et rayon d’impact (fichiers et symboles) déduit de la provenance de l’étape — ou « inconnu » lorsque l’étape n’a aucune provenance.
La barre d’approbation affiche le total du plan : une plage de coût globale, une plage de durée pour le chemin critique (les branches parallèles se chevauchent, ce n’est donc pas la somme) et le plafond budgétaire lorsque le plan en définit un.
Si seules certaines étapes ont un historique, le total est marqué partiel et ne couvre que les étapes estimables. Si le haut de la fourchette de l’estimation dépasse le plafond budgétaire, le total passe au 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 plage, et s’affiche comme inconnue plutôt que d’être devinée. Interprétez « Pas encore d’historique » comme « personne ne sait », et non comme « bon marché ».

Le plafond budgétaire est une simple comparaison affichée avec cette estimation. Rien ne le fait respecter une fois le plan lancé — voir Gérer les coûts pour des contrôles qui arrêtent réellement les dépenses.

Comparer une révision à une proposition antérieure

Chaque modification et chaque replanification de 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 courante. Sans sélection, le panneau compare la révision précédente à la courante.
Lisez le diff dans la moitié inférieure du panneau : étapes ajoutées, supprimées ou modifiées entre les deux révisions.
Si le plan est encore proposed, cliquez sur l’icône de retour arrière d’une révision pour y revenir. Le retour 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 : une exécution en cours ne prend donc pas en compte une replanification en milieu d’exécution.

Approuver, rejeter ou élargir un plan

Dans l’application, un plan proposé se décide d’un seul bloc : Approuver le plan ou Rejeter dans la barre d’approbation. Approuver le plan approuve toujours toutes les étapes — impossible de sélectionner d’abord un sous-ensemble. L’approbation est bloquée tant que la proposition comporte des erreurs de validation, qui s’affichent à côté des boutons.

L’approbation est réservée aux opérateurs. Aucun outil MCP ne permet de le faire : un agent peut proposer et réviser un plan, mais jamais l’approuver.

Une fois qu’une orchestration s’exécute, 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 figure dans la barre d’exécution de toutes les orchestrations ; il est sans effet lorsque le plan a été approuvé en entier.
Appuyez sur Annuler l’exécution pour arrêter toute l’orchestration.

Les étapes en dehors d’un ensemble approuvé partiellement s’affichent comme différées et ne s’exécutent pas tant que vous n’élargissez pas cet ensemble.

Exécuter un playbook avec des paramètres

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

Dans la section Playbooks du hub, appuyez sur Exécuter sur le playbook (ou ouvrez la palette ⌘K et choisissez-y le playbook).
Renseignez 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 attendent 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 sur lequel le plan est proposé, puis confirmez.

Exécuter 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 ne 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 ; voir 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, vu depuis 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