Saltar al contenido
Todas las herramientas

recipe_run

Skills y recetas · macOS · Windows

Efecto: ejecución. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Ejecuta una receta de principio a fin: enlaza los parámetros, ejecuta la herramienta de cada paso en orden a través del registro, guarda la ejecución (consulta recipe_runs) y devuelve el resultado de cada paso y, si lo hay, markers_path. Las recetas con pasos que cambian el estado (write/send/delete) muestran primero una VISTA PREVIA: vuelve a llamar con confirm:true para ejecutarlas; las recetas de solo lectura se ejecutan de inmediato. Esa confirmación inicia la ejecución y nada más: un paso no puede confirmarse a sí mismo. `confirm` en los argumentos de un paso se ignora (la vista previa y el informe de ejecución marcan ese paso como confirm_ignored), de modo que un paso cuya herramienta pide su propia confirmación responde con su vista previa y NO se ejecuta (el informe de ejecución lo marca como previewed y lo lista en previewed_steps); ejecuta esa herramienta directamente para hacerlo. Un paso que da error (un error en su respuesta, o un rechazo) detiene la ejecución y se informa (stopped_at, con el error_key del paso); un paso cuya herramienta este Mac no ofrece en tools/list se rechaza (tool_not_advertised). Cualquiera de los dos detiene la ejecución, salvo que ese paso esté marcado como "optional": true; entonces el error se registra en su resultado y en skipped_optional, y la ejecución continúa.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para recipe_run. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows

Propósito

Ejecuta una receta guardada de principio a fin: enlaza los parámetros, ejecuta la herramienta de cada paso en orden, registra la ejecución (consulta recipe_runs) y devuelve el resultado de cada paso. Control de confirmación: sin confirm:true devuelve una VISTA PREVIA DRY-RUN de los pasos ordenados con sus argumentos enlazados; vuelve a llamar con confirm:true para ejecutarla. Un paso que da error detiene la ejecución y se informa (stopped_at), salvo que ese paso esté marcado como "optional": true; entonces el error se registra en su resultado y en skipped_optional, y la ejecución continúa. Un paso no puede confirmarse a sí mismo: confirm en los argumentos de un paso se ignora (el paso dice confirm_ignored), de modo que un paso cuya herramienta pide confirmación (para enviar, eliminar, reemplazar un archivo o ejecutar un comando) devuelve la vista previa de esa herramienta y no cambia nada; para hacer el cambio, llama directamente a esa herramienta después de que el usuario lo apruebe.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para recipe_run. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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