AI CodeOps

AI CodeOps مع GitHub Copilot

اربط GitHub Copilot بخادم MCP الخاص بـ AI CodeOps في VS Code أو في وكيل Copilot السحابي، وأخضع طلبات السحب للبوابة بفحص الإصدار الذي يستطيع CI لديك استدعاءه.

يعمل GitHub Copilot في محررك، وبصفة وكيل سحابي يفتح طلبات سحب، وبصفة مراجع على GitHub. و AI CodeOps منصة تعمل في المتصفح، يخطط فيها وكلاء الذكاء الاصطناعي للتغيير ويكتبونه ويختبرونه ويراجعونه، ولا يصبح التغيير طلب سحب إلا بعد نجاح بوابات الجودة وموافقة شخص عليه. اربط Copilot بخادم MCP الخاص بـ AI CodeOps، فيستطيع Copilot تسليم مهمة إلى جلسة AI CodeOps خاضعة للبوابات، وقراءة ملاحظاتها، والسؤال هل يجوز إطلاق طلب سحب.

ما يخضعه AI CodeOps لبواباته، وما لا يخضعه

يطبق AI CodeOps بواباته على التغييرات التي تجري في جلساته هو. وحين يعمل وكيل Copilot السحابي على مهمة، يدفع إلى فرعه الخاص ويفتح طلب سحب؛ وتقول وثائق GitHub إنه يخضع لحماية الفروع والفحوص المطلوبة في المستودع، وإنه لا يستطيع الموافقة على طلب السحب الخاص به ولا دمجه (المخاطر ووسائل التخفيف). وذلك الطلب ليس تغييرا من AI CodeOps: لا يراجعه AI CodeOps، ويرفضه فحص الإصدار لأن أي جلسة AI CodeOps لم تنشئه.

لإمرار العمل عبر بوابات AI CodeOps، اجعل Copilot يبدأ جلسة AI CodeOps بالمهمة، أو ابدأها بنفسك في AI CodeOps. فتكتب الجلسة التغيير، وتشغل اختباراتك، وتراجعه بعدة وكلاء، ولا تفتح طلب السحب على فرع codeops/run-<id> إلا حين تنجح البوابة (AI CodeOps مع GitHub).

ربط Copilot في VS Code

  1. في AI CodeOps، أنشئ مفتاح API لمساحة العمل من Configure → API Keys. يبدأ بـ sk- ويعرض مرة واحدة. وليستطيع Copilot بدء الجلسات، اختر Scope على المفتاح وضع علامة على Start sessions from the MCP server (/mcp). راجع مفاتيح API.
  2. أضف الخادم إلى .vscode/mcp.json. تستخدم صيغة VS Code كائنا اسمه servers، ويطلب إدخال inputs المفتاح منك فلا يكتب في الملف أبدا (إعداد MCP في VS Code)، كما يلي:
    {
      "inputs": [
        { "type": "promptString", "id": "aicodeops-key", "description": "AI CodeOps API key", "password": true }
      ],
      "servers": {
        "aicodeops": {
          "type": "http",
          "url": "https://console.aicodeops.dev/mcp",
          "headers": { "Authorization": "Bearer ${input:aicodeops-key}" }
        }
      }
    }
  3. شغّل الخادم من VS Code، الذي يطلب المفتاح، ثم استخدم Copilot في وضع الوكيل (agent mode). فيستطيع استدعاء أدوات AI CodeOps التسع.

ربط وكيل Copilot السحابي

يقرأ الوكيل السحابي إعداد MCP من إعدادات المستودع (توسيع الوكيل السحابي عبر MCP)، بالخطوات التالية:

  1. في المستودع على GitHub، افتح Settings. وضمن Code, planning, and automation، اختر Copilot ثم MCP servers.
  2. أضف سرا من نوع Agents secret اسمه COPILOT_MCP_AICODEOPS_KEY يحمل مفتاح API. ولا يتاح للإعداد إلا الأسرار والمتغيرات التي تبدأ أسماؤها بـ COPILOT_MCP_.
  3. الصق الإعداد التالي في MCP configuration ثم اختر Save MCP configuration، وهذا نصه:
    {
      "mcpServers": {
        "aicodeops": {
          "type": "http",
          "url": "https://console.aicodeops.dev/mcp",
          "headers": { "Authorization": "Bearer $COPILOT_MCP_AICODEOPS_KEY" },
          "tools": ["list_projects", "get_session", "check_release_gate", "list_findings"]
        }
      }
    }

تقول وثائق GitHub إن الحقول النصية في هذا الإعداد، ومنها الترويسات، تستطيع الإشارة إلى أسرار COPILOT_MCP_ بالصيغة $NAME أو ${NAME}. وقائمة tools مطلوبة؛ والمثال لا يسمح إلا بأدوات القراءة، فيستطيع الوكيل السحابي فحص البوابة وقراءة الملاحظات لكنه لا يستطيع بدء الجلسات. وتقول وثائق GitHub أيضا إن مراجعة الكود في Copilot تستطيع استخدام خوادم MCP لجلب سياق إلى المراجعة (مراجعة الكود).

ما تفعله الأدوات

الأداةما تفعلهما يحتاج إليه المفتاح
list_projectsمشاريع مساحة العمل ومستودعاتهاworkspace:read
start_sessionتبدأ جلسة خاضعة للبوابات على مشروع بمهمةworkflow_run:manage
get_sessionحالة الجلسة وخطواتها وطلب السحب والتغييرworkspace:read
check_release_gateهل يجوز إطلاق طلب سحب أو إيداع، مع الأسبابworkspace:read
list_findingsملاحظات الأمان والجودة، حسب الخطورة أو التصنيفworkspace:read
get_evidence_packحزمة الأدلة الموقّعة لتغييرworkspace:audit.read
list_buildsعمليات البناء الأخيرة، وما بدأ كلا منها وكيف انتهتworkspace:read
get_buildعملية بناء واحدة: الخطوة التي فشلت عندها ونهاية مخرجاتهاworkspace:read
list_saved_buildsعمليات البناء التي تحتفظ بها مساحة العمل وما يبدأ كلا منهاworkspace:read

تتصرف كل أداة بصفة منشئ المفتاح، بدوره وميزانيته، كما في لوحة التحكم (دليل خادم MCP).

إخضاع الدمج للبوابة في CI

يستطيع سير عمل GitHub Actions لديك أن يسأل بوابة الإصدار مباشرة وأن يفشل حين ترفض طلب السحب:

- name: Ask the AI CodeOps release gate
  env:
    AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
    PR_URL: ${{ github.event.pull_request.html_url }}
  run: |
    curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
      -H "Authorization: Bearer $AICODEOPS_API_KEY" \
      -H "Content-Type: application/json" \
      -d "{\"pullRequestURL\":\"$PR_URL\"}" > gate.json
    jq -r '.summary' gate.json
    jq -e '.allowed == true' gate.json

اجعل المهمة فحص حالة مطلوبا في حماية الفروع، فلا يدمج طلب سحب إلا بحكم بالسماح. ويشمل ذلك طلبات السحب من وكيل Copilot السحابي، التي ترفضها البوابة لأن أي جلسة AI CodeOps لم تنشئها؛ فاستخدمه على الفروع التي ينبغي أن يكون AI CodeOps فيها هو الطريق إلى الدمج. والحقول، ومنها حد أدنى للتغطية وتراخيص محظورة، موجودة في صفحة API.

الحدود

  • 120 طلب MCP في الدقيقة من العنوان الواحد؛ و 60 فحص إصدار في الدقيقة لكل مساحة عمل.
  • الخادم عديم الحالة ولا يرسل إشعارات، فيستطلع Copilot الأداة get_session دوريا لمتابعة الجلسة.
  • مفاتيح API لمساحة العمل فقط. وتسجيل الدخول عبر OAuth غير مدعوم بعد.

البدء

  1. أنشئ حسابا مجانيا: AI CodeOps في مرحلة بيتا المفتوحة ويعمل في متصفحك.
  2. اربط GitHub وأنشئ مشروعا، مستعينا بدليل البدء السريع.
  3. أنشئ مفتاح API وأضف الخادم إلى VS Code أو إلى الوكيل السحابي كما سبق.

تقارن بدل أن تجمع؟ اقرأ AI CodeOps مقابل مراجعة الكود في GitHub Copilot وAI CodeOps مقابل وكيل البرمجة في GitHub Copilot.

الأسئلة الشائعة

هل يراجع AI CodeOps طلبات السحب التي يفتحها وكيل Copilot السحابي؟

لا. يطبق AI CodeOps بواباته على التغييرات التي تجري في جلساته هو. وطلب السحب الصادر عن Copilot لا يراجعه AI CodeOps، ويرفضه فحص الإصدار لأن أي جلسة AI CodeOps لم تنشئه.

أين أضبط MCP لوكيل Copilot السحابي؟

في Settings الخاصة بالمستودع، ضمن Copilot ثم MCP servers. والأسرار التي يستخدمها الإعداد يجب أن تكون من نوع Agents secrets وأن تبدأ أسماؤها بـ COPILOT_MCP_.

أي أدوات AI CodeOps ينبغي أن يحصل عليها الوكيل السحابي؟

يأخذ إعداد الوكيل السحابي قائمة سماح بالأدوات. ابدأ بأدوات القراءة، مثل check_release_gate و list_findings، ولا تضف start_session إلا إذا أردت أن يسلم Copilot المهام إلى AI CodeOps.

هل يحتاج خادم AI CodeOps إلى OAuth؟

لا. يأخذ مفتاح API لمساحة العمل في ترويسة Authorization Bearer، وهو ما يدعمه كل من VS Code ووكيل Copilot السحابي. وتقول GitHub إن الوكيل السحابي لا يدعم الخوادم البعيدة التي تستخدم OAuth.