وثائق

وكلاء البرمجة على جهازك الخاص

تشغّل أدوار ملف تعريف AI الخاص بك على وكيل برمجة في جهاز الشخص الذي يبدأ المهمة، باستخدام أدوات CoRoid ودون أي شيء آخر من الجهاز.

يمكن لتطبيق من ملف تعريف AI أن يعمل على وكيل برمجة على جهازك الخاص بدلاً من نموذج يستدعيه CoRoid. يقوم الوكيل بعمليات الاستنتاج المطلوبة لهذا الدور هناك، مسجلًا الدخول باستخدام الإعدادات التي حددتها، على حسابك الخاص لدى مزود الخدمة. يوفر لـ CoRoid أدوات الدور المطلوبة ويحتفظ بباقي تفاصيل سير العمل: المهمة، عمليات التحقق والقيود، وسجل ما حدث.

ما الذي يشمله؟

  • كل أدوار الملف التعريف باستثناء محرك القرار: ال معماري ومنسق، ال مطور، ضمان الجودة، ال مراجع، ومختبر الويب، والمترجم وغيرهم. محرك القرار ليس وكيلًا قيد التشغيل: فهو يطلب من نموذج القرارات تحديد احتمالية كل إجابة مسموح بها، وهو أمر لا يوفره وكيل البرمجة.
  • أربعة وكلاء: Codex وOpenCode، وبالنسبة لبعض المنظمات فقط، حاليًا Claude Code وCursor. يعمل كل منها ضمن خطتك الخاصة لدى مزود الخدمة (انظر خطة وكيلك).
  • كل الطرق التي يمكن من خلالها تنفيذ المهمة. في وضع المنسق، يعمل المنسق والأدوار الفرعية التي يُسندها للوكيل مثل أي دور آخر.

خطة وكيلك

يعمل الوكيل تحت تسجيل دخولك الخاص وضمن خطتك لدى مزود الخدمة: Anthropic لـ Claude Code، وOpenAI لـ Codex، وCursor لـ Cursor، وأي مزودي خدمات تضبطهم في OpenCode. لا يطلع CoRoid على بيانات تسجيل الدخول هذه، ولا يعيد بيع أو مشاركة خطة أي شخص: فكل شخص يربط جهازه الخاص، ويقوم الوكيل بتنفيذ المهام التي بدأها.

ما إذا كانت شروط الخطة تسمح باستخدامها عبر منتج آخر، ولأي أعمال، هو أمر بينك وبين مزود الخدمة. يختلف الأمر بين المزودين، وبين خططهم الشخصية والتجارية، وقد يعتمد على حجم العمل المنجز عبرها، ويمكن أن يتغير. اقرأ شروط خطتك، واسأل المزود في حال لم يتم توضيحها.

يجب على المنظمة التي تخصص أدوارًا للوكلاء التحقق من نفس الأمور بالنسبة لخطط موظفيها. قد تسمح سياستها فقط بالوكلاء الذين تم التحقق من شروطهم (انظر ما الذي تسمح به منظمتك).

كيفية الاتصال

آلتك

موصل CoRoid

مفتوح المصدر. يبدأ تشغيل الوكيل لجولة واحدة في مجلد فارغ جديد ويتوقف بعدها.

وكيل البرمجة الخاص بك

الوكيل الذي تستخدمه، مسجل الدخول باسمك، مع إيقاف أدواته الخاصة.

  1. 1يطلب القيام بالعمل. كل طلب يستغرق حتى 25 ثانية؛ ويبلغ الموصل عما يقوله الوكيل كل 3 ثوانٍ.
  2. 2يستدعي أدوات الدور. برمز مميز لهذه الجولة فقط، ويتوقف عن العمل عند انتهاء الجولة.
  3. 3يستفسر من نموذجه. كما لو كان بدون CoRoid. لا يرى CoRoid ذلك تسجيل الدخول أبدًا.

CoRoid

منسق

يوزع عمل الدور على آلة الشخص الذي بدأ المهمة (1).

أدوات الدور

يعمل داخل بيئة العزل الخاصة بالمهمة، حيث يظل كودك محفوظًا (2).

مزود الوكيل

يستجيب لطلبات نموذج الوكيل تحت تسجيل دخولك الخاص، ضمن خطتك (3).

لا شيء يصل إلى الآلة: لا يفتح الموصل أي منفذ، ولا يرسل أيًا من ملفاته، ولا ينفذ أي أمر خاص به.

على الآلة تبقى بيانات تسجيل دخولك للوكيل وما يحتفظ به الوكيل نفسه من معلومات عن الجولة.

تبدأ كل عملية اتصال من الآلة وتخرج عبر بروتوكول HTTPS. يظل المستودع داخل بيئة العزل الخاصة بالمهمة في CoRoid؛ ولا يعمل الوكيل عليه إلا عبر أدوات الدور المخصص.

يعمل الجهاز لصالح CoRoid عبر موصل CoRoid، وهو برنامج صغير مفتوح المصدر تقوم بتثبيته وتشغيله. يبدأ كل اتصال من الجهاز: يطلب الموصل من CoRoid تنفيذ المهام، وينادي الوكيل على أدوات الدور ضمن بيئة العزل المخصصة للمهمة، ويطلب من مزود الخدمة الخاص به إجابات النموذج، وكل ذلك تحت تسجيل دخولك. لا يفتح الموصل أي منافذ ولا يرسل أي ملفات من الجهاز. أمان الموصل يوضح ما يفعله وما لا يفعله، وكيفية التحقق من إصداره.

ربط جهاز

  1. قم بتثبيت الوكيل على الجهاز وتسجيل الدخول إليه، كما تفعل عند استخدامه بنفسك.

  2. قم بتثبيت الموصل، باستخدام Homebrew على macOS أو Linux:

    brew install coroid-ai/tap/coroid-connector

    أو باستخدام npm، في أي مكان يتوفر فيه Node.js 20 أو أحدث:

    npm install --global @coroid/connector
  3. لـ Codex أو Claude Code، أضف الوكيل: coroid-connector add codex (أو add claude). يقوم هذا بتثبيت محول ACP الخاص بالوكيل، الذي يحمل نسخته الخاصة من الوكيل (حوالي 350 ميجابايت)، في ~/.coroid/connector، من الحزم التي يؤمنها الموصل عبر التجزئة. لا تحتاج OpenCode وCursor إلى إضافة: فـ CoRoid يستخدم تثبيتك الخاص.

  4. افتح إعدادات → اتصالات → أجهزتك وشغّل الأمر الموضح هناك (coroid-connector --api …). يفتح متصفحك: وافق على ربط الجهاز بمنظمتك. وافق فقط على موصل بدأته للتو.

يستمر الموصل في العمل حتى توقفه، طالبًا من CoRoid تنفيذ المهام. أجهزتك يسرد الجهاز كجهاز متصل، مع الوكلاء الذي وجده الموصل عليه ونسخة كل منهم. لا يظهر الوكيل كجاهز إلا إذا جرّبه CoRoid؛ وعلى نسخة أخرى يظهر ولكن لا يُستخدم.

coroid-connector status يعرض نفس المعلومات من الجهاز، مع النموذج المحدد لكل وكيل.

أنت فقط من يرى أجهزتك. فصل الاتصال ينهي تسجيل دخول الجهاز، ويتوقف موصله خلال دقيقة.

تعيين دور لوكيل

يقوم مالك المنظمة بذلك في ملف تعريف مخصص، ضمن إعدادات → ملف تعريف AI (انظر ملفات تعريف AI).

  1. افتح تفاصيل الملف التعريف. في الحقل الأول لكل دور، تبدأ القائمة بـ على جهازك الخاص: الوكلاء المتاحة لمنظمتك، وبجانب كل منها ما إذا كان جهازك جاهزًا لاستخدامه.
  2. اختر الوكيل. تظهر حقلان إضافيان:
    • النموذج في : النموذج الذي يجب أن يستخدمه الوكيل لهذا الدور، من بين النماذج التي تبلغ عنها أجهزتك المتصلة. كما هو مضبوط على الجهاز يترك الوكيل على النموذج الذي حدده مالكه.
    • بدون جهاز متصل: النموذج الذي يُشغّل الدور عندما لا يتولى أي جهاز العمل. وهو النموذج الذي كان يستخدمه الدور.
  3. حفظ.

اختيار نموذج في الحقل الأول مرة أخرى يبعد الوكيل، ويأخذ معه النموذج المسمى به.

ماذا يحدث عند تشغيل مهمة؟

المهمة تخص المؤسسة؛ والجهاز يخص الشخص. عندما يبدأ دور ما، يبحث CoRoid عن جهاز الشخص الذي بدأ المهمة:

  • متصل في هذه المؤسسة خلال الدقيقة الأخيرة،
  • مع وجود الوكيل المخصص جاهزًا على إصدار جربه CoRoid،
  • ويقدم النموذج المسمى، إذا حددت المهمة اسمًا له.

إذا وُجد جهاز كهذا، يذهب عمل الدور إليه. وإلا، يعمل الدور على النموذج الموجود تحت بدون جهاز متصل، تمامًا كما كان سيحدث. لا ينتظر أي شيء حتى يتوفر جهاز. الأعمال التي لم يبدأها أحد (تلقائية بناءً على حدث أو جدول زمني) ليس لديها جهاز كهذا وتعمل على نموذجها.

على الجهاز، يبدأ الموصل الوكيل في مجلد جديد فارغ ويمنح جلسته مجموعة من الأدوات: أدوات CoRoid لهذا الدور، المتاحة فقط لهذا العمل. يُغيّر المطور الكود عبرها، في مساحة عمل المهمة ضمن CoRoid، كما يفعل النموذج؛ ويقيّم فريق ضمان الجودة والمراجع ذلك التغيير عبرها. أي رسالة تُضاف إلى المهمة أثناء عمل الوكيل تصل إليه مع نتيجة الأداة التالية.

الدور الذي ينتظر يعود إلى الوكيل. يُسلّم المنسق العمل إلى المطور وفريق ضمان الجودة والمراجع وينتظر من كل منهم ردًا؛ وقد ينتظر طفلٌ رد المنسق. عند انتهاء الانتظار، يعود الدور إلى الوكيل، الذي يُعطى محادثة حتى تلك اللحظة. يمكن لجهاز واحد تشغيل ما يصل إلى أربعة أدوار في آنٍ واحد (موصل 0.4.0)، لذا تعمل عمليات استكشاف المطور التي يبدأها جنبًا إلى جنب معه.

إذا توقف الجهاز عن الاستجابة أثناء تشغيل دور ما، يستمر الدور في نفس المحادثة على نموذجه السحابي، الذي يُخبر بما حدث. المهمة المتوقفة توقف الوكيل أيضًا. عند انتهاء الدور، يُوقف وكيله ويُزال المجلد.

ما يبقى على جهازك

يُزيل الموصل المجلد الذي عمل فيه الدور. ما يحتفظ به الوكيل من العمل في تخزينه الخاص يعتمد على نوع الوكيل:

وكيلما يحتفظ به
Claude Codeلا توجد محاضر: يبدأه الموصل بميزة عدم الاحتفاظ بالجلسة.
Codexمحضر لكل جلسة في ~/.codex/sessions، بما في ذلك الملفات التي قرأها.
OpenCodeجلساته في قاعدة بياناته الخاصة تحت ~/.local/share/opencode
Cursorكل جلسة في قاعدة بياناتها الخاصة تحت ~/.cursor/acp-sessions

لا توفر Codex وOpenCode وCursor خيارًا للتحكم بذلك حاليًا. إذا كانت مؤسستك تلزم بعدم تخزين الكود على أجهزة الكمبيوتر المحمولة، سمح فقط باستخدام Claude Code وفق السياسة (انظر أدناه).

ما تسمح به مؤسستك

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

  • السماح بوكلاء البرمجة على أجهزة الأشخاص. عندما يكون هذا الخيار مغلقًا، تعمل كل الأدوار على نموذجها، بما في ذلك الدور الذي يخصصه ملف التعريف مسبقًا لوكيل.
  • مفتاح تبديل واحد لكل وكيل تُقدَّم لك في مؤسستك، بالإضافة إلى ما يحتفظ به ذلك الوكيل على الجهاز. مع تفعيل كل وكلاء، يتم تفعيل أي وكيل يقدمه CoRoid لاحقًا أيضًا.

تقدم صفحة ملف تعريف AI فقط الوكلاء المسموح بها في السياسة، ولا يمكن إسناد دور جديد إلى آخر. الدور المخصص قبل تغيير السياسة يحتفظ بإسناده، وتُظهر الصفحة أنه يعمل على نموذجه. يمكن لسياسة المشروع أن تضيّق من سياسة المؤسسة، لكن لا يمكنها توسيعها.

ما يمكن للوكيل فعله وما لا يمكنه فعله

  • أدوات CoRoid فقط. أدوات الوكيل الخاصة به (مثل الصدفة وتحرير الملفات والبحث على الويب وخوادم MCP وموصلاته) تُعطل خلال الجلسة، بالطريقة التي يوفرها الوكيل. أي طلب لاستخدام شيء آخر يُرفض.
  • لا شيء من الجهاز. لا يعمل الوكيل في بيئة التحقق من الكود الخاصة بك ولا يحصل على ملفات الجهاز. كما لا يحصل CoRoid على صلاحيات الوصول إلى الجهاز: يطلب الموصل من CoRoid العمل فقط ويبلغه بما يقوله الوكيل.
  • نفس الفحوصات. التغييرات التي يُحدثها الوكيل تمر بنفس عمليات ضمان الجودة والمراجعة والقيود والحدود مثل عمل النموذج.
  • ما يُرسَل. ما يحتاجه الدور (الكود الذي يقرأه، المتطلبات، نتائج أدواته، صور المرفقات) يُرسل إلى الجهاز، ومن هناك إلى مزود الوكيل تحت حساب تسجيل الدخول الخاص به. إذا كانت مؤسستك تلزم بتخزين الكود لدى مزودين معينين، خذ ذلك في الاعتبار قبل إسناد دور إلى وكيل.

التكاليف والسجلات

منطق عمل الوكيل يُعزى إلى الشخص الذي نفذ المهمة على جهازه، وليس إلى إنفاق نموذج CoRoid. تُظهر أنشطة المهمة تنفيذًا من هذا النوع، على سبيل المثال: Codex (gpt-6-luna) على حاسوب Ada المحمول · غير مُحتسب بالفواتير، ولا يُعتبر عدد الرموز صفرًا أبدًا. إذا استخدم دور ما نموذجه السحابي، فإن ذلك الجزء يُحتسب في الفاتورة كالمعتاد.

CoRoid يسجل كل جزء من العمل الذي يُسلّمه إلى جهاز: أي جهاز ووكيل، واسم النموذج المستخدم، وكيف انتهى تنفيذه وعدد عمليات الاستدعاء التي تمت.

تصدير واستيراد

وكيل المهمة ونموذجه يُرفقان مع الملف الشخصي عند تصدير الإعدادات، كما يُرفق اختيار الوكيل وفق السياسة مع سياسة المنظمة. المنظمة التي لا تحتوي على وكلاء محليين، أو التي لا يتوفر لديها ذلك الوكيل، أو التي لا تسمح سياستها باستخدامه، تستورد المهمة بنموذجها السحابي فقط، ويُشار إلى ذلك في عملية الاستيراد. اطلع على تصدير واستيراد الإعدادات.