Ir para o conteúdo
Todas as ferramentas

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 do início ao fim: vincula os params, executa a ferramenta de cada passo em ordem pelo registro, persiste a execução (veja recipe_runs) e retorna o resultado de cada passo mais qualquer markers_path. Receitas com passos que alteram o estado (gravar/enviar/apagar) mostram PRÉVIA primeiro — chame de novo com confirm:true para executar; receitas somente de leitura executam imediatamente. Essa confirmação inicia a execução e nada mais: um passo não pode se confirmar sozinho. `confirm` nos args de um passo é ignorado (a prévia e o relatório da execução marcam esse passo com confirm_ignored), então um passo cuja ferramenta pede a própria confirmação responde com a sua prévia e NÃO é executado (o relatório da execução o marca como previewed e o lista em previewed_steps) — execute essa ferramenta diretamente para fazê-lo. Um passo que dá erro (um erro na resposta, ou uma recusa) interrompe a execução e é informado (stopped_at, com o error_key do passo); um passo cuja ferramenta este Mac não oferece em tools/list é recusado (tool_not_advertised). Qualquer um dos dois interrompe a execução, a menos que esse passo esteja marcado como "optional": true — nesse caso o erro é registrado no seu resultado e em skipped_optional, e a execução continua.

Entradas obrigatórias

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.

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": {
      "description": "Name of the saved skill (recipe) to run, exactly as recipe_list reports it.",
      "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 do início ao fim: vincula os params, executa a ferramenta de cada passo em ordem, registra a execução (veja recipe_runs) e retorna o resultado de cada passo. Porta de confirmação: sem confirm:true retorna uma PRÉVIA DRY-RUN dos passos em ordem com seus argumentos vinculados; chame de novo com confirm:true para executar. Um passo que dá erro interrompe a execução e é informado (stopped_at), a menos que esse passo esteja marcado como "optional": true — nesse caso o erro é registrado no seu resultado e em skipped_optional, e a execução continua. Um passo não pode se confirmar sozinho: confirm nos argumentos de um passo é ignorado (o passo diz confirm_ignored), então um passo cuja ferramenta pede confirmação (para enviar, apagar, substituir um arquivo, executar um comando) retorna a prévia dessa ferramenta e não altera nada; para fazer a alteração, chame essa ferramenta diretamente depois que o usuário aprovar.

Entradas obrigatórias

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.

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