1. مقدمة
ستنشئ وكيلاً يمكنه الإجابة عن أي طلب بحث حول الأخبار، ثم ستنشره في Cloud Run. يمكن أن تتناول الأخبار أي موضوع يخصّ موقعًا جغرافيًا واحدًا فقط، وهو "بنغالور". يمكن أن تكون بعض طلبات البحث كما يلي:
- هل يمكنك إخباري ببعض آخر الأخبار من بنغالور؟
- أريد بعض الأخبار الحديثة المتعلقة بحركة المرور في بنغالور.
يمكنك نشر الوكلاء على Cloud Run. سننشئ وكيلاً بسيطًا يستخدم النموذج وأداة محلية، ثم سننشره.
ما ستتعلمه
- كيفية إعداد مشروع على Google Cloud لخدمة Cloud Run
- كيفية إنشاء وكيل ذكاء اصطناعي بسيط باستخدام Google ADK
- كيفية تحديد الأدوات المحلية واستخدامها داخل الوكيل
- كيفية تجميع الوكيل باستخدام 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.