Minds para GitHub Actions: guía de la acción Research Review

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. 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.

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 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 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:

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. 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.

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.
• 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.

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 o consulte la referencia de herramientas MCP.