Codex VaultAgent Jelly Forest Demo - Tool Workflow
01 ProjectsAgent Jelly Forest DemoAgent Jelly Forest Demo - Tool Workflow
项目档案982 字

Agent Jelly Forest Demo - Tool Workflow

Agent Jelly Forest Demo Tool Workflow Goal 用一次真实的 Agent 原生生图演练覆盖灵帧工坊的完整资产生产状态机，并把成功产物、失败质量判定、错误下游执行和持久化结果全部保留为回归证据。 Inputs 独立项目 ，不修改 Default 项目。 2×2 道具图目标：蘑菇屋、药水瓶、宝箱、萤火灯。 风格契约：低细节、

Goal

用一次真实的 Agent 原生生图演练覆盖灵帧工坊的完整资产生产状态机，并把成功产物、失败质量判定、错误下游执行和持久化结果全部保留为回归证据。

Inputs

  • 独立项目 agent-jelly-forest-demo，不修改 Default 项目。
  • 2×2 道具图目标：蘑菇屋、药水瓶、宝箱、萤火灯。
  • 风格契约：低细节、大块面，纯洋红 #ff00ff 背景，道具不得使用该颜色。
  • agent_native 生图能力，不调用付费 MCP。
  • 动作参数请求尺寸 1024×1024。
  • 逐步执行与问题记录：F:\Codex-Program\sprite-video-lab\docs\agent-run-reports\2026-07-24-agent-jelly-forest-demo.md。

Outputs

  • 灵帧工坊项目、持久化 Agent run、workflow run、风格和资产节点。
  • 1 张原始 2×2 图片；实际尺寸为 1254×1254。
  • 自动抠图结果和 4 张拆分透明素材。
  • quality.review 的结构化拒绝结果：passed=false。
  • 4 条错误入库资产记录和 1 份错误保存的流程配方，作为失败证据保留。
  • 配方重新实例化验证、23/23 Agent 服务/API 回归结果和跨服务重启恢复证据。

Core Flow

project.create
-> agent run.create
-> style.define
-> 服务端创建并确认 style
-> asset.plan
-> 服务端创建 asset node
-> image.generate / agent_native
-> artifact 回传
-> 服务端色键抠图
-> 服务端 2×2 拆分
-> quality.review
-> library.ingest
-> flow.save
-> 运行收尾与持久化复核

预期控制流：

quality.review.passed=true
-> 允许 library.ingest
-> 允许 flow.save
-> run succeeded

quality.review.passed=false
-> 保留复核证据
-> 阻断入库和配方保存
-> run failed 或 action_required

本次实际控制流：

quality.review.passed=false
-> 动作仍被标记 succeeded
-> 4 张不合格素材入库
-> 配方保存
-> 整条运行标记 succeeded

Automation Boundaries

可自动执行：

  • 项目与运行创建、风格/资产节点落库。
  • artifact 接收、文件哈希与真实尺寸记录。
  • 背景估计、色键抠图、网格拆分和资产记录。
  • 流程状态、配方和结果持久化。

需要 Agent 或人工判断：

  • 风格契约是否满足。
  • 透明边缘是否有洋红溢色、主体缺损或切分错误。
  • 尺寸偏差是否可接受。
  • quality.review 拒绝后的处理选择：重试、人工修复或终止。
  • 保存的配方是否忠实表达运行时 executor 协商语义。

Error Handling

  • quality.review.passed=false：当前实现未正确阻断；修复后必须停止 library.ingest 与 flow.save，并保留拒绝原因。
  • 洋红描边：增加可配置 despill 和可选边缘收缩；用本次原图与 4 张拆图做固定回归。
  • 请求与实际尺寸不一致：保留真实尺寸，产生可观察警告或契约错误，不能静默当作完全匹配。
  • 风格漂移：先加强提示词和质量反馈，首轮不扩张为复杂风格编译器。
  • 配方静态显示 server_mcp、实例化实际协商为 agent_native：将配方字段表达为“运行时协商”，避免误导调用方。
  • 失败产物：不删除、不覆盖；修复后创建新运行并用幂等链路与原失败记录比较。

Reusable Patterns

  • 质量复核必须是控制流门禁，而不只是“已成功接收一条 review 记录”。
  • 外部生成结果要同时保存请求规格与实际产物规格。
  • 图像色键处理不能只改 alpha；生产透明素材还要验证边缘污染。
  • 工作流配方应保存意图与能力要求，executor 由实例化时协商。
  • 失败演练数据是长期回归资产；修复验证应新建记录，不篡改历史。

Pending Confirmations

  • passed=false 后运行最终状态使用 failed 还是 action_required。
  • despill、边缘收缩和 AI Matting 的首批实现范围。
  • 尺寸偏差采用警告、自动重采样还是硬失败。
  • 首个需要支持的引擎导出格式。