layer-workflow-import

Layer 工作流导入

概述

阅读源工作流的功能，使用 Layer 的节点类型重建它，然后将整个图交给 import_workflow。导入结果始终为私有；分享是 Layer 应用中的单独步骤。若要运行 现有工作流，请使用 layer-workflows。花费限制和轮询规则见 layer 技能。

如果你可用的技能中缺少此处提到的同级技能，请让用户安装 （npx skills add layerai/skills --skill <name>）；若无需人工介入，则根据工具架构继续操作，并标明缺失项。

转译意图，而非节点

其他工具会展示底层机制；Layer 则关注任务本身。一个低级文本生成图像工作流包含模型 加载器、每个提示词对应的文本编码器、空潜变量、采样器和解码器。在 Layer 中，这些就是一个 生成节点。阅读输入、各步骤的作用以及输出，然后用尽可能少的 Layer 节点完成相同任务。

如何阅读陌生的源工作流，以及常见节点模式的含义，详见 references/sources.md。

快速参考

步骤	工具	说明
了解组成部分	get_blueprint_system_config	节点类型、端口及其值架构。调用一次，重复使用。
选择模型	list_base_models、get_base_model	按用途查找。切勿照搬源工作流的模型名称。
采样文件	request_file_upload_url 或 upload_file	仅用于验证运行：文件输入的值是 file_id。
检查图	使用 validate_only: true 调用 import_workflow	不会创建任何内容。修复报告的所有问题。
导入	import_workflow	默认以私有方式发布，以便运行。
验证运行	estimate_workflow_price、execute_workflow	按 layer-workflows 中的运行格式执行。轮询 get_workflow_run。
归档	list_projects，然后在导入时传入 project_id	可选：将工作流放入项目以供审查。

图

graph 是一个开放对象，包含三个映射：inputs（参数键到输入参数）、nodes（节点 ID 到节点）和 outputs（参数键到输出参数）。没有公开接口定义这些映射内部的字段，因此 不要假设其结构。节点类型、端口键、端口类型和值架构来自 get_blueprint_system_config；validate_only 会指出缺失或命名错误的内容。

图中没有边列表。每个输入的来源都在 refs 中指定，格式为 {"_default": [...]}， 其中保存 nodes::<node id>[<kind key>]::<port key>（节点输出）或 blueprint::<input key>（工作流输入）。

只有当 A 等于 B，或（A，B）是类型转换规则时，类型为 A 的输出才能连接到类型为 B 的输入。 带有 transformer 的规则表示禁止直接连接：在两者之间插入指定的转换器节点类型，并通过它连线。

静态值必须符合系统配置中对应类型的 JSON 架构。若某个端口用于选择模型，请使用 list_base_models，并按该节点所服务的用途筛选模型。

流程

1. 获取工作区的 get_blueprint_system_config。
2. 阅读源文件，用通俗的语言记下输入、步骤和输出。
3. 将每个步骤映射到一种节点类型。如果没有合适的类型，就停下来告诉用户哪个步骤没有对应的 Layer 节点，不要用无关节点近似替代。
4. 构建图，然后调用 import_workflow，并设置 validate_only: true。结果会按节点、输入和输出归类问题。修复后重复此操作，直到 is_valid 为 true。
5. 正式调用 import_workflow，并提供清晰的 name 和说明来源的 description。如果用户希望将其归入某个项目，则传入 project_id。
6. 验证效果：为每个文件输入上传一个示例，调用 estimate_workflow_price，确认费用高于 20 CUs，然后使用 session_name 调用 execute_workflow 并轮询结果。图通过验证，并不代表生成的内容正确；要检查输出。
7. 汇报：工作流 ID、各项内容的映射方式，以及任何被舍弃或近似处理的内容。

publish: false 会保留草稿，而不是创建可运行的工作流；即使存在验证问题，也可以使用。仅当用户希望在编辑器中手动完成图时才使用它。

示例

“导入这个工作流。”用户附上一个节点图 JSON，其中包含顶层的 nodes 列表和 links 列表；links 中每项的格式为 [link, from node, from slot, to node, to slot]。

1. 阅读内容：一个检查点加载器、一个像素艺术风格适配器、正向和负向文本编码器、一个空的 1024x1024 潜变量、一个采样器、一个解码器、一个 2x 放大节点和一个保存节点。
2. 意图：输入文本，输出放大 2x 的像素艺术图像。输入：提示词。固定项：尺寸和风格。
3. 调用 get_blueprint_system_config，然后选择端口匹配的图像生成和放大节点类型。如果图像生成节点类型有风格端口，调用 list_reference_sets 查找像素艺术参考集；否则，将风格信息合并到提示词中。
4. 针对文生图用例调用 list_base_models；选取第一个结果作为图像生成节点的模型。
5. 图：输入为 prompt；图像生成节点的提示词端口引用 blueprint::prompt；放大节点的图像端口引用 nodes::<generate id>[<generate kind>]::<image port>；输出引用放大节点的输出。
6. validate_only 报告放大节点的图像端口类型错误。此端口对的类型转换规则包含 transformer，因此无法直接连接：插入该转换器节点类型，并通过它连接。
7. 导入工作流，估算费用（6 CUs），使用 session_name 和示例提示词执行，轮询结果，并检查图像是否已放大且呈现像素风格。
8. 汇报：“已导入为私有工作流。采样器、潜变量和解码器的连接逻辑合并到了一个图像生成节点中。风格适配器替换为一个参考集。已舍弃负向提示词：所选模型没有负向提示词端口。”

常见错误

• 将检查点或权重文件名复制到模型端口，而不是查询 base_model_id。
• 在 graph 中臆造字段名，而不是根据系统配置和验证结果填写。
• 端口对的类型转换规则包含 transformer，却没有通过该节点类型进行连接。
• 悄悄近似处理 Layer 没有对应节点的步骤。应说明是哪个步骤，以及原因。
• 承诺工作流会共享。工作流是私有的；共享操作在 Layer 应用中进行。
• 跳过测试运行。验证只会检查连线，不会判断输出是否正确。