--- title: "Minds para GitHub Actions: guía de la acción Research Review" description: "Use la acción Minds Research Review de GitHub Marketplace para planificar Estudios revisables, hacer una pregunta a una Audiencia y leer resultados desde un flujo de trabajo de GitHub." canonical_url: "https://getminds.ai/guide/es/integration-github-action" last_updated: "2026-10-02T21:16:39.079Z" --- # Minds para GitHub Actions Minds es una plataforma integral para la investigación sintética comercial. La acción Minds Research Review la lleva a los flujos de trabajo de GitHub: prepare un plan de Estudio revisable para un texto propuesto que vive en su repositorio, haga una pregunta a una Audiencia existente o recopile el progreso y el resumen de un Estudio en el resumen del job. ## Disponibilidad y requisitos La acción está publicada como [Minds Research Review en GitHub Marketplace](https://github.com/marketplace/actions/minds-research-review). Esta guía cubre la versión `v1.0.0`, referenciada como `minds-ai-co/minds-research-action@v1`. El código fuente y el contrato completo de entradas son públicos en el [repositorio minds-research-action](https://github.com/minds-ai-co/minds-research-action). Necesita un repositorio de GitHub con Actions habilitado y una cuenta de Minds con acceso a la API. La acción llama al [servidor MCP de Minds](/mcp/overview) alojado en `https://getminds.ai/mcp`. Se aplican los permisos de API y los límites de uso existentes. No tiene dependencias en tiempo de ejecución y no solicita ningún permiso del token de GitHub. ## Configuración 1. En Minds, abra [Settings → API Keys](/?settings=api-keys) y cree una clave para este repositorio. 2. En GitHub, guarde la clave como secreto de Actions con el nombre `MINDS_API_KEY` a nivel de repositorio u organización. 3. Añada un flujo de trabajo que use la acción. Este ejemplo prepara un plan para un texto propuesto de página de inicio, usando el ID de Estudio guardado en la variable de repositorio `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. Ejecute el flujo de trabajo, revise el borrador guardado en Minds e inicie allí la investigación cuando esté lista. ## Operaciones Las entradas de la acción usan los nombres de MCP: un *Group* es una Audiencia guardada y un *Panel* es un Estudio.
Operación Entradas obligatorias Efecto
list-groups ninguna Lista las Audiencias guardadas de la cuenta. search-query filtra por nombre.
plan-study (predeterminada) panel-id o panel-name , request Guarda un borrador de Estudio revisable sin iniciar la investigación.
ask-group group-id o group-name , question Inicia un Estudio privado y asíncrono con una Audiencia.
get-panel-status panel-id o panel-name Devuelve la composición y el progreso del Estudio.
get-panel-summary panel-id o panel-name Lee el resumen o lo actualiza con refresh-summary: true .
La versión 1 no ejecuta un plan de Estudio estructurado. Confirmar un plan guardado sigue siendo una decisión explícita en Minds. `ask-group` sí inicia la investigación y consume la asignación de la cuenta conectada, así que úsela solo donde sea intencionado. La pregunta se muestra a los encuestados; no incluya en ella instrucciones del flujo de trabajo o del modelo. ## Entradas y salidas Para `plan-study`, ponga el objetivo de la investigación en `request` y el material que deben ver los encuestados en `stimulus` o en `stimulus-file`, no en ambos. Un archivo de estímulo debe permanecer dentro del espacio de trabajo extraído y está limitado a 20 KB. `study-locale` acepta `en`, `es`, `fr`, `de`, `zh`, `tr`, `ar`, `ja` o `ko`. Cada ejecución escribe un resultado legible en el resumen del job de GitHub. Las salidas son `result-json` (el resultado completo, omitido si supera 500 KB), `panel-id`, `draft-plan-id`, `revision` y `workspace-url`. Úselas en pasos posteriores, por ejemplo para publicar el enlace de Minds en una pull request. Los resultados de `ask-group` llegan de forma asíncrona: léalos en una ejecución posterior con `get-panel-status` o `get-panel-summary`. ## Seguridad - Pase la clave de API solo a través de la entrada `api-key` desde un secreto de GitHub Actions. La acción la enmascara y la mantiene fuera de registros, salidas, resúmenes y archivos. - No use la acción con `pull_request_target` para evaluar contenido no confiable de forks mientras los secretos del repositorio estén expuestos. - Fije los flujos de trabajo de producción a una etiqueta de versión o a un SHA de commit completo. ## Solución de problemas - *Error 401 o de autenticación:* compruebe que el secreto contenga una clave de API de Minds vigente; consulte [Autenticación de la API](/docs/api/authentication). - *Estudio o Audiencia no encontrados:* use un ID exacto o ejecute `list-groups` para comprobar los nombres de las Audiencias guardadas de la cuenta asociada a la clave. - *Falta result-json:* el resultado superó 500 KB; léalo en el resumen del job o en Minds. - *Respuestas limitadas por plan o por tasa:* compruebe el acceso a la API y la asignación de uso de la cuenta, y consulte [Errores y límites de la API](/docs/api/errors). Los hallazgos sintéticos aportan evidencia temprana y orientativa; no sustituyen la investigación representativa con personas para decisiones de alto impacto. Explore [todas las integraciones](/guide/integrations) o consulte la [referencia de herramientas MCP](/mcp/tools).