إنتقل إلى المحتوى الرئيسي

استخدام الوكلاء في الخلفية في Cursor للأتمتة

Cursor Background Agents

قدم Cursor 1.0 الوكلاء في الخلفية - ميزة قوية تتيح لوكلاء الذكاء الاصطناعي تشغيل المهام في الخلفية دون حظر IDE الخاص بك. يغطي هذا الدليل كيفية الإعداد والإدارة والاستفادة من وكلاء الخلفية لتحقيق أقصى قدر من الإنتاجية.

ما هي الوكلاء في الخلفية؟​

يتيح وكلاء الخلفية:

  • المهام طويلة المدى التي تستمر أثناء عملك على أشياء أخرى
  • المعالجة المتوازية لمهام متعددة ومستقلة
  • العمليات غير المتزامنة مثل الاختبارات والبناء والتحليل
  • المهام المجدولة التي تعمل في أوقات محددة

المتطلبات الأساسية​

  • Cursor الإصدار 1.0 أو أحدث
  • خطة Pro أو أعلى (قد يتطلب وكلاء الخلفية مستوى مدفوعًا)
  • مشاريع تحتوي على مهام يمكن تشغيلها بشكل مستقل

بدء تشغيل وكيل في الخلفية​

الطريقة 1: قائمة السياق​

  1. افتح Composer (Cmd/Ctrl + I)
  2. اكتب وصف المهمة الخاص بك
  3. انقر على قائمة ... (المزيد من الإجراءات)
  4. حدد التشغيل في الخلفية

الطريقة 2: الأمر​

@background حلل قاعدة الكود بالكامل بحثًا عن ثغرات الأمان وأبلغ عن النتائج.

الطريقة 3: اختصار لوحة المفاتيح​

  1. اكتب مهمتك
  2. اضغط على Cmd/Ctrl + Shift + B (إذا تم تكوينه)
  3. يبدأ الوكيل في الخلفية

حالات استخدام الوكلاء في الخلفية​

1. تحليل قاعدة الكود​

[خلفية] امسح قاعدة الكود بالكامل و:
1. ابحث عن جميع تعليقات TODO
2. حدد استخدام واجهات برمجة التطبيقات المهملة
3. ادرج الملفات التي لا تحتوي على تغطية اختبارية
4. اكتشف تسريبات الذاكرة المحتملة
5. أبلغ عن تكرار الكود

قدم تقريرًا ملخصًا عند الانتهاء.

2. تنفيذ الاختبارات​

[خلفية] شغل مجموعة الاختبارات الكاملة:
1. نفذ جميع اختبارات الوحدة
2. شغل اختبارات التكامل
3. أنشئ تقرير التغطية
4. احفظ النتائج في test-results/

أبلغني عند الانتهاء مع ملخص النجاح/الفشل.

3. إنشاء الوثائق​

[خلفية] أنشئ وثائق API:
1. امسح src/ بحثًا عن جميع الوظائف/الفئات العامة
2. أنشئ JSDoc/docstring حيثما ينقص
3. أنشئ مستندات markdown في docs/api/
4. أنشئ فهرس تنقل

استخدم الأسلوب الموجود من src/utils/helpers.ts.

4. إعادة بناء قواعد الكود الكبيرة​

[خلفية] أعد بناء معالجة الأخطاء:
1. ابحث عن جميع كتل try/catch
2. قم بتوحيد رسائل الخطأ
3. أضف تسجيل الأخطاء المنظم
4. أنشئ فئات أخطاء مخصصة

طبق التغييرات عبر قاعدة الكود بالكامل.

إدارة الوكلاء في الخلفية​

عرض الوكلاء النشطين​

  1. افتح لوحة الوكلاء في الخلفية:

    • عرض > المظهر > إظهار الوكلاء في الخلفية
    • أو استخدم أيقونة الشريط الجانبي

  2. شاهد جميع الوكلاء قيد التشغيل مع:

    • وصف المهمة
    • وقت البدء
    • الحالة الحالية
    • مؤشر التقدم

حالات الوكيل​

الحالةالوصفالإجراء
قيد التشغيلالوكيل يعمل بنشاطمراقبة التقدم
متوقف مؤقتًاتم إيقاف الوكيل يدويًااستئناف أو إلغاء
مكتملانتهت المهمة بنجاحعرض النتائج
فشلواجهت المهمة خطأمراجعة السجلات
تم الإلغاءتوقفت المهمة من قبل المستخدمإعادة التشغيل إذا لزم الأمر

التحكم في الوكلاء​

# إيقاف وكيل مؤقتًا
cursor agent:pause <agent-id>

# استئناف وكيل
cursor agent:resume <agent-id>

# إلغاء وكيل
cursor agent:cancel <agent-id>

# عرض سجلات الوكيل
cursor agent:logs <agent-id>

إخراج الوكيل والنتائج​

أنواع النتائج​

  1. تغييرات الملفات: قام الوكيل بتعديل الملفات

    • راجع في لوحة التحكم في المصدر
    • انظر الفرق قبل الالتزام

  2. التقارير: الملخصات المُنشأة

    • محفوظة في الموقع المحدد
    • أو معروضة في لوحة الإشعارات

  3. الإشعارات: تحديثات الحالة

    • إشعارات سطح المكتب عند الانتهاء
    • شارة على أيقونة Cursor

الوصول إلى النتائج​

عند اكتمال وكيل الخلفية:

  1. تظهر إشعار (إذا كان ممكّنًا)
  2. تظهر شارة على رصيف Cursor / شريط المهام
  3. لوحة النتائج تفتح تلقائيًا
  4. الملفات المتغيرة تظهر في التحكم في المصدر

أفضل الممارسات​

حبكة المهام​

قسّم المهام الكبيرة إلى وكلاء خلفية أصغر:

# جيد: مهام محددة ومستقلة
[خلفية] أعد بناء معالجة أخطاء وحدة المصادقة
[خلفية] أعد بناء معالجة أخطاء وحدة الدفع
[خلفية] أعد بناء معالجة أخطاء وحدة الإشعارات

# أقل مثالية: مهمة ضخمة واحدة
[خلفية] أعد بناء جميع معالجة الأخطاء في التطبيق بالكامل

إدارة الموارد​

حدّد وكلاء الخلفية المتزامنين:

# الحد الأقصى الموصى به للوكلاء المتزامنين
- 2-3 للمهام المكثفة لوحدة المعالجة المركزية (إعادة البناء، التحليل)
- 5+ للمهام المرتبطة بالإدخال/الإخراج (التوثيق، التقارير)

نقاط التفتيش​

للمهام الطويلة، استخدم نقاط التفتيش:

[خلفية] ترحيل مخطط قاعدة البيانات:
1. إنشاء نسخة احتياطية
2. تشغيل سكريبتات الترحيل
3. التحقق من سلامة البيانات
4. إنشاء سكريبت التراجع

احفظ التقدم بعد كل خطوة.
إذا انقطع، استأنف من آخر نقطة تفتيش.

المراقبة والسجلات​

عرض سجلات الوكيل​

  1. افتح لوحة الوكلاء في الخلفية
  2. انقر على وكيل مكتمل
  3. عرض سجل التنفيذ الكامل
  4. راجع الطوابع الزمنية والإجراءات

هيكل السجل​

[2026-06-25 10:00:00] بدأ الوكيل: "فحص أمان قاعدة الكود"
[2026-06-25 10:00:05] قراءة: src/auth/login.ts
[2026-06-25 10:00:10] قراءة: src/auth/register.ts
[2026-06-25 10:00:15] اكتمل التحليل: تم العثور على 3 ثغرات
[2026-06-25 10:00:20] كتابة التقرير: security-report.md
[2026-06-25 10:00:25] اكتمل الوكيل بنجاح

اختيار النموذج للوكلاء في الخلفية​

تناسب نماذج مختلفة مهام خلفية مختلفة:

نوع المهمةالنموذج الموصى بهالسبب
تحليل الكودClaude 3.5 Sonnetشامل ودقيق
إعادة البناءGPT-4oسريع وموثوق
التوثيقGemini 1.5 Proسياق طويل
الاختباراتClaude 3.5 Sonnetاكتشاف جيد للحالات الحدية
تدقيق الأمانClaude 3 Opusتحليل عميق

تكوين النموذج الافتراضي في الإعدادات:

{
  "backgroundAgents": {
    "defaultModel": "claude-3-5-sonnet",
    "maxConcurrent": 3,
    "autoNotify": true
  }
}

استكشاف الأخطاء وإصلاحها​

المشكلةالحل
الوكيل لا يبدأتحقق من حدود الخطة؛ قد تحتاج إلى الترقية
الوكيل يختفيتحقق من لوحة الوكلاء في الخلفية بحثًا عن الأخطاء
النتائج لم تحفظحدد مسار الإخراج في وصف المهمة
الوكيل يتعطلألغِ وأعد التشغيل؛ قد يكون في انتظار إدخال
استخدام عالٍ لوحدة المعالجة المركزيةقلل الوكلاء المتزامنين؛ استخدم نماذج أخف

مثال: سير عمل كامل في الخلفية​

# الصباح: بدء التحليل
[خلفية] حلل الديون التقنية في قاعدة الكود.
أنشئ قائمة مفضلة بمهام إعادة البناء.

# بينما يعمل الوكيل، استمر في البرمجة...

# اكتمل الوكيل
[إشعار] "اكتمل التحليل: تم العثور على 12 فرصة لإعادة البناء"

# مراجعة النتائج
افتح: analysis-results/refactoring-tasks.md

# بدء إعادة البناء في الخلفية
[خلفية] نفذ أفضل 3 مهام لإعادة البناء من التحليل.

# استمرار العمل الآخر...

# مراجعة التغييرات عندما يكون ذلك مناسبًا
تحقق من لوحة التحكم في المصدر للفرق

موارد ذات صلة​