recipe_run
Skills et recettes · macOS · Windows
Effet: exécution. État: disponibilité conditionnelle.
«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.
macOS
Objectif
Exécute une recette de bout en bout : lie les params, exécute l’outil de chaque étape dans l’ordre via le registre, conserve l’exécution (voir recipe_runs) et renvoie le résultat de chaque étape ainsi que tout markers_path. Les recettes avec des étapes qui modifient l’état (écriture/envoi/suppression) affichent d’abord un APERÇU — rappelez avec confirm:true pour exécuter ; les recettes en lecture seule s’exécutent immédiatement. Cette confirmation lance l’exécution et rien d’autre : une étape ne peut pas se confirmer elle-même. `confirm` dans les args d’une étape est ignoré (l’aperçu et le rapport d’exécution marquent cette étape confirm_ignored), donc une étape dont l’outil demande sa propre confirmation répond par son aperçu et n’est PAS exécutée (le rapport d’exécution la marque previewed et la liste dans previewed_steps) — lancez cet outil directement pour le faire. Une étape en erreur (une erreur dans sa réponse, ou un refus) arrête l’exécution et est signalée (stopped_at, avec l’error_key de l’étape) ; une étape dont l’outil n’est pas proposé par ce Mac dans tools/list est refusée (tool_not_advertised). L’un ou l’autre arrête l’exécution, sauf si cette étape est marquée "optional": true — l’erreur est alors consignée dans son résultat et dans skipped_optional, et l’exécution continue.
Entrées requises
name
Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.
Autorisations et confirmation
Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.
- Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.
Schéma technique canonique en anglais — macOS
{
"properties": {
"confirm": {
"description": "Set true to execute a recipe that has state-changing steps; read-only recipes ignore it.",
"type": "boolean"
},
"name": {
"description": "Name of the saved skill (recipe) to run, exactly as recipe_list reports it.",
"type": "string"
},
"params": {
"description": "Param overrides (merged over the recipe defaults).",
"type": "object"
}
},
"required": [
"name"
],
"type": "object"
}Exemple documentaire
Exemple de documentation pour recipe_run. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.
{
"confirm": false,
"name": "Demo morning brief"
}Windows
Objectif
Exécute une recette enregistrée de bout en bout : lie les params, exécute l’outil de chaque étape dans l’ordre, enregistre l’exécution (voir recipe_runs) et renvoie le résultat de chaque étape. Porte de confirmation : sans confirm:true, il renvoie un APERÇU DRY-RUN des étapes ordonnées avec leurs args liés ; rappelez avec confirm:true pour exécuter. Une étape en erreur arrête l’exécution et est signalée (stopped_at), sauf si cette étape est marquée "optional": true — l’erreur est alors consignée dans son résultat et dans skipped_optional, et l’exécution continue. Une étape ne peut pas se confirmer elle-même : confirm dans les arguments d’une étape est ignoré (l’étape indique confirm_ignored), donc une étape dont l’outil demande une confirmation (pour envoyer, supprimer, remplacer un fichier, exécuter une commande) renvoie l’aperçu de cet outil et ne change rien ; pour effectuer la modification, appelez cet outil directement après l’approbation de l’utilisateur.
Entrées requises
name
Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.
Autorisations et confirmation
Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.
- Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.
Schéma technique canonique en anglais — Windows
{
"properties": {
"confirm": {
"description": "Set true to execute; without it a dry-run preview is returned.",
"type": "boolean"
},
"name": {
"description": "Recipe name (from recipe_list).",
"type": "string"
},
"params": {
"description": "Param overrides (merged over the recipe defaults).",
"type": "object"
}
},
"required": [
"name"
],
"type": "object"
}Exemple documentaire
Exemple de documentation pour recipe_run. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.
{
"confirm": false,
"name": "Demo morning brief"
}