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 recept van begin tot eind uit: koppelt parameters, voert via het register de tool van elke stap in volgorde uit, bewaart de uitvoering (zie recipe_runs) en retourneert het resultaat van elke stap plus eventuele markers_path. Recepten met stappen die de toestand wijzigen (schrijven/verzenden/verwijderen) geven eerst een PREVIEW — roep opnieuw aan met confirm:true om ze uit te voeren; alleen-lezenrecepten worden meteen uitgevoerd. Een fout in een stap stopt de uitvoering en wordt gerapporteerd.

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

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 recept van begin tot eind uit: koppelt parameters, voert de tool van elke stap in volgorde uit, registreert de uitvoering (zie recipe_runs) en retourneert het resultaat van elke stap. Bevestigingspoort: zonder confirm:true retourneert dit een DRY-RUN PREVIEW van de geordende stappen met hun gekoppelde argumenten; roep opnieuw aan met confirm:true om uit te voeren. Een fout in een stap stopt de uitvoering en wordt gerapporteerd.

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