1. مقدمة
ستنشئ وكيلاً يمكنه الإجابة عن أي طلب بحث حول الأخبار، ثم ستنشره في Cloud Run. يمكن أن تكون الأخبار حول أي موضوع يخصّ موقعًا جغرافيًا واحدًا فقط، وهو "بنغالور". يمكن أن تكون بعض طلبات البحث كما يلي:
- هل يمكنك إخباري ببعض آخر الأخبار من بنغالور؟
- أريد بعض الأخبار الحديثة المتعلقة بحركة المرور في بنغالور.
يمكنك نشر "الوكلاء" على Cloud Run. سننشئ وكيلاً بسيطًا يستخدم النموذج وأداة محلية، ثم سننشره.
ما ستتعلمه
- كيفية إعداد مشروع على Google Cloud لاستخدام Cloud Run
- كيفية إنشاء وكيل بسيط يعمل بالذكاء الاصطناعي باستخدام "حزمة تطوير التطبيقات" من Google
- كيفية تحديد الأدوات المحلية واستخدامها داخل الوكيل
- كيفية تجميع الوكيل باستخدام Docker
- كيفية نشر الوكيل كخدمة على Google Cloud Run
- كيفية التفاعل مع الوكيل الذي تم نشره من خلال واجهة مستخدم على الويب
المتطلبات
- حساب Gmail
- متصفّح Chrome
2. الإعداد
- تأكَّد من توفّر مشروع Google Cloud مع إعداد الفوترة.
- استنسِخ مستودع Github:
git clone https://github.com/abhishekr700/Cloud-Run-Day-Workshop-2025.git
- انتقِل إلى دليل ورشة العمل الأولى:
cd Cloud-Run-Day-Workshop-2025/workshop1
3- نشر الوكيل على Cloud Run
بعد أن تصبح جميع الملفات جاهزة في محرّر Cloud Shell، نفِّذ الأوامر التالية في وحدة Cloud Shell الطرفية لنشر الخدمة على Cloud Run:
gcloud run deploy news-assistant-agent \
--source . \
--region $REGION \
--project $PROJECT_ID \
--allow-unauthenticated \
--set-env-vars="GOOGLE_GENAI_USE_VERTEXAI=$GOOGLE_GENAI_USE_VERTEXAI,GOOGLE_API_KEY=$GOOGLE_API_KEY"
(أكِّد عملية التفعيل بكتابة "Y" عند/إذا طُلب منك ذلك.)
4. اختبار الوكيل
بعد اكتمال عملية النشر بنجاح، ستعرض Cloud Shell عنوان URL لخدمة Cloud Run التي تم نشرها.
عند فتح الرابط، يمكنك التفاعل مباشرةً مع وكيلك باستخدام واجهة مستخدم الويب الخاصة بـ ADK:
5- تنظيف
لتجنُّب تحمّل رسوم مستقبلية، احذف خدمة Cloud Run التي أنشأتها.
gcloud run services delete news-assistant-agent --region $REGION $GOOGLE_CLOUD_LOCATION --quiet
6. تهانينا!
لقد أنشأت ونشرت بنجاح "وكيل أخبار" يعمل بالذكاء الاصطناعي على Google Cloud Run.