Minds pour GitHub Actions : guide de l'action Research Review

Minds est une plateforme complète pour la recherche synthétique commerciale. L'action Minds Research Review l'intègre aux workflows GitHub : préparez un plan d'Étude vérifiable pour un texte proposé qui se trouve dans votre dépôt, posez une question à une Audience existante, ou récupérez la progression et le résumé d'une Étude dans le résumé du job.

Disponibilité et prérequis

L'action est publiée sous le nom Minds Research Review sur le GitHub Marketplace. Ce guide couvre la version v1.0.0, référencée comme minds-ai-co/minds-research-action@v1. Le code source et le contrat d'entrée complet sont publics dans le dépôt minds-research-action.

Vous avez besoin d'un dépôt GitHub avec Actions activé et d'un compte Minds disposant d'un accès API. L'action appelle le serveur MCP Minds hébergé à l'adresse https://getminds.ai/mcp. Les autorisations API et limites d'utilisation existantes s'appliquent. Elle n'a aucune dépendance d'exécution et ne demande aucune autorisation de jeton GitHub.

Configuration

1. Dans Minds, ouvrez Paramètres → Clés API et créez une clé pour ce dépôt.
2. Dans GitHub, enregistrez la clé comme secret Actions nommé MINDS_API_KEY au niveau du dépôt ou de l'organisation.
3. Ajoutez un workflow qui utilise l'action. Cet exemple prépare un plan pour un texte de page d'accueil proposé, en utilisant l'ID d'Étude stocké dans la variable de dépôt MINDS_PANEL_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. Exécutez le workflow, puis examinez le brouillon enregistré dans Minds et démarrez la recherche depuis Minds lorsqu'elle est prête.

Opérations

Les entrées de l'action utilisent les noms MCP : un Group est une Audience enregistrée et un Panel est une Étude.

La version 1 n'exécute pas de plan d'Étude structuré. La confirmation d'un plan enregistré reste une décision explicite dans Minds. ask-group démarre en revanche une recherche et consomme le quota du compte connecté : ne l'exécutez que lorsque c'est voulu. La question est montrée aux répondants ; n'y mettez pas d'instructions de workflow ou de modèle.

Entrées et sorties

Pour plan-study, placez l'objectif de recherche dans request et le matériel que les répondants doivent voir dans stimulus ou dans stimulus-file, mais pas les deux. Un fichier de stimulus doit rester dans l'espace de travail extrait et est limité à 20 Ko. study-locale accepte en, es, fr, de, zh, tr, ar, ja ou ko.

Chaque exécution écrit un résultat lisible dans le résumé du job GitHub. Les sorties sont result-json (le résultat complet, omis au-delà de 500 Ko), panel-id, draft-plan-id, revision et workspace-url. Utilisez-les dans les étapes suivantes, par exemple pour publier le lien Minds dans une pull request. Les résultats de ask-group arrivent de manière asynchrone : lisez-les lors d'une exécution ultérieure avec get-panel-status ou get-panel-summary.

Sécurité

• Transmettez la clé API uniquement via l'entrée api-key, à partir d'un secret GitHub Actions. L'action la masque et la tient à l'écart des journaux, sorties, résumés et fichiers.
• N'utilisez pas l'action avec pull_request_target pour évaluer du contenu non fiable provenant de forks alors que les secrets du dépôt sont exposés.
• Épinglez les workflows de production sur un tag de version ou un SHA de commit complet.

Dépannage

• Erreur 401 ou d'authentification : vérifiez que le secret contient une clé API Minds valide ; consultez Authentification API.
• Étude ou Audience introuvable : utilisez un ID exact, ou exécutez list-groups pour vérifier les noms d'Audiences enregistrées du compte associé à la clé.
• result-json manquant : le résultat dépassait 500 Ko ; lisez-le dans le résumé du job ou dans Minds.
• Réponses limitées par le forfait ou le débit : vérifiez l'accès API et le quota d'utilisation du compte, et consultez Erreurs et limites de l'API.

Les résultats synthétiques fournissent des indications précoces et directionnelles ; ils ne remplacent pas une recherche représentative auprès de personnes réelles pour les décisions à fort enjeu. Parcourez toutes les intégrations ou consultez la référence des outils MCP.