---
title: "GitHub Actions용 Minds: Research Review 액션 가이드"
description: "GitHub Marketplace의 Minds Research Review 액션으로 검토 가능한 Study를 계획하고, Audience에게 질문하고, GitHub 워크플로에서 결과를 읽어 오세요."
canonical_url: "https://getminds.ai/guide/ko/integration-github-action"
last_updated: "2026-10-02T21:16:30.629Z"
---

# GitHub Actions용 Minds

Minds는 상업용 합성 리서치를 위한 엔드투엔드 플랫폼입니다. Minds Research Review 액션은 Minds를 GitHub 워크플로로 가져옵니다. 저장소에 있는 제안 문구에 대해 검토 가능한 Study 계획을 준비하거나, 기존 Audience에게 질문 하나를 하거나, 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 키(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입니다.

<table>
<thead>
  <tr>
    <th>
      작업
    </th>
    
    <th>
      필수 입력
    </th>
    
    <th>
      효과
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        list-groups
      </code>
    </td>
    
    <td>
      없음
    </td>
    
    <td>
      계정에 저장된 Audience를 나열합니다. <code>
        search-query
      </code>
      
      로 이름을 필터링합니다.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        plan-study
      </code>
      
      (기본값)
    </td>
    
    <td>
      <code>
        panel-id
      </code>
      
       또는 <code>
        panel-name
      </code>
      
      , <code>
        request
      </code>
    </td>
    
    <td>
      리서치를 시작하지 않고 검토 가능한 Study 초안을 저장합니다.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        ask-group
      </code>
    </td>
    
    <td>
      <code>
        group-id
      </code>
      
       또는 <code>
        group-name
      </code>
      
      , <code>
        question
      </code>
    </td>
    
    <td>
      Audience 하나를 대상으로 비공개 비동기 Study를 시작합니다.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        get-panel-status
      </code>
    </td>
    
    <td>
      <code>
        panel-id
      </code>
      
       또는 <code>
        panel-name
      </code>
    </td>
    
    <td>
      Study의 구성과 진행 상황을 반환합니다.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        get-panel-summary
      </code>
    </td>
    
    <td>
      <code>
        panel-id
      </code>
      
       또는 <code>
        panel-name
      </code>
    </td>
    
    <td>
      요약을 읽거나 <code>
        refresh-summary: true
      </code>
      
      로 새로 고칩니다.
    </td>
  </tr>
</tbody>
</table>

버전 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)를 참고하세요.

<integration-actions integration-id="github_action">



</integration-actions>