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
- في AI CodeOps، أنشئ مفتاح API لمساحة العمل من Configure → API Keys. يبدأ بـ
sk-ويعرض مرة واحدة. وليستطيع Copilot بدء الجلسات، اختر Scope على المفتاح وضع علامة على Start sessions from the MCP server (/mcp). راجع مفاتيح API. - أضف الخادم إلى
.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}" } } } } - شغّل الخادم من VS Code، الذي يطلب المفتاح، ثم استخدم Copilot في وضع الوكيل (agent mode). فيستطيع استدعاء أدوات AI CodeOps التسع.
ربط وكيل Copilot السحابي
يقرأ الوكيل السحابي إعداد MCP من إعدادات المستودع (توسيع الوكيل السحابي عبر MCP)، بالخطوات التالية:
- في المستودع على GitHub، افتح Settings. وضمن Code, planning, and automation، اختر Copilot ثم MCP servers.
- أضف سرا من نوع Agents secret اسمه
COPILOT_MCP_AICODEOPS_KEYيحمل مفتاح API. ولا يتاح للإعداد إلا الأسرار والمتغيرات التي تبدأ أسماؤها بـCOPILOT_MCP_. - الصق الإعداد التالي في 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 غير مدعوم بعد.
البدء
- أنشئ حسابا مجانيا: AI CodeOps في مرحلة بيتا المفتوحة ويعمل في متصفحك.
- اربط GitHub وأنشئ مشروعا، مستعينا بدليل البدء السريع.
- أنشئ مفتاح 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.