recipe_install

Skills e ricette · macOS · Windows

Effetto: scrittura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Installa una SKILL della community tramite id (da recipe_discover) su questo Mac in modo che recipe_run possa usarla. L'installazione si limita a memorizzare la skill. L'esecuzione richiede una conferma quando ha passaggi che modificano lo stato (send/write/delete), e un passaggio non può confermare se stesso: `confirm` negli argomenti di un passaggio viene rimosso qui (confirm_removed_steps) e ignorato durante l'esecuzione, quindi un passaggio il cui strumento richiede conferma risponde con la sua anteprima invece di eseguire. Se esiste già una skill con lo stesso nome, viene salvata con un nome che non crea conflitti. La prima chiamata mostra un'anteprima; confirm: true la scarica e la salva. Restituisce {name, installed}.

Input obbligatori

id

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per recipe_install. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "confirm": false,
  "id": 101
}

Windows

Scopo

Installa una SKILL della community tramite id (da recipe_discover) su questa macchina in modo che recipe_run possa usarla. Sicuro: l'installazione si limita a memorizzare la skill; un passaggio non può confermare se stesso, quindi quando viene eseguito in seguito un passaggio il cui strumento richiede conferma (per inviare, eliminare, sostituire un file, eseguire un comando) restituisce la sua anteprima e non cambia nulla. Se esiste già una skill con lo stesso nome, viene salvata con un nome che non crea conflitti. La prima chiamata restituisce un'anteprima con i passaggi della skill e non salva nulla; confirm=true la salva. Restituisce {name, imported}.

Input obbligatori

id

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

{
  "confirm": false,
  "id": 101
}