Minds لـ GitHub Actions: دليل إجراء Research Review

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

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

الإجراء منشور باسم Minds Research Review في GitHub Marketplace. يغطي هذا الدليل الإصدار v1.0.0، المشار إليه بـ minds-ai-co/minds-research-action@v1. الكود المصدري وعقد المدخلات الكامل متاحان للعموم في مستودع minds-research-action.

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

الإعداد

1. في Minds، افتح الإعدادات ← مفاتيح API وأنشئ مفتاحاً لهذا المستودع.
2. في GitHub، احفظ المفتاح كسرّ Actions باسم MINDS_API_KEY على مستوى المستودع أو المؤسسة.
3. أضف سير عمل يستخدم الإجراء. يُعدّ هذا المثال خطة لنص مقترح للصفحة الرئيسية، باستخدام معرّف الدراسة المخزّن في متغير المستودع MINDS_PANEL_ID:

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. شغّل سير العمل، ثم راجع المسودة المحفوظة في Minds وابدأ البحث هناك عندما تكون جاهزة.

العمليات

تستخدم مدخلات الإجراء تسميات MCP: Group هو جمهور محفوظ وPanel هو دراسة.

لا يشغّل الإصدار 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.
• الدراسة أو الجمهور غير موجود: استخدم معرّفاً دقيقاً، أو شغّل list-groups للتحقق من أسماء الجماهير المحفوظة للحساب المرتبط بالمفتاح.
• result-json مفقود: تجاوزت النتيجة 500 KB؛ اقرأها من ملخص المهمة أو في Minds.
• استجابات مقيّدة بالخطة أو بمعدل الطلبات: تحقق من صلاحية الوصول إلى API ورصيد الاستخدام في الحساب، وراجع أخطاء API وحدودها.

تقدم النتائج الاصطناعية أدلة مبكرة وتوجيهية؛ ولا تحل محل البحث البشري التمثيلي في القرارات عالية المخاطر. تصفح جميع التكاملات أو راجع مرجع أدوات MCP.