recipe_run
Skills e receitas · macOS · Windows
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 uma receita de ponta a ponta: vincula parâmetros, executa a ferramenta de cada etapa em ordem por meio do registro, persiste a execução (consulte recipe_runs) e retorna o resultado de cada etapa mais qualquer markers_path. Receitas com etapas de mudança de estado (gravar/enviar/excluir) PREVIEW primeiro — chame novamente com confirm:true para executar; receitas somente leitura são executadas imediatamente. Uma etapa que apresenta erros interrompe a execução e é relatada.
Entradas obrigatórias
name
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": "Set true to execute a recipe that has state-changing steps; read-only recipes ignore it.",
"type": "boolean"
},
"name": {
"type": "string"
},
"params": {
"description": "Param overrides (merged over the recipe defaults).",
"type": "object"
}
},
"required": [
"name"
],
"type": "object"
}Exemplo documental
Exemplo de documentação para recipe_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": "Demo morning brief"
}Windows
Finalidade
Executa uma receita salva de ponta a ponta: vincula parâmetros, executa a ferramenta de cada etapa em ordem, registra a execução (consulte recipe_runs) e retorna o resultado de cada etapa. Porta de confirmação: sem confirm:true retorna um DRY-RUN PREVIEW das etapas ordenadas com seus argumentos vinculados; chame novamente com confirm:true para executar. Uma etapa que apresenta erros interrompe a execução e é relatada.
Entradas obrigatórias
name
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 — Windows
{
"properties": {
"confirm": {
"description": "Set true to execute; without it a dry-run preview is returned.",
"type": "boolean"
},
"name": {
"description": "Recipe name (from recipe_list).",
"type": "string"
},
"params": {
"description": "Param overrides (merged over the recipe defaults).",
"type": "object"
}
},
"required": [
"name"
],
"type": "object"
}Exemplo documental
Exemplo de documentação para recipe_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": "Demo morning brief"
}