recipe_import

Skills et recettes · macOS · Windows

Effet: écriture. É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

Installe une COMPÉTENCE (SKILL) que quelqu’un a partagée avec vous — passez le skill_token issu de son recipe_export (ou un manifeste de recette JSON brut). L’enregistre sur ce Mac pour que recipe_run puisse l’utiliser. L’importation ne fait que stocker la compétence. L’exécuter demande une confirmation lorsqu’elle comporte des étapes qui modifient l’état (envoi/écriture/suppression), et une étape ne peut pas se confirmer elle-même : `confirm` dans les args d’une étape est retiré ici (confirm_removed_steps) et ignoré à l’exécution, de sorte qu’une étape dont l’outil demande une confirmation répond par son aperçu au lieu de s’exécuter. Si une compétence du même nom existe déjà, l’import est enregistré sous un nom sans conflit. Le premier appel affiche un aperçu ; confirm: true l’enregistre. Renvoie {name, imported}.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

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": "Must be true to save the skill. Without it the call returns a preview and saves nothing.",
      "type": "boolean"
    },
    "skill": {
      "description": "A skill_token from recipe_export, or a raw recipe manifest JSON string.",
      "type": "string"
    },
    "skill_token": {
      "description": "Alias for `skill` — the exact field name recipe_export returns.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour recipe_import. 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,
  "skill": "{\"name\":\"Demo morning brief\",\"description\":\"Read the local date and time.\",\"steps\":[{\"tool\":\"get_datetime\",\"args\":{}}]}"
}

Windows

Objectif

Installe une COMPÉTENCE (SKILL) que quelqu’un a partagée avec vous — passez le skill_token issu de son recipe_export (ou un manifeste de recette JSON brut). L’enregistre sur cette machine pour que recipe_run puisse l’utiliser. Sans risque : l’importation ne fait que stocker la compétence ; une étape ne peut pas se confirmer elle-même, donc lors de son exécution ultérieure, une étape dont l’outil demande une confirmation (pour envoyer, supprimer, remplacer un fichier, exécuter une commande) renvoie son aperçu et ne change rien. Si une compétence du même nom existe déjà, l’import est enregistré sous un nom sans conflit. Le premier appel renvoie un aperçu indiquant les étapes de la compétence et n’enregistre rien ; confirm=true l’enregistre. Renvoie {name, imported}.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

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": "Must be true to save the skill. Without it, returns a preview naming its steps.",
      "type": "boolean"
    },
    "skill": {
      "description": "A skill_token from recipe_export, or a raw recipe manifest JSON string.",
      "type": "string"
    },
    "skill_token": {
      "description": "Alias for `skill` — the exact field name recipe_export returns.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Exemple documentaire

{
  "confirm": false,
  "skill": "{\"name\":\"Demo morning brief\",\"description\":\"Read the local date and time.\",\"steps\":[{\"tool\":\"get_datetime\",\"args\":{}}]}"
}