--- title: "Minds pour GitHub Actions : guide de l'action Research Review" description: "Utilisez l'action Minds Research Review du GitHub Marketplace pour planifier des Études vérifiables, poser une question à une Audience et lire les résultats depuis un workflow GitHub." canonical_url: "https://getminds.ai/guide/fr/integration-github-action" last_updated: "2026-10-02T21:17:14.928Z" --- # Minds pour GitHub Actions 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](https://github.com/marketplace/actions/minds-research-review). 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](https://github.com/minds-ai-co/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](/mcp/overview) 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](/?settings=api-keys) 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` : ```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. 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.
Opération Entrées requises Effet
list-groups aucune Liste les Audiences enregistrées du compte. search-query filtre par nom.
plan-study (par défaut) panel-id ou panel-name , request Enregistre un brouillon d'Étude vérifiable sans démarrer de recherche.
ask-group group-id ou group-name , question Démarre une Étude privée et asynchrone avec une Audience.
get-panel-status panel-id ou panel-name Renvoie la composition et la progression de l'Étude.
get-panel-summary panel-id ou panel-name Lit le résumé, ou l'actualise avec refresh-summary: true .
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](/docs/api/authentication). - *É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](/docs/api/errors). 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](/guide/integrations) ou consultez la [référence des outils MCP](/mcp/tools).