הצגת הקשרים בין הסוכנים

אתם יכולים לראות את הקשרים בין הסוכנים בפלטפורמת הסוכנים של Gemini Enterprise, כולל התקשורת בין הסוכנים והתקשורת בין הסוכנים לבין שרתי ה-MCP.

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

אתם יכולים לראות נתונים גם של סוכנים שזוהו וגם של סוכנים שרשומים ב-Agent Registry. ‫Gemini Enterprise Agent Platform קובעת את הקשרים באמצעות נתוני מעקב מצטברים.

מגבלות

  • תוצאות השאילתה כוללות רק רכיבים שעומדים בקריטריונים הבאים:
    • צריך להגדיר את סוג הפונקציה של הסוכנים לערך AGENT, ולפרוס אותם באמצעות ADK,‏ Gemini Enterprise או Cloud Run, או לפרוס אותם באמצעות GKE ולרשום אותם במאגר הסוכנים.
    • בשרתי ה-MCP, הערך של functional type צריך להיות MCP. השרתים כלולים אם הם שרתי MCP של צד ראשון שנפרסו באמצעות OneMCP,‏ GKE או Cloud Run. שרתי MCP אחרים צריכים להיות רשומים ב-Agent Registry כדי להיכלל.
    • רכיבים אחרים, כמו כלים ומודלים, או סוכני Workspace, לא נכללים בתוצאות.
  • כששרת MCP רשום ב-Agent Registry, הוא מסווג כמשאב משותף על ידי מרכז האפליקציות, ולא יוצגו קצוות לצמתים אחרים בתרשים הטופולוגיה. המגבלה הזו חלה רק אם שרת ה-MCP מסווג כמשאב משותף, ולא חלה על משאבים שייחודיים לאפליקציה, כמו מחברים של נתונים ב-Gemini Enterprise או שרתי MCP שמתארחים ב-Cloud Run.

לפני שמתחילים

  1. מפעילים את ממשקי ה-API של מרכז האפליקציות, App Topology, ניראות (observability) ו-Trace.

    תפקידים שנדרשים להפעלת ממשקי API

    כדי להפעיל ממשקי API, נדרשת ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק 'שימוש בשירות'' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

    הפעלת ממשקי ה-API

    2. אם הוספתם פרויקטים אחרים להיקף המעקב, מומלץ להפעיל גם את Observability API בפרויקטים האלה. בתרשים הטופולוגיה מוצגים רק נתוני מעקב מפרויקטים בהיקף מעקב שנמצאים באותו ארגון כמו הפרויקט שנבחר.

  2. לבצע אינסטרומנטציה לאפליקציות ה-AI באמצעות OpenTelemetry.

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

כדי לקבל את ההרשאות שדרושות לצפייה בתרשימי טופולוגיה, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט:

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

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

הצגת תרשימים של פרויקט

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

    מעבר אל Topology

  2. בכלי לבחירת פרויקטים, בוחרים את הפרויקט שמכיל את הסוכנים.

  3. בקטע שאילתות, לוחצים על שאילתה.

  4. בקטע תרשים מוצגות התוצאות של השאילתה שנבחרה.

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

  5. כדי להציג את תוצאות השאילתה כטבלה, לוחצים על טבלה.

    • כדי לבחור את העמודות שיוצגו בטבלה, לוחצים על Column display options
    • כדי לסנן את הטבלה לפי מאפיינים ספציפיים, בוחרים את המאפיינים בשדה Filter.
    • אפשר גם למיין כל עמודה בסדר עולה או יורד.

  6. כדי לשפר או להתאים אישית את השאילתה, אפשר לערוך את השאילתה שנבחרה ולראות את התוצאות כתרשים טופולוגיה ב-Cloud Hub. לוחצים על עריכה ב-Cloud Hub.

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

הצגת גרפים של סוכן רשום

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

    כניסה ל-Agent Registry

  2. בכלי לבחירת פרויקטים, בוחרים את הפרויקט שמכיל את הסוכנים.

  3. בכרטיסייה סוכנים, לוחצים על השם של הסוכן שרוצים לראות.

  4. לוחצים על הכרטיסייה טופולוגיה.

  5. בקטע שאילתות, לוחצים על שאילתה.

  6. בקטע תרשים מוצגות התוצאות של השאילתה שנבחרה.

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

  7. כדי להציג את תוצאות השאילתה כטבלה, לוחצים על טבלה.

    • כדי לבחור את העמודות שיוצגו בטבלה, לוחצים על Column display options
    • כדי לסנן את הטבלה לפי מאפיינים ספציפיים, בוחרים את המאפיינים בשדה Filter.
    • אפשר גם למיין כל עמודה בסדר עולה או יורד.

  8. כדי לשפר או להתאים אישית את השאילתה, אפשר לערוך את השאילתה שנבחרה ולראות את התוצאות כתרשים טופולוגיה ב-Cloud Hub. לוחצים על עריכה ב-Cloud Hub.

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

המאמרים הבאים