--- title: "Minds for GitHub Actions: Research Review アクションガイド" description: "GitHub Marketplace の Minds Research Review アクションを使って、レビュー可能な Study を計画し、Audience に質問し、GitHub ワークフローから結果を読み取ります。" canonical_url: "https://getminds.ai/guide/ja/integration-github-action" last_updated: "2026-10-02T21:16:38.321Z" --- # Minds for GitHub Actions Minds は、商用の合成リサーチのためのエンドツーエンドプラットフォームです。Minds Research Review アクションは Minds を GitHub ワークフローに組み込みます。リポジトリ内の提案コピーに対してレビュー可能な Study プランを準備したり、既存の Audience に 1 つの質問をしたり、Study の進捗とサマリーをジョブサマリーにまとめたりできます。 ## 提供状況と要件 このアクションは [GitHub Marketplace の Minds Research Review](https://github.com/marketplace/actions/minds-research-review) として公開されています。このガイドはリリース `v1.0.0` を対象とし、`minds-ai-co/minds-research-action@v1` として参照します。ソースコードと入力仕様の全体は [minds-research-action リポジトリ](https://github.com/minds-ai-co/minds-research-action)で公開されています。 Actions が有効な GitHub リポジトリと、API アクセス権のある Minds アカウントが必要です。アクションは `https://getminds.ai/mcp` のホスト型 [Minds MCP サーバー](/mcp/overview)を呼び出します。既存の API 権限と利用上限が適用されます。ランタイム依存関係はなく、GitHub トークンの権限も要求しません。 ## セットアップ 1. Minds で [Settings → API Keys](/?settings=api-keys) を開き、このリポジトリ用のキーを作成します。 2. GitHub で、そのキーをリポジトリまたは組織レベルの Actions シークレット `MINDS_API_KEY` として保存します。 3. アクションを使うワークフローを追加します。次の例では、リポジトリ変数 `MINDS_PANEL_ID` に保存した 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. ワークフローを実行し、保存されたドラフトを Minds で確認して、準備ができたらそこでリサーチを開始します。 ## 操作 アクションの入力には MCP の名称が使われています。*Group* は保存済みの Audience、*Panel* は Study を指します。
操作 必須入力 効果
list-groups なし アカウントの保存済み Audience を一覧表示します。 search-query で名前を絞り込めます。
plan-study （デフォルト） panel-id または panel-name 、 request リサーチを開始せずに、レビュー可能な Study ドラフトを保存します。
ask-group group-id または group-name 、 question 1 つの Audience を対象に、非公開の非同期 Study を開始します。
get-panel-status panel-id または panel-name Study の構成と進捗を返します。
get-panel-summary panel-id または panel-name サマリーを読み取るか、 refresh-summary: true で更新します。
バージョン 1 は構造化された Study プランを実行しません。保存したプランの確定は、引き続き Minds 上での明示的な判断です。`ask-group` はリサーチを開始し、接続したアカウントの利用枠を消費するため、それが意図されている場合にのみ実行してください。質問は回答者に表示されるので、ワークフローやモデルへの指示は含めないでください。 ## 入力と出力 `plan-study` では、リサーチの目的を `request` に、回答者に見せる素材を `stimulus` または `stimulus-file` のどちらか一方に入れます。両方は指定できません。stimulus ファイルはチェックアウトしたワークスペース内にある必要があり、上限は 20 KB です。`study-locale` には `en`、`es`、`fr`、`de`、`zh`、`tr`、`ar`、`ja`、`ko` を指定できます。 実行のたびに、読みやすい結果が GitHub のジョブサマリーに書き込まれます。出力は `result-json`（結果全体。500 KB を超える場合は省略）、`panel-id`、`draft-plan-id`、`revision`、`workspace-url` です。後続のステップで利用でき、たとえばプルリクエストに Minds のリンクを投稿できます。`ask-group` の結果は非同期で届くため、後の実行で `get-panel-status` または `get-panel-summary` を使って読み取ってください。 ## セキュリティ - API キーは GitHub Actions のシークレットから `api-key` 入力経由でのみ渡してください。アクションはキーをマスクし、ログ、出力、サマリー、ファイルに残しません。 - リポジトリのシークレットが公開される状態で、信頼できないフォークのコンテンツを評価するために `pull_request_target` でこのアクションを使用しないでください。 - 本番のワークフローは、リリースタグまたは完全なコミット SHA に固定してください。 ## トラブルシューティング - *401 または認証エラー:* シークレットに有効な Minds API キーが入っているか確認してください。[API 認証](/docs/api/authentication)を参照してください。 - *Study または Audience が見つからない:* 正確な ID を使うか、`list-groups` を実行して、キーに紐づくアカウントの保存済み Audience 名を確認してください。 - *result-json がない:* 結果が 500 KB を超えています。ジョブサマリーまたは Minds で確認してください。 - *プラン制限またはレート制限の応答:* アカウントの API アクセスと利用枠を確認し、[API エラーと制限](/docs/api/errors)を参照してください。 合成リサーチの結果は初期段階の方向性を示すエビデンスであり、重要な意思決定において代表性のある人間を対象としたリサーチに代わるものではありません。[すべての連携](/guide/integrations)を見るか、[MCP ツールリファレンス](/mcp/tools)を参照してください。