recipe_run

技能与流程 · macOS · Windows

效果: 执行. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置，并不表示它在所有安装中都已启用。

macOS

用途

端到端执行配方：绑定 params，通过注册表依次运行每个步骤 (steps) 的工具，持久保存此次运行（参见 recipe_runs），并返回每个步骤的结果以及任何 markers_path。包含状态更改步骤（写入/发送/删除）的配方会先进行 PREVIEW——再次调用并传入 confirm:true 才会执行；只读配方会立即运行。任何步骤出错都会停止运行并报告错误。

必填输入

name

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构声明了明确的确认参数。请检查预览，并按此平台的契约授权实际操作。

仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

英文规范技术架构 — macOS

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

文档示例

recipe_run 的文档示例。请勿执行此示例。所示参数属于虚构数据集；在实际调用前，请解析真实标识符并获得授权。

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

Windows

用途

端到端执行已保存的配方：绑定 params，依次运行每个步骤 (steps) 的工具，记录此次运行（参见 recipe_runs），并返回每个步骤的结果。确认门控：不传 confirm:true 时，会返回已绑定 args 的有序步骤 DRY-RUN PREVIEW；再次调用并传入 confirm:true 才会执行。任何步骤出错都会停止运行并报告错误。