الدروس التعليمية

استخدام literate coding لتوليد الكود من التعليقات

استخدم literate coding لتوليد الكود من تعليقات اللغة الطبيعية. يساعدك Bob على كتابة تعديلات كود دقيقة وواعية بالسياق مباشرةً في محررك.

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

Literate coding فعّال للتعديلات التالية:

  • إضافة منطق تغليف: آليات إعادة المحاولة ومعالجة الأخطاء أو التسجيل حول الكود الموجود.
  • إعادة هيكلة كتل محددة: تعديل أقسام مستهدفة مع الحفاظ على المنطق المحيط.
  • تعديلات دقيقة ومحددة: تغييرات دقيقة لدوال محددة دون التأثير على البنية الأشمل. للتعديلات المعقدة التي تؤثر على دوال أو ملفات متعددة، فكّر في استخدام واجهة الدردشة الوكيلية لـ Bob لإنشاء خطة.

في هذا الدرس، تُصلح مهلة متقطعة بتغليف كتلة كود بمنطق إعادة المحاولة.

المتطلبات المسبقة

لإتمام هذا الدرس، تحتاج إلى ما يلي:

  • إذا لم يكن لديك بالفعل، استنسخ كود عرض Galaxium Travels التوضيحي.
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels
  • Bob IDE مع فتح كود عرض Galaxium Travels التوضيحي.
  • على الرغم من أنه غير مطلوب، فكّر في إتمام درس البدء السريع للتعرف على واجهة Bob وميزاته.

استخدام literate coding

الواجهة الخلفية لـ Galaxium Travels غير موثوقة وتحصل أحيانًا على أخطاء مهلة. بدلًا من إعادة كتابة الكود من الصفر، يمكنك استخدام literate coding لتغليف كتلة الكود المحددة بمنطق إعادة المحاولة.

فتح الملف

افتح ملف booking_system_frontend/src/pages/Flights.tsx.

تحديد موضع المؤشر

انقر داخل السطر 43.

تفعيل وضع literate coding

انقر على أيقونة العصا السحرية للدخول إلى وضع literate coding.

أيقونة العصا السحرية تُفعّل وضع literate coding

كتابة تعليماتك

أدخل تعليمة اللغة الطبيعية التالية لوصف التغيير المطلوب في السطر 43:

The backend is unreliable at times. We need a retry logic here

أمر اللغة الطبيعية المُدخَل في وضع literate coding

توليد الكود

انقر Generate لتوليد التعديلات.

يعرض Bob التغييرات في واجهة عرض فرق الكود. النص الأحمر المُبرَّز يُظهر الكود الذي سيُزال والنص الأخضر المُبرَّز يُظهر الكود الذي يضيفه Bob.

Bob يعرض التغييرات المقترحة في عرض الفرق

قبول التغييرات

راجع التغييرات وانقر Accept All لتطبيقها.

لقد أضفت حلقة إعادة محاولة لحل أخطاء المهلة في تطبيق Galaxium Travels على الويب.

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

في هذا الدرس، تعلمت كيف يتيح literate coding استخدام تعديلات كود دقيقة مدفوعة باللغة الطبيعية. انتقل إلى التخطيط وتنفيذ الميزات المعقدة لتتعلم عن وضع Plan وتنفيذ ميزات متعددة الملفات.

ما رأيك في هذا الموضوع؟