---
title: "Minds لـ GitHub Actions: دليل إجراء Research Review"
description: "استخدم إجراء Minds Research Review من GitHub Marketplace لتخطيط دراسات قابلة للمراجعة، وطرح سؤال على جمهور، وقراءة النتائج من سير عمل GitHub."
canonical_url: "https://getminds.ai/guide/ar/integration-github-action"
last_updated: "2026-10-02T21:17:15.043Z"
---

# Minds لـ GitHub Actions

Minds منصة متكاملة للبحث التجاري الاصطناعي. يجلب إجراء Minds Research Review هذه المنصة إلى سير عمل GitHub: أعدّ خطة دراسة قابلة للمراجعة لنص مقترح موجود في مستودعك، أو اطرح سؤالاً واحداً على جمهور موجود، أو اجمع تقدم الدراسة وملخصها في ملخص المهمة.

## التوفر والمتطلبات

الإجراء منشور باسم [Minds Research Review في GitHub Marketplace](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).

تحتاج إلى مستودع GitHub مفعّل فيه Actions وإلى حساب Minds يملك صلاحية الوصول إلى API. يستدعي الإجراء [خادم Minds MCP](/mcp/overview) المستضاف على `https://getminds.ai/mcp`. تنطبق صلاحيات API وحدود الاستخدام الحالية. لا يحتوي الإجراء على تبعيات وقت التشغيل ولا يطلب أي صلاحية لرمز GitHub.

## الإعداد

1. في Minds، افتح [الإعدادات ← مفاتيح API](/?settings=api-keys) وأنشئ مفتاحاً لهذا المستودع.
2. في GitHub، احفظ المفتاح كسرّ Actions باسم `MINDS_API_KEY` على مستوى المستودع أو المؤسسة.
3. أضف سير عمل يستخدم الإجراء. يُعدّ هذا المثال خطة لنص مقترح للصفحة الرئيسية، باستخدام معرّف الدراسة المخزّن في متغير المستودع `MINDS_PANEL_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* هو جمهور محفوظ و*Panel* هو دراسة.

<table>
<thead>
  <tr>
    <th>
      العملية
    </th>
    
    <th>
      المدخلات المطلوبة
    </th>
    
    <th>
      التأثير
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        list-groups
      </code>
    </td>
    
    <td>
      لا شيء
    </td>
    
    <td>
      يعرض الجماهير المحفوظة في الحساب. يصفّي <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>
      يحفظ مسودة دراسة قابلة للمراجعة دون بدء البحث.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        ask-group
      </code>
    </td>
    
    <td>
      <code>
        group-id
      </code>
      
       أو <code>
        group-name
      </code>
      
      ، <code>
        question
      </code>
    </td>
    
    <td>
      يبدأ دراسة خاصة وغير متزامنة مع جمهور واحد.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        get-panel-status
      </code>
    </td>
    
    <td>
      <code>
        panel-id
      </code>
      
       أو <code>
        panel-name
      </code>
    </td>
    
    <td>
      يعيد تكوين الدراسة وتقدمها.
    </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 خطة دراسة منظمة. يظل تأكيد الخطة المحفوظة قراراً صريحاً في Minds. أما `ask-group` فيبدأ البحث فعلاً ويستهلك من رصيد الحساب المتصل، لذا شغّله فقط حيث يكون ذلك مقصوداً. يُعرض السؤال على المستجيبين؛ فلا تضع فيه تعليمات سير العمل أو النموذج.

## المدخلات والمخرجات

بالنسبة إلى `plan-study`، ضع هدف البحث في `request` والمادة التي يجب أن يراها المستجيبون في `stimulus` أو `stimulus-file`، وليس في كليهما. يجب أن يبقى ملف المحفّز داخل مساحة العمل المسحوبة، وحده الأقصى 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 فقط عبر المدخل `api-key` من سرّ GitHub Actions. يخفي الإجراء المفتاح ويبقيه خارج السجلات والمخرجات والملخصات والملفات.
- لا تستخدم الإجراء مع `pull_request_target` لتقييم محتوى غير موثوق من نسخ مشتقة (forks) بينما تكون أسرار المستودع مكشوفة.
- ثبّت سير العمل الإنتاجي على وسم إصدار أو على SHA كامل للالتزام.

## استكشاف الأخطاء وإصلاحها

- *خطأ 401 أو خطأ مصادقة:* تأكد من أن السرّ يحتوي على مفتاح Minds API صالح؛ راجع [مصادقة API](/docs/api/authentication).
- *الدراسة أو الجمهور غير موجود:* استخدم معرّفاً دقيقاً، أو شغّل `list-groups` للتحقق من أسماء الجماهير المحفوظة للحساب المرتبط بالمفتاح.
- *result-json مفقود:* تجاوزت النتيجة 500 KB؛ اقرأها من ملخص المهمة أو في Minds.
- *استجابات مقيّدة بالخطة أو بمعدل الطلبات:* تحقق من صلاحية الوصول إلى API ورصيد الاستخدام في الحساب، وراجع [أخطاء API وحدودها](/docs/api/errors).

تقدم النتائج الاصطناعية أدلة مبكرة وتوجيهية؛ ولا تحل محل البحث البشري التمثيلي في القرارات عالية المخاطر. تصفح [جميع التكاملات](/guide/integrations) أو راجع [مرجع أدوات MCP](/mcp/tools).

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



</integration-actions>