·更新于 ·Minds Team

Minds ComfyUI 结果、输出与问题排查

结合研究小组件和结构化结果进行分析,路由选定的原始媒体,并诊断阻止图运行的阶段。本参考指南涵盖平局、多受众、输入限制和持久重试。

Minds · Audience Preferences 会返回一份研究响应以及一组图输出。该响应可帮助你了解选定 Audience 的偏好。输出则使你能够保留该结果,并继续使用选定的原始媒体进行后续处理。偏好测试顺利完成,并不自动意味着每个输出端口都有原生图像或视频可供发送。

本参考指南假定已安装该插件包且服务器已配置 MINDS_API_KEY。如果找不到该节点或尚未运行首次测试,请先阅读 ComfyUI 配置指南。当工作流图需要动态画面和音频时,请参阅原生视频指南。

ComfyUI 节点内部显示的真实 Minds 响应,包含 QA Audience 的图像偏好分布

请将缩略图与标签对应阅读:广告 A 是足球营销活动图片,广告 B 是 Share a Coke。完成的分布包含 A 的 1 次选择和 B 的 4 次选择,因此小组件显示 20% 和 80%。结果详情截图包含解释及最下方的操作栏。配套工作流展示了原始 B 图片被传递到 Save Image。这 5 份 QA 回答证明显示与选择一致,不用于验证市场估计。 营销活动来源: Coca-Cola football, Share a Coke.

将指针移到结果区域内,使用鼠标滚轮或触控板双指滚动,即可查看分析结论和底部控件,画布不会随之移动。这张加高的文档截图一次展示了完整结果。

将小组件作为研究响应来解读

内置小组件采用了与 MCP 客户端相同的 Minds 响应界面。根据已完成的响应内容,它可以显示问题、选定的 Audience、分类分布、核心发现以及可用的单个 Mind 详细回答。请在结果区域内滚动查看完整响应,而不是仅看最高的那根柱状图。

首先确认问题。背景信息、候选素材引用以及编写的问题共同组成了已保存的偏好测试工具。针对网站介绍得出的测试结果,不能自动套用来回答哪套素材能在静音的社交媒体信息流中胜出。随后确认 Audience 和备选项标签。这些定义了结果所适用的目标群体和选择集。

在查看分布数据的同时,请一并阅读核心发现和详细回答。它们有助于发现值得深入探究的问题,但合理的解释并不能作为现实世界行为的独立证明。如需进行更广泛的定性探索、问卷调查或定量方法(如 MaxDiff),请在关联的 Study 工作流和功能指南中继续操作。

Minds 是用于商业合成研究的端到端平台,通过 Minds、Audiences 和 Studies 将定性与定量工作紧密连接。PRISM 为每个 Mind 底层提供推理、推断和源建模基础。此适配器在该基础之上提供了一个聚焦的分类偏好问题接口。

理解五个输出端口

端口类型用途
selected_imagesIMAGE 列表为路由 Audience 选出的原始原生图像
selected_videosVIDEO 列表为路由 Audience 选出的原始原生视频,包含音频
results_jsonSTRING序列化结果,包含 Study/运行引用以及分 Audience 排名
preference_resultMINDS_CREATIVE_RESULT用于兼容的自定义节点处理的结构化结果
selected_creativesMINDS_CREATIVES选定的素材记录,包含原生素材或托管/文本引用

图像和视频端口均为列表输出。候选名单、平局结果或选定集合可能包含多个项目。请确保下游节点能够接受你的 ComfyUI 工作流中的原生类型和列表行为。这些自定义输出不是通用字符串,因此请连接能够识别相应匹配类型的节点。

当特定模态不存在原生媒体时,结果端口依然有用。例如,文本概念对比可以生成有效的结果和选定的概念记录,而无需生成图像。同样,托管的视频引用不会仅仅因为其 MIME 类型为 video/mp4 就自动变为原生 VIDEO 对象。

results_json 中包含的内容

该 JSON 包含 studyId、runId、reviewUrl、question、audiences、creativeFingerprint 和 interpretation。它将偏好数据与保存的研究以及确切的素材集关联起来。在记录决策时请保留这些引用,以便追溯是哪次运行和哪些备选方案为该决策提供了依据。

每个 Audience 条目都包含其 audienceId、显示名称、ranking、winners、可选的 API estimation 数据以及 confidence。每个排名条目包含 label、index、share 和 rank。这里的 share 是返回分布总数中的占比小数,而非百分比字符串。80% 的份额表示为 0.8。

候选项索引从零开始,对应组合后的素材顺序。winners 数组包含排名为 1 的索引,包括平局项。在检查或路由结果时,请结合使用标签、索引和指纹。仅凭输入位置本身并不能证明某个候选素材更受偏好。

适配器会对返回的分类分布进行归一化处理,并按份额降序排序。它将 confidence 保留为 null;它不会计算未经支持的置信区间、显著性评分或转化率预测。如果你要构建自己的下游自动化流程,请保留这种区分,而不是将偏好直接重新标记为实测效果。

对比各个 Audience 而不进行合并

每个选定的 Audience 都会保留其专属的偏好分布和排名。如果 Audience A 偏好某种方案而 Audience B 偏好另一种方案,结果将分别记录这两者。节点不会使用凭空捏造的权重将它们合并为一个群体。

当仅选择了一个 Audience 时,其排名可直接用于驱动媒体选择。如果选择了多个,请在 selection_audience_id 中输入一个已包含的 Audience ID。这将指定由哪个群体的偏好来控制选定素材的输出。这不会改变其他 Audience 的研究结果。

如果没有进行该路由选择,小组件和 results_json 仍可正常显示已完成的研究,但媒体和选定素材的路由将保持阻塞。这是符合预期的行为。请先审查受众群体的差异,然后选择应当由哪个 Audience 来主导生产工作流的这一分支。

测试范围之外的 Audience ID 将被拒绝。友好名称不能替代 ID。如果需要确认当前服务端账户可访问的群体,请参阅 Audience 指南以及可选的 Minds · Find Audiences 辅助节点。

解读 top_k 与平局

top_k 用于在候选项总数中设置入围名单的截断阈值。节点会选出份额不低于该截断处份额的所有候选项。如果有多个候选项在该处并列,它们都会被保留在选定结果中,即使输出的项目数量超过了 top_k。

排名依据份额严格大于自身的候选数量来决定。并列第一的两个备选项都会获得排名 1。在有两个并列第一且第三个备选项得分较低的情况下,该第三备选项将获得排名 3。这样可以保留真实的平局情况,而不会臆造出数据中并不存在的先后顺序。

如果你的下一步流程只需要单个文件,请在工作流中明确体现这一假设。你可以保留平局输出用于下一轮迭代,或在 Minds 中查看平局详情。适配器不会为了消除平局而默认静默选择最先连接的候选项。

在选择原始素材之前,节点还会检查素材指纹是否与已排名的批次匹配。更改标签或媒体输入属于对研究内容的修改,而不仅仅是工作流图的外观调整。针对修改后的素材,请启动新的测试。

原生输出保留原始素材品质

原生图像输入在上传用于研究副本时会被编码为 PNG。原生视频会被编码为 MP4(包含音频)。选定的输出将使用最初连接的张量或 VIDEO 对象,而不是上传时的编码文件或从小组件中提取的预览图。

完整的图像工作流,通过 Save Image 保留选定的原始图像

这使你的工作流图能够以原始工作质量继续执行。下游节点仍然决定了其保存文件的编码方式和命名规则。如需特定的格式或音频行为,请检查下游节点的设置。偏好适配器无法恢复在接收输入之前就已缺失的素材内容。

如果在混合对比中图像胜出,selected_images 可以正常使用,而 selected_videos 将没有选定的原生视频。如果是托管记录胜出,请检查选定的引用项。在未核对实际胜出候选项之前,不要将原生输出的缺失误判为研究响应失败。

了解准备、审核和运行阶段

在首次加入队列时,节点会创建或加载保存的 Study 草稿并打开其审核对话框。在等待批准期间,它会阻止下游的执行。请检查问题、备选项、Audience 和语言,批准确切的草稿,然后再次加入队列以正式运行。

批准运行前实际的 ComfyUI 草稿审核对话框

如果取消审核,将无法获得胜出项。如果批准但未再次加入队列,仅凭该操作并不会触发研究。Review draft 按钮可重新打开可用的审核界面。它无法显示尚未准备好的草稿。

适配器会在执行前验证保存的草稿。更改问题、修改附件、更换 Audience 或产生新版本都会使先前的批准失效。请对新状态进行准备和审核。不要为了跳过审核步骤而在不同工作流之间复制批准值。

重试相同请求或开始新测试

节点会维护一个请求标识以及作用于已认证账户的持久服务端凭据。未做更改的重试可以复用已保存的 Study、草稿和运行。当研究已经启动后发生网络中断或本地轮询超时,这一机制尤其有用。

如需进行无更改的重试,请将同一个工作流加入队列。保持素材、标签、问题、背景信息、Audience 和调研语言不变。将服务端凭证更换为另一个账户并不能获得对原账户已保存成果的访问权限;适配器会检查所有权。

当研究输入发生变化时,请使用 New test。它会创建一个新的请求标识,并清除节点先前的批准和响应显示。对修改后的测试进行准备、审核并执行。这也适用于上游生成节点生成了新图像或视频的情况,即使其提示词文本保持未变。

终态的失败或已取消运行与轮询超时不同。请打开保存的 Study 进行检查。重复将终态失败的任务加入队列,并不能使其不完整的证据变得足以选出胜出项。

输入限制与校验

输入项当前适配器规范
创意备选项总数2–20 个互不相同的候选项
创意标签互不相同、非空,每个最多 200 个字符
选定的 Audience1–100 个互不相同的逗号分隔 UUID,取决于账户访问权限和就绪状态
组合后的问题最多 2,000 个字符,包含背景信息、候选项引用和概念文本
本地编码创意素材非空,每次上传最多 50 MB
文本概念记录1–20,000 个字符,同时受限于更严格的组合问题字符上限
托管 URLHTTPS 文件引用,最多 4,096 个字符,不得包含嵌入的登录信息或哈希片段
top_k至少为 1 且在实际候选项数量范围内
本地轮询超时时间5–3,600 秒;默认 900 秒
study_localear, de, en, es, fr, ja, ko, tr, zh

这些限制用于校验适配器的输入,并不保证每个符合限制的文件或每个账户都能执行相同的测试。账户访问权限、额度、Audience 就绪状态以及研究服务的校验仍然适用。单独的清单文本限制并不能授权超出组合问题字符上限的问题内容。

故障排查:诊断停止的阶段

现象排查项与后续操作
缺少节点确认官方插件包位于正在运行的服务器的 custom_nodes 中,已使用其对应的 Python 环境安装了依赖,并已重启服务器。检查自定义节点的导入错误。
MINDS_API_KEY 错误将凭证注入到实际的 ComfyUI 服务器进程中并重启该进程。在工作流 JSON 中或不相关的终端中设置密钥无法配置该服务器。
标签或候选项校验错误按收集顺序清点所有原生图像和视频。确保 labels_json 与原生输入一一对应,并为清单记录分配其独有的标签。
显示草稿但保存被阻止审核并批准已准备好的草稿,然后再次加入队列。这是正常的初始阶段。
审核不再匹配针对更改后的素材启动新测试,或按提示加载并审核当前保存的草稿。
结果已显示但媒体被阻止检查多受众研究的 selection_audience_id,并确认选定的记录中是否包含你预期的原生媒体类型。
研究仍在运行中将未做更改的工作流加入队列,以恢复对同一保存运行的轮询。
证据不完整或分布异常打开保存的 Study 进行排查。适配器刻意设计为不会从不兼容或不完整的结果中选择创意素材。
小组件显示空白检查插件包的前端静态资源是否已加载,刷新 ComfyUI,并检查浏览器控制台错误。JSON 结果有助于区分是显示问题还是研究执行失败。

身份验证错误与草稿错误是分开的。HTTP 401 提示服务器密钥有问题。HTTP 402 或 403 可能表示权限或账户额度问题。HTTP 409 可能表示请求已更改或 Minds 尚未就绪。HTTP 413 表示资产大小超出限制。对于 HTTP 429,请稍后重试相同的请求,而不是重复创建新的 Study。

官方 Issue 追踪器是该插件包的支持渠道。提交反馈时请提供插件包和 ComfyUI 的版本号、发生故障的阶段以及脱敏后的错误信息。请勿在公开报告中包含服务器密钥、私有媒体、签名 URL 以及未经脱敏的账户数据。

已验证的内容

已发布的集成所包含的验证证据涵盖了真实的图像和原生视频工作流,贯穿草稿审批、线上 Minds API 执行、内置响应渲染和原生保存等完整环节。测试所用的视频样本长度为 2 秒并包含音频。在测试的工作流中重复相同的请求可恢复现有的持久运行。

上述测试使用的是 ComfyUI 0.41.0 和前端 1.55.17 版本,并采用了包含 5 个 Mind 的 QA Audience。这些测试并未确立对长视频的支持、Comfy Cloud 上的执行、原生 Partner Node 上架状态、研究校准或实际营销转化的提升。在向同事展示你的素材决策时,请注意保留这一界限。

有关研究设计和解读的更多信息,请阅读入门指南、Minds、Audiences 和 Studies。集成概述、ChatGPT 配置、Claude 配置和 MCP 概述介绍了其他宿主环境的工作流。ComfyUI 创意文章展示了如何将明确范围的偏好问题转化为有价值的下一轮素材迭代。

常见问题

偏好百分比代表什么?

它描述了针对某一个选定 Audience,在提供的具体备选方案中所返回的分布情况。这是方向性的合成研究,而非实测的营销活动效果、代表性总体估计或预测的转化率。

top_k 是否始终精确返回该数量的素材?

否。该节点会包含截断处的所有平局项,因此候选名单中的素材数量可能多于 top_k。它会保留并列第一,而不是按输入顺序进行取舍。

为什么结果已显示但选定的媒体仍处于阻塞状态?

当包含多个 Audience 时,请选择一个已包含的 selection_audience_id 来驱动媒体路由。同时请确认所选候选项包含你所连接的原生模态;托管 URL 和文本记录不会生成原生 IMAGE 或 VIDEO 输出。

我可以在不启动新的 Study 运行的情况下进行重试吗?

使用相同的请求标识和未更改的输入将同一个工作流加入队列,即可恢复其持久保存的请求。当素材、标签、问题、背景信息、Audience 或调研语言发生变化时,请使用 New test 并重新审核。

响应小组件会接收到 API 密钥吗?

不会。身份验证属于 ComfyUI Python 服务端。结果 iframe 仅接收响应数据用于展示,不需要服务端的 Minds 密钥。请将研究内容本身视为你选择共享的信息。

该节点是否提供统计置信区间?

结构化结果中 confidence 保持为 null,不会凭空生成置信区间或显著性声明。请结合本次运行的 Audience、测试物、问题和证据局限性来解读分布情况。