Minds für GitHub Actions: Anleitung zur Action Research Review

Minds ist eine End-to-End-Plattform für kommerzielle synthetische Forschung. Die Action Minds Research Review bringt sie in GitHub-Workflows: Bereiten Sie einen prüfbaren Study-Plan für Textentwürfe aus Ihrem Repository vor, stellen Sie einer bestehenden Audience eine Frage oder übernehmen Sie Fortschritt und Zusammenfassung einer Study in die Job-Zusammenfassung.

Verfügbarkeit und Anforderungen

Die Action ist als Minds Research Review im GitHub Marketplace veröffentlicht. Diese Anleitung behandelt Release v1.0.0, referenziert als minds-ai-co/minds-research-action@v1. Der Quellcode und der vollständige Eingabevertrag sind öffentlich im Repository minds-research-action verfügbar.

Sie benötigen ein GitHub-Repository mit aktivierten Actions und ein Minds-Konto mit API-Zugriff. Die Action ruft den gehosteten Minds-MCP-Server unter https://getminds.ai/mcp auf. Bestehende API-Berechtigungen und Nutzungslimits gelten. Sie hat keine Laufzeitabhängigkeiten und fordert keine GitHub-Token-Berechtigung an.

Einrichten

1. Öffnen Sie in Minds Einstellungen → API Keys und erstellen Sie einen Schlüssel für dieses Repository.
2. Speichern Sie den Schlüssel in GitHub als Actions-Secret mit dem Namen MINDS_API_KEY auf Repository- oder Organisationsebene.
3. Fügen Sie einen Workflow hinzu, der die Action verwendet. Dieses Beispiel bereitet einen Plan für einen Entwurf von Homepage-Texten vor und verwendet die in der Repository-Variablen MINDS_PANEL_ID gespeicherte Study-ID:

name: Research review

on:
  workflow_dispatch:

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: minds-ai-co/minds-research-action@v1
        with:
          api-key: ${{ secrets.MINDS_API_KEY }}
          operation: plan-study
          panel-id: ${{ vars.MINDS_PANEL_ID }}
          request: >-
            Prepare a concept test covering clarity, relevance, objections,
            credibility, and concrete improvements.
          stimulus-file: docs/proposed-homepage-copy.md
          stimulus-label: Proposed homepage copy
          study-locale: en

4. Führen Sie den Workflow aus, prüfen Sie anschließend den gespeicherten Entwurf in Minds und starten Sie die Forschung dort, sobald sie bereit ist.

Operationen

Die Eingaben der Action verwenden die MCP-Namen: Eine Group ist eine gespeicherte Audience und ein Panel ist eine Study.

Version 1 führt keinen strukturierten Study-Plan aus. Die Bestätigung eines gespeicherten Plans bleibt eine bewusste Entscheidung in Minds. ask-group startet dagegen Forschung und verbraucht das Kontingent des verbundenen Kontos; führen Sie es daher nur aus, wo das beabsichtigt ist. Die Frage wird den Befragten angezeigt; halten Sie Workflow- oder Modellanweisungen aus ihr heraus.

Eingaben und Ausgaben

Für plan-study gehört das Forschungsziel in request und das Material, das die Befragten sehen sollen, entweder in stimulus oder in stimulus-file, nicht in beide. Eine Stimulus-Datei muss im ausgecheckten Workspace liegen und ist auf 20 KB begrenzt. study-locale akzeptiert en, es, fr, de, zh, tr, ar, ja oder ko.

Jeder Lauf schreibt ein lesbares Ergebnis in die GitHub-Job-Zusammenfassung. Die Ausgaben sind result-json (das vollständige Ergebnis, entfällt bei mehr als 500 KB), panel-id, draft-plan-id, revision und workspace-url. Verwenden Sie sie in späteren Schritten, zum Beispiel um den Minds-Link in einem Pull Request zu posten. Ergebnisse von ask-group treffen asynchron ein: Lesen Sie sie in einem späteren Lauf mit get-panel-status oder get-panel-summary aus.

Sicherheit

• Übergeben Sie den API-Schlüssel nur über die Eingabe api-key aus einem GitHub-Actions-Secret. Die Action maskiert ihn und hält ihn aus Logs, Ausgaben, Zusammenfassungen und Dateien heraus.
• Verwenden Sie die Action nicht mit pull_request_target, um nicht vertrauenswürdige Inhalte aus Forks zu bewerten, während Repository-Secrets offengelegt sind.
• Pinnen Sie produktive Workflows auf ein Release-Tag oder einen vollständigen Commit-SHA.

Fehlerbehebung

• 401 oder Authentifizierungsfehler: Prüfen Sie, ob das Secret einen aktuellen Minds-API-Schlüssel enthält; siehe API-Authentifizierung.
• Study oder Audience nicht gefunden: Verwenden Sie eine exakte ID oder führen Sie list-groups aus, um die gespeicherten Audience-Namen des Kontos hinter dem Schlüssel zu prüfen.
• result-json fehlt: Das Ergebnis war größer als 500 KB; lesen Sie es aus der Job-Zusammenfassung oder in Minds.
• Antworten mit Plan- oder Ratenlimit: Prüfen Sie den API-Zugriff und das Nutzungskontingent des Kontos und lesen Sie API-Fehler und Limits.

Synthetische Ergebnisse liefern frühe, richtungsweisende Evidenz; sie ersetzen keine repräsentative Forschung mit Menschen bei weitreichenden Entscheidungen. Durchsuchen Sie alle Integrationen oder lesen Sie die Referenz der MCP-Tools.