Créer votre première recette

Ce tutoriel construit un workflow local qui retire les espaces au début et à la fin d'un texte. Il comporte une seule action de texte sans effet de bord, produit une valeur inspectable et ne colle rien, n'appuie sur aucune touche, n'écrit aucun fichier, n'appelle pas le réseau et ne lance aucun autre programme.

1. Créer la recette locale

Ouvrez la fenêtre Recipes (popup → Recipes), créez une nouvelle recette depuis la bibliothèque, puis ouvrez-la dans l'éditeur visuel. Renommez-la Élaguer le texte.

2. Configurer le déclencheur et le traitement

Choisissez Configurer dans l'en-tête de l'éditeur.

1. Sous Identité, saisissez une description claire telle que « Retirer les espaces autour du texte fourni ».
2. Sous Déclencheur, ajoutez un raccourci clavier ou une phrase vocale seulement si vous en souhaitez un. Pour apprendre, vous pouvez laisser les deux vides et utiliser Exécution de test.
3. Sous Traitement, laissez Afficher dans le menu Appliquer désactivé et définissez Sortie du workflow sur l'alias non standard trimmed_text.
4. Enregistrez les réglages du workflow.

Les contrôles de traitement comprennent également des options LLM et de synthèse vocale. Cette recette n'en a pas besoin.

3. Ajouter une action de texte sans effet de bord

Choisissez + (Ajouter une étape), ouvrez la catégorie Text, puis ajoutez Trim. Double-cliquez sur le nouveau nœud pour le modifier.

Dans l'onglet Config, définissez la valeur sur {{input}}. L'action transformera ainsi le texte fourni à l'exécution de test, et non un exemple codé en dur.

4. Configurer les entrées et sorties

Ouvrez l'onglet I/O du nœud.

1. Vérifiez que l'entrée est {{input}}.
2. Définissez le nom de sortie sur l'alias non standard trimmed_text. Echo conserve ce nom de sortie avec l'action, et la sortie de workflow configurée plus haut le référence.
3. Consultez Available Variables. Pour ce premier nœud, cette liste contient les entrées du workflow, mais aucune sortie de nœud ultérieur.

5. Examiner les autorisations et enregistrer

Avant d'enregistrer un workflow, contrôlez chaque action dans la Référence des actions générée. Elle dérive l'état d'exécution, les champs, les ports, l'autorisation et la confirmation à l'exécution du contrat actuel. Trim est une transformation de texte sans autorisation spéciale.

Choisissez Done, puis Save dans l'en-tête de l'éditeur. Le graphe et la boîte Configurer s'enregistrent séparément : utilisez les deux commandes lorsque vous modifiez les deux zones.

6. Tester sans effet de bord

Choisissez Exécution de test → One-shot, saisissez un texte entouré d'espaces, puis lancez-le. L'éditeur ouvre la console ; sélectionnez la ligne Trim terminée pour inspecter sa sortie trimmed_text. Trim n'ajoute actuellement qu'une sortie à cette ligne, sans aperçu d'entrée.

Ne commencez pas par une recette qui colle du texte, simule des frappes, exécute Shell ou AppleScript, modifie des fichiers ou émet des requêtes HTTP. Apprenez d'abord les surfaces de revue et de trace avec cette transformation pure, puis ajoutez les effets de bord volontairement en gardant le guide de sécurité ouvert.

Ensuite : comprendre l’éditeur de recette ou déboguer les exécutions pas à pas.