Minds for n8n：安装与工作流指南
使用 n8n-nodes-minds 在自托管 n8n 中准备和检查 Study。0.1.1 版本已发布在 npm 上；n8n 验证正在审核中。研究仅在 Minds 中进行单独确认后才会开始。
Minds 是一个用于商业合成研究的端到端平台。Minds 社区节点将您的 n8n 工作流连接到其 Study API：创建 Study，准备可供审核的计划，并为下游工作流收集现有结果。您还可以将 Minds 操作作为工具公开给 n8n AI Agent。
可用性与要求
Minds 维护的包 n8n-nodes-minds 已发布在 npm 上。本指南涵盖 0.1.1 版本，即 npm 上的当前版本。自动 n8n 审核已通过；人工验证正在审核中。此列表尚未经过验证，且该节点目前无法在 n8n Cloud 上安装。
请使用允许社区包的自托管 n8n 实例、能够安装它们的所有者或管理员，以及具有 API 访问权限的 Minds 账户。现有的 API 权限和使用限制仍然适用。您在 n8n 内部配置节点；无需在 Minds 中建立 OAuth 连接。
安装与连接
- 在 n8n 中，打开 Settings → Community Nodes → Install。
- 输入
[email protected]，查看 n8n 的社区代码通知并安装。如果您的实例使用不同的安装方法，请参阅 n8n 的安装指南。 - 在 Minds 中，打开 Settings → API Keys 并为此集成创建一个密钥。
- 将 Minds 节点添加到 n8n 工作流。创建 Minds API 凭据，将密钥粘贴到 API Key 中，保存并运行连接测试。
- 选择 Study → Get Many 并执行它以确认访问权限。列表为空可能意味着该账户尚无 Study。
n8n 将密钥存储在其加密凭据系统中。请将密钥保留在该凭据中，而不是节点表达式、工作流 JSON、提示词或导出的文件中。请求发送至 https://getminds.ai/api/v1。连接测试会检查已认证的 Minds 账户；有关访问详情，请参阅 API 认证。
支持的操作
所有五个操作均使用 Study 资源。n8n 直接公开 API 的 data 负载，因此创建的 Study 的 ID 可在后续节点中作为 {{ $json.id }} 使用。
| 操作 | 输入与行为 |
|---|---|
| Get Many | 列出可访问的 Study。将 Limit 设置为 1 到 100，或启用 Return All 进行分页。 |
| Create | 需要 Name。Audience IDs 接受以逗号分隔的现有 Audience ID。Enable Link Sharing 默认关闭；开启它将发布对 Study 及其关联 Audience 的访问权限。 |
| Get | 需要 Study ID；检索 Study、其 Audience、Minds 和消息。 |
| Preview Research Plan | 需要 Study ID 和 Research Request。选择 Study Locale 并通过 Source Kind、Source Label 和 Source Content 或 Source URL 分别提供受访者可见的材料。保存计划草稿而不开始研究。 |
| Get Summary | 需要 Study ID；读取已持久化的 Study 摘要和语义输出块。它不会生成或刷新缺失的摘要。 |
使用 Research Request 进行规划器指令，例如要询问的问题。将受访者应评估的实际文案放入 Source Content。Source Content 适用于 Prompt 源类型。对于网站、图像或视频等其他类型，请使用带有公共 HTTPS URL 的 Source URL。选择源类型不会上传本地文件。
准备研究计划
- 从 Manual Trigger 和设置为 Study → Create 的 Minds 节点开始。输入描述性名称和您想要使用的现有 Audience ID。除非您打算发布访问权限，否则请保持链接共享关闭。
- 连接另一个设置为 Preview Research Plan 的 Minds 节点。使用
{{ $json.id }}作为 Study ID。 - 将 Research Request 设置为：“起草三个关于清晰度、相关性和可信度的问题。不要运行 Study。”选择输出语言，选择 Source Kind Prompt，并将确切的消息或概念放入 Source Content。
- 运行一次工作流。在 Minds 中查看保存的草稿、Audience、问题和源，然后明确确认并在那里开始研究。
- 在后续的工作流执行中，使用带有已保存 Study ID 的 Get 来检查 Study，并使用 Get Summary 来收集现有摘要。将生成的数据传递给您的报告或通知节点。
在工作流执行之间保留 Study ID。重新运行 Create 会创建另一个 Study；它不会恢复之前的 Study。在检查是否成功之前，请避免在模糊的超时后自动重试创建。
将 Minds 作为 AI Agent 工具使用
添加一个 n8n AI Agent 和兼容的聊天模型，然后将 Minds 附加到 Agent 的工具连接器。选择 Minds API 凭据、Study 资源以及您想要公开的特定操作。从 Get Many 或 Create 开始，并为工具提供清晰的描述。
例如：“使用配置的 Minds 工具创建一个名为 Commuter bottle review 的草稿 Study。返回其 ID。不要开始研究。”在工具配置中设置 Name，或者为您有意让 Agent 选择的字段使用 n8n 的模型定义参数控制。将凭据排除在模型提示词之外，并保持链接共享禁用。该工具具有与常规节点相同的五个操作；将其添加到 Agent 不会启用研究执行。
示例与故障排除
通过 n8n 的 Import from File 导入 示例工作流：列出 Study、准备研究计划或读取 Study 摘要。导入后选择您自己的凭据并填写所需的 Audience 或 Study ID。
- 节点缺失： 确认确切的包名称、安装状态，以及您的自托管实例是否允许社区节点。n8n Cloud 无法安装此未验证的包。
- 连接测试或 401 错误： 检查凭据是否包含当前的 Minds API 密钥，并在替换已撤销的密钥后重新测试。
- 403 或计划限制响应： 检查账户的 API 访问权限、工作区权限和当前使用限额。
- 未找到 Study： 使用同一账户下 Get Many 返回的 ID；Study 名称不是其 ID。
- 无摘要： 在 Minds 中打开 Study，检查研究是否已完成且存在摘要。Get Summary 仅读取已持久化的输出。
- 429 或临时服务错误： 使用退避策略重试读取，并遵循 API 错误与限制。在重试写入之前，检查是否已创建 Study。
0.1.1 版本不会创建 Audience、上传文件、开始研究、删除数据或提供 Minds 事件触发器。有关其他操作，请查阅 Study API 和 MCP 文档。合成研究结果提供方向性证据；它们不建立具有代表性的人类群体估计。
浏览 所有集成 或查看 n8n 受众检查工作流。
