Minds para n8n: guía de instalación y flujo de trabajo
Utilice n8n-nodes-minds para preparar e inspeccionar Estudios en n8n autohospedado. La versión 0.1.1 está publicada en npm; la verificación de n8n está bajo revisión. La investigación comienza solo después de una confirmación por separado en Minds.
Minds es una plataforma integral para la investigación sintética comercial. El nodo de la comunidad Minds conecta sus flujos de trabajo de n8n con su API de Study: cree un Study, prepare un plan revisable y recopile resultados existentes para un flujo de trabajo posterior. También puede exponer una operación de Minds como una herramienta para un Agente de IA de n8n.
Disponibilidad y requisitos
El paquete mantenido por Minds n8n-nodes-minds está publicado en npm. Esta guía cubre la versión 0.1.1, la versión actual en npm. La revisión automatizada de n8n fue aprobada; la verificación manual está bajo revisión. Este aún no es un listado verificado y el nodo no está disponible para instalar en n8n Cloud.
Utilice una instancia de n8n autohospedada que permita paquetes de la comunidad, un propietario o administrador que pueda instalarlos y una cuenta de Minds con acceso a la API. Los permisos de API y los límites de uso existentes siguen aplicándose. Usted configura el nodo dentro de n8n; no hay conexión OAuth que establecer en Minds.
Instalación y conexión
- En n8n, abra Settings → Community Nodes → Install.
- Introduzca
[email protected], revise el aviso de código de la comunidad de n8n e instale. Consulte la guía de instalación de n8n si su instancia utiliza un método de instalación diferente. - En Minds, abra Settings → API Keys y cree una clave para esta integración.
- Añada un nodo Minds a un flujo de trabajo de n8n. Cree una credencial de Minds API, pegue la clave en API Key, guárdela y ejecute la prueba de conexión.
- Seleccione Study → Get Many y ejecútelo para confirmar el acceso. Una lista vacía puede significar que la cuenta aún no tiene Estudios.
n8n almacena la clave en su sistema de credenciales cifradas. Mantenga la clave en esa credencial, en lugar de en expresiones de nodo, JSON de flujo de trabajo, prompts o archivos exportados. Las solicitudes se dirigen a https://getminds.ai/api/v1. La prueba de conexión verifica la cuenta de Minds autenticada; consulte API authentication para obtener detalles de acceso.
Operaciones admitidas
Las cinco operaciones utilizan el recurso Study. n8n expone el payload data de la API directamente, por lo que el ID de un Study creado está disponible como {{ $json.id }} en el siguiente nodo.
| Operación | Entradas y comportamiento |
|---|---|
| Get Many | Lista los Estudios accesibles. Establezca Limit de 1 a 100, o habilite Return All para paginación. |
| Create | Requiere Name. Audience IDs acepta IDs separados por comas de Audiencias existentes. Enable Link Sharing está desactivado por defecto; activarlo publica el acceso al Study y sus Audiencias adjuntas. |
| Get | Requiere Study ID; recupera el Study, sus Audiencias, Minds y mensajes. |
| Preview Research Plan | Requiere Study ID y Research Request. Elija Study Locale y suministre el material visible para el encuestado por separado a través de Source Kind, Source Label y Source Content o Source URL. Guarda un borrador del plan sin iniciar la investigación. |
| Get Summary | Requiere Study ID; lee el resumen del Study persistido y los bloques de salida semántica. No genera ni actualiza un resumen faltante. |
Utilice Research Request para instrucciones del planificador, como qué preguntas hacer. Coloque el texto real que los encuestados deben evaluar en Source Content. Source Content está disponible para el tipo de fuente Prompt. Para otros tipos, como un sitio web, una imagen o un video, utilice Source URL con una URL HTTPS pública. Seleccionar un tipo de fuente no carga un archivo local.
Preparar un plan de investigación
- Comience con un Manual Trigger y un nodo de Minds configurado en Study → Create. Introduzca un nombre descriptivo y los IDs de Audience existentes que desea utilizar. Deje el uso compartido de enlaces desactivado a menos que pretenda publicar el acceso.
- Conecte otro nodo de Minds configurado en Preview Research Plan. Utilice
{{ $json.id }}para Study ID. - Establezca Research Request en: “Redacta tres preguntas sobre claridad, relevancia y credibilidad. No ejecutes el Study.” Seleccione el idioma de salida, elija Source Kind Prompt y coloque el mensaje o concepto exacto en Source Content.
- Ejecute el flujo de trabajo una vez. Revise el borrador guardado, las Audiencias, las preguntas y la fuente en Minds, luego confirme explícitamente e inicie la investigación allí.
- En una ejecución posterior del flujo de trabajo, utilice Get con el Study ID guardado para inspeccionar el Study y Get Summary para recopilar un resumen existente. Pase los datos resultantes a sus nodos de informes o notificaciones según corresponda.
Conserve el Study ID entre ejecuciones del flujo de trabajo. Volver a ejecutar Create crea otro Study; no reanuda el anterior. Evite reintentar automáticamente la creación después de un tiempo de espera ambiguo hasta que verifique si tuvo éxito.
Usar Minds como herramienta de Agente de IA
Añada un AI Agent de n8n y un modelo de chat compatible, luego adjunte Minds al conector de herramientas del Agente. Seleccione la credencial de Minds API, el recurso Study y la operación específica que desea exponer. Comience con Get Many o Create y dé a la herramienta una descripción clara.
Por ejemplo: “Crea un borrador de Study llamado Commuter bottle review usando la herramienta Minds configurada. Devuelve su ID. No inicies la investigación.” Establezca Name en la configuración de la herramienta, o utilice el control de parámetros definido por el modelo de n8n para los campos que intencionalmente permite que el Agente elija. Mantenga las credenciales fuera del prompt del modelo y deje el uso compartido de enlaces deshabilitado. La herramienta tiene las mismas cinco operaciones que el nodo regular; añadirla a un Agente no habilita la ejecución de la investigación.
Ejemplos y solución de problemas
Importe los flujos de trabajo de ejemplo a través de Import from File de n8n: listar Estudios, preparar un plan de investigación o leer un resumen de Study. Seleccione su propia credencial después de la importación y rellene los IDs de Audience o Study requeridos.
- Nodo faltante: confirme el nombre exacto del paquete, el estado de instalación y que su instancia autohospedada permite nodos de la comunidad. n8n Cloud no puede instalar este paquete no verificado.
- Prueba de conexión o error 401: verifique que la credencial contenga una clave API de Minds actual y vuelva a probar después de reemplazar una clave revocada.
- Respuesta 403 o limitada por plan: verifique el acceso a la API de la cuenta, los permisos del espacio de trabajo y el límite de uso actual.
- Study no encontrado: utilice un ID devuelto por Get Many para la misma cuenta; un nombre de Study no es su ID.
- Sin resumen: abra el Study en Minds y verifique que la investigación se haya completado y que exista un resumen. Get Summary solo lee la salida persistida.
- Error 429 o error temporal del servicio: reintente las lecturas con backoff y siga API errors and limits. Verifique si ya existe un Study creado antes de reintentar una escritura.
La versión 0.1.1 no crea Audiencias, carga archivos, inicia investigaciones, elimina datos ni proporciona un disparador de eventos de Minds. Para operaciones adicionales, consulte la Study API y la documentación de MCP. Los hallazgos sintéticos proporcionan evidencia direccional; no establecen estimaciones representativas de la población humana.
Explore todas las integraciones o vea el flujo de trabajo de verificación de audiencia de n8n.
