Minds für n8n: Installations- und Workflow-Anleitung
Verwenden Sie n8n-nodes-minds, um Studies in selbst gehostetem n8n vorzubereiten und zu prüfen. Version 0.1.1 ist auf npm veröffentlicht; die n8n-Verifizierung wird geprüft. Die Forschung beginnt erst nach einer separaten Bestätigung in Minds.
Minds ist eine End-to-End-Plattform für kommerzielle synthetische Forschung. Der Minds-Community-Node verbindet Ihre n8n-Workflows mit der Study API: Erstellen Sie eine Study, bereiten Sie einen prüfbaren Plan vor und sammeln Sie vorhandene Ergebnisse für einen nachgelagerten Workflow. Sie können eine Minds-Operation auch als Tool für einen n8n AI Agent bereitstellen.
Verfügbarkeit und Anforderungen
Das von Minds gepflegte Paket n8n-nodes-minds ist auf npm veröffentlicht. Diese Anleitung behandelt Version 0.1.1, das aktuelle npm-Release. Die automatisierte n8n-Überprüfung war erfolgreich; die manuelle Verifizierung wird derzeit geprüft. Dies ist noch kein verifizierter Eintrag, und der Node ist für die Installation auf n8n Cloud nicht verfügbar.
Verwenden Sie eine selbst gehostete n8n-Instanz, die Community-Pakete zulässt, einen Inhaber oder Administrator, der diese installieren kann, sowie ein Minds-Konto mit API-Zugriff. Bestehende API-Berechtigungen und Nutzungslimits gelten weiterhin. Sie konfigurieren den Node innerhalb von n8n; es gibt keine OAuth-Verbindung, die in Minds hergestellt werden muss.
Installieren und verbinden
- Öffnen Sie in n8n Einstellungen → Community Nodes → Installieren.
- Geben Sie
[email protected]ein, prüfen Sie den Hinweis von n8n zu Community-Code und installieren Sie ihn. Siehe n8n-Installationsanleitung, falls Ihre Instanz eine andere Installationsmethode verwendet. - Öffnen Sie in Minds Einstellungen → API Keys und erstellen Sie einen Schlüssel für diese Integration.
- Fügen Sie einen Minds-Node zu einem n8n-Workflow hinzu. Erstellen Sie eine Minds API-Berechtigung, fügen Sie den Schlüssel in API Key ein, speichern Sie ihn und führen Sie den Verbindungstest aus.
- Wählen Sie Study → Get Many und führen Sie ihn aus, um den Zugriff zu bestätigen. Eine leere Liste kann bedeuten, dass das Konto noch keine Studies hat.
n8n speichert den Schlüssel in seinem verschlüsselten Berechtigungssystem. Bewahren Sie den Schlüssel in dieser Berechtigung auf, anstatt in Node-Ausdrücken, Workflow-JSON, Prompts oder exportierten Dateien. Anfragen gehen an https://getminds.ai/api/v1. Der Verbindungstest prüft das authentifizierte Minds-Konto; siehe API-Authentifizierung für Zugriffsdetails.
Unterstützte Operationen
Alle fünf Operationen verwenden die Study-Ressource. n8n stellt das data-Payload der API direkt bereit, sodass die ID einer erstellten Study als {{ $json.id }} im folgenden Node verfügbar ist.
| Operation | Eingaben und Verhalten |
|---|---|
| Get Many | Listet zugängliche Studies auf. Legen Sie Limit von 1 bis 100 fest oder aktivieren Sie Return All für Paginierung. |
| Create | Erfordert Name. Audience IDs akzeptiert kommagetrennte IDs bestehender Audiences. Link Sharing aktivieren ist standardmäßig aus; das Einschalten veröffentlicht den Zugriff auf die Study und ihre zugehörigen Audiences. |
| Get | Erfordert Study ID; ruft die Study, ihre Audiences, Minds und Nachrichten ab. |
| Preview Research Plan | Erfordert Study ID und Research Request. Wählen Sie Study Locale und stellen Sie das für die Befragten sichtbare Material separat über Source Kind, Source Label und Source Content oder Source URL bereit. Speichert einen Planentwurf, ohne die Forschung zu starten. |
| Get Summary | Erfordert Study ID; liest die gespeicherte Study-Zusammenfassung und semantische Ausgabeblöcke. Es generiert oder aktualisiert keine fehlende Zusammenfassung. |
Verwenden Sie Research Request für Anweisungen an den Planer, wie z. B. welche Fragen gestellt werden sollen. Fügen Sie den tatsächlichen Text, den die Befragten bewerten sollen, in Source Content ein. Source Content ist für den Quelltyp Prompt verfügbar. Für andere Typen, etwa eine Website, ein Bild oder ein Video, verwenden Sie Source URL mit einer öffentlichen HTTPS-URL. Die Auswahl eines Quelltyps lädt keine lokale Datei hoch.
Einen Forschungsplan vorbereiten
- Beginnen Sie mit einem Manual Trigger und einem Minds-Node, der auf Study → Create eingestellt ist. Geben Sie einen beschreibenden Namen und die vorhandenen Audience IDs ein, die Sie verwenden möchten. Lassen Sie Link Sharing aus, es sei denn, Sie beabsichtigen, den Zugriff zu veröffentlichen.
- Verbinden Sie einen weiteren Minds-Node, der auf Preview Research Plan eingestellt ist. Verwenden Sie
{{ $json.id }}für die Study ID. - Setzen Sie Research Request auf: „Entwirf drei Fragen zu Klarheit, Relevanz und Glaubwürdigkeit. Starte die Study nicht.“ Wählen Sie die Ausgabesprache, wählen Sie Source Kind Prompt und fügen Sie die genaue Nachricht oder das Konzept in Source Content ein.
- Führen Sie den Workflow einmal aus. Überprüfen Sie den gespeicherten Entwurf, die Audiences, Fragen und die Quelle in Minds und bestätigen und starten Sie die Forschung dann explizit dort.
- Verwenden Sie in einer späteren Workflow-Ausführung Get mit der gespeicherten Study ID, um die Study zu prüfen, und Get Summary, um eine vorhandene Zusammenfassung zu sammeln. Leiten Sie die resultierenden Daten gegebenenfalls an Ihre Berichts- oder Benachrichtigungs-Nodes weiter.
Behalten Sie die Study ID zwischen Workflow-Ausführungen bei. Ein erneutes Ausführen von Create erstellt eine weitere Study; es setzt die frühere nicht fort. Vermeiden Sie es, die Erstellung nach einer unklaren Zeitüberschreitung automatisch zu wiederholen, bis Sie geprüft haben, ob sie erfolgreich war.
Minds als AI Agent-Tool verwenden
Fügen Sie einen n8n AI Agent und ein kompatibles Chat-Modell hinzu und verbinden Sie dann Minds mit dem Tool-Connector des Agents. Wählen Sie die Minds API-Berechtigung, die Study-Ressource und die spezifische Operation aus, die Sie bereitstellen möchten. Beginnen Sie mit Get Many oder Create und geben Sie dem Tool eine klare Beschreibung.
Zum Beispiel: „Erstelle eine Entwurfs-Study namens Commuter bottle review mit dem konfigurierten Minds-Tool. Gib die ID zurück. Starte die Forschung nicht.“ Legen Sie den Namen in der Tool-Konfiguration fest oder verwenden Sie die modelldefinierte Parametersteuerung von n8n für Felder, die der Agent auswählen darf. Halten Sie Berechtigungen aus dem Modell-Prompt fern und lassen Sie Link Sharing deaktiviert. Das Tool verfügt über dieselben fünf Operationen wie der reguläre Node; das Hinzufügen zu einem Agent ermöglicht keine Forschungsausführung.
Beispiele und Fehlerbehebung
Importieren Sie die Beispiel-Workflows über Import from File in n8n: Studies auflisten, Forschungsplan vorbereiten oder Study-Zusammenfassung lesen. Wählen Sie nach dem Import Ihre eigene Berechtigung aus und füllen Sie die erforderlichen Audience- oder Study-IDs aus.
- Node fehlt: Bestätigen Sie den genauen Paketnamen, den Installationsstatus und dass Ihre selbst gehostete Instanz Community-Nodes zulässt. n8n Cloud kann dieses unverifizierte Paket nicht installieren.
- Verbindungstest oder 401-Fehler: Prüfen Sie, ob die Berechtigung einen aktuellen Minds API-Schlüssel enthält, und testen Sie erneut, nachdem Sie einen widerrufenen Schlüssel ersetzt haben.
- 403 oder plan-limitierte Antwort: Prüfen Sie den API-Zugriff des Kontos, die Workspace-Berechtigungen und das aktuelle Nutzungskontingent.
- Study nicht gefunden: Verwenden Sie eine ID, die von Get Many für dasselbe Konto zurückgegeben wurde; ein Study-Name ist nicht seine ID.
- Keine Zusammenfassung: Öffnen Sie die Study in Minds und prüfen Sie, ob die Forschung abgeschlossen ist und eine Zusammenfassung existiert. Get Summary liest nur gespeicherte Ausgaben.
- 429 oder temporärer Servicefehler: Wiederholen Sie Lesezugriffe mit Backoff und befolgen Sie API-Fehler und Limits. Prüfen Sie vor dem Wiederholen eines Schreibvorgangs, ob bereits eine Study erstellt wurde.
Version 0.1.1 erstellt keine Audiences, lädt keine Dateien hoch, startet keine Forschung, löscht keine Daten und bietet keinen Minds-Event-Trigger. Für weitere Operationen konsultieren Sie die Study API und die MCP-Dokumentation. Synthetische Ergebnisse liefern richtungsweisende Erkenntnisse; sie stellen keine repräsentativen Schätzungen der menschlichen Bevölkerung dar.
Durchsuchen Sie alle Integrationen oder sehen Sie sich den n8n audience-check Workflow an.
