shortcuts_run

macOS

Doel

Voert een van de macOS-opdrachten (Shortcuts) van de gebruiker uit op naam of identificatie: de manier waarop Mac-gebruikers al HomeKit, focusstanden en acties van apps van derden automatiseren die de catalogus niet dekt. De EIGEN acties van de opdracht worden uitgevoerd met de eigen machtigingen van de opdracht, niet met een afgeschermde subset: hetzelfde als op Voer uit klikken in de Opdrachten-app. Dit is een schrijfactie: de eerste aanroep (confirm=false) geeft een voorbeeld met de naam van de opdracht, de identificatie en de map, zonder iets uit te voeren; stel confirm=true in om hem echt uit te voeren. Een naam die bij meer dan één opdracht past, wordt geweigerd met beide identificaties: roep opnieuw aan met een van die twee, nooit gokken. Een opdracht die op een dialoogvenster wacht of lang duurt, wordt na een begrensde time-out met een duidelijke melding gestopt in plaats van deze aanroep te laten hangen.

Vereiste invoer

• name_or_identifier

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

• Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

{
  "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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor shortcuts_run. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{
  "confirm": false,
  "name_or_identifier": "Demo morning brief"
}