0Pricing
AI Agents · درس

حلقات التصحيح الذاتي التكرارية

شغّل الاختبارات، وحلّل الإخفاقات، واطلب من النموذج إصلاحها — هذه هي الحلقة الداخلية لكل وكيل برمجي حديث.

حلقات التصحيح الذاتي التكرارية درس مجاني في AI Agents على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في AI Agents، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة AI Agents 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

لماذا التصحيح الذاتي؟

غالبًا ما تفشل المحاولات الأولى. وتتمثل الخاصية المميزة لوكيل البرمجة في قدرته على:

  1. تشغيل الشفرة
  2. قراءة الخطأ
  3. إصلاح الشفرة
  4. التكرار

هذه الحلقة الداخلية هي ما يميز وكلاء البرمجة الحقيقيين عن العروض التوضيحية لإكمال النصوص.

The Loop

def code_until_pass(task, max_iters=10):
    write_initial_code(task)
    for i in range(max_iters):
        result = run_tests()
        if result.passed:
            return 'success'
        fix_prompt = f'Tests failed:\n{result.stderr}\nRead the code, identify the bug, and fix it with edit_file.'
        agent.run(fix_prompt)
    return 'gave up'

تقديم ملاحظات مفيدة

عبارة عامة مثل "فشلت الاختبارات" لا تساعد على اتخاذ إجراء. مرّروا كامل مخرجات الخطأ، وتتبع الاستدعاءات، والفرق بين المتوقع والفعلي:

fix_prompt = f'''
The tests failed with this output:

FAILED tests/test_utils.py::test_add
  AssertionError: expected 4, got 5
  at line 42

Fix the code by editing the file.
'''

إعادة القراءة قبل إعادة الإصلاح

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

fix_prompt = 'First, read_file the failing module. Then edit it.'

اكتشاف حالات الفشل المتكررة

إذا فشل الاختبار نفسه 3 تكرارات متتالية مع أخطاء متطابقة، فهذا يعني أن الوكيل عالق. أعيدوا التخطيط أو صعّدوا المشكلة:

if same_error_count >= 3:
    return 'stuck — replanning needed'

Replan When Stuck

replan_prompt = f'''
The current approach is not working. The repeated error is:
{error}

Describe ONE alternative approach to solving the task.
'''

التصعيد إلى نموذج أكبر

إذا علق نموذج منخفض التكلفة، فأعيدوا تنفيذ مطالبة الإصلاح نفسها باستخدام نموذج أقوى:

if iter > 3 and using_cheap_model:
    switch_to_big_model()
    # often unblocks 50% of stuck cases

التحقق بعد كل تعديل

لا تجمعوا تعديلات كثيرة ثم تتحققوا منها — فمن الصعب جدًا تحديد سبب الإخفاقات. عدّلوا شيئًا واحدًا، وتحققوا منه، ثم عدّلوا الشيء التالي.

تضمين مخرجات الاختبارات في السياق

احتفظوا بأحدث مخرجات الاختبارات في سياق الوكيل. من دونها، لا يعرف الوكيل ما فعله للتو:

messages.append({'role': 'tool', 'content': f'After your edit, tests now: {test_summary}'})

تجنب حلقات الإصلاح اللانهائية

ضعوا حدًا أقصى صارمًا للتكرارات. إذا لم تكتمل المهمة عند الوصول إلى MAX_ITERS، فصعّدوها إلى إنسان:

if iter == MAX_ITERS - 1:
    notify_human(task, current_state, error_history)
    break

تتبّع مقاييس التصحيح الذاتي

  • متوسط عدد التكرارات اللازمة للنجاح
  • المهام التي تتوقف عند max_iter
  • المهام التي تنجح في تكرار واحد مقارنة بخمسة تكرارات

توجّه هذه المقاييس إلى تحسين المطالبات والأدوات.

النقد الذاتي من دون اختبارات

بالنسبة إلى المهام التي لا تملك مجموعة اختبارات واضحة، أضيفوا خطوة للنقد: اجعلوا الوكيل يراجع الفروقات التي أجراها قبل الإرسال:

critique_prompt = '''
Review your changes for:
- Off-by-one errors
- Missing error handling
- Breaking other tests
Return FIX LATER or DONE.
'''

مدخلات التصحيح الذاتي

ما أهم مدخل منفرد لحلقة "fix loop" الخاصة بالوكيل؟

مراجعة

تشغيل ← خطأ ← إصلاح ← تكرار. مرّروا أخطاء ملموسة. أعيدوا القراءة قبل إعادة الإصلاح. اكتشفوا حالات التوقف. صعّدوا إلى نماذج أكبر أو إلى أشخاص عند التعثر.

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

هل درس «حلقات التصحيح الذاتي التكرارية» مجاني؟

نعم — نص درس «حلقات التصحيح الذاتي التكرارية» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة AI Agents، انتقل إلى CoddyKit PRO. تتضمن دورة AI Agents 4 دروس في المجموع.

ماذا ستتعلم في «حلقات التصحيح الذاتي التكرارية»؟

شغّل الاختبارات، وحلّل الإخفاقات، واطلب من النموذج إصلاحها — هذه هي الحلقة الداخلية لكل وكيل برمجي حديث. تتمرن على AI Agents مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ AI Agents؟

لا تُشترط خبرة سابقة. AI Agents على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «حلقات التصحيح الذاتي التكرارية»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس AI Agents هذا؟

نعم. كل درس في AI Agents يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. أنماط الوكلاء: التخطيط والتنفيذ والتحقق
  2. واجهات أدوات البرمجة (Read وEdit وBash)
  3. حلقات التصحيح الذاتي التكرارية
  4. معماريات SWE-Agent وOpenDevin
← العودة إلى AI Agents