shortcuts_run

macOS

Propósito

Ejecuta uno de los Atajos de macOS del usuario por nombre o identificador: la forma en que los usuarios de Mac ya automatizan HomeKit, los modos de concentración y acciones de apps de terceros que el catálogo no cubre. Ejecuta las acciones PROPIAS del atajo con los permisos del propio atajo, no un subconjunto aislado: igual que pulsar Ejecutar en la app Atajos. Es una operación de escritura: la primera llamada (confirm=false) devuelve una vista previa con el nombre del atajo, su identificador y su carpeta, sin ejecutar nada; indica confirm=true para ejecutarlo de verdad. Un nombre que coincide con más de un atajo se rechaza con ambos identificadores: vuelve a llamar con uno de ellos, nunca lo adivines. Un atajo que espera un diálogo o tarda demasiado se detiene tras un tiempo límite con un mensaje claro, en lugar de bloquear esta llamada.

Entradas obligatorias

• name_or_identifier

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

• Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

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

Ejemplo documental

Ejemplo de documentación para shortcuts_run. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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