关联运行环境

ComfyUI 作为一种基于节点的工作流编排工具，其扩展性很大程度上依赖于第三方节点。ComfyUI 节点通常基于 Python 代码实现的，可能依赖于特定的 Python 库及其版本。当用户安装和使用多个节点时，不同节点之间可能存在依赖冲突，导致环境配置复杂且容易出错。

即使借助虚拟环境，在生产环境中管理多个 ComfyUI 工作流时，仍面临环境污染、工作流复现性、环境维护等挑战。

什么是工作流环境？

为了更好地实现环境隔离，平台推出了多运行环境方案。利用容器镜像，为每个 ComfyUI 工作流提供一个隔离的、独立的运行环境。

• 容器镜像隔离： 每个 ComfyUI 工作流及其依赖的节点和 Python 环境被打包到一个独立的容器镜像中。
• 环境定制化： 用户可以根据工作流的具体需求，自定义构建容器镜像。用户可以自由选择 Python 版本、预装所需的 Python 包、配置系统库等，从而精确控制工作流的运行环境。
• 工作流与环境关联： 平台允许用户将环境（容器镜像）与特定的 ComfyUI 工作流进行关联。当用户运行工作流时，平台会自动在关联的容器环境中执行，确保工作流运行在预期的环境中。

为了确保工作流在上线后能够稳定运行，工作流必须先经过与其关联环境的验证，才能被发布到在线状态。平台会在工作流与环境关联时，自动进行环境兼容性检查，确保工作流及其依赖的节点、库与所选容器镜像环境能够良好匹配。未通过校验的工作流将无法运行，从而避免因环境问题导致的服务故障。

预置环境与私有环境

预置环境类似 ComfyUI 整合包等，提供了一个开箱即用的 ComfyUI 环境，预先配置了常见的模型、节点以及依赖项，无需复杂的环境搭建，即可立即开始工作流创作。

NOTE

如果需要制作私有环境，请联系无问芯穹。

关联环境

新建托管工作流后，工作流处于「待校验」状态，尚未关联工作流运行环境。点击关联环境，进入下一步。

在「环境配置」标签页中，选择一个环境进行关联。平台会将比对工作流文件与目标运行环境中的模型、节点。

如果您选择的环境可支持工作流运行，则校验通过，工作流进入「待上线」状态，可在详情页操作上线。

NOTE

如果工作流进入「校验失败」状态，说明您选择的环境无法支持工作流运行。请检查以下内容：

• 托管工作流时，是否在上传 API JSON 文件误传了工作流 JSON 文件。
• 如果关联了预置环境，说明工作流中使用的自定义节点和模型不在预置环境中。您需要制作私有环境。
• 如果关联了私有环境，说明工作流中使用的自定义节点和模型不在该私有环境中。请关联其他环境或制作私有环境。

如果是已上线的工作流，需要先进行下线，才能更换关联环境。

后续步骤

新建托管工作流后，工作流处于「待校验」状态，下一步：

• 试运行：参考在线调试工作流的操作，在线调试工作流参数，预览结果图片、查看推理时长等。注意工作流未上线时不支持 API 调用。
• 在线调试、编辑工作流： 工作流未上线时，可在详情页修改参数，并保存到工作流中。
• 上线工作流：将工作流发布为线上 API 服务。后续在搭建 API 流程时，我们将使用 GenStudio 平台，获取工作流 ID 和工作流参数。