۱. مقدمه
شما یک عامل ایجاد خواهید کرد که میتواند به هر پرسشی در مورد اخبار پاسخ دهد و آن را در Cloud Run مستقر کند. اخبار میتواند در مورد هر موضوعی باشد که فقط به یک مکان «بنگلور» مربوط باشد. برخی از پرسشها میتوانند عبارتند از:
- میشه یه کم از آخرین اخبار بنگلور برام بگی؟
- چند خبر جدید در مورد ترافیک بنگلور به من بدهید.
شما میتوانید Agentها را روی Cloud Run مستقر کنید. ما یک Agent ساده ایجاد میکنیم که از مدل و یک ابزار محلی استفاده میکند، سپس آن را مستقر میکنیم.
آنچه یاد خواهید گرفت
- نحوه راهاندازی یک پروژه ابری گوگل برای Cloud Run.
- چگونه با استفاده از Google ADK یک عامل هوش مصنوعی ساده بسازیم؟
- نحوه تعریف و استفاده از ابزارهای محلی درون عامل.
- نحوه بستهبندی عامل با استفاده از داکر.
- نحوه استقرار عامل به عنوان سرویس در Google Cloud Run.
- نحوه تعامل با عامل مستقر شده از طریق رابط کاربری وب.
آنچه شما نیاز خواهید داشت
- یک حساب جیمیل
- مرورگر کروم
۲. راهاندازی
- مطمئن شوید که پروژه گوگل کلود (Google Cloud Project) را به همراه تنظیمات صورتحساب (Billing setup) دارید.
- مخزن گیتهاب را کلون کنید:
git clone https://github.com/abhishekr700/Cloud-Run-Day-Workshop-2025.git
- برای کارگاه اول به دایرکتوری بروید:
cd Cloud-Run-Day-Workshop-2025/workshop1
۳. عامل را در 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» استقرار را تأیید کنید.)
۴. عامل را آزمایش کنید
پس از استقرار موفقیتآمیز، Cloud Shell آدرس اینترنتی (URL) سرویس Cloud Run مستقر شده را نمایش میدهد.
وقتی لینک را باز میکنید، میتوانید مستقیماً با استفاده از رابط کاربری وب ADK با نماینده خود تعامل داشته باشید:
۵. پاکسازی
برای جلوگیری از هزینههای بعدی، سرویس Cloud Run که ایجاد کردهاید را حذف کنید.
gcloud run services delete news-assistant-agent --region $REGION $GOOGLE_CLOUD_LOCATION --quiet
۶. تبریک میگویم!
شما با موفقیت یک عامل خبری هوش مصنوعی را ساخته و در Google Cloud Run مستقر کردهاید!