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 end-to-end: lega i parametri, esegue lo strumento di ogni passaggio in ordine tramite il registro, persiste nell'esecuzione (vedi recipe_runs) e restituisce il risultato di ogni passaggio più qualsiasi markers_path. Ricette con passaggi di modifica dello stato (scrittura/invio/eliminazione) PREVIEW prima — chiamare di nuovo con conferma:vero per eseguire; ricette di sola lettura eseguite immediatamente. Un passaggio in cui gli errori interrompono l'esecuzione e vengono segnalati. Elementi tecnici invariati: confirm:true.

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": {
      "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 end-to-end: lega i parametri, esegue lo strumento di ogni passaggio in ordine, registra l'esecuzione (vedi recipe_runs) e restituisce il risultato di ogni passaggio. Conferma cancello: senza conferma:true restituisce un DRY-RUN PREVIEW dei passaggi ordinati con i relativi argomenti legati; richiamare con conferma:true per eseguire. Un passaggio in cui gli errori interrompono l'esecuzione e vengono segnalati. Elementi tecnici invariati: confirm:true.

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