layer-workflows

Layer 工作流

概述

工作流是由工作室在 Layer 的 Blueprint 编辑器中构建并发布的多步骤流水线。Forge 使用你选择的参数运行一个模型，而工作流运行的是他人已设计、测试并标准化的图。如果已有适用于当前任务的工作流，它通常是更好的选择：它封装了工作室已经做出的决策。

在会话中首次运行工作流前，调用 get_workflow_instructions。共享流程和费用门槛见 layer 技能。

如果这里提到的同级技能不在你可用的技能中，请让用户安装（npx skills add layerai/skills --skill <name>）；若无人值守，请根据工具 schema 继续操作，并指出这一缺失。

先检查是否已有工作流

在用 Forge 运行构建多步骤流程之前，先调用 list_workflows，并传入工作区 ID，将 fulltext 筛选条件设为用户想要制作的内容。结果会按相关性排序。如果某个工作室已经发布了角色转面图流水线，他们就不希望你临时拼一个，而且临时方案也无法匹配游戏中已有的素材。

对于包含多个生成步骤的任何任务，一开始进行一次成本低廉的只读调用都很值得。

输入 schema 就是约定

每个工作流都有自己的输入，而 list_workflows 会返回每个工作流完整的 JSON schema。应以该 schema 为准，而非工作流的名称或描述。两个都叫“角色设定表”的工作流，可能需要完全不同的输入。

在编写运行参数前先阅读 schema，并严格按其声明传入。两种输入类型需要特别注意：

• 文件。 先上传文件并传入返回的 file_id，或者传入先前运行已生成的 file_id。如果 schema 要求文件 ID，切勿传入 URL。
• 样式。 样式输入需要使用 list_reference_sets 返回的参考集 set_id。base_model_id 在此处无效，传入后会报错，而且错误看起来像是工作流本身有问题。

如果必填输入没有明显的取值，请询问用户，而不要自行编造。即使工作流使用错误输入成功运行，也仍会按全价收费。

估价、执行、轮询

estimate_workflow_price 接收工作流 ID 和预期输入，会返回价格，但不会执行工作流。请用表格展示：工作流会生成什么、由哪个工作区付费，以及价格相对于余额的情况。超过 20 CUs 时，先询问并等待用户明确同意。

execute_workflow 会返回 run_id 和 poll_interval_seconds。get_workflow_run 会依次报告 PENDING、RUNNING，然后报告 SUCCESS、FAILURE 或 CANCELLED 等状态，并在运行期间报告步骤信息。

工作流比单次生成耗时更长，因此请定期报告进度，例如“已完成步骤数 / 总步骤数”，不要默默轮询。cancel_workflow_run 会停止运行并释放预留的 Creative Units；已消耗的单位不会退还。

示例

“在这个概念图上运行我们的角色转面图流水线。”

1. 调用 list_workflows 并传入 fulltext: "turnaround"，获取工作流及其输入 schema。
2. 阅读 schema。它需要一个 character_image 文件 ID、一个 view_count 整数，以及可选的样式。
3. 这个概念图来自先前的运行，因此已经有 file_id。无需上传。
4. 使用这些输入调用 estimate_workflow_price。返回价格为 34 CUs，余额为 900，超过了门槛，因此请展示表格并等待用户明确同意。
5. 调用 execute_workflow，并传入 session_name，以便在 Layer 应用中归类输出。
6. 按 poll_interval_seconds 调用 get_workflow_run，并在过程中报告“3 / 7 步”。
7. 状态为 SUCCESS 时，用带链接的表格展示输出。每个输出都包含一个 file_id，可直接用于下一次运行。

常见错误

• 在 Forge 中临时编排多步骤流程前，没有先检查 list_workflows。
• 根据工作流名称猜测输入，而不是读取其架构。
• 将 base_model_id 传给需要参考集 set_id 的风格输入。
• 在架构声明需要文件 ID 时传入 URL。
• 未先估算就执行，或未经明确同意就清除 20 CUs。
• 长时间静默轮询运行任务，不报告步骤进度。
• 重新上传之前的运行已生成的资源。