2026年10月1日·Minds Team

Adobe GenStudio 中的 Minds：开发指南

了解计划中的邮件文案评估扩展、Adobe 权限要求、明确体验选择、Minds 研究草稿以及原生宿主发布门槛。

Minds 受众评估扩展是面向 Adobe GenStudio for Performance Marketing 的开发包。其首个实现版本可选择单个邮件体验，并根据其文本字段准备研究。该扩展已构建完成，但尚未在原生 GenStudio 环境中安装或验收。它并不是 Adobe Exchange 的公开上线插件。

Minds 是用于商业合成研究的端到端平台，连接横跨 Audiences 与 Studies 的定性与定量工作。该适配器仅是进入该工作流的一个轻量切入点。其邮件文案范围和开发层面的限制，并不代表 Minds 整体研究平台的局限。

状态与权限阻碍

2026-10-01 状态检查结果：Adobe 开发者账户与 Minds Creative Review 控制台项目已存在。当前组织的 Add to Project 中 Runtime 处于停用状态；该账户未提供所需的 App Builder/GenStudio 权限。

仅有 Adobe 账户或空白 Console 项目并不代表拥有产品访问权限。在进行部署、扩展注册和实际宿主测试之前，必须拥有具备相应权限的组织以及项目/工作区。切勿仅因为开发者项目存在，就将编译好的软件包描述为已安装。

运行要求与归属权

请使用具有 App Builder 与 GenStudio 访问权限、且拥有扩展注册权限的目标 Adobe 组织。通过 Adobe 支持的组织流程获取所需项目/工作区。你还需要一个 Minds 账户，以及一个 Audience 与研究问题相匹配的现有 Study。

Adobe 开发者归属权与 Minds 研究归属权相互独立。在更改项目配置前请核实组织，在选择 Study 前请核实 Minds 账户。服务商凭据、运行时密钥、私有链接和私有研究载荷切勿出现在文档或屏幕截图中。

GenStudio 扩展开发指南是 Adobe 官方的扩展配置参考文档。Express 开发者访问权限并不能建立 GenStudio 权限；请使用具备权限的组织所支持的部署路径。

该开发包实现的功能

该开发包为邮件渠道注册了一个验证扩展以及 Minds 受众评估入口。其评估视图附加在宿主环境中，加载体验内容并要求用户做出明确选择。单体验评估不会静默导出每个生成的变体。

素材或决策	首个开发包的行为
单个选定的邮件体验	读取指定命名的文本字段，并准备完全一致的文案研究输入。
多个生成的变体	要求用户手动选择一个；不进行自动批量传输。
图像与视觉排版	该适配器不导出也不评估此类内容。
法律或合规监管	不提供任何合规认证或合规保证。

扩展在宿主的验证入口点运行。它不会将受众反馈转化为合规认证、广告活动发布批准或品牌政策决策。

选择并批准邮件文案

在完成有权限的部署与注册后，从验证区域打开 Minds 评估视图并生成邮件体验。使用 Select material to review，挑选目标体验；如果素材有误或应保留在宿主中，则点击取消。

适配器会将该体验中的具名字段转换为带标签的文本，完整保留原始文案作为输入。它不会渲染 HTML、抓取视觉排版或导出邮件中的图片。请提出可通过文本回答的问题，例如信息清晰度、相关性、可信度以及对下一步行动的理解。

在生成草稿前，核对所选标签，挑选目标 Study 并批准传输。选择单个体验并不代表允许发送所有变体。同意传输素材也不等于立即执行研究。在实际宿主中确认选择、取消操作以及字段准确性无误之前，请勿将其称为已测试。

预期的 Minds 授权与草稿流程

共享面板会打开原生浏览器 Minds OAuth。批准连接后返回 GenStudio，点击 Refresh Studies 并选择包含 Audience 的现有 Study。输入具体的研究诉求并选择 Study 语言。开发面板使用有边界的 Study 列表，因此如有缺失项，需要检查账户与列表权限范围。

点击 Draft research plan，会将选定的精确文本作为提示词源发送至规范的 Study 预览操作中。检查已保存响应的目标、语言、问题和来源，确保其准确对应所选体验。在当前面板中对未更改输入的重试将复用幂等性标识符。

在 Minds 中打开保存的精确草稿，在明确确认研究前仔细核对素材、问题、Audience 和用量。系统仅会返回该草稿已完成运行的结论。服务商注册和公开市场审核依然是独立的发布门槛。

结论与证据边界

共享面板会请求所选草稿已完成研究运行后的结论。该适配器未实现结论回写功能。预期的初始工作流是展示汇总结论，方便用户决定如何修改邮件文案。在将其描述为已在宿主中测试之前，请先在 GenStudio 中完成验证。

合成受众反馈属于有明确范围的方向性证据。它可以辅助文案探索，但不能代替真实人类观察、代表性估计、法律审查或受监管的法定证据。当决策有严格要求时，请使用专业人员或真人验证。未生成摘要的已保存预览不能视为研究结论。

评估、确认并运行已保存的方案

已保存草稿的工作流会在 Minds 中打开精确的研究方案。网关和私有 Zapier 1.2.0 开发包会返回与该草稿绑定的已完成结论。评估和执行均在 Minds 内进行；公开应用市场的可用性则取决于各服务商的注册与审核进度。请按照以下步骤操作：

从面板中选择 Open Study in Minds，或打开 Zapier 返回的 Review URL。登录创建该草稿的账户。
检查导入的源素材、研究目标、语言、每个问题以及选定的 Audience。确认素材与目标人群与你想要做出的决策完全相符。
回答所有缺失信息或需进一步明确的问题，并保存修改后的方案。再次核对更新后的问题；最终确认仅对该精确版本生效。
在方法允许估算的情况下，查看可用响应额度和预计用量。在执行过程中会生成补充问题的方法不会显示虚假的固定总量。在确认前，请先解决受众缺失、人群为空或账户额度受限等问题。
勾选明确的研究确认框。如果方案使用了高级方法，请查看并接受其独立的许可选项。点击 Confirm and run once。打开链接、导入素材和预览方案均不会自动执行研究。
关注本次运行的状态：排队中（queued）、运行中（running）、已完成（completed）或失败（failed）。重新加载同一草稿会继续其已确认的运行，而不是重复创建新运行。在确认前重新加载则需要重新获取许可。若发生错误，已保存的草稿将被保留以供检查和重试。
返回原始面板并选择 Load findings，或使用 Zapier 的 Get Completed Research Results 查询保存的 Study ID 和 Draft Plan ID。系统仅返回该草稿已确认运行的已完成结果。未完成、失败或缺失的运行不会回退到旧版 Study 摘要。

在研究运行期间，请保持原始面板处于开启状态。其短期连接与草稿选择状态均保存在内存中。重新加载宿主面板或重新连接可能需要重新选择素材并再次起草。即便面板会话结束，已保存的草稿及其已确认的运行仍会保留在 Minds 中。可随时返回 Minds 中的 Study 以查看保留的结果。

权限、数据与会话

扩展通过 Adobe SDK 读取所选体验，并通过 Minds 网关发送经过明确批准的素材。OAuth 令牌保留在网关中，而面板仅在内存中保留一份不透明的短期凭证。试点会话有效期为 1 小时，网关重启后需要重新连接。

请勿在测试体验中包含不必要的个人信息。断开连接会移除网关访问权限，但不会删除已随 Study 草稿保存的文本。请依据 Minds 隐私政策及 Adobe 组织的管控规范管理留存素材。

故障排查与验收

现象	含义及后续步骤
Console 中 Runtime 处于停用状态	缺少必需的组织权限；新建另一个空白项目无法解决该问题。
扩展未显示	请核实具备权限的部署、注册状态以及所选工作区。
无可用体验	在选择素材之前，请先生成邮件体验。
问题依赖视觉排版	该开发包仅读取文本；请在 Minds 中使用支持的视觉输入方式。
网关拒绝该源（Origin）	GenStudio 的确切宿主源尚未被接受并启用。
草稿无法通过交接流程运行	核实相匹配的前端版本和创建者账户；原生 GenStudio 验收仍受权限阻碍。

验收必须涵盖真实注册、体验选择/取消、完全一致文案许可、OAuth 生命周期、来源准确性、重试行为、支持的成本/确认/执行流程、无摘要状态、过期机制以及服务商审核。由于尚未开展有权限的宿主测试，因此不提供 GenStudio 实际运行的截图。