Ir para o conteúdo
Todas as ferramentas

recipe_install

Skills e receitas · macOS · Windows

Efeito: escrita. 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

Instala uma SKILL da comunidade por id (de recipe_discover) neste Mac para que recipe_run possa usá-la. Instalar apenas armazena a skill. Executá-la pede uma confirmação quando tem passos que alteram o estado (enviar/gravar/apagar), e um passo não pode se confirmar sozinho: `confirm` nos args de um passo é removido aqui (confirm_removed_steps) e ignorado na execução, então um passo cuja ferramenta pede confirmação responde com a sua prévia em vez de executar. Se já existir uma skill com o mesmo nome, ela é salva com um nome que não colide. A primeira chamada mostra uma prévia; confirm: true baixa e salva. Retorna {name, installed}.

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": "Must be true to download and save the skill. Without it the call returns a preview and contacts nothing.",
      "type": "boolean"
    },
    "id": {
      "description": "The community skill id from recipe_discover.",
      "type": "integer"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para recipe_install. 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,
  "id": 101
}

Windows

Finalidade

Instala uma SKILL da comunidade por id (de recipe_discover) nesta máquina para que recipe_run possa usá-la. Seguro: instalar apenas armazena a skill; um passo não pode se confirmar sozinho, então, quando ela for executada mais tarde, um passo cuja ferramenta pede confirmação (para enviar, apagar, substituir um arquivo, executar um comando) retorna a sua prévia e não altera nada. Se já existir uma skill com o mesmo nome, ela é salva com um nome que não colide. A primeira chamada retorna uma prévia com os passos da skill e não salva nada; confirm=true salva. Retorna {name, imported}.

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": "Must be true to save the skill. Without it, returns a preview naming its steps.",
      "type": "boolean"
    },
    "id": {
      "description": "The community skill id from recipe_discover.",
      "type": "integer"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para recipe_install. 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,
  "id": 101
}