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

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

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

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

מגבלות

  • תוצאות השאילתה כוללות רק רכיבים שעומדים בקריטריונים הבאים:
    • צריך להגדיר את סוג הפונקציה של הסוכנים לערך AGENT, ולפרוס אותם באמצעות ADK,‏ Gemini Enterprise או Cloud Run, או לפרוס אותם באמצעות GKE ולרשום אותם במאגר הסוכנים.
    • בשרתי ה-MCP צריך להגדיר את הסוג הפונקציונלי לערך 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, צריך את תפקיד ה-IAM 'אדמין של Service Usage' (roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאה serviceusage.services.enable. איך מקצים תפקידים

    הפעלת ממשקי ה-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.

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

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