run-featured-workflow

精选工作流（run-workflow MCP）

运行 MCP 服务中内置的预构建营销和生产工作流。如果 get_featured_workflow 找到匹配项，切勿从头开始组合。

何时使用

在用户满足以下条件时触发：

• 提到某个精选工作流：再营销、本地化、横幅广告、包装、大规模产品横幅、产品目录、产品静物图、旋转视频等。
• 要求按名称或关键词运行某个“已知”或“预定义”工作流
• 提供产品图片和字体，用于采用默认设置的横幅／数据合并工作流

以下情况不要触发：

• 用户需要没有匹配名称的自定义工作流——使用 run-workflow 和 compose_workflow
• 用户只粘贴了批次／执行／工作流 ID——通过 run-workflow 技能使用 inspect_run

工具路由

步骤	工具
查找预定义工作流	get_featured_workflow
上传图片、字体、自定义模板、CSV 数据	upload_asset
从自定义 .indd 中提取合并标签	get_indesign_tags
提交（大型／多横幅工作流）	run_workflow_submit
轮询进度和输出	run_workflow_get_status（始终设置 includeOutputs: true）
标签差异后重新连接图	compose_workflow（仅限自定义模板）
诊断失败	inspect_run

发现流程

1. 调用 get_featured_workflow({ query: "<keyword>" })。
2. 有多个匹配项——不提供 prepared。列出匹配项名称，让用户选择，然后使用准确名称重试。
3. 只有一个匹配项——向用户展示 mergeNodes、必填输入和尺寸。请用户确认。
4. 如果未指定模板，询问用户是否使用默认模板还是自定义 .indd。
5. 如果用户有 .otf／.ttf 文件，询问是否需要使用字体——通过 upload_asset 上传。
6. 如果用户提供了 .csv（例如 product-banners-at-scale 这类数据合并工作流），上传该文件，并将其连接到 input-files 节点（prepared.inputNodes 中的 type: "file"）——参见下方“数据／CSV 输入”。

**不同类型的资源应路由到不同的输入节点：**图片 → input-images，字体 → defaults.fonts，CSV／数据 → input-files（它会传给 parse-data）。切勿将它们合并到同一个节点。

快速路径（默认设置）

用户希望使用默认模板和默认文本时：

1. 通过 upload_asset 上传产品图片和字体。
2. 调用 run_workflow_submit：

{
  "session_id": "<prepared.session_id>",
  "useSessionDefaults": true,
  "defaults": {
    "fonts": [{ "presignedUrl": "...", "name": "Font.otf", "storageType": "azure" }]
  },
  "inputs": [
    {
      "node_id": "<input-images id from prepared.inputNodes>",
      "content": [{ "type": "image", "url": "..." }]
    }
  ]
}

• 不要调用 compose_workflow。
• 存在 session_id 时，不要发送 actions／connections。
• 在一个 content 数组中传入所有图片——只调用一次提交。

数据／CSV 输入

某些精选工作流（例如 product-banners-at-scale）包含 CSV 分支：input-files → parse-data → merge-data。prepared.inputNodes 会显示 type: "file" 的 CSV 节点，而 prepared.inputs 则以内嵌内容的形式提供工作流自带的示例 CSV。

• **仅使用默认设置（没有用户 CSV）：**按原样提交——自带的示例 CSV 会流经工作流，无需添加 input-files 条目。
• **用户提供了 CSV：**通过 upload_asset 上传，然后为 input-files 节点 ID 添加一个 inputs[] 条目，以覆盖自带的默认值：

{
  "node_id": "<input-files id from prepared.inputNodes>",
  "content": [{ "url": "<uploaded csv url>", "mimeType": "text/csv" }]
}

CSV 列会驱动 parse-data 的扇出（例如 headline、subcopy、CTA）——不要再将这些字段单独连接为文本输入。对于每行都相同的产品图片（不是 CSV 中逐行变化的列），应将 input-images 直接连接到 merge-data，完全绕过 parse-data——这是特权默认路由；只有当图片确实随行变化时，才通过 parse-data 的媒体覆盖端口进行路由。

自定义模板路径

当用户提供自定义 .indd 模板时：

1. 对每个模板调用 get_indesign_tags。
2. 与 prepared.mergeNodes[].tags 比较：
   • 相同 → 仅替换模板 URL；跳过 compose。
   • 不同 → 先检查可行性，再视情况重新连线 compose_workflow。
3. 如果关键图像标签已被移除（例如重定向中的 background），请停止——提供默认选项、其他模板或从头构建。
4. 以可视化方式展示更新后的图。仅询问缺失的合并数据输入。
5. 在用户确认所有值后再提交。

合并数据与场景提示词： 只有 InDesign 合并端口标签需要面向用户的文本／图像输入。除非用户要求更改，否则将 gen-object-composite 场景提示词保留为默认值。

轮询与输出

调用 run_workflow_submit 后，每隔约 5 秒轮询一次 run_workflow_get_status，并设置 includeOutputs: true。

• 报告：Running — N/M complete (X%) · Ns elapsed，使用响应中的 elapsedSeconds。
• 完成时：逐一列出所有输出的完整预签名 URL，原样提供。切勿截断。
• 失败时：调用 inspect_run，概述情况并停止——不要自动重试。

已知精选工作流

Slug／关键词	用途
product-banners-at-scale	根据 CSV 创建产品横幅（数据合并），使用一个模板和一张固定图像，每行对应一段文案
retargeting	重定向广告
localization	本地化
generic-banner-advertising	通用横幅广告
contextual-or-native-advertising	原生广告
catalogs-and-circulars	产品目录
promotional-pricing-or-discounting	促销定价
packaging-variants-2d	包装
standardized-packshots-2d / 3d	产品白底图
refreshed-product-imagery-2d	产品图像更新
composite-imagery-3d	3D 合成
3d-spin-video	360 度旋转视频

反模式

• 在精选工作流已存在且标签匹配时调用 compose_workflow
• session_id 可用时仍发送完整图 JSON
• 在每个合并数据输入中重复填写 fonts——请使用 defaults.fonts
• useSessionDefaults: true 已足够时仍发送所有输入条目
• 每张图像单独提交一次
• 缺少合并数据文本字段时跳过用户确认

参考

• 完整的 run-workflow 技能（资产输入、发布／保存、警报 RCA）：run-workflow/SKILL.md