GitHub Actions için Minds: Research Review action kılavuzu

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

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

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ı 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 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 göz atın veya MCP araçları referansına bakın.