Naar de inhoud
Alle hulpmiddelen

recipe_run

Skills en recepten · macOS · Windows

Effect: uitvoeren. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Voert een recipe van begin tot eind uit: bindt params, voert de tool van elke stap in volgorde uit via het register, bewaart de run (zie recipe_runs) en geeft het resultaat van elke stap terug plus een eventueel markers_path. Recipes met stappen die iets wijzigen (schrijven/verzenden/verwijderen) tonen EERST een VOORBEELD — roep opnieuw aan met confirm:true om uit te voeren; recipes die alleen lezen draaien meteen. Die bevestiging start de run en verder niets: een stap kan zichzelf niet bevestigen. `confirm` in de args van een stap wordt genegeerd (het voorbeeld en het runrapport markeren die stap als confirm_ignored), dus een stap waarvan de tool om zijn eigen bevestiging vraagt, antwoordt met zijn voorbeeld en wordt NIET uitgevoerd (het runrapport markeert hem als previewed en vermeldt hem in previewed_steps) — voer die tool rechtstreeks uit om het te doen. Een stap die een fout geeft (een fout in zijn antwoord, of een weigering) stopt de run en wordt gemeld (stopped_at, met de error_key van de stap); een stap waarvan de tool niet door deze Mac in tools/list wordt aangeboden, wordt geweigerd (tool_not_advertised). Beide stoppen de run, tenzij die stap is gemarkeerd met "optional": true — dan wordt de fout vastgelegd in zijn resultaat en in skipped_optional, en gaat de run door.

Vereiste invoer

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor recipe_run. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{
  "confirm": false,
  "name": "Demo morning brief"
}

Windows

Doel

Voert een opgeslagen recipe van begin tot eind uit: bindt params, voert de tool van elke stap in volgorde uit, legt de run vast (zie recipe_runs) en geeft het resultaat van elke stap terug. Bevestigingspoort: zonder confirm:true geeft het een DRY-RUN-VOORBEELD van de stappen in volgorde met hun gebonden args; roep opnieuw aan met confirm:true om uit te voeren. Een stap die een fout geeft stopt de run en wordt gemeld (stopped_at), tenzij die stap is gemarkeerd met "optional": true — dan wordt de fout vastgelegd in zijn resultaat en in skipped_optional, en gaat de run door. Een stap kan zichzelf niet bevestigen: confirm in de argumenten van een stap wordt genegeerd (de stap zegt confirm_ignored), dus een stap waarvan de tool om bevestiging vraagt (om te verzenden, te verwijderen, een bestand te vervangen, een opdracht uit te voeren) geeft het voorbeeld van die tool terug en wijzigt niets; roep om de wijziging door te voeren die tool rechtstreeks aan nadat de gebruiker akkoord is.

Vereiste invoer

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor recipe_run. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{
  "confirm": false,
  "name": "Demo morning brief"
}