recipe_import

Skills und Rezepte · macOS · Windows

Wirkung: Schreiben. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Installiert einen SKILL, den jemand mit Ihnen geteilt hat – übergeben Sie das skill_token aus dessen recipe_export (oder ein rohes Rezept-Manifest als JSON). Speichert ihn auf diesem Mac, damit recipe_run ihn verwenden kann. Der Import speichert den Skill nur. Seine Ausführung verlangt eine Bestätigung, wenn er zustandsändernde Schritte enthält (senden/schreiben/löschen), und ein Schritt kann sich nicht selbst bestätigen: `confirm` in den Argumenten eines Schritts wird hier entfernt (confirm_removed_steps) und bei der Ausführung ignoriert, sodass ein Schritt, dessen Tool eine Bestätigung verlangt, mit seiner Vorschau antwortet, statt ausgeführt zu werden. Existiert bereits ein Skill mit demselben Namen, wird der Import unter einem nicht kollidierenden Namen gespeichert. Der erste Aufruf zeigt eine Vorschau; confirm: true speichert. Gibt {name, imported} zurück.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für recipe_import. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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

Windows

Zweck

Installiert einen SKILL, den jemand mit Ihnen geteilt hat – übergeben Sie das skill_token aus dessen recipe_export (oder ein rohes Rezept-Manifest als JSON). Speichert ihn auf diesem Rechner, damit recipe_run ihn verwenden kann. Sicher: Der Import speichert den Skill nur; ein Schritt kann sich nicht selbst bestätigen, sodass bei der späteren Ausführung ein Schritt, dessen Tool eine Bestätigung verlangt (senden, löschen, eine Datei ersetzen, einen Befehl ausführen), seine Vorschau zurückgibt und nichts ändert. Existiert bereits ein Skill mit demselben Namen, wird der Import unter einem nicht kollidierenden Namen gespeichert. Der erste Aufruf gibt eine Vorschau zurück, die die Schritte des Skills nennt, und speichert nichts; confirm=true speichert. Gibt {name, imported} zurück.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

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