Tutti gli strumenti

recipe_save

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

Salva uno SKILL riutilizzabile - una ricetta con nome (una sequenza ordinata di chiamate allo strumento LMCP con parametri) — su questo Mac in modo che l'utente possa eseguirlo nuovamente in qualsiasi momento con recipe_run. Un utente ne salverebbe uno per trasformare un flusso di lavoro LMCP in più passaggi che ripetono (un brief mattutino, triage della casella di posta, un report settimanale, un pull di dati) in un singolo comando riutilizzabile. Le competenze salvate possono essere condivise con altre persone tramite recipe_export. Il manifesto deve avere un nome e un array di passaggi non vuoti. Restituisce {name}.

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 non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Schema tecnico canonico in inglese — macOS
{
  "properties": {
    "manifest": {
      "description": "The recipe manifest. Shape: {\"name\": string (required), \"description\": string, \"params\": [{\"name\": string, \"type\": \"string\"|\"int\"|\"bool\", \"default\": any}], \"steps\": [ ... ] (required, non-empty), \"outputs\": [{\"kind\": string}]}. A step is EITHER a tool call {\"tool\": <tool_name>, \"args\": {...}} OR a pause {\"wait\": {\"seconds\": N}} (also {\"wait\": N}). Any arg string may interpolate a declared param with ${name} (e.g. \"limit\": \"${count}\"); an arg that is exactly \"${name}\" keeps the param's type. Steps run in order; a later step can consume an EARLIER step's output with \"${steps[N].result.KEY}\" (0-based; supports .key and [i], e.g. \"account\": \"${steps[0].result.accounts[0].name}\"). On recipe_run a state-changing step previews first unless confirm:true.",
      "type": "object"
    }
  },
  "required": [
    "manifest"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per recipe_save. 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.

{
  "manifest": {
    "description": "Read the local date and time.",
    "name": "Demo morning brief",
    "steps": [
      {
        "args": {},
        "tool": "get_datetime"
      }
    ]
  }
}

Windows

Scopo

Salva su questo computer una SKILL riutilizzabile, cioè una ricetta con nome (una sequenza ordinata di chiamate agli strumenti LMCP con parametri), affinché l’utente possa eseguirla di nuovo in qualsiasi momento con recipe_run. Un utente ne salverebbe una per trasformare un flusso di lavoro LMCP ripetuto e composto da più passaggi (un riepilogo mattutino, la selezione della posta in arrivo, un report settimanale, un’estrazione di dati) in un singolo comando riutilizzabile. Il manifest deve contenere un nome e un array steps non vuoto. Una stringa arg può interpolare un parametro dichiarato con ${name}; un arg che è esattamente "${name}" conserva il tipo del parametro. Un passaggio successivo può usare l’output di un passaggio precedente con "${steps[N].result.KEY}" (indice a partire da 0; sono supportati .key e [i]). Restituisce {name, step_count}.

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 non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Schema tecnico canonico in inglese — Windows
{
  "properties": {
    "manifest": {
      "description": "The recipe manifest. Shape: {\"name\": string (required), \"description\": string, \"schema_version\": int, \"params\": [{\"name\": string, \"type\": string, \"default\": any}], \"steps\": [{\"tool\": string, \"args\": object}] (required, non-empty)}.",
      "type": "object"
    }
  },
  "required": [
    "manifest"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per recipe_save. 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.

{
  "manifest": {
    "description": "Read the local date and time.",
    "name": "Demo morning brief",
    "steps": [
      {
        "args": {},
        "tool": "get_datetime"
      }
    ]
  }
}