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

בדף הזה מוסבר איך להשתמש ב-Agent Studio בCloud de Confiance מסוף.

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

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

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

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

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

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

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

יצירת סוכן

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

יצירת סוכן באמצעות פרומפטים

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

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

    כניסה לדף Agents

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

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

  4. לחץ על .

  5. בהתאם להנחיה, קורה אחד מהדברים הבאים:

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

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

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

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

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

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

מגבלות

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

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

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

כדי לעצב ולבדוק סוכן באמצעות הכלי ליצירת תרשימי זרימה:

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

    כניסה לדף Agents

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

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

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

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

    Flow

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

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

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

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

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

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

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

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

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

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

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

    תצוגה מקדימה

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

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

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

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

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

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

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

  1. במסוף Cloud de Confiance , עוברים אל Agent Studio.

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

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

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

  5. לחץ על .

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

בדיקת אירועים של סוכנים

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

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

כדי לבדוק אירועים של סוכנים:

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

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

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

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

שמירת סוכן

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

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

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

  1. במרחב העבודה של Agent Studio, לוחצים על שמירה.

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

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

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

עדכון סוכן

כדי לעדכן סוכן:

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

    לדף Agents

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

  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. הגדרת אימות: בוחרים באפשרות ללא כדי להשתמש בגישה רגילה לשירותים שמוגדרת באמצעות קישורי IAM.
    5. לוחצים על הוספה.
    6. אם שומרים את הנציג בפעם הראשונה, לוחצים על Save בכותרת של אזור העריכה. השינויים הבאים יישמרו אוטומטית.

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

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

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

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

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

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

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

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

  1. פותחים את הסוכן ב-Agent Studio.
  2. בקטע Tools, מאתרים את הכלי Vertex AI Search Data Store.
  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. אם שומרים את הסוכן בפעם הראשונה, לוחצים על שמירה בכותרת של אזור העריכה. השינויים הבאים נשמרים באופן אוטומטי.

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

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

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

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

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

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

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

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

לכל סוכן ב-Agent Studio יש זהות ייחודית, שמשמשת כחשבון משתמש ב-IAM כדי לגשת למשאבים אחרים של Cloud de Confiance by S3NS .

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

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

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

  • ‫ORGANIZATION_ID: מזהה הארגון (מספרי).
  • ‫PROJECT_NUMBER: מספר הפרויקט ב-Cloud de Confiance by S3NS .
  • ‫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).

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

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

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

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

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

  2. במסוף Cloud de Confiance , עוברים אל IAM:

    כניסה לדף IAM

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

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

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

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

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

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

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

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

  2. לוחצים על Deploy (פריסה) כדי לפתוח את תיבת הדו-שיח Deploy to an Agent Runtime instance (פריסה למופע בזמן ריצה של סוכן).

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

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

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

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

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

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

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

כדי לראות את הסוכן שפרסתם:

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

    מעבר לדף Deployments

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

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

  4. לוחצים על השם של הנציג הרלוונטי. ייפתח הדף מדדים של הסוכן.

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

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

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