תכנון סוכנים ב-Agent Studio

בדף הזה מוסבר איך משתמשים ב-Agent Studio במסוףGoogle Cloud .

‫Agent Studio הוא כלי לעיצוב חזותי עם תכנות מינימלי במסוף Google Cloud , שמאפשר לפתח סוכנים בקלות. אתם יכולים למפות באופן חזותי את Agentic Workflows, לבדוק את התשובות בזמן אמת ולנסות הגדרות שונות לפני שאתם פורסים או עוברים לקוד.

מסמך זה מספק סקירה כללית של Agent Studio ומסביר איך להגדיר את הסביבה, ליצור ולבדוק סוכנים ולפרוס אותם ישירות בסביבת זמן ריצה בסביבת הייצור.

מגדירים את הסביבה

לפני שמשתמשים ב-Agent Studio, צריך להגדיר אתGoogle Cloud.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות לשימוש ב-Agent Studio, צריך לבקש מהאדמין להקצות לכם את התפקיד משתמש ב-Agent Platform (roles/aiplatform.user) ב-IAM בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

יצירת סוכן

אתם יכולים ליצור סוכן ב-Agent Studio באמצעות הנחיות או הכלי ליצירת תהליכים.

איך יוצרים סוכן באמצעות הנחיות

כדי ליצור נציג באמצעות הנחיות:

  1. נכנסים לדף Agents במסוף Google Cloud .

    לדף Agents

  2. לוחצים על יצירת סוכן כדי לפתוח את אזור העריכה של Agent Studio לסוכן חדש.

  3. בתיבת הצ'אט, כותבים הנחיה שמתארת את המטרה וההתנהגות הרצויה של הנציג.

  4. לחץ על .

  5. בהתאם להנחיה, תתבצע אחת מהפעולות הבאות:

    • הצלחה: כלי הפיתוח של התהליך מתעדכן מיד ומציג את התצוגה המקדימה של הנציג בזמן אמת, והצ'אט מספק סיכום של השינויים שבוצעו. כל השינויים נשמרים אוטומטית.

    • Clarification needed: אם ההנחיה לא ברורה, העוזר הדיגיטלי שואל שאלה להבהרה בצ'אט כדי להבין טוב יותר מה אתם רוצים ליצור.

    • שגיאה: אם הכלי לא יכול ליישם את ההנחיה, תופיע הודעת שגיאה שתבקש מכם לנסח מחדש את הבקשה.

  6. אתם יכולים להמשיך לעדכן את הנציג באמצעות הנחיות או הכלי ליצירת תהליכים.

  7. כדי לשמור את הנציג, לוחצים על Save בכותרת של אזור העריכה ופועלים לפי ההנחיות. פרטים נוספים זמינים במאמר שמירת נציג.

  8. כדי לבדוק את היכולות והתשובות של הסוכן בזמן שאתם יוצרים אותו, לחצו על הכרטיסייה תצוגה מקדימה ודברו איתו בצ'אט.

מגבלות

המגבלות הבאות חלות כשיוצרים סוכן באמצעות הנחיות:

יכולת מגבלה
ידע אי אפשר להוסיף מאגר ידע לסוכן. אתם יכולים להשתמש בממשק של הכלי ליצירת תהליכים כדי להוסיף ידע לנציג.

יצירת נציג באמצעות הכלי ליצירת תהליכים

כדי לתכנן ולבדוק נציג באמצעות הכלי ליצירת תהליכים:

  1. נכנסים לדף Agents במסוף Google Cloud .

    לדף Agents

  2. לוחצים על יצירת נציג כדי לפתוח את אזור העריכה של Agent Studio לנציג חדש.

  3. מעצבים ושומרים את הסוכן ב-Agent Studio. אתם יכולים ליצור סוכן ראשי ולהוסיף סוכני משנה. הסוכן הראשי הוא תמיד סוכן מקומי. סוכני משנה יכולים להיות סוכנים מקומיים או סוכנים מ-Agent Registry:

    • סוכן מקומי: סוכן שההוראות, המודל והכלים שלו נוצרים ומוגדרים ישירות ב-Agent Studio.
    • סוכן ב-Agent Registry: סוכן שרשום ומפורסם ב-Agent Registry. אתם יכולים להשתמש בסוכנים האלה כסוכני משנה מרוחקים בתהליך של הסוכן הראשי.

    במהלך העיצוב, אתם יכולים לעבור בין הכרטיסיות הבאות: Flow ו-Preview:

    Flow

    יוצרים את הנציג הראשי ואת נציגי המשנה באמצעות ייצוג חזותי של תהליך העבודה ולוגיקת הבקרה של הנציג.

    1. לוחצים על נציג כדי לפתוח את החלונית Details של אותו נציג. אפשר גם ללחוץ על הוספת סוכן משנה (+) כדי להוסיף סוכני משנה.

    2. מגדירים את הסוכן הראשי ואת סוכני המשנה בחלונית Details:

      לסוכן הראשי ולסוכני המשנה המקומיים:

      1. שם: מוסיפים שם שיעזור לזהות את הנציג.
      2. תיאור: סיכום של מטרת הסוכן.
      3. הוראות: מוסיפים הוראות שינחו את ה-Agent.
      4. מודל: בוחרים את המודל שיפעיל את הסוכן.
      5. כלים: לוחצים על הוספת כלים (+) כדי להוסיף כלים שמאפשרים לנציג להשלים משימות. מידע נוסף מופיע במאמר הגדרה והוספה של כלים.

      לסוכני משנה (מקומיים או ממרשם הסוכנים):

      1. מקור סוכן המשנה: בוחרים את המקור של סוכן המשנה:

        • מקומי: כותבים את ההוראות, המודל והכלים של סוכן המשנה ישירות באזור העבודה.
        • ‫Agent Registry: בחירת נציג רשום מ-Agent Registry כנציג משנה מרוחק. האפשרות הזו זמינה רק אחרי ששומרים את הנציג. פרטים נוספים זמינים במאמר שמירת נציג.

        כשבוחרים נציג רשום, השם והתיאור שלו מיובאים מהמרשם ומופיעים לקריאה בלבד בלוח הציור. הסוכן הראשי מנתב משימות לסוכן המשנה הזה על סמך כרטיס הסוכן שלו.

        כדי להריץ או לפרוס את הסוכן הראשי, הזהות של הסוכן הראשי צריכה לקבל הרשאות לגלות ולהפעיל סוכני משנה של A2A. תיבת הדו-שיח של ההרשאות מטפלת בפעולה הזו באופן אוטומטי. אם אתם צריכים לנהל את ההרשאות באופן ידני, קראו את המאמר מתן גישה להעברת נתונים בין סוכנים (A2A).

    3. כדי לשמור את הנציג, לוחצים על Save בכותרת של אזור העריכה ופועלים לפי ההנחיות. פרטים נוספים זמינים במאמר שמירת נציג.

    תצוגה מקדימה

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

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

    אם הנציג משתמש בנציג משנה מרוחק מ-Agent Registry, קוד ה-Python שנוצר כולל קריאה ל-AgentRegistry.get_remote_a2a_agent כדי לפתור באופן דינמי את נציג המשנה בזמן הריצה.

כשהסוכן מוכן, אתם יכולים לפרוס אותו ישירות מ-Agent Studio. מידע נוסף זמין במאמר פריסת נציג מ-Agent Studio.

יצירת סוכן באמצעות המתג של מצב הסוכנים בהנחיה ב-Studio

כדי להתחיל ליצור סוכנים ישירות מההנחיה הראשונית ב-Agent Studio, עוברים למצב סוכנים. כשהאפשרות הזו מופעלת, שליחת ההנחיה מפעילה ישירות את Agent Builder בתוך אזור העריכה של Agent Designer.

כדי ליצור סוכן מההנחיה ב-Studio:

  1. במסוף Google Cloud , נכנסים אל Agent Studio.

  2. באזור הקלט של ההנחיה הראשית בסביבת העבודה, מאתרים את המתג להחלפת מצב.

  3. מעבירים את המתג למצב Agents.

  4. מזינים הנחיה שמתארת את המטרה, את תהליך העבודה ואת ההתנהגות של הנציג שרוצים לעצב.

  5. לחץ על .

‫Agent Studio מפעיל ישירות את כלי פיתוח הסוכנים באזור העריכה של כלי לתכנון סוכנים, ומאכלס שדות מראש את התהליך וההגדרות של הסוכן על סמך הפרומפט שלכם. אחר כך אפשר להמשיך לערוך את ההוראות, לבחור מודלים ולהוסיף כלים או סוכני משנה.

בדיקת אירועים של נציגים

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

כדי לנפות באגים בהפעלה של הנציג, אתם יכולים לבדוק את האירועים של הנציג בכרטיסייה Preview ב-Agent Studio. הפעולה הזו מאפשרת לכם לאבחן בעיות באירועים הספציפיים שהנציג יוצר במהלך ההפעלה.

כדי לבדוק את האירועים של הנציג, פועלים לפי השלבים הבאים:

  1. פותחים את הנציג ב-Agent Studio ולוחצים על הכרטיסייה Preview.
  2. כדי להתחיל הרצה, פותחים שיחה עם הנציג בחלונית התצוגה המקדימה.

  3. בוחרים אירוע בשיחה כדי לפתוח את הפרטים שלו. הפרטים שזמינים תלויים באירוע, ויכולים לכלול את הדברים הבאים:

    • מחבר: הנציג או נציג המשנה שיצרו את האירוע. אפשר להשתמש בשדה author כדי לזהות איזה סוכן משנה ביצע שלב בתהליך עבודה עם כמה סוכנים.
    • בקשה ותשובה: המטען הייעודי (payload) שנשלח למודל והתשובה שהתקבלה.
    • קריאות לכלים: הארגומנטים שמועברים לכלים במהלך הפעלת הנציג.
    • מטא-נתונים: מידע נוסף לצורך אבחון, כמו שם המודל, השימוש באסימונים וחותמת הזמן.

אם הסוכן מחזיר שגיאה במהלך התצוגה המקדימה, השגיאה מופיעה בכרטיסייה Preview כדי שתוכלו לאבחן את הבעיה.

שמירת סוכן

כדי להציג את הסוכן בתצוגה מקדימה, לפרוס אותו או להעלות קובצי ידע, צריך קודם לשמור אותו, כי לסוכן שלא נשמר עדיין אין זהות. הדרישה הזו חלה גם על סוכני משנה ב-Agent Registry.

בנוסף, צריך לשמור את הסוכן לפני שמוסיפים שרתי MCP שפורסמו ב-Agent Registry ככלים ברמת הצומת.

כדי לשמור סוכן בפעם הראשונה:

  1. ב-Agent Studio, לוחצים על Save.

  2. בתיבת הדו-שיח Save Agent, מזינים את השם של הסוכן בשדה Agent name.

  3. לוחצים על Save.

אחרי השמירה הראשונה, Agent Studio שומר באופן אוטומטי את כל השינויים הנוספים שתבצעו. אם תנסו לצאת מה-canvas לפני ששמרתם סוכן חדש, Agent Studio יבקש מכם לשמור אותו קודם.

עדכון סוכן

כדי לעדכן נציג:

  1. נכנסים לדף Agents במסוף Google Cloud .

    כניסה לדף Agents

  2. בסוכן שרוצים לעדכן, לוחצים על ואז על Edit.

  3. מעדכנים את הנציג באמצעות הנחיות או הכלי ליצירת תהליכים.

השינויים נשמרים באופן אוטומטי ב-Agent Studio.

הגדרה והוספה של כלים ב-Agent Studio

אתם יכולים להגדיר את הכלים הבאים לנציג:

  • חיפוש Google: מאפשר לסוכן לבצע חיפושים באינטרנט באמצעות חיפוש Google. המתג מופעל כברירת מחדל.

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

  • ‫שרת MCP מ-Agent Registry: צירוף שרת MCP שפורסם ב-Agent Registry ככלי ברמת הצומת. האפשרות הזו זמינה רק אחרי ששומרים את הנציג. פרטים נוספים זמינים במאמר שמירת נציג.

    1. לוחצים על הוספה (+) לצד שרת MCP מ-Agent Registry.
    2. מיקום: בוחרים את האזור כדי לסנן את הכלים הרשומים.
    3. שרת MCP: בוחרים מהרשימה את שרת Google MCP הרשום.
    4. Auth Config: בוחרים באפשרות None כדי להשתמש בגישה רגילה לשירות, שנקבעת באמצעות קישורי IAM.
    5. לוחצים על הוספה.
    6. אם שומרים את הנציג בפעם הראשונה, לוחצים על Save בכותרת של אזור העריכה. שינויים נוספים נשמרים באופן אוטומטי.

    הסוכן יכול להשתמש בכל הכלים בשרת ה-MCP המחובר.

העברת כלים מדור קודם

כדי לסייע באכיפת האבטחה ולנהל את הכלים באופן אחיד באמצעות Agent Registry, ב-Agent Studio הוצאנו משימוש את השילוב הישיר עם מאגרי הנתונים של חיפוש מבוסס-Vertex AI ואת השרתים הישירים של Model Context Protocol‏ (MCP).

בסוכנים קיימים, הכלים האלה שהוצאו משימוש זמינים לקריאה בלבד. כדי לשמור על פונקציונליות מלאה, צריך לעבור לשרת MCP מ-Agent Registry.

מעבר ממאגרי נתונים מדור קודם של חיפוש מבוסס-Vertex AI

אם הסוכן שלכם משתמש בכלי "מאגר נתונים לחיפוש" של Agent Platform שהוצא משימוש, אתם צריכים לעבור לשרת ה-MCP של "חיפוש מבוסס סוכנים" שזמין ב-Agent Registry. הכלי הזה מופיע בתור discoveryengine.googleapis.com ב-Agent Registry.

כשמחברים את שרת ה-MCP של "חיפוש מבוסס סוכנים", צריך להגדיר את תצורת הצגת המודעות לטירגוט בהוראות של הסוכן. בנוסף, זהות הסוכן צריכה הרשאות גישה.

כדי להעביר את הנתונים, פועלים לפי השלבים הבאים:

  1. פותחים את הסוכן ב-Agent Studio.
  2. בחלונית כלים, מאתרים את הכלי "מאגר הנתונים של חיפוש מבוסס-Vertex AI".
  3. שימו לב להגדרות של הכלי, כמו מזהה הפרויקט, המיקום ומזהה מאגר הנתונים.
  4. יוצרים נציג חדש ושומרים אותו.
  5. מקצים לזהות הסוכן את התפקיד "צפייה ב-Discovery Engine"‏ (roles/discoveryengine.viewer). מומלץ להקצות את התפקיד הזה ישירות במאגר הנתונים או באפליקציית החיפוש הרלוונטיים. עם זאת, לצורך פתרון בעיות אפשר להקצות אותו בפרויקט. כדי למצוא את חשבון המשתמש של הסוכן ולהקצות לו את התפקיד, קראו את המאמר ניהול תפקידים באופן ידני. הנציג צריך גם את התפקיד "משתמש בכלי MCP"‏ (roles/mcp.toolUser), שניתן באופן אוטומטי באמצעות תיבת הדו-שיח של ההרשאות.
  6. בחלונית כלים, לוחצים על הוספה (+) לצד שרת MCP מ-Agent Registry.
  7. מציינים את הפרטים הבאים:
    1. מיקום: בוחרים את האזור שבו הכלים רשומים.
    2. ‫MCP Server: בוחרים באפשרות Agent Search או באפשרות discoveryengine.googleapis.com מרשימת שרתי ה-MCP הרשומים.
    3. הגדרת האימות: בוחרים באפשרות ללא. הגישה נקבעת באמצעות קישורי IAM רגילים.
    4. לוחצים על הוספה.

  8. בהוראות של הנציג החדש, מציינים את הגדרת הצגת המודעות הרצויה באמצעות הערכים שרשמתם בשלב 3. לדוגמה:

    Use the search tool to answer questions about YOUR_TOPIC.
When using the search tool, use this servingConfig:
projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores/DATA_STORE_ID/servingConfigs/default_search

    באפליקציית חיפוש, מחליפים את dataStores/DATA_STORE_ID ב-engines/APP_ID. במאמר הפניית כלי MCP: ‏discoveryengine.googleapis.com מפורטים הפורמטים והארגומנטים הנתמכים.

העברה משרת MCP ישיר מדור קודם

אם הנציג שלכם מתחבר ישירות לשרת MCP באמצעות כתובת URL של נקודת קצה, קודם אתם צריכים לרשום את קטלוג שרתי ה-MCP ב-Agent Registry.

כדי להעביר את הכלי, פועלים לפי השלבים הבאים:

  1. מוודאים ששרת ה-MCP רשום ב-Agent Registry.
  2. מעדכנים את הסוכן ב-Agent Studio:
    1. פותחים את הסוכן ב-Agent Studio.
    2. מאתרים ומסירים את החיבור הישיר הקודם לשרת ה-MCP.
    3. לוחצים על הוספה (+) לצד שרת MCP מ-Agent Registry.
    4. בוחרים את שרת ה-MCP הרשום מהרשימה.
    5. לוחצים על הוספה.
    6. אם שומרים את הנציג בפעם הראשונה, לוחצים על Save בכותרת של אזור העריכה. שינויים נוספים נשמרים באופן אוטומטי.

איך לבסס את הסוכנים על קובצי ידע

מעלים מסמכי עזר סטטיים כדי לבסס את התשובות של הסוכן ב-Agent Studio:

  1. בוחרים את צומת הסוכן הראשי בלוח הציור שבו רוצים לצרף קובצי רפרנס. חשוב לזכור שאי אפשר לצרף קובצי ידע לסוכני משנה.
  2. בחלונית Details של הצומת, מאתרים את הקטע Knowledge. הקטע Knowledge מופיע רק אחרי ששומרים את הנציג בפעם הראשונה. פרטים נוספים זמינים במאמר שמירת נציג.
  3. לוחצים על הרכיב להעלאת קבצים ובוחרים את קובץ רפרנס. אפשר לצרף עד 10 קבצים לכל סוכן. גודל הקובץ לא יכול לחרוג מ-2 מגה-בייט (2MB). אפשר להעלות קבצים מהסוגים הבאים:
    • PDF
    • טקסט פשוט

  4. אם אתם שומרים את הסוכן בפעם הראשונה, לוחצים על Save בכותרת של אזור העריכה כדי לאחסן קבצים בקטגוריה של Cloud Storage ייעודית, בנתיב עם תחילית שתואמת ל-AGENT_ID של הסוכן הראשי. השינויים הבאים נשמרים באופן אוטומטי.

    תיבת הדו-שיח של ההרשאות מעניקה את התפקיד "צפייה באובייקט אחסון" (roles/storage.objectViewer) לזהות של הסוכן בקטגוריה.

  5. עוברים לכרטיסייה Preview ושולחים שאילתת בדיקה כדי לוודא שהסוכן מבסס את התשובה שלו על תוכן הקובץ בלי להזות.

  6. אופציונלי: אתם יכולים ללחוץ על Get code כדי להעתיק את קוד ה-Python שנוצר (agent.py) ולבדוק את הגדרת קובץ ה-grounding. אפשר לדלג על השלב הזה.

ניהול ההרשאות של Agent Identity

לכל סוכן ב-Agent Studio יש זהות ייחודית שפועלת כחשבון משתמש ב-IAM כדי לגשת למשאבים אחרים ב- Google Cloud .

הפורמט של חשבון המשתמש הוא:

principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ORGANIZATION_ID: המזהה המספרי של הארגון.
  • ‫PROJECT_NUMBER: מספר הפרויקט ב-Google Cloud .
  • ‫LOCATION: האזור שבו הנציג פרוס.
  • ‫REASONING_ENGINE_ID: מזהה המשאב של מנוע החשיבה הרציונלית.

מידע נוסף על זהויות של נציגים זמין במאמרים יצירת נציג עם זהות נציג וסקירה כללית על זהות נציג.

התנהגות של תיבת הדו-שיח של ההרשאות

כשלוחצים על Deploy או פותחים את הכרטיסייה Preview של נציג שמור, Agent Studio בודק באופן אוטומטי אם לזהות של הנציג יש את קבוצת תפקידי ה-IAM שנדרשים כדי לפעול בצורה תקינה. אם הרשאות מסוימות לא מוגדרות כמו שצריך, יכול להיות שהסוכן ייכשל. כשמעניקים את ההרשאות האלה לזהות של הסוכן, הוא יכול לפעול כצפוי.

אם המערכת מזהה בעיות בהרשאות, מופיעה הודעת שגיאה בתיבת הדו-שיח של ההרשאות.

  • תפקידים חסרים: אם חסרים תפקידים נדרשים, תופיע תיבת דו-שיח עם רשימה מפורטת של התפקידים. לוחצים על Grant All בתיבת הדו-שיח כדי להקצות באופן אוטומטי את כל התפקידים הנדרשים לזהות של הנציג בפעולה אחת. כדי לראות תצוגה מקדימה של הנציג או לפרוס אותו בלי להקצות את התפקידים, לוחצים על Proceed anyway.
  • כל התפקידים הוקצו: אם כל התפקידים הנדרשים כבר הוקצו, תיבת הדו-שיח של ההרשאות לא תופיע.
  • סוכנים שלא נשמרו: לסוכנים שלא נשמרו עדיין אין זהות. תיבת הדו-שיח של ההרשאות לא מופיעה, והכרטיסייה Preview והאפשרויות של Deploy מושבתות עד ששומרים את הנציג.

התפקידים הנדרשים

תיבת הדו-שיח של ההרשאות מעניקה באופן אוטומטי את רשימת התפקידים הבאה:

  • ‫roles/storage.objectViewer: נדרש אם הנציג משתמש בקבצים שהועלו. צריך להקצות את התפקיד הזה בקטגוריה הספציפית של Cloud Storage לקובצי הנציג (לדוגמה, {projectNumber}_{location}_agent_studio_files).
  • ‫roles/mcp.toolUser: חובה אם הסוכן משתמש בכלי MCP של Agent Registry.
  • ‫roles/agentregistry.viewer: חובה אם הסוכן משתמש בכלי MCP או בסוכן משנה של Agent Registry.
  • ‫roles/iamconnectors.user: חובה אם כלי MCP של Agent Registry מציין authProviderName.
  • ‫roles/aiplatform.viewer: נדרש אם הנציג מפעיל נציגי משנה מרוחקים באמצעות העברת סמכויות מנציג לנציג (A2A).

ניהול תפקידים באופן ידני במסוף Google Cloud

תיבת הדו-שיח של ההרשאות מקצה באופן אוטומטי את התפקידים הנדרשים. עם זאת, אם אתם מעדיפים לנהל את התפקידים באופן ידני או אם אתם צריכים לפתור בעיות שקשורות להרשאות, בצעו את השלבים הבאים:

  1. מעתיקים את חשבון השירות הייחודי של הסוכן. בכותרת של אזור העריכה ב-Agent Studio, לוחצים על התפריט הנפתח לצד שם הסוכן ומעתיקים את מחרוזת החשבון הראשי.

    הפורמט של חשבון המשתמש נראה כמו בדוגמה הבאה:

    principal://agents.global.org-ORG_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID

  2. במסוף Google Cloud , נכנסים לדף IAM:

    כניסה לדף IAM

  3. מחפשים את חשבון המשתמש של Agent Identity ברשימת החשבונות. אפשר לחפש באמצעות REASONING_ENGINE_ID הספציפי מסוף המחרוזת של חשבון המשתמש. כדי לקבל את חשבון המשתמש של זהות הסוכן, אתם יכולים לבחור באחת מהאפשרויות הבאות:

    • אם החשבון הראשי של זהות הסוכן כבר מופיע ברשימה, לוחצים על Edit principal ליד זהות הסוכן.
    • אם חשבון המשתמש של זהות הנציג לא מופיע ברשימה, לוחצים על Grant access כדי להוסיף אותו כחשבון משתמש חדש.

  4. מוסיפים או משנים את התפקידים הנדרשים להגדרה, כמו roles/storage.objectViewer או roles/mcp.toolUser.

  5. לוחצים על Save.

בהתאם להגדרות האישיות, יכול להיות שתצטרכו להקצות באופן ידני תפקידים נוספים שלא מטופלים באופן אוטומטי בתיבת הדו-שיח של ההרשאות. לדוגמה, אם כלי ה-MCP הרשום ניגש למשאבים אחרים של Google Cloud , כמו שאילתות נתונים מ-BigQuery, צריך להקצות באופן ידני את התפקידים הנדרשים, כמו התפקיד BigQuery Data Viewer (roles/bigquery.dataViewer), לזהות של הנציג.

פריסת סוכן מ-Agent Studio

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

  1. בדף הרשימה Agents, לוחצים על הנציג שרוצים לפרוס. דף הפרטים של הנציג שנבחר מופיע.

  2. לוחצים על Deploy כדי לפתוח את תיבת הדו-שיח Deploy to an Agent Runtime instance.

    אם לזהות של הסוכן חסרות הרשאות נדרשות, מופיעה תיבת הדו-שיח של ההרשאות והפעולה הזו מטופלת באופן אוטומטי. אם אתם צריכים לנהל את ההרשאות באופן ידני, קראו את המאמרים ניהול הרשאות של Agent Identity ומתן גישה להעברת סמכויות בין סוכנים (A2A).

  3. בחלון הגדרות הפריסה, קובעים את האפשרויות הבאות:

    • שם לתצוגה ותיאור: עורכים את השם לתצוגה ואם רוצים, מוסיפים תיאור לנציג.
    • פריסה כ-A2A: מסמנים את התיבה הזו כדי לפרוס את הנציג כנכס מסוג Agent-to-Agent ‏ (A2A) שנציגים אחרים יכולים להשתמש בו. באפליקציות עצמאיות, אל תסמנו את התיבה כדי לארוז את הנציג כאפליקציית ADK רגילה.

  4. בוחרים אזור פריסה מרשימת האזורים הזמינים ולוחצים על OK.

  5. לוחצים על Deploy.

הפריסה יוצרת מופע חדש של זמן ריצה, והיא יכולה להימשך עד חמש דקות. אם הפעולה בוצעה בהצלחה, תופיע הודעה בכרטיסייה Flow ב-Agent Studio. הסוכן זמין עכשיו בסביבת הייצור ואפשר לשלב אותו בצורה מאובטחת עם אפליקציות של צד שלישי.

הצגת סוכן פעיל

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

  1. במסוף Google Cloud , נכנסים לדף Deployments ב-Agent Platform.

    מעבר אל Deployments

  2. ברשימה Region אפשר לסנן לפי אזור הפריסה.

  3. הסוכנים שפרסתם בפרויקט שנבחר יופיעו ברשימה.

  4. לוחצים על השם של הנציג הרלוונטי. נפתח הדף Metrics של הנציג.

  5. כדי לבדוק את הסוכן, לוחצים על הכרטיסייה Playground.

  6. מזינים שאילתת בדיקה בחלונית הצ'אט כדי לוודא שהנציג פועל כמו שצריך.

מידע נוסף על המדדים הזמינים לנציג מופיע במאמר הצגת מדדים של הנציג שנפרס.