1. نظرة عامة
تركّز هذه التجربة العملية على استخدام Gemini Code Assist، وهو وكيل مستنِد إلى الذكاء الاصطناعي في Google Cloud. سنتعلّم كيفية استخدام Gemini Code Assist في مهام المطوّرين الشائعة، بما في ذلك فهم قواعد الرموز البرمجية الحالية، وإنشاء المستندات واختبارات الوحدة، وإعادة تصميم مكوّنات الواجهات الأمامية والخلفية لتطبيقات الويب المصمّمة بلغة Python.
ما ستتعلمه
في هذه الميزة الاختبارية، ستتعرّف على كيفية تنفيذ ما يلي:
- كيفية استخدام Gemini Code Assist لإنجاز المهام الشائعة للمطوّرين
المتطلبات الأساسية
- يفترض هذا التمرين العملي معرفة بيئتَي Cloud Console وCloud Shell.
2. الإعداد والمتطلبات
إعداد مشروع على السحابة الإلكترونية
- سجِّل الدخول إلى Google Cloud Console وأنشِئ مشروعًا جديدًا أو أعِد استخدام مشروع حالي. إذا لم يكن لديك حساب على Gmail أو Google Workspace، عليك إنشاء حساب.



- اسم المشروع هو الاسم المعروض للمشاركين في هذا المشروع. وهي سلسلة أحرف لا تستخدمها Google APIs. ويمكنك تعديلها في أي وقت.
- رقم تعريف المشروع هو معرّف فريد في جميع مشاريع Google Cloud ولا يمكن تغييره بعد ضبطه. تنشئ Cloud Console تلقائيًا سلسلة فريدة، ولا يهمّك عادةً ما هي. في معظم دروس البرمجة، عليك الرجوع إلى رقم تعريف مشروعك (يُشار إليه عادةً باسم
PROJECT_ID). إذا لم يعجبك رقم التعريف الذي تم إنشاؤه، يمكنك إنشاء رقم تعريف عشوائي آخر. يمكنك بدلاً من ذلك تجربة اسم من اختيارك ومعرفة ما إذا كان متاحًا. لا يمكن تغيير هذا الخيار بعد هذه الخطوة وسيظل ساريًا طوال مدة المشروع. - للعلم، هناك قيمة ثالثة، وهي رقم المشروع، تستخدمها بعض واجهات برمجة التطبيقات. يمكنك الاطّلاع على مزيد من المعلومات عن كل هذه القيم الثلاث في المستندات.
- بعد ذلك، عليك تفعيل الفوترة في Cloud Console لاستخدام موارد/واجهات برمجة تطبيقات Cloud. لن تكلفك تجربة هذا الدرس التطبيقي حول الترميز الكثير، إن وُجدت أي تكلفة على الإطلاق. لإيقاف الموارد وتجنُّب تحمّل تكاليف فوترة تتجاوز هذا البرنامج التعليمي، يمكنك حذف الموارد التي أنشأتها أو حذف المشروع. يمكن لمستخدمي Google Cloud الجدد الاستفادة من برنامج الفترة التجريبية المجانية بقيمة 300 دولار أمريكي.
إعداد البيئة
افتح محادثة Gemini.

أو اكتب "اسأل Gemini" في شريط البحث.

فعِّل واجهة برمجة التطبيقات Gemini for Google Cloud API باتّباع الخطوات التالية:

فعِّل ميزة "التحكّم في النشاط على Google" على الشاشة التالية.

انقر على "Start chatting" واتّبِع أحد الأسئلة النموذجية أو اكتب طلبك الخاص لتجربته.

إليك بعض الطلبات التي يمكن تجربتها:
- اشرح Cloud Run في 5 نقاط رئيسية.
- أنا مدير منتج Cloud Run في Google Cloud، وأريد شرح Cloud Run لطالب في 5 نقاط رئيسية قصيرة.
- أنت مدير منتج في Google Cloud Run، اشرح خدمة Cloud Run لمطوّر معتمد في Kubernetes في 5 نقاط رئيسية قصيرة.
- أنت مدير منتج في Google Cloud Run، اشرح متى تستخدم Cloud Run بدلاً من GKE لمطوّر أقدم في 5 نقاط رئيسية قصيرة.
أغلِق نافذة محادثة Gemini Cloud Assist بعد الانتهاء.
يمكنك الاطّلاع على دليل الطلبات لمعرفة المزيد حول كتابة طلبات أفضل.
كيف يستخدم "Gemini في Google Cloud" بياناتك؟
التزام Google بالخصوصية
كانت Google من أوائل الشركات في المجال التي نشرت التزامًا بشأن خصوصية الذكاء الاصطناعي/تعلُّم الآلة، والذي يوضّح اعتقادنا بأنّه يجب أن يحصل العملاء على أعلى مستوى من الأمان والتحكّم في بياناتهم المخزّنة في السحابة الإلكترونية.
البيانات التي ترسلها وتتلقّاها
تُعرف الأسئلة التي تطرحها على Gemini، بما في ذلك أي معلومات أو رموز برمجية ترسلها إلى Gemini لتحليلها أو إكمالها، باسم الطلبات. تُعرف الإجابات أو عمليات إكمال الرمز البرمجي التي تتلقّاها من Gemini باسم الردود. لا يستخدم Gemini طلباتك أو ردوده كبيانات لتدريب نماذجه.
تشفير الطلبات
عند إرسال طلبات إلى Gemini، يتم تشفير بياناتك أثناء نقلها كمدخلات إلى النموذج الأساسي في Gemini.
بيانات البرنامج من إنشاء Gemini
يتم تدريب Gemini على رمز Google Cloud للطرف الأول بالإضافة إلى رمز الطرف الثالث المحدّد. تتحمّل أنت مسؤولية أمان الرمز واختباره وفعاليته، بما في ذلك أي عملية إكمال أو إنشاء أو تحليل للرمز يقدّمه لك Gemini.
مزيد من المعلومات حول طريقة Google في معالجة طلباتك
3- خيارات لاختبار الطلبات
إذا أردت تغيير الطلبات الحالية، تتوفّر لك عدة خيارات.
Vertex AI Studio هو جزء من منصة Vertex AI من Google Cloud، وهو مصمَّم خصيصًا لتبسيط عملية تطوير نماذج الذكاء الاصطناعي التوليدي وتسريعها واستخدامها.
Google AI Studio هي أداة مستندة إلى الويب تتيح إنشاء نماذج أولية وتجربة هندسة الطلبات وGemini API.
- تطبيق Gemini للويب (gemini.google.com)
تطبيق Google Gemini للويب (gemini.google.com) هو أداة مستندة إلى الويب مصمّمة لمساعدتك في استكشاف إمكانات نماذج الذكاء الاصطناعي Gemini من Google والاستفادة منها.
- تطبيق Google Gemini للأجهزة الجوّالة على Android وتطبيق Google على iOS
4. تنزيل التطبيق وفحصه
فعِّل Cloud Shell من خلال النقر على الرمز على يسار شريط البحث.

إذا طُلب منك منح الإذن، انقر على "منح الإذن" للمتابعة.

في الوحدة الطرفية، نفِّذ الأوامر أدناه لاستنساخ مستودع Git محليًا.
git clone https://github.com/gitrey/calendar-app-lab
cd calendar-app-lab
ابدأ "محرّر Cloud Shell".

افتح مجلد "calendar-app-lab".

ابدأ وحدة طرفية جديدة في "محرِّر Cloud Shell".

يجب أن تبدو بيئتك مشابهة للقطة الشاشة أدناه.

في نافذة محادثة Gemini Code Assist، أرسِل الطلب التالي:
Don't suggest any changes. Explain this codebase to me.
مثال على الناتج:

5- بدء تشغيل التطبيق على الجهاز
في نافذة المحادثة، أرسِل الطلب التالي:
How do I set up a virtual environment and run this app locally?
تشغيل الأوامر المقترَحة في الوحدة الطرفية:

ثبِّت التبعيات:

ابدأ تشغيل التطبيق:

انقر على الرابط لمعاينة التطبيق:

مثال على الناتج:


6. إضافة مستندات
في نافذة المحادثة، أرسِل الطلب التالي:
Add docstrings to all files
مراجعة التغييرات المقترَحة وقبولها في المحادثة:

في نافذة المحادثة، أرسِل الطلب التالي:
update .gitignore and add venv/* folder
يلي ذلك الطلب التالي:
update .gitignore and add __pycache__ folder
مثال على الناتج:

انتقِل إلى "عرض التحكّم بالمصدر" وراجِع التغييرات التي أجريتها حتى الآن:

7. إضافة اختبارات الوحدات
افتح ملف calendar.py واختَر Gemini Code Assist >> Generate Unit Tests من قائمة السياقات.

اضغط على Enter في نافذة محادثة Gemini Code Assist. راجِع التغييرات واقبلها.

اسأل Gemini عن كيفية إجراء الاختبارات:
How do I run the tests?
نفِّذ الأوامر المقترَحة في الوحدة الطرفية وراجِع الناتج.

8. البحث عن الأخطاء
افتح الملف calendar.py وأرسِل الطلب التالي في نافذة المحادثة:
Are there any bugs in the conversion logic?
مراجعة التغييرات المقترَحة وقبولها في المحادثة:

أعِد تشغيل اختبارات الوحدات للتحقّق من صحة التغييرات:
python3 test_calendar.py
إذا ظهرت لك رسائل خطأ، يمكنك اختيار الخطأ وإضافته إلى السياق ليساعدك Gemini في تحديد المشاكل وحلّها.

9- Refactor UI
في نافذة المحادثة، أرسِل الطلب التالي:
Refactor UI to use bootstrap library
راجِع التغييرات واقبلها باتّباع الخطوات التالية:

ابدأ تشغيل التطبيق أو أعِد تحميل الصفحة إذا كان التطبيق قيد التشغيل.
في الوحدة الطرفية، ابدأ تشغيل التطبيق إذا لم يكن قيد التشغيل:
python3 main.py
يُرجى إعادة تحميل الصفحة والتحقّق من التغييرات.


جرِّب إرسال رقم سالب للتحقّق من صفحة الخطأ.


10. إعادة هيكلة الخلفية
في نافذة المحادثة، أرسِل الطلب التالي:
Store requests in memory and create a page to display conversion history. Add links on all pages to view the history.
راجِع التغييرات في المحادثة واقبلها باتّباع الخطوات التالية:

ابدأ تشغيل التطبيق من خلال تنفيذ الأمر التالي في الوحدة الطرفية:
python3 main.py
الوصول إلى التطبيق وإرسال طلبات متعددة قبل مراجعة صفحة السجلّ

راجِع سجلّ طلبات الإحالة الناجحة.

11. الخلاصة حول Gemini Code Assist
لقد رأيت الآن كيف يمكن لأداة Gemini Code Assist تبسيط العديد من مهام التطوير بشكل كبير، بدءًا من فهم الرموز البرمجية الحالية إلى إنشاء المستندات واختبارات الوحدة وإعادة تصميم مكوّنات واجهة المستخدم والخلفية. وبفضل قدرته على فهم السياق وتقديم اقتراحات ذات صلة، يشكّل أداة فعالة للمطوّرين.
ننصحك بتجربة المزيد من الميزات في Gemini Code Assist. جرِّب طلبات مختلفة، واستكشِف إمكاناته باستخدام قواعد الرموز الخاصة بك، واكتشِف كيف يمكنه تحسين سير عملك اليومي في التطوير. وكلّما تفاعلت معه أكثر، اكتشفت إمكاناته في تسريع إنتاجيتك وتحسين جودة الرمز.
12. تهانينا!
تهانينا، لقد أكملت درس البرمجة.
المواضيع التي تناولناها:
- استخدام Gemini Code Assist لتنفيذ مهام المطوّرين الشائعة
الخطوة التالية:
- سنقدّم المزيد من الجلسات العملية قريبًا.
تَنظيم
لتجنُّب تحمّل رسوم في حسابك على Google Cloud مقابل الموارد المستخدَمة في هذا البرنامج التعليمي، احذف المشروع الذي يحتوي على الموارد أو احتفظ بالمشروع واحذف الموارد الفردية.
حذف المشروع
أسهل طريقة لإيقاف الفوترة هي حذف المشروع الذي أنشأته لتنفيذ البرنامج التعليمي.
© 2024 Google LLC. جميع الحقوق محفوظة. Google وشعار Google هما علامتان تجاريتان (TM) تابعتان لشركة Google LLC. جميع أسماء الشركات والمنتجات الأخرى قد تكون علامات تجارية للشركات المالكة لها.