Minds pour n8n : guide d'installation et de workflow
Utilisez n8n-nodes-minds pour préparer et inspecter des Études dans n8n auto-hébergé. La version 0.1.1 est publiée sur npm ; la vérification n8n est en cours d'examen. La recherche ne démarre qu'après une confirmation séparée dans Minds.
Minds est une plateforme complète pour la recherche synthétique commerciale. Le nœud communautaire Minds connecte vos workflows n8n à son API d'Étude : créez une Étude, préparez un plan révisable et collectez les résultats existants pour un workflow en aval. Vous pouvez également exposer une opération Minds en tant qu'outil pour un Agent IA n8n.
Disponibilité et prérequis
Le package maintenu par Minds n8n-nodes-minds est publié sur npm. Ce guide couvre la version 0.1.1, la version actuelle sur npm. L'examen automatisé de n8n est passé ; la vérification manuelle est en cours d'examen. Il ne s'agit pas encore d'une liste vérifiée, et le nœud n'est pas disponible pour une installation sur n8n Cloud.
Utilisez une instance n8n auto-hébergée qui autorise les packages communautaires, un propriétaire ou un administrateur capable de les installer, et un compte Minds avec accès API. Les autorisations API et les limites d'utilisation existantes s'appliquent toujours. Vous configurez le nœud dans n8n ; il n'y a pas de connexion OAuth à établir dans Minds.
Installation et connexion
- Dans n8n, ouvrez Paramètres → Nœuds communautaires → Installer.
- Saisissez
[email protected], examinez l'avis sur le code communautaire de n8n et installez. Consultez le guide d'installation de n8n si votre instance utilise une méthode d'installation différente. - Dans Minds, ouvrez Paramètres → Clés API et créez une clé pour cette intégration.
- Ajoutez un nœud Minds à un workflow n8n. Créez une accréditation Minds API, collez la clé dans API Key, enregistrez-la et exécutez le test de connexion.
- Sélectionnez Study → Get Many et exécutez-le pour confirmer l'accès. Une liste vide peut signifier que le compte n'a pas encore d'Études.
n8n stocke la clé dans son système d'accréditations chiffrées. Gardez la clé dans cette accréditation, plutôt que dans des expressions de nœud, des JSON de workflow, des invites ou des fichiers exportés. Les requêtes sont envoyées à https://getminds.ai/api/v1. Le test de connexion vérifie le compte Minds authentifié ; consultez l'authentification API pour les détails d'accès.
Opérations prises en charge
Toutes les cinq opérations utilisent la ressource Étude. n8n expose directement la charge utile data de l'API, donc l'ID d'une Étude créée est disponible sous la forme {{ $json.id }} dans le nœud suivant.
| Opération | Entrées et comportement |
|---|---|
| Get Many | Liste les Études accessibles. Définissez la Limite de 1 à 100, ou activez Retourner tout pour la pagination. |
| Create | Nécessite un Nom. Les Audience IDs acceptent des ID séparés par des virgules d'Audiences existantes. Activer le partage de lien est désactivé par défaut ; l'activer publie l'accès à l'Étude et à ses Audiences attachées. |
| Get | Nécessite un Study ID ; récupère l'Étude, ses Audiences, Minds et messages. |
| Preview Research Plan | Nécessite un Study ID et une Research Request. Choisissez la Study Locale et fournissez le matériel visible par les répondants séparément via Source Kind, Source Label et Source Content ou Source URL. Enregistre un brouillon de plan sans démarrer la recherche. |
| Get Summary | Nécessite un Study ID ; lit le résumé de l'Étude persisté et les blocs de sortie sémantique. Il ne génère ni ne rafraîchit un résumé manquant. |
Utilisez Research Request pour les instructions de planification telles que les questions à poser. Placez le texte réel que les répondants doivent évaluer dans Source Content. Source Content est disponible pour le type de source Prompt. Pour les autres types, comme un site web, une image ou une vidéo, utilisez Source URL avec une URL HTTPS publique. La sélection d'un type de source ne télécharge pas de fichier local.
Préparer un plan de recherche
- Commencez avec un Déclencheur manuel et un nœud Minds réglé sur Study → Create. Saisissez un nom descriptif et les Audience IDs existants que vous souhaitez utiliser. Laissez le partage de lien désactivé sauf si vous avez l'intention de publier l'accès.
- Connectez un autre nœud Minds réglé sur Preview Research Plan. Utilisez
{{ $json.id }}pour l'Study ID. - Réglez la Research Request sur : « Rédigez trois questions sur la clarté, la pertinence et la crédibilité. Ne lancez pas l'Étude. » Sélectionnez la langue de sortie, choisissez le Source Kind Prompt, et placez le message ou le concept exact dans Source Content.
- Exécutez le workflow une fois. Examinez le brouillon enregistré, les Audiences, les questions et la source dans Minds, puis confirmez explicitement et démarrez la recherche sur place.
- Dans une exécution de workflow ultérieure, utilisez Get avec l'Study ID enregistré pour inspecter l'Étude et Get Summary pour collecter un résumé existant. Transmettez les données résultantes à vos nœuds de rapport ou de notification selon le cas.
Conservez l'Study ID entre les exécutions de workflow. Réexécuter Create crée une autre Étude ; cela ne reprend pas la précédente. Évitez de réessayer automatiquement la création après un délai d'attente ambigu avant de vérifier si elle a réussi.
Utiliser Minds comme outil d'Agent IA
Ajoutez un AI Agent n8n et un modèle de chat compatible, puis attachez Minds au connecteur d'outils de l'Agent. Sélectionnez l'accréditation Minds API, la ressource Étude et l'opération spécifique que vous souhaitez exposer. Commencez par Get Many ou Create et donnez à l'outil une description claire.
Par exemple : « Créez une Étude brouillon nommée Revue de bouteille de banlieusard en utilisant l'outil Minds configuré. Retournez son ID. Ne démarrez pas la recherche. » Définissez le Nom dans la configuration de l'outil, ou utilisez le contrôle de paramètres défini par le modèle de n8n pour les champs que vous laissez intentionnellement l'Agent choisir. Gardez les accréditations hors de l'invite du modèle et laissez le partage de lien désactivé. L'outil dispose des mêmes cinq opérations que le nœud régulier ; l'ajouter à un Agent n'active pas l'exécution de la recherche.
Exemples et dépannage
Importez les exemples de workflows via Importer depuis un fichier de n8n : lister les Études, préparer un plan de recherche ou lire un résumé d'Étude. Sélectionnez votre propre accréditation après l'importation et remplissez les Audience IDs ou d'Étude requis.
- Nœud manquant : confirmez le nom exact du package, le statut d'installation et que votre instance auto-hébergée autorise les nœuds communautaires. n8n Cloud ne peut pas installer ce package non vérifié.
- Test de connexion ou erreur 401 : vérifiez que l'accréditation contient une clé Minds API actuelle et retentez après avoir remplacé une clé révoquée.
- Réponse 403 ou limitée par le plan : vérifiez l'accès API du compte, les autorisations de l'espace de travail et l'allocation d'utilisation actuelle.
- Étude non trouvée : utilisez un ID retourné par Obtenir plusieurs pour le même compte ; un nom d'Étude n'est pas son ID.
- Aucun résumé : ouvrez l'Étude dans Minds et vérifiez que la recherche est terminée et qu'un résumé existe. Obtenir le résumé ne lit que les sorties persistées.
- Erreur 429 ou erreur de service temporaire : réessayez les lectures avec un délai d'attente et suivez les erreurs et limites de l'API. Vérifiez l'existence d'une Étude déjà créée avant de réessayer une écriture.
La version 0.1.1 ne crée pas d'Audiences, ne télécharge pas de fichiers, ne démarre pas de recherche, ne supprime pas de données et ne fournit pas de déclencheur d'événement Minds. Pour des opérations supplémentaires, consultez l'API d'Étude et la documentation MCP. Les résultats synthétiques fournissent des preuves directionnelles ; ils n'établissent pas d'estimations représentatives de la population humaine.
Parcourez toutes les intégrations ou consultez le workflow de vérification d'audience n8n.
