shortcuts_run
Atalhos · macOS
Efeito: execução. Estado: disponibilidade condicionada.
«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.
macOS
Finalidade
Executa um dos Atalhos (Atajos) do macOS do usuário por nome ou identificador — a forma como os usuários de Mac já automatizam o HomeKit, os modos de Foco 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 — o mesmo que clicar em Executar no app Atalhos, então pode fazer tudo o que esse atalho faz (enviar mensagens, alterar ou excluir arquivos, chamar serviços web, controlar o Mac), inclusive efeitos que o LMCP não pode mostrar em prévia nem desfazer. Esta é uma operação de gravação: a primeira chamada (confirm=false) retorna uma prévia com o nome do atalho, seu identificador e sua pasta, sem executar nada; defina confirm=true para realmente executá-lo. Um nome que corresponda a mais de um atalho é recusado com os dois identificadores — chame de novo com um deles, nunca por suposição. Um atalho que espera por uma caixa de diálogo ou demora demais é interrompido após um tempo limite, com uma mensagem clara, em vez de travar 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.
Esquema técnico canónico em inglês — macOS
{
"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"
},
"remember": {
"description": "With confirm: true, also stop asking for this kind of action from now on. Only when the person said so (\"don't ask again\"). The person can revoke it in LMCP or with set_always_allowed.",
"type": "boolean"
}
},
"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"
}