البرمجة الثنائية بالذكاء الاصطناعي مع IBM Bob

تشغيل IBM Bob

شغّل تطبيق IBM Bob على حاسوبك. Bob بيئة تطوير متكاملة مستقلة، وليس امتداداً.

فتح واجهة دردشة Bob

إذا لم تكن واجهة دردشة Bob مرئية، افتحها بتحديد أيقونة Bob بجانب شريط التنقل، أو استخدم الاختصار Option + Command + B (Mac) أو Ctrl + Alt + B (Windows).

فتح مجلد مشروع فارغ

أنشئ مجلداً فارغاً باسم todo-api، ثم افتحه في Bob عبر File > Open Folder. إذا سألك Bob عما إذا كنت تثق في مؤلفي الملفات في المجلد، حدد Yes, I trust the authors.

يكتب Bob التطبيق المُولَّد في هذا المجلد. لا تحتاج إلى مستودع موجود مسبقاً لهذا البرنامج التعليمي.

تعطيل الموافقة التلقائية

افتح Permissions وتأكد من أن الموافقة التلقائية معطّلة. مع تعطيل الموافقة التلقائية، يطلب Bob إذنك قبل قراءة الملفات أو تعديلها أو تشغيل الأوامر، مما يبقيك في السيطرة على كل تغيير في هذا البرنامج التعليمي.

التبديل إلى وضع Plan

افتح قائمة الأوضاع في أسفل شريط Bob الجانبي وحدد Plan.

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

تحديد متطلبات التطبيق

في واجهة دردشة Bob، أدخل المطالبة التالية:

Create a simple FastAPI To-Do API.

Requirements:

- Store tasks in a Python list.
- Each task should contain:
    - id
    - task_name

Implement:

- Get all tasks
- Add a task
- Delete a task

Use FastAPI and Pydantic.

Include a requirements.txt and a Dockerfile that run the API on port 8000.

Keep the implementation simple.

يحلّل Bob المتطلبات ويُنشئ خطة مهام.

تحسين الخطة

يمكنك تغيير الخطة قبل كتابة أي كود. في واجهة دردشة Bob، أدخل مطالبة متابعة:

Update the plan to reject a task whose task_name is empty or longer than 200 characters.

يراجع Bob الخطة لتضمين التحقق من الإدخال الإضافي. راجع الخطة المحدّثة.

مراجعة الخطة والموافقة عليها

يعرض Bob الإجراءات التي يخطط لاتخاذها قبل تنفيذها. على سبيل المثال، قد يقترح Bob:

• إنشاء تطبيق FastAPI.
• إضافة ملف Dockerfile وملف requirements.txt.
• التحقق من التنفيذ.

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

التبديل إلى وضع Agent وتنفيذ الخطة

افتح قائمة الأوضاع في أسفل شريط Bob الجانبي وحدد Agent. ثم أخبر Bob بتنفيذ الخطة المعتمدة:

Implement the plan.

يتيح وضع Agent لـ Bob كتابة الملفات وتشغيل الأوامر. يطلب Bob الموافقة قبل كل تغيير لأنك عطّلت الموافقة التلقائية. وافق على الخطوات بينما يعمل Bob على تنفيذ الخطة.

مراجعة التطبيق المُولَّد

عند اكتمال التنفيذ، راجع الكود المُولَّد. يتكون التطبيق من الأجزاء التالية.

نماذج البيانات. يولّد Bob نموذجَي Pydantic: أحدهما لجسم الطلب عند إنشاء مهمة، والآخر للمهمة المحفوظة. يُطبّق نموذج الإنشاء قاعدة الطول التي أضفتها أثناء التخطيط:

class TaskCreate(BaseModel):
    task_name: Annotated[str, Field(min_length=1, max_length=200)]


class Task(BaseModel):
    id: int
    task_name: str

تعتمد الأسماء الدقيقة والمسارات على ما يولّده Bob. يفترض هذا البرنامج التعليمي وجود النموذجَين Task وTaskCreate ومسار نقطة النهاية /tasks. عدّل المطالبات التالية إذا اختار Bob أسماء مختلفة.

مخزن البيانات في الذاكرة. يخزّن Bob المهام في قائمة Python فارغة ويخصص لكل مهمة جديدة id متصاعداً:

tasks: list[dict] = []
id_counter = 0

عمليات واجهة برمجة التطبيقات. يوفر التطبيق نقاط النهاية التالية:

• GET /tasks
• POST /tasks
• DELETE /tasks/{task_id}

يأخذ POST /tasks فقط task_name في جسم الطلب ويعيد 201 مع المهمة المُنشأة. يعيد DELETE /tasks/{task_id} القيمة 204 عند النجاح و404 عندما لا توجد مهمة بذلك task_id.

التبعيات. ملف requirements.txt يُدرج FastAPI، وUvicorn، وPydantic.

الحاوية. ملف Dockerfile يُثبّت التبعيات ويشغّل واجهة برمجة التطبيقات على المنفذ 8000 مع Uvicorn.

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

بدء نافذة سياق جديدة

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

فتح ملف التطبيق

افتح ملف main.py الذي أنشأه Bob وضع مؤشرك على سطر فارغ في نهاية الملف، أسفل آخر معالج للمسار.

تفعيل وضع الترميز الأدبي

اضغط Cmd + I (Mac) أو Ctrl + I (Windows وLinux)، أو حدد أيقونة العصا السحرية في شريط أدوات المحرر.

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

أدخل التعليمة التالية على السطر الفارغ. تظهر مميّزة بلون مختلف عن بقية الكود.

Add an endpoint that updates the task_name of an existing task by its ID, matching the style and conventions of the existing routes.

يستنتج Bob مسار المسار، واسم المعامل، وطريقة HTTP، ومعالجة الأخطاء من الكود المحيط، فلا تحتاج إلى تحديدها.

توليد الكود وقبوله

حدد Generate أسفل الكود الذي يقترحه Bob. يستبدل Bob التعليمة بتنفيذ ويعرض فرقاً مضمّناً.

راجع الفرق، ثم حدد Accept All لتطبيق التغيير. حدد Exit للخروج من وضع الترميز الأدبي.

بدء نافذة سياق جديدة

انقر على New task في مربع الدردشة أو + في أعلى لوحة الدردشة لبدء نافذة سياق جديدة.

اطلب من Bob شرح الكود

فهم الكود المُولَّد جزء مهم من البرمجة الثنائية بالذكاء الاصطناعي. اسأل Bob:

Explain the generated To-Do API.

يمكن لـ Bob شرح بنية التطبيق، وتدفق البيانات، ومكونات FastAPI، ونماذج Pydantic، وسلوك نقاط النهاية، وقرارات التصميم. تساعدك هذه الشروحات على فهم كيفية عمل التطبيق بدلاً من التعامل مع الكود المُولَّد بالذكاء الاصطناعي كصندوق أسود.

تشغيل التطبيق

اطلب من Bob بناء واجهة برمجة التطبيقات وتشغيلها في حاوية:

Build the Docker image and run the container with port 8000 mapped to the host. Confirm the API is reachable.

يشغّل Bob أوامر البناء والتشغيل ويُبلّغ عند تشغيل الحاوية. لتشغيل الأوامر بنفسك، افتح نافذة طرفية في مجلد todo-api:

docker build -t todo-api .
docker run -d --name todo-api -p 8000:8000 todo-api

افتح http://127.0.0.1:8000/docs في متصفحك.

تقدّم FastAPI واجهة Swagger UI تفاعلية على /docs. استخدمها لاستكشاف كل نقطة نهاية، وفحص مخططات الطلب والاستجابة، وتشغيل استدعاءات واجهة برمجة التطبيقات من المتصفح.

التحقق من واجهة برمجة التطبيقات

استخدم Swagger UI على /docs لاختبار كل عملية. لكل نقطة نهاية، وسّع صفها، وحدد Try it out، وأدخل أي معاملات مسار أو جسم طلب، وحدد Execute، ثم تحقق من رمز Server response وجسمه.

إضافة مهمة

1. وسّع POST /tasks وحدد Try it out.

2. استبدل جسم الطلب بـ:

   {
     "task_name": "My first API item!"
   }

3. حدد Execute. تأكد من أن رمز الاستجابة 201 وأن جسم الاستجابة يحتوي على المهمة مع id مخصص. لاحظ id؛ ستحتاجه في خطوات التحديث والحذف.

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

4. في جسم الطلب نفسه، اضبط task_name على سلسلة فارغة (""), حدد Execute، وتأكد من أن رمز الاستجابة 422 مع جسم استجابة يصف خطأ التحقق.
5. اضبط task_name على سلسلة أطول من 200 حرف، وحدد Execute، وتأكد من أن رمز الاستجابة 422 أيضاً.

استرجاع المهام

1. وسّع GET /tasks وحدد Try it out.
2. حدد Execute. تأكد من أن رمز الاستجابة 200 وأن جسم الاستجابة يُدرج المهمة My first API item! مع id المخصص عند إضافتها.

تحديث مهمة

1. وسّع PUT /tasks/{task_id} وحدد Try it out.

2. أدخل task_id للمهمة التي أنشأتها.

3. استبدل جسم الطلب بـ:

   {
     "task_name": "Build and ship a To-Do API"
   }

4. حدد Execute. تأكد من أن رمز الاستجابة 200 وأن المهمة المُعادة تُظهر task_name المحدّث.

5. غيّر task_id إلى قيمة غير موجودة وحدد Execute مرة أخرى. تأكد من أن رمز الاستجابة 404.

حذف مهمة

1. وسّع DELETE /tasks/{task_id} وحدد Try it out.
2. أدخل task_id للمهمة التي أنشأتها وحدد Execute. تأكد من أن رمز الاستجابة 204.
3. وسّع GET /tasks، وحدد Execute، وتأكد من أن المهمة لم تعد تظهر في الاستجابة.
4. وسّع DELETE /tasks/{task_id} مجدداً، وأدخل نفس task_id، وحدد Execute. تأكد من أن رمز الاستجابة 404.

هذا يؤكد أن التنفيذ، بما يشمل نقطة النهاية للتحديث التي أضفتها بالترميز الأدبي، يستوفي المتطلبات الأصلية.

بدء نافذة سياق جديدة

انقر على New task في مربع الدردشة أو + في أعلى لوحة الدردشة لبدء نافذة سياق جديدة.

اطلب من Bob اقتراحات للتحسين

في واجهة دردشة Bob، أدخل:

Review the To-Do API and suggest improvements to code quality, error handling, and HTTP status codes.

يرصد Bob الثغرات مثل نقطة النهاية المفقودة لاسترداد مهمة واحدة، ومخزن في الذاكرة يحتفظ بقواميس عادية بدلاً من نماذج Task المُتحقَّق منها، ومتغير id_counter على مستوى الوحدة يصعب إعادة تعيينه أو اختباره.

تطبيق التحسينات

اطلب من Bob تنفيذ الاقتراحات التي تريد الإبقاء عليها:

Add a GET /tasks/{task_id} endpoint that returns 404 when the task ID does not exist, and store tasks as Task models instead of dictionaries.

راجع التغييرات المقترحة وافق عليها لتطبيقها. اطلب من Bob إعادة بناء الصورة وإعادة تشغيل الحاوية، ثم كرّر خطوات التحقق. تأكد من أن GET /tasks/{task_id} يُعيد 200 مع المهمة لمعرّف صالح و404 لمعرّف غير معروف، وأن نقاط النهاية الموجودة لا تزال تتصرف كالسابق.

بدء نافذة سياق جديدة

انقر على New task في مربع الدردشة أو + في أعلى لوحة الدردشة لبدء نافذة سياق جديدة.

توليد اختبارات الوحدة

اسأل Bob:

Generate pytest unit tests for this application. Add pytest and httpx to a dev requirements file, build a test image, and run the suite in a container.

يضيف Bob تبعيات الاختبار pytest وhttpx، ويبني صورة تتضمنها، ويشغّل المجموعة في حاوية، ويُبلّغ بالنتائج. تشغيل الاختبارات في حاوية يعني أنك لا تحتاج إلى بيئة Python محلية. راجع الاختبارات المُولَّدة وحسّنها.

تظل مراجعة الاختبارات المُولَّدة وصيانتها مسؤوليتك.

توليد التوثيق التقني

اسأل Bob:

Generate technical documentation for this To-Do API.

يمكن لـ Bob توليد نظرة عامة على التطبيق، ووصف البنية، وملخصات نقاط النهاية، وأمثلة الطلب والاستجابة، وتعليمات الاستخدام. يكمّل هذا التوثيق توثيق واجهة برمجة التطبيقات الذي تولّده FastAPI تلقائياً.