Vai al contenuto
Tutti gli strumenti

recipe_import

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 che qualcuno ha condiviso con te: passa lo skill_token del suo recipe_export (o il JSON grezzo di un manifest di ricetta). La salva su questo Mac in modo che recipe_run possa usarla. L'importazione 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, l'importazione viene salvata con un nome che non crea conflitti. La prima chiamata mostra un'anteprima; confirm: true salva. Restituisce {name, imported}.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

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": "Must be true to save the skill. Without it the call returns a preview and saves nothing.",
      "type": "boolean"
    },
    "skill": {
      "description": "A skill_token from recipe_export, or a raw recipe manifest JSON string.",
      "type": "string"
    },
    "skill_token": {
      "description": "Alias for `skill` — the exact field name recipe_export returns.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per recipe_import. 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,
  "skill": "{\"name\":\"Demo morning brief\",\"description\":\"Read the local date and time.\",\"steps\":[{\"tool\":\"get_datetime\",\"args\":{}}]}"
}

Windows

Scopo

Installa una SKILL che qualcuno ha condiviso con te: passa lo skill_token del suo recipe_export (o il JSON grezzo di un manifest di ricetta). La salva su questa macchina in modo che recipe_run possa usarla. Sicuro: l'importazione 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, l'importazione 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 salva. Restituisce {name, imported}.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

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": "Must be true to save the skill. Without it, returns a preview naming its steps.",
      "type": "boolean"
    },
    "skill": {
      "description": "A skill_token from recipe_export, or a raw recipe manifest JSON string.",
      "type": "string"
    },
    "skill_token": {
      "description": "Alias for `skill` — the exact field name recipe_export returns.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per recipe_import. 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,
  "skill": "{\"name\":\"Demo morning brief\",\"description\":\"Read the local date and time.\",\"steps\":[{\"tool\":\"get_datetime\",\"args\":{}}]}"
}