Asteria Docs
Workflows

Étapes

Les quatre sortes d'étape, et la façon dont chacune utilise ce qui précède.

Les étapes s'exécutent de haut en bas. Ajoutez-les, supprimez-les et réordonnez-les dans l'éditeur, et donnez à chacune un nom facultatif pour que l'historique des exécutions se lise correctement.

Transmettre les résultats

Une étape peut utiliser ce qu'une étape antérieure a produit, au moyen d'une référence :

  • {{run.input}} : l'entrée avec laquelle cette exécution a été lancée
  • {{trigger.summary}} : un champ du déclencheur
  • {{steps.summarise.output}} : ce que l'étape nommée summarise a produit

Tapez / dans n'importe quel champ pour en insérer une plutôt que de la saisir. Un identifiant d'étape erroné est une cause fréquente de résultat vide.

Exécuter une fois par élément

Si vous pointez l'entrée d'une étape vers une étape dont la sortie est une liste, elle s'exécute une fois par élément, avec {{item}} disponible à l'intérieur.

Dix concurrents résumés individuellement plutôt qu'en un seul bloc, ou chaque fichier d'un dossier Drive traité à son tour.

Vous choisissez ensuite ce qui se passe quand un élément échoue :

  • Arrêter l'exécution : on stoppe tout. C'est le bon choix quand les éléments sont les parties d'un même livrable.
  • Continuer avec les autres éléments : on laisse de côté celui qui pose problème et on poursuit. C'est le bon choix quand ils sont indépendants, et l'exécution se termine en Terminé avec des problèmes pour que vous le sachiez.

Étapes Agent

Exécute un agent. Deux façons de le désigner :

Définir ici. Vous écrivez les instructions et choisissez les outils pour cette étape uniquement. Bien quand le travail est propre à ce workflow et n'existe pas déjà sous forme d'agent.

Utiliser un agent existant. Vous pointez vers l'un de vos agents et vous épinglez une Révision, pour que des modifications ultérieures de cet agent ne changent pas ce workflow en douce. L'accès est revérifié au moment de l'exécution : si vous perdez l'accès à l'agent, l'étape échoue plutôt que de s'exécuter avec des permissions périmées.

Préférez un agent existant quand le même travail se fait aussi à la main en conversation. Une seule définition, maintenue une seule fois.

Vous pouvez également définir le modèle, la température et les collections épinglées de l'étape.

Étapes Approbation

Met l'exécution en pause jusqu'à ce qu'une personne décide. L'exécution reste en En attente d'approbation jusqu'à ce que quelqu'un approuve ou rejette, et un rejet met fin à l'exécution.

Approbateurs : nommez des personnes précises, ou laissez vide pour le propriétaire et les éditeurs.

Message : dites ce que vous voulez leur faire regarder. « Vérifiez les chiffres par rapport au tableau de bord avant que cela parte chez le client » est un message utile. « Merci d'approuver » ne l'est pas.

Placez-en une avant tout ce qui sort de la maison : un e-mail à des clients, un fichier écrit sur un disque partagé, une publication dans un canal.

Étapes Condition

Vérifie quelque chose et décide s'il faut continuer.

Source : ce qu'il faut vérifier, en général une référence comme {{steps.research.output}}.

Type de test, au choix parmi deux :

Règle compare mécaniquement : n'est pas vide, est vide, contient, ne contient pas, est égal à, supérieur à, inférieur à. Prévisible et gratuit. À utiliser dès que la question est mécanique.

Demander au modèle pose la question en langage courant : « Cela signale-t-il une anomalie ? ». À n'utiliser que lorsque le jugement demande vraiment de la compréhension de texte, car cela coûte un appel au modèle et peut répondre différemment sur deux entrées similaires.

Si le test échoue, on saute à une étape ultérieure ou à la fin du workflow. Les étapes ignorées sont marquées comme ignorées dans l'exécution : une semaine calme se lit donc comme « rien à signaler » plutôt que comme un échec.

La condition la plus courante et la plus utile est simplement N'est pas vide sur une étape de recherche, pour que le workflow ne fasse rien plutôt que d'envoyer une synthèse vide.

Étapes Action

Fait une chose précise : envoyer un e-mail, créer un fichier, appeler un outil d'un service connecté.

Choisissez l'outil, puis remplissez ce dont il a besoin. Tous les champs acceptent une référence : le corps d'un e-mail peut donc être {{steps.writeup.output}}.

Modifie des données est un badge apposé sur les outils qui agissent sur le monde plutôt que de se contenter de lire. Considérez que chacun d'eux exige une étape d'approbation avant lui, sauf si vous en êtes certain.

Comme les étapes Agent, une action peut s'exécuter une fois par élément d'une liste.

Les étapes Action qui touchent un service connecté portent un avertissement, et il vaut la peine de le lire en entier. Une telle étape :

  • agit avec le compte connecté du propriétaire du workflow, pas avec celui de la personne ou de la chose qui a lancé l'exécution
  • continue sans rien demander, parce que personne n'est là. Seul le workflow enregistré décide de ce qui se passe
  • n'est pas réessayée si l'exécution est interrompue, parce qu'elle a peut-être déjà eu lieu. Un e-mail à moitié envoyé ne se dés-envoie pas en réessayant

Ce dernier point est celui que l'on manque : une exécution interrompue ne peut pas reprendre une action sans risque, donc le workflow vous le dit plutôt que de deviner.

Si un outil devient indisponible (un connecteur désactivé, un serveur MCP retiré), l'étape vous le signale et vous en choisissez un autre. Elle ne se contente pas de ne rien faire en silence.

Valider avant d'enregistrer

L'éditeur contrôle vos étapes et signale les champs manquants ou mal formés en face de l'étape concernée. Un workflow comportant des erreurs ne s'enregistrera pas, et c'est délibéré : un workflow cassé qui s'enregistre est un workflow cassé qui s'exécute à 9h le lundi.

On this page