Codelab: Cloud Run Day 2025 - Workshop 1

1. مقدمه

شما یک عامل ایجاد خواهید کرد که می تواند به هر سؤالی در مورد اخبار پاسخ دهد و آن را در Cloud Run مستقر کند. اخبار می تواند در مورد هر موضوعی باشد که فقط به یک مکان "بنگالور" مربوط می شود. برخی از پرس و جوها می تواند باشد:

  • آیا می توانید در مورد آخرین اخبار بنگالورو به من بگویید؟
  • چند خبر اخیر مرتبط با ترافیک بنگالورو به من بدهید.

می توانید Agents را در Cloud Run مستقر کنید. ما یک عامل ساده ایجاد می کنیم که از مدل و یک ابزار محلی استفاده می کند، سپس آن را مستقر می کنیم.

آنچه خواهید آموخت

  • نحوه راه اندازی یک پروژه Google Cloud برای Cloud Run.
  • چگونه با استفاده از Google ADK یک عامل هوش مصنوعی ساده بسازیم.
  • نحوه تعریف و استفاده از ابزارهای محلی در یک عامل.
  • نحوه بسته بندی نماینده با استفاده از Docker.
  • نحوه استقرار عامل به عنوان یک سرویس در Google Cloud Run.
  • نحوه تعامل با عامل مستقر شده از طریق رابط کاربری وب.

آنچه شما نیاز خواهید داشت

  • یک اکانت جیمیل
  • مرورگر کروم

2. راه اندازی

  1. تمام دستورالعمل های راه اندازی را در اینجا تکمیل کنید
  2. به دایرکتوری کارگاه اول بروید:
cd Cloud-Run-Day-Workshop-2025/workshop1

3. Agent را در 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 مستقر شده را خروجی می دهد.

اسکرین شات از خروجی URL سرویس Cloud Run

وقتی پیوند را باز می‌کنید، می‌توانید مستقیماً با عامل خود با استفاده از رابط کاربری وب ADK تعامل داشته باشید:

تصویری از رابط کاربری وب ADK

5. پاکسازی

برای جلوگیری از تحمیل هزینه‌های آینده، سرویس Cloud Run را که ایجاد کرده‌اید حذف کنید.

gcloud run services delete news-assistant-agent --$REGION $GOOGLE_CLOUD_LOCATION  --quiet

6. تبریک!

شما با موفقیت یک AI News Agent را در Google Cloud Run ساخته و مستقر کرده اید!