AI CodeOps

AI CodeOps مع OpenAI Codex

أضف خادم MCP لـ AI CodeOps إلى Codex في config.toml: ابدأ جلسات ذكاء اصطناعي خاضعة للبوابات، واقرأ الملاحظات، وافحص بوابة الإصدار من Codex CLI أو إضافة IDE.

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

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

يطبق AI CodeOps بواباته على التغييرات التي تجري في جلساته هو. وحين تنتهي مهمة Codex السحابية، يمكنك الإيداع أو فتح طلب سحب منها (Codex cloud)، وعلى GitHub يمكنك أن تطلب من Codex مراجعة طلب سحب بـ @codex review (Codex على GitHub). وتلك طلبات سحب عادية: لا يراجعها AI CodeOps، ويرفضها فحص الإصدار لأن أي جلسة AI CodeOps لم تنشئها.

لإمرار العمل عبر بوابات AI CodeOps، اطلب من Codex أن يبدأ جلسة AI CodeOps بالمهمة. فتكتب الجلسة التغيير، وتشغل اختباراتك، وتراجعه بعدة وكلاء، ولا تفتح طلب السحب إلا حين تنجح البوابة. أو اسأل بوابة الإصدار قبل الدمج، من Codex أو من CI.

ربط Codex

  1. في AI CodeOps، أنشئ مفتاح API لمساحة العمل من Configure → API Keys. يبدأ بـ sk- ويعرض مرة واحدة. وليستطيع Codex بدء الجلسات، اختر Scope على المفتاح وضع علامة على Start sessions from the MCP server (/mcp). راجع مفاتيح API.
  2. ضع المفتاح في متغير بيئة، مثل AICODEOPS_API_KEY.
  3. أضف الخادم إلى ~/.codex/config.toml. ولخادم Streamable HTTP، تذكر وثائق OpenAI الحقلين url و bearer_token_env_var، والثاني اسم المتغير الذي يرسل Codex قيمته في ترويسة Authorization (وثائق MCP لدى Codex)، كما يلي:
    [mcp_servers.aicodeops]
    url = "https://console.aicodeops.dev/mcp"
    bearer_token_env_var = "AICODEOPS_API_KEY"

لحصر الخادم في مستودع واحد، ضع الجدول نفسه في .codex/config.toml داخل ذلك المشروع؛ ولا يقرأ Codex ملفات المشروع إلا للمشاريع الموثوقة. ويتشارك CLI وإضافة IDE وتطبيق ChatGPT لسطح المكتب هذا الإعداد، فيكفي إدخال واحد للثلاثة.

ما يستطيع Codex فعله

الأداةما تفعله
list_projectsتسرد مشاريع مساحة العمل ومستودعاتها.
start_sessionتبدأ جلسة على مشروع بمهمة. ويمكنك أن تسمي فيها workflow و agent.
get_sessionحالة الجلسة وخطواتها وطلب السحب الذي فتحته وتغييرها.
check_release_gateهل يجوز إطلاق طلب سحب أو إيداع: الملاحظات المانعة والاختبارات الفاشلة وأسباب أخرى.
list_findingsملاحظات الأمان والجودة، الأحدث أولا.
get_evidence_packحزمة الأدلة الموقّعة لتغيير، حسب التغيير أو حسب الجلسة.
list_buildsعمليات البناء الأخيرة: ما الذي بدأ كلا منها، وفرعها وإيداعها، وكيف انتهت.
get_buildعملية بناء واحدة: الخطوة التي فشلت عندها ونهاية مخرجاتها.
list_saved_buildsعمليات البناء التي تحتفظ بها مساحة العمل، وما يبدأ كلا منها.

تتصرف كل أداة بصفة منشئ المفتاح، وتمر بالفحوص نفسها التي في لوحة التحكم: دوره، وميزانية مساحة العمل، وحد العمل الجاري للوكيل. والجلسة التي يبدؤها Codex تفتح طلب السحب كأي جلسة أخرى، فتبقى الموافقات وبوابة الإصدار سارية. راجع دليل خادم MCP.

أشياء يمكنك أن تطلبها من Codex، مثل:

Use AI CodeOps to start a security-sensitive-change session on the payments project: rotate the webhook signing secret handling.
Poll that AI CodeOps session and summarize the findings when it's done.
Check the AI CodeOps release gate for commit 3f9c2ab and tell me why it's denied, if it is.

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

فحص الإصدار واجهة HTTP API، فيستطيع أي نظام CI قادر على تشغيل curl أن يسأله قبل الدمج:

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $AICODEOPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"commitSHA\":\"$GIT_COMMIT\"}" > gate.json
jq -e '.allowed == true' gate.json

يمكنك إرسال pullRequestURL أو commitSHA من 7 أحرف أو أكثر. والجواب هو 200 مع allowed وملخص وأسباب؛ وإذا فشل الفحص نفسه، تكون قيمة allowed هي false. ومن الخيارات حد أدنى للتغطية، ومسارات سير عمل مطلوبة، وتراخيص محظورة، وعملية نشر مطلوبة في staging (API). وحين يكون فحصا مطلوبا، يرفض أي تغيير لم تنشئه جلسة AI CodeOps.

الحدود

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

البدء

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

تستخدم وكيل برمجة آخر؟ راجع AI CodeOps مع Claude Code أو Cursor أو GitHub Copilot.

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

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

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

أين يوضع الإعداد؟

في ~/.codex/config.toml، أو في .codex/config.toml داخل مشروع موثوق. وتقول وثائق OpenAI إن Codex CLI وإضافة IDE وتطبيق ChatGPT لسطح المكتب تتشارك هذا الإعداد.

كيف يرسل Codex مفتاح API؟

اضبط bearer_token_env_var على اسم متغير بيئة يحمل المفتاح. فيرسله Codex في ترويسة Authorization، ولا يوجد المفتاح في الملف أبدا.

هل يستطيع Codex بدء جلسات AI CodeOps؟

نعم، بمفتاح يتضمن نطاقه Start sessions from the MCP server. والمفتاح الذي لا نطاق له يستطيع استخدام أدوات القراءة السبع فقط.