---
title: "GitHub Actions için Minds: Research Review action kılavuzu"
description: "İncelenebilir Çalışmalar planlamak, bir Kitleye soru sormak ve sonuçları bir GitHub iş akışından okumak için GitHub Marketplace'teki Minds Research Review action'ını kullanın."
canonical_url: "https://getminds.ai/guide/tr/integration-github-action"
last_updated: "2026-10-02T21:16:30.253Z"
---

# GitHub Actions için Minds

Minds, ticari sentetik araştırma için uçtan uca bir platformdur. Minds Research Review action'ı onu GitHub iş akışlarına taşır: deponuzda bulunan önerilen bir metin için incelenebilir bir Çalışma planı hazırlayın, mevcut bir Kitleye tek bir soru sorun veya bir Çalışmanın ilerlemesini ve özetini job özetinde toplayın.

## Kullanılabilirlik ve gereksinimler

Action, [GitHub Marketplace'te Minds Research Review](https://github.com/marketplace/actions/minds-research-review) olarak yayınlanmıştır. Bu kılavuz, `minds-ai-co/minds-research-action@v1` olarak referans verilen `v1.0.0` sürümünü kapsar. Kaynak kodu ve eksiksiz girdi sözleşmesi [minds-research-action deposunda](https://github.com/minds-ai-co/minds-research-action) herkese açıktır.

Actions özelliği etkin bir GitHub deposuna ve API erişimi olan bir Minds hesabına ihtiyacınız vardır. Action, `https://getminds.ai/mcp` adresinde barındırılan [Minds MCP sunucusunu](/mcp/overview) çağırır. Mevcut API izinleri ve kullanım limitleri geçerlidir. Çalışma zamanı bağımlılığı yoktur ve hiçbir GitHub token izni istemez.

## Kurulum

1. Minds içinde [Ayarlar → API Anahtarları](/?settings=api-keys) kısmını açın ve bu depo için bir anahtar oluşturun.
2. GitHub'da anahtarı depo veya kuruluş düzeyinde `MINDS_API_KEY` adlı bir Actions gizli anahtarı olarak kaydedin.
3. Action'ı kullanan bir iş akışı ekleyin. Bu örnek, `MINDS_PANEL_ID` depo değişkeninde saklanan Çalışma kimliğini kullanarak önerilen ana sayfa metni için bir plan hazırlar:

```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. İş akışını çalıştırın, ardından kaydedilen taslağı Minds içinde inceleyin ve hazır olduğunda araştırmayı orada başlatın.

## İşlemler

Action'ın girdileri MCP adlarını kullanır: *Group* kaydedilmiş bir Kitle, *Panel* ise bir Çalışmadır.

<table>
<thead>
  <tr>
    <th>
      İşlem
    </th>
    
    <th>
      Zorunlu girdiler
    </th>
    
    <th>
      Etki
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        list-groups
      </code>
    </td>
    
    <td>
      yok
    </td>
    
    <td>
      Hesabın kaydedilmiş Kitlelerini listeler. <code>
        search-query
      </code>
      
       ada göre filtreler.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        plan-study
      </code>
      
       (varsayılan)
    </td>
    
    <td>
      <code>
        panel-id
      </code>
      
       veya <code>
        panel-name
      </code>
      
      , <code>
        request
      </code>
    </td>
    
    <td>
      Araştırmayı başlatmadan incelenebilir bir Çalışma taslağı kaydeder.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        ask-group
      </code>
    </td>
    
    <td>
      <code>
        group-id
      </code>
      
       veya <code>
        group-name
      </code>
      
      , <code>
        question
      </code>
    </td>
    
    <td>
      Tek bir Kitleyle özel, eşzamansız bir Çalışma başlatır.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        get-panel-status
      </code>
    </td>
    
    <td>
      <code>
        panel-id
      </code>
      
       veya <code>
        panel-name
      </code>
    </td>
    
    <td>
      Çalışmanın bileşimini ve ilerlemesini döndürür.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        get-panel-summary
      </code>
    </td>
    
    <td>
      <code>
        panel-id
      </code>
      
       veya <code>
        panel-name
      </code>
    </td>
    
    <td>
      Özeti okur veya <code>
        refresh-summary: true
      </code>
      
       ile yeniler.
    </td>
  </tr>
</tbody>
</table>

Sürüm 1 yapılandırılmış bir Çalışma planını yürütmez. Kaydedilmiş bir planı onaylamak Minds içinde açık bir karar olarak kalır. `ask-group` ise araştırmayı başlatır ve bağlı hesabın kullanım hakkından düşer; bu nedenle yalnızca bilinçli olarak istendiği yerde çalıştırın. Soru katılımcılara gösterilir; iş akışı veya model talimatlarını sorunun dışında tutun.

## Girdiler ve çıktılar

`plan-study` için araştırma hedefini `request` alanına, katılımcıların görmesi gereken materyali ise `stimulus` veya `stimulus-file` alanlarından birine koyun, ikisine birden değil. Bir uyaran dosyası checkout edilen çalışma alanının içinde kalmalıdır ve 20 KB ile sınırlıdır. `study-locale` şu değerleri kabul eder: `en`, `es`, `fr`, `de`, `zh`, `tr`, `ar`, `ja` veya `ko`.

Her çalıştırma, GitHub job özetine okunabilir bir sonuç yazar. Çıktılar şunlardır: `result-json` (tam sonuç, 500 KB'tan büyükse atlanır), `panel-id`, `draft-plan-id`, `revision` ve `workspace-url`. Bunları sonraki adımlarda kullanın, örneğin Minds bağlantısını bir pull request'e yazmak için. `ask-group` sonuçları eşzamansız olarak gelir: bunları sonraki bir çalıştırmada `get-panel-status` veya `get-panel-summary` ile okuyun.

## Güvenlik

- API anahtarını yalnızca bir GitHub Actions gizli anahtarından `api-key` girdisi üzerinden iletin. Action anahtarı maskeler ve günlüklerin, çıktıların, özetlerin ve dosyaların dışında tutar.
- Depo gizli anahtarları açıktayken güvenilmeyen fork içeriğini değerlendirmek için action'ı `pull_request_target` ile kullanmayın.
- Üretim iş akışlarını bir sürüm etiketine veya tam bir commit SHA'sına sabitleyin.

## Sorun giderme

- *401 veya kimlik doğrulama hatası:* gizli anahtarın geçerli bir Minds API anahtarı içerdiğini kontrol edin; [API kimlik doğrulaması](/docs/api/authentication) sayfasına bakın.
- *Çalışma veya Kitle bulunamadı:* tam bir kimlik kullanın veya anahtarın ait olduğu hesabın kaydedilmiş Kitle adlarını kontrol etmek için `list-groups` çalıştırın.
- *result-json eksik:* sonuç 500 KB'ı aştı; job özetinden veya Minds içinden okuyun.
- *Plan veya hız sınırına takılan yanıtlar:* hesabın API erişimini ve kullanım hakkını kontrol edin ve [API hataları ve limitleri](/docs/api/errors) sayfasına bakın.

Sentetik bulgular erken ve yön gösterici kanıt sağlar; yüksek riskli kararlar için temsili insan araştırmasının yerini tutmaz. [Tüm entegrasyonlara](/guide/integrations) göz atın veya [MCP araçları referansına](/mcp/tools) bakın.

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



</integration-actions>