Table of Contents

العودة إلى دورة سير العمل العملي للذكاء الاصطناعي

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

هدف التعلّم: ستعد سجل قبول للمصادر ونطاق الملفات والاختبارات والخصوصية والاستخدام.

أهم النقاط

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

قبل البدء

المتطلبات: مختبر الدورة، وdocs/requirements.md، ولقطة Git محلية، و درس MCP أو بديله في المتصفح. خصص 40 دقيقة. مستوى الصعوبة متوسط. استخدم المختبر الذي عدّلته في أول مهمة لوكيل البرمجة. إذا تخطيت التعديل، فاستخدم نسخة استخراج جديدة وسجّل أن فحوص الميزات غير منفذة. لا تزال النسخة الأساسية غير المعدّلة تجتاز اختباريها الأصليين.

تحقق من ادعاء واقعي

الادعاء: «قيم الحالة المعتمدة هي open وpending». افتح docs/requirements.md، المراجعة 1. يذكر الملف open وdone. الادعاء خاطئ. النبرة الواثقة لا تغيّر المتطلب.

بالنسبة إلى ادعاءات المنتجات، استخدم الوثائق الرسمية الحالية وسجّل عنوان الصفحة وتاريخ المراجعة. تصبح المعلومات المتعلقة بقائمة أو خطة أو أمر أو حد للسياق قديمة أسرع من مبادئ سير العمل العامة. تعرض وثائق Codex و وثائق Claude Code و وثائق OpenCode واجهاتها الحالية.

الادعاءالمصدرالقرار
open وpendingمتطلب المختبر، المراجعة 1ارفضه واستبدل pending بـ done
العدد بلا مرشح هو 4البرنامج الأساسي وأربعة سجلات JSONتحقق بتشغيل البرنامج
حدثت قراءة عبر MCPسجل أدوات الجلسةاقبلها فقط إذا ظهر استدعاء الأداة

افحص التغيير

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

git status --short
git diff -- task_report.py tests

النطاق المتوقع: بعد مهمة التصفية، لا يتغير سوى task_report.py والاختبارات المحددة. يحتاج أي تغيير في tasks.json أو docs/requirements.md أو ملف إعداد مخفي إلى تفسير ومراجعة منفصلة. إذا لم تنفذ تعديلًا، فلا تتوقع تغييرات.

اختبر السلوك

شغّل فحوص الأساس والميزات نفسها من مجلد المختبر المستخرج. يجب أن يذكر تقرير إكمال الوكيل النتائج التي لوحظت لهذه الفحوص.

python3 -m unittest discover -s tests -v
python3 task_report.py tasks.json
python3 task_report.py tasks.json --status open
python3 task_report.py tasks.json --status done
python3 task_report.py tasks.json --status invalid

في النسخة المعدّلة، تغطي الاختبارات الحالات الجديدة، وتكون الأعداد 4 و2 و2، أما القيمة غير الصالحة فتنتج خطأً واضحًا ورمز خروج غير صفري. في نسخة بدء جديدة، ينجح اختبارا الأساس فقط ويكون الإجمالي 4. سجّل حالة البداية منفصلة.

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

افحص الخصوصية والوصول

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

يثبت الاختبار المحلي السلوك المحلي فقط. لا يثبت أذونات حساب سحابي أو نطاق خادم MCP أو سلوك خدمة منشورة. اختبر كل حد في البيئة المعنية.

سجّل الاستخدام والتكاليف

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

افتح صفحة استخدام الحساب الذي نفّذ المهمة. سجّل رموز الإدخال والإخراج المعروضة والنموذج وفترة الفوترة وأي فئة للإدخال المخزن مؤقتًا. في اشتراكات ChatGPT أو Claude، لا يعادل حد الاستخدام أو حصته تكلفة API لمهمة واحدة. عند تشغيل OpenCode عبر API أو مزوّد، راجع الاستخدام أو الفوترة لدى ذلك المزوّد وسعره الحالي. إذا لم يعرض المنتج الرموز لكل مهمة، فاكتب «غير متاح» ولا تستنتج الرسوم من طول المحادثة.

حساب توضيحي وليس سعرًا لمزوّد: تبلغ تكلفة 30,000 رمز إدخال بسعر دولار واحد لكل مليون 0.03 دولار. وتبلغ تكلفة 5,000 رمز إخراج بسعر 5 دولارات لكل مليون 0.025 دولار. إجمالي تكلفة النموذج في هذا المثال 0.055 دولار قبل رسوم الأدوات أو الاستضافة.

تكلفة الإدخال = رموز الإدخال / 1,000,000 × سعر الإدخال
تكلفة الإخراج = رموز الإخراج / 1,000,000 × سعر الإخراج
الإجمالي = تكلفة الإدخال + تكلفة الإخراج + رسوم الأدوات المنفصلة

تستهلك مهمة العامل رموزًا أيضًا. ينقل التفويض المخرجات التفصيلية خارج المحادثة الرئيسية، لكنه لا يجعل العمل مجانيًا. قارن التكلفة بقيمة الفحص المستقل.

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

احتفظ بسجل قبول

الحقلمثال مكتمل بعد التعديل
المصدرتمت قراءة docs/requirements.md، المراجعة 1
الملفات المتغيرةtask_report.py وtests/test_task_report.py في git status --short
الاختباراتنجحت اختبارات الأساس ومرشح الحالة الجديد، سجّل العدد المرصود
المخرجات اليدويةلوحظت Total tasks: 4 و2 و2، ورُفضت القيمة غير الصالحة
حالة الميزةنُفّذ --status open و--status done
الخصوصيةملفات اصطناعية فقط
الاستخدامسجّل أرقام مزوّدك إن توفرت
القراراقبل فقط بعد اجتياز فحوص المصدر والفارق والاختبارات والخصوصية

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

تحقق من فهمك

  1. سؤال: هل يثبت نجاح خط الأساس في النسخة الأولية وجود الميزة المطلوبة؟ الإجابة: لا. اختبر سلوك القبول الجديد بعد التعديل.

  2. سؤال: ماذا يتضمن سجل القبول؟ الإجابة: أدلة المصدر والملفات المتغيرة وفحوص السلوك ونطاق الوصول والاستخدام المرصود.

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

  • لا يوجد مصدر للادعاء: سجّله على أنه غير متحقق وابحث عن مرجع موثوق.
  • تنجح الاختبارات لكن تختلف المخرجات: أضف حالة يدوية وافحص البيانات.
  • بيانات الاستخدام غير متاحة: سجّل «غير متاح» بدل تقدير تكلفة فعلية.
  • يتضمن الفارق بيانات خاصة: توقف عن مشاركة المخرجات واحذف البيانات من سجل التدريب.

الخطوات التالية

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

التنقل في الدورة: السابق: إعداد MCP ، مخطط الدورة .