Recettes

Une recette est l'unité d'automatisation d'Echo : un nom et une description, une ou plusieurs actions, des connexions de graphe facultatives et une ou plusieurs façons de la déclencher. Le corps de workflow embarqué est ce qui s'exécute ; la recette l'habille pour être listée, publiée et installée. Vous travaillez sur les recettes dans la fenêtre Recipes, ouverte depuis l'action Recipes de la popup.

Le cycle de vie habituel est créer ou importer → configurer → relier les actions → enregistrer → tester → déclencher → examiner l'exécution.

Ce qu'une recette peut faire

Une recette peut être déclenchée de plusieurs façons :

• une phrase de déclenchement principale plus des alias vocaux parlés ;
• un raccourci clavier global lié sous Paramètres → App → General → Keyboard Shortcuts ;
• les menus Appliquer après transcription et dans l'Historique, lorsque Afficher dans le menu Appliquer est activé ;
• l'écoute permanente, qui entend la phrase de déclencheur en arrière-plan ;
• une Exécution de test dans l'éditeur.

Une fois déclenchée, la recette exécute ses actions en séquence ou en graphe : transformations de texte, prompts LLM, sortie vocale, contrôle d'applications, frappes clavier, opérations fichiers, requêtes HTTP, commandes shell et plugins. La Référence des actions générée est le contrat de chaque action : champs, permissions et effets de bord.

Ce qu'une recette ne peut pas faire

Quelques frontières importantes à connaître avant de construire :

• Rien n'est préinstallé. Echo fournit et initialise actuellement zéro recette intégrée. Le démarrage actif crée une liste par défaut vide en mémoire et ne la remplit pas de contenu intégré — les recettes existent parce que vous les créez ou les importez.
• Les déclencheurs vocaux exigent un modèle local. L'écoute permanente requiert un modèle de reconnaissance vocale téléchargé et sélectionné ; aucun enregistrement ne se produit sans lui.
• Il n'existe pas de mode continu distinct. Les deux chemins vocaux — enregistrement standard et écoute permanente — passent par le même appariement de préfixe normalisé et le même analyseur d'emplacements vocaux. L'ancien écouteur continu, qui disposait de sa propre correspondance exacte, incluse puis approximative et ignorait les emplacements vocaux, a été retiré d'Echo ; un texte qui ne commence pas par une phrase de déclenchement reste une transcription ordinaire en enregistrement standard et est simplement ignoré par l'écoute permanente.
• Les recettes tierces sont contrôlées, pas approuvées. Les recettes importées tournent sous une revue de capacités et des confirmations à l'exécution ; les recettes créées localement sont de confiance par défaut — relisez vos propres effets de bord.
• Les graphes de l'éditeur ont des règles structurelles. Les sorties ne vont que vers l'avant, les cycles ordinaires sont rejetés et les points d'entrée se déduisent du graphe — voir L'Éditeur de recette.

Les actions reliées au réseau (HTTP, téléchargements, shell, plugins) restent des frontières de confiance explicites à l'intérieur d'une exécution sinon locale ; voir Sécurité des recettes avant de traiter du texte sensible.

Déclencheurs vocaux et emplacements vocaux

Les alias vocaux sont d'autres formulations prononcées qui désignent la même recette. L'enregistrement standard, écoute permanente désactivée ou activée, examine les recettes actives dans l'ordre et retient la première phrase principale ou le premier alias qui constitue un préfixe normalisé de la transcription. Ces chemins d'enregistrement standard et d'écoute permanente analysent également les emplacements vocaux. La normalisation retire les accents et la ponctuation, convertit en minuscules et réduit les espaces successifs. Le texte qui suit le préfixe reconnu devient l'entrée de la recette.

Il n'y a pas d'autre chemin de déclenchement : une transcription qui ne commence pas par une phrase de déclenchement ou un alias n'est jamais retenue par similarité, et il n'existe plus de mode continu sans emplacements vocaux.

Les emplacements vocaux découpent la parole qui suit le déclencheur en champs nommés auxquels les actions accèdent avec {{field}}. Configurez-les sous Réglages de la recette → Emplacements vocaux. Chaque emplacement possède :

• un nom de champ ;
• un ou plusieurs mots-clés délimiteurs, y compris des expressions de plusieurs mots ;
• un type : texte libre text, choix canonique enum ou reste final rest ;
• des options d'énumération et alias prononcés facultatifs ;
• une valeur par défaut facultative.

Echo repère le premier mot-clé de chaque emplacement, ordonne les correspondances selon leur position dans la phrase et conserve le texte original entre les délimiteurs. Un mot-clé absent ne provoque pas d'erreur ; la valeur par défaut configurée est insérée lorsqu'elle existe. Les noms de variables réservés au moteur ne peuvent pas servir de noms d'emplacements.

Pour un emplacement enum, la valeur prononcée est normalisée et comparée d'abord à chaque option canonique, puis à ses alias. Une correspondance renvoie la valeur canonique. Par exemple, les alias « anglais » et « in English » peuvent tous deux produire la valeur canonique English ; l'action lit ensuite {{language}}.

Pour continuer

• Partage des recettes — catalogue, publication et revue d'installation
• L'Éditeur de recette
• Créer votre première recette
• Variables
• Exécutions de workflows
• Sécurité des recettes