shortcuts_run

macOS

Finalidade

Executa um dos Atalhos do macOS do utilizador por nome ou identificador: a forma como os utilizadores de Mac já automatizam o HomeKit, os modos de concentração e ações de apps de terceiros que o catálogo não cobre. Executa as ações PRÓPRIAS do atalho com as permissões do próprio atalho, não um subconjunto isolado: tal como clicar em Executar na app Atalhos. É uma operação de escrita: a primeira chamada (confirm=false) devolve uma pré-visualização com o nome do atalho, o seu identificador e a sua pasta, sem executar nada; indique confirm=true para o executar de facto. Um nome que corresponda a mais de um atalho é recusado com ambos os identificadores: volte a chamar com um deles, nunca adivinhe. Um atalho que espera por uma caixa de diálogo ou demora demasiado é interrompido após um limite de tempo com uma mensagem clara, em vez de bloquear esta chamada.

Entradas obrigatórias

• name_or_identifier

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

• Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

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

Exemplo documental

Exemplo de documentação para shortcuts_run. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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