Tous les outils

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 paramètres, 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. Recettes avec étapes de changement d'état (écriture/envoi/suppression) PREVIEW d'abord — rappelez avec confirm:true pour exécuter ; les recettes en lecture seule s'exécutent immédiatement. Une étape qui génère des erreurs arrête l'exécution et est signalée.

Entrées requises

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.

Schéma technique canonique en anglaismacOS
{
  "properties": {
    "confirm": {
      "description": "Set true to execute a recipe that has state-changing steps; read-only recipes ignore it.",
      "type": "boolean"
    },
    "name": {
      "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 paramètres, 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. Confirm gate : sans confirm:true, il renvoie un DRY-RUN PREVIEW des étapes ordonnées avec leurs arguments liés ; appelez à nouveau avec confirm:true pour exécuter. Une étape qui génère des erreurs arrête l'exécution et est signalée.

Entrées requises

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.

Schéma technique canonique en anglaisWindows
{
  "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"
}