--- title: "Minds für GitHub Actions: Anleitung zur Action Research Review" description: "Nutzen Sie die Action Minds Research Review aus dem GitHub Marketplace, um prüfbare Studies zu planen, einer Audience eine Frage zu stellen und Ergebnisse in einem GitHub-Workflow abzurufen." canonical_url: "https://getminds.ai/guide/de/integration-github-action" last_updated: "2026-10-02T21:16:21.728Z" --- # Minds für GitHub Actions 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](https://github.com/marketplace/actions/minds-research-review) 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](https://github.com/minds-ai-co/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](/mcp/overview) 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](/?settings=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: ```yaml 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 ``` 1. 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.
Operation Erforderliche Eingaben Wirkung
list-groups keine Listet die gespeicherten Audiences des Kontos auf. search-query filtert nach Namen.
plan-study (Standard) panel-id oder panel-name , request Speichert einen prüfbaren Study-Entwurf, ohne Forschung zu starten.
ask-group group-id oder group-name , question Startet eine private, asynchrone Study mit einer Audience.
get-panel-status panel-id oder panel-name Gibt Zusammensetzung und Fortschritt der Study zurück.
get-panel-summary panel-id oder panel-name Liest die Zusammenfassung oder aktualisiert sie mit refresh-summary: true .
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](/docs/api/authentication). - *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](/docs/api/errors). Synthetische Ergebnisse liefern frühe, richtungsweisende Evidenz; sie ersetzen keine repräsentative Forschung mit Menschen bei weitreichenden Entscheidungen. Durchsuchen Sie [alle Integrationen](/guide/integrations) oder lesen Sie die [Referenz der MCP-Tools](/mcp/tools).