Vai al contenuto
Tutti gli strumenti

recipe_run

Skills e ricette · macOS · Windows

Effetto: esecuzione. Stato: disponibilità condizionata.

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

macOS

Scopo

Esegue una ricetta dall'inizio alla fine: associa i params, esegue in ordine lo strumento di ogni passaggio tramite il registro, conserva l'esecuzione (vedi recipe_runs) e restituisce il risultato di ogni passaggio più l'eventuale markers_path. Le ricette con passaggi che modificano lo stato (write/send/delete) mostrano prima un'ANTEPRIMA: richiama con confirm:true per eseguirle; le ricette di sola lettura vengono eseguite subito. Quella conferma avvia l'esecuzione e nient'altro: un passaggio non può confermare se stesso. `confirm` negli argomenti di un passaggio viene ignorato (l'anteprima e il report di esecuzione contrassegnano quel passaggio come confirm_ignored), quindi un passaggio il cui strumento richiede la propria conferma risponde con la sua anteprima e NON viene eseguito (il report di esecuzione lo contrassegna come previewed e lo elenca in previewed_steps): esegui direttamente quello strumento per farlo. Un passaggio che dà errore (un errore nella risposta o un rifiuto) interrompe l'esecuzione e viene segnalato (stopped_at, con l'error_key del passaggio); un passaggio il cui strumento questo Mac non offre in tools/list viene rifiutato (tool_not_advertised). Entrambi interrompono l'esecuzione, a meno che quel passaggio non sia contrassegnato "optional": true: in tal caso l'errore viene registrato nel suo risultato e in skipped_optional, e l'esecuzione continua.

Input obbligatori

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.

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

Esempio documentale

Esempio di documentazione per recipe_run. 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,
  "name": "Demo morning brief"
}

Windows

Scopo

Esegue una ricetta salvata dall'inizio alla fine: associa i params, esegue in ordine lo strumento di ogni passaggio, registra l'esecuzione (vedi recipe_runs) e restituisce il risultato di ogni passaggio. Blocco di conferma: senza confirm:true restituisce un'ANTEPRIMA DRY-RUN dei passaggi in ordine con i loro argomenti associati; richiama con confirm:true per eseguire. Un passaggio che dà errore interrompe l'esecuzione e viene segnalato (stopped_at), a meno che quel passaggio non sia contrassegnato "optional": true: in tal caso l'errore viene registrato nel suo risultato e in skipped_optional, e l'esecuzione continua. Un passaggio non può confermare se stesso: confirm negli argomenti di un passaggio viene ignorato (il passaggio riporta confirm_ignored), quindi un passaggio il cui strumento richiede conferma (per inviare, eliminare, sostituire un file, eseguire un comando) restituisce l'anteprima di quello strumento e non cambia nulla; per effettuare la modifica, chiama direttamente quello strumento dopo l'approvazione dell'utente.

Input obbligatori

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.

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

Esempio documentale

Esempio di documentazione per recipe_run. 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,
  "name": "Demo morning brief"
}