shortcuts_run

macOS

Objectif

Exécute l’un des Raccourcis macOS de l’utilisateur par son nom ou son identifiant : la façon dont les utilisateurs de Mac automatisent déjà HomeKit, les modes de concentration et des actions d’apps tierces que le catalogue ne couvre pas. Il exécute les actions PROPRES du raccourci avec les autorisations du raccourci lui-même, et non un sous-ensemble isolé : comme cliquer sur Exécuter dans l’app Raccourcis. C’est une opération d’écriture : le premier appel (confirm=false) renvoie un aperçu indiquant le raccourci, son identifiant et son dossier, sans rien exécuter ; indiquez confirm=true pour l’exécuter réellement. Un nom qui correspond à plusieurs raccourcis est refusé avec les deux identifiants : rappelez avec l’un d’eux, sans jamais deviner. Un raccourci qui attend une boîte de dialogue ou dure trop longtemps est arrêté après un délai limité avec un message clair, au lieu de bloquer cet appel.

Entrées requises

• name_or_identifier

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.

{
  "properties": {
    "confirm": {
      "description": "Must be true to actually run the shortcut. Without it, returns a preview.",
      "type": "boolean"
    },
    "input_text": {
      "description": "Optional text input for the shortcut, passed via a temp file — omit if the shortcut takes no input.",
      "type": "string"
    },
    "name_or_identifier": {
      "description": "Shortcut name or identifier, from shortcuts_list. An ambiguous name is refused — pass the identifier instead.",
      "type": "string"
    }
  },
  "required": [
    "name_or_identifier"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour shortcuts_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_or_identifier": "Demo morning brief"
}