מודל הנתונים של Agent Registry

‫Agent Registry מארגן את סביבת ה-AI שלכם במשאבים סטנדרטיים, כדי שתוכלו לרשום, לגלות ולנהל סוכנים, שרתי MCP, נקודות קצה ומיומנויות. כדי לתכנן ולנהל את המרשם, חשוב להבין איך Agent Registry מפריד בין משאבים שניתן לכתוב בהם Service לבין משאבי גילוי לקריאה בלבד, ואילו מוצרים תומכים ברישום אוטומטי וידני.

רכיבים של סוכנים

ב-Agent Registry אתם יכולים לרשום, לגלות ולנהל את הסוגים הבאים של רכיבים מבוססי-סוכנים:

  • סוכנים: גורמי AI אוטונומיים שמבצעים משימות ספציפיות, מפעילים כלים ומשתפים פעולה עם סוכנים אחרים.
  • ‫שרתי MCP: תוכנות שמטמיעות את Model Context Protocol‏ (MCP) כדי לחשוף משאבי נתונים וכלים סטנדרטיים. כלים הם פונקציות דטרמיניסטיות שחשופות על ידי שרת MCP, שנציגים יכולים להפעיל כדי לבצע פעולות ספציפיות.
  • נקודות קצה (endpoints): כתובות URL של יעדים, בדרך כלל ממשקי API בארכיטקטורת REST, שהסוכן ניגש אליהן. הכלי Agent Registry מאפשר לכם לנהל באופן מרוכז את ממשקי ה-API החיצוניים שהסוכנים יכולים לגשת אליהם, על ידי הפיכת היעדים האלה למשאבים שניתן לנהל.
  • מיומנויות: יכולות מודולריות שמרחיבות את מה שהנציג יכול לעשות. מיומנויות עצמאיות הן חבילות של הוראות וסקריפטים אופציונליים שמנוהלים ישירות במאגר. מיומנויות A2A הן תיאורי יכולות בכרטיס הסוכן של סוכן, שמציינים לסוכנים אחרים מתי ואיך לתקשר איתו. מידע נוסף זמין במאמר ארכיטקטורת מיומנויות.

משאבי שירות ומשאבי גילוי

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

סוכנים, שרתי MCP ונקודות קצה (endpoints)

לא משנה אם הסוכן, שרת ה-MCP או נקודת הקצה רשומים באופן אוטומטי או ידני, Agent Registry מייצג אותם כמשאב גילוי לקריאה בלבד מסוג Agent,‏ McpServer או Endpoint. צרכנים, כמו סוכני תזמור, אפליקציות לקוח ומפתחים, משתמשים במשאבי הגילוי האלה כדי להציג, לחפש ולראות רכיבים רשומים.

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

כשאתם רושמים באופן ידני סוכן, שרת MCP או נקודת קצה, Agent Registry מפריד בין פעולות הניהול לבין גילוי הרכיבים על ידי יצירת הפריטים הבאים:

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

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

דגלים אוסף משאבים תרחיש לדוגמה הערכים האפשריים
--agent-spec-type
--agent-spec-content		 משאב אחד (Agent) באוסף אחד (agents) סוכני REST רגילים או סוכנים מרוחקים שתואמים ל-A2A a2a-agent-card, no-spec
--endpoint-spec-type
--endpoint-spec-content		 משאב אחד (Endpoint) באוסף אחד (endpoints) כתובות URL של שירותים או ממשקי API חיצוניים בארכיטקטורת REST no-spec
--mcp-server-spec-type
--mcp-server-spec-content		 משאב אחד (McpServer) באוסף אחד (mcp-servers) שרתים חיצוניים של Model Context Protocol‏ (MCP) tool-spec, no-spec

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

מיומנויות עצמאיות

מיומנויות עצמאיות לא משתמשות במשאבי Service נפרדים. במקום זאת, אתם רושמים מיומנויות, יוצרים להן גרסאות ושולחים להן שאילתות ישירות באמצעות משאבי Skill ברמה העליונה, משאבי SkillRevision צאצאים ומשאבי Publisher.

כדי להתחיל, עיינו במאמר הגדרת Agent Registry. מידע נוסף על Agent Registry API זמין במאמרי העזרה של ה-API.

מוצרים ורכיבים נתמכים

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

רישום אוטומטי

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

בטבלה הבאה מפורטים המוצרים והרכיבים ש-Agent Registry רושם באופן אוטומטי:

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

רישום ידני

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

בטבלה הבאה מפורטים המוצרים והרכיבים שצריך לרשום באופן ידני:

סוג הרכיב משאבים נתמכים
סוכנים סוכנים מרוחקים שנפרסו ב-Compute Engine, ב-GKE, ב-Cloud Run, במערכות מקומיות או בעננים חיצוניים
שרתי MCP רכיבים מותאמים אישית של סוכנים בסביבות זמן ריצה לא נתמכות או בשרתי MCP חיצוניים
נקודות קצה (endpoints) ממשקי API חיצוניים ל-REST או כתובות URL של שירותים שמנוהלים כנקודות קצה (endpoint)
מיומנויות מיומנויות עצמאיות משלכם שנוצרו על ידי הארגון שלכם

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