Codelab: Cloud Run Day 2025 - Setup

1. מבוא

תצרו סוכן שיכול לענות על כל שאלה לגבי חדשות ותפרסו אותו ב-Cloud Run. החדשות יכולות להיות על כל נושא שקשור רק למיקום אחד, 'בנגלור'. דוגמאות לשאילתות:

  • תספר לי על כמה חדשות עדכניות מבנגלור.
  • תן לי כמה חדשות עדכניות שקשורות לתנועה בבנגלור.

אפשר לפרוס סוכנים ב-Cloud Run. ניצור סוכן פשוט שמשתמש במודל ובכלי מקומי, ואז נפעיל אותו.

מה תלמדו

  • איך מגדירים פרויקט ב-Google Cloud לשימוש ב-Cloud Run.
  • איך יוצרים סוכן AI פשוט באמצעות Google ADK.
  • איך מגדירים כלים מקומיים ומשתמשים בהם בסוכן.
  • איך לארוז את הסוכן באמצעות Docker.
  • איך פורסים את הסוכן כשירות ב-Google Cloud Run.
  • איך מבצעים אינטראקציה עם הסוכן שפרסתם דרך ממשק משתמש באינטרנט.

מה צריך

  • חשבון Gmail
  • דפדפן Chrome

2. הגדרת סביבת Google Cloud

קבלת קרדיטים ל-Cloud

כדי לממש את שובר המתנה, תצטרכו אותו לפריסה. חשוב להשתמש בחשבון Gmail.

יצירת פרויקט

  1. ב-Google Cloud Console, בדף לבחירת הפרויקט, בוחרים או יוצרים פרויקט ב-Google Cloud.
  2. מוודאים שהחיוב מופעל בפרויקט ב-Cloud. כך בודקים אם החיוב מופעל בפרויקט
  3. לוחצים על הקישור כדי להפעיל את Cloud Shell.
  4. כדי להגדיר את החשבון הפעיל, מריצים את הפקודה הבאה ב-Cloud Shell:
gcloud config set account <ACCOUNT>

שימו לב: ACCOUNT היא כתובת Gmail שבה השתמשתם כדי להיכנס ל-Google Cloud.

  1. מריצים את הפקודה הבאה ב-Cloud Shell כדי לבדוק את האימות:
gcloud auth list
  1. כדי לוודא מה מזהה הפרויקט, מריצים את הפקודה הבאה:
gcloud config list project
  1. מגדירים את המשתנה של מזהה הפרויקט. מחליפים את <YOUR_PROJECT_ID> במזהה מהשלב הקודם:
export PROJECT_ID=<YOUR_PROJECT_ID> && gcloud config set project $PROJECT_ID
export REGION=europe-west1 && gcloud config set run/region $REGION
  1. הגדרת מפתח Google API:

יוצרים מפתח API בכתובת https://aistudio.google.com/app/apikey ומדביקים אותו כאן:

export GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE
export GOOGLE_GENAI_USE_VERTEXAI=FALSE
  1. מפעילים את ממשקי ה-API הנדרשים:
gcloud services enable cloudresourcemanager.googleapis.com \
    servicenetworking.googleapis.com \
    run.googleapis.com \
    cloudbuild.googleapis.com \
    artifactregistry.googleapis.com \
    aiplatform.googleapis.com \
    compute.googleapis.com \
    storage.googleapis.com

(הפעולה הזו עשויה להימשך כמה דקות).

שיבוט של דוגמאות קוד לסדנאות של Cloud Run Day

כדי לגשת לקוד לדוגמה של כל הסדנאות, משכפלים את כל המאגר:

git clone https://github.com/shrutimantri/first-adk-agent5.git

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. בדיקת הנציג

אחרי פריסה מוצלחת, כתובת ה-URL של שירות Cloud Run שנפרס תוצג ב-Cloud Shell.

צילום מסך של פלט כתובת ה-URL של שירות Cloud Run

כשפותחים את הקישור, אפשר ליצור אינטראקציה ישירה עם הסוכן באמצעות ממשק המשתמש באינטרנט של ADK:

צילום מסך של ממשק המשתמש של ADK בדפדפן

5. הסרת המשאבים

כדי להימנע מחיובים עתידיים, צריך למחוק את שירות Cloud Run שיצרתם.

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

6. מעולה!

הצלחתם ליצור ולפרוס סוכן חדשות מבוסס-AI ב-Google Cloud Run!