Variables de workflow

Echo maintient un contexte d'exécution pour chaque lancement d'un workflow. Les entrées arrivent dans ce contexte, les étapes terminées y ajoutent leurs sorties et les champs d'action peuvent interpoler des valeurs avec {{...}}.

Entrées

Une entrée de workflow déclarée peut avoir un type, une valeur par défaut, un caractère obligatoire, une description, des options et un libellé. Le formulaire Configurer actuel affiche les entrées déjà déclarées par le workflow et permet de modifier leurs valeurs par défaut ; il ne propose pas de constructeur général pour ajouter des entrées.

L'exécution de test fournit toujours le texte saisi comme {{input}} et {{transcription}}. Les autres chemins de déclenchement peuvent transmettre la transcription, le texte sélectionné, le presse-papiers, l'application active et d'autres données de contexte selon leur appelant.

Le moteur réserve les noms suivants ; un workflow utilisateur ne doit pas les masquer avec Définir une variable :

transcription, selected_text, clipboard, active_app, active_window_title, workflow_id, workflow_name et app_context.

Les emplacements vocaux peuvent ajouter leurs propres noms de champs sûrs après un déclencheur prononcé. Consultez les Emplacements vocaux.

Sorties

Toute action qui produit des données possède un nom de sortie par défaut dans la Référence des actions. Dans l'onglet I/O du nœud, Output peut remplacer ce nom par un alias descriptif tel que trimmed ou response_body.

Les données d'une étape terminée sont également enregistrées sous l'identifiant stable de son nœud. Une arête peut ainsi transmettre {{source_node_id}} au nœud suivant, tandis qu'un alias de sortie explicite offre une référence lisible aux actions ultérieures.

La portée avance uniquement dans l'éditeur : le sélecteur I/O liste les entrées du workflow et les alias de sortie des actions antérieures, jamais les sorties des actions suivantes. Dans un graphe, une arête amont explicite exprime la dépendance le plus clairement ; ne vous fiez pas à la seule position sur le canevas.

Au niveau du workflow, Sortie du workflow nomme la variable à renvoyer. Echo essaie ensuite la dernière sortie d'étape configurée, puis processed_text lorsqu'elle est disponible. Un nom qui ne reçoit jamais de valeur ne peut pas produire de résultat.

Interpolation

Utilisez les doubles accolades dans les champs pris en charge :

{{input}}
{{trimmed}}
{{response.status}}
{{count + 1}}
{{name || 'Anonymous'}}
{{upper(trim(name))}}

L'interpolation accepte l'accès aux variables et propriétés, les expressions, des fonctions courantes, l'arithmétique, les comparaisons, les conditions et les valeurs de repli. Pour assurer la compatibilité avec les anciennes versions, une valeur manquante entre doubles accolades devient une chaîne vide : validez donc les entrées obligatoires au lieu de compter sur une erreur visible.

Les constantes réutilisables — des valeurs partagées référencées comme {{constants.KEY}} — se modifient dans l'onglet réglages de l'éditeur de recettes, sous Constantes globales de workflow. Traitez-les comme une entrée de workflow ordinaire, pas comme un stockage de secrets.

Tous les champs n'acceptent pas l'interpolation, et toutes les actions n'exposent pas le même contrôle d'entrée. Vérifiez les Champs et l'exemple de l'action générée au lieu de deviner.

Secrets

Les variables de workflow, les emplacements vocaux, les valeurs de nœud, les alias de sortie, la console et l'historique des exécutions ne sont pas un coffre à secrets. Ne placez jamais de clé API, jeton d'accès, mot de passe, clé privée ou identifiant dans une variable ordinaire, un exemple, une entrée de test, une invite, un chemin de fichier ou un YAML de recette.

Utilisez des profils de fournisseur ou d'exécuteur configurés pour les identifiants LLM. Traitez Lire une variable d'environnement, Shell, HTTP, les fichiers, les plugins et les actions LLM comme des frontières de confiance explicites : une action capable de lire ou de transmettre des données peut exposer un secret présent dans son entrée, même si son workflow paraît inoffensif.

Avant d'importer ou d'exécuter un contenu tiers, suivez les Autorisations récursives et comparez chaque action aux métadonnées d'autorisation de la Référence des actions générée.