recipe_run

技能与流程 · macOS · Windows

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

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

macOS

用途

端到端执行一个配方：绑定参数，通过注册表按顺序运行每个步骤的工具，保存该次运行（参见 recipe_runs），并返回每个步骤的结果以及 markers_path（若有）。含有会更改状态的步骤（写入/发送/删除）的配方会先预览——再次调用并传入 confirm:true 才会运行；只读配方会立即运行。该确认只会启动运行，仅此而已：步骤无法自行确认。步骤参数中的 `confirm` 会被忽略（预览和运行报告会将该步骤标记为 confirm_ignored），因此其工具要求自行确认的步骤只会返回预览而不会执行（运行报告会将其标记为 previewed 并列入 previewed_steps）——请直接运行该工具来执行。出错的步骤（答复中有错误，或被拒绝）会停止运行并被报告（stopped_at，附带该步骤的 error_key）；这台 Mac 没有在 tools/list 中提供其工具的步骤会被拒绝（tool_not_advertised）。两者都会停止运行，除非该步骤被标记为 "optional": true——此时错误会记录在其结果和 skipped_optional 中，运行继续。

必填输入

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

文档示例

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

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

Windows

用途

端到端执行一个已保存的配方：绑定参数，按顺序运行每个步骤的工具，记录该次运行（参见 recipe_runs），并返回每个步骤的结果。确认关卡：不传 confirm:true 时，返回按顺序列出各步骤及其绑定参数的 DRY-RUN 预览；再次调用并传入 confirm:true 才会执行。出错的步骤会停止运行并被报告（stopped_at），除非该步骤被标记为 "optional": true——此时错误会记录在其结果和 skipped_optional 中，运行继续。步骤无法自行确认：步骤参数中的 confirm 会被忽略（该步骤会显示 confirm_ignored），因此其工具要求确认的步骤（发送、删除、替换文件、运行命令）会返回该工具的预览，不会改动任何内容；要进行更改，请在用户批准后直接调用该工具。