‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

מודל הנתונים של 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 מחיל את כללי ההיקף הבאים כדי לספק קטלוג מאוחד בלי לשכפל משאבים או ליצור התנגשויות בין נקודות קצה:

קטגוריית משאב	היקף בתחום ניהול	תיאור
משאבים שזוהו באופן אוטומטי	צבירה מפרויקטים שחברים בקבוצה	סוכנים ושרתי MCP שמתגלים באופן אוטומטי בפרויקטים החברים נאספים לתצוגת פרויקט הניהול כשמציגים אותם או מחפשים אותם במיקום בפרויקט הניהול. כשמציגים, מפרטים או מחפשים נציג או שרת MCP, אפשר לציין בבקשה את מזהה הפרויקט לניהול או את מזהה הפרויקט של החבר. שם המשאב שומר על המזהה ש-Agent Registry מקצה לרכיב, ומשתמש בפרויקט שצוין בבקשה.
משאבים שנרשמו באופן ידני	מוגבלים לפרויקט שבו הם נוצרו	סוכנים בהתאמה אישית, שרתי MCP חיצוניים ונקודות קצה (endpoints) שנרשמו באופן ידני כמשאבי `Service` מוגבלים לפרויקט שבו הם נוצרו. אפשר ליצור אותם בפרויקט הניהול כדי שיהיו גלויים בכל גבולות הניהול, או בפרויקט חבר כדי שיהיו גלויים רק בפרויקט היחיד הזה.
קישורים	מוגבלים לפרויקט שבו הם נוצרו	המשאבים של `Binding` מוגבלים לפרויקט שבו הם נוצרו. אפשר ליצור אותם בפרויקט הניהול כדי שהם יהיו גלויים בכל הפרויקטים שבתחום, או בפרויקט חבר כדי שהם יהיו גלויים רק בפרויקט אחד.
מיומנויות ובעלי תוכן דיגיטלי עצמאיים	מוגבלים לפרויקט שבו הם נוצרו	משאבים מותאמים אישית מסוג `Skill`,‏ `SkillRevision` ו-`Publisher` מוגדרים ברמת הפרויקט שבו הם נוצרו, והם לא נאספים מפרויקטים חברים לפרויקט הניהול. מיומנויות עצמאיות שמנוהלות על ידי Google ניתנות לגילוי בכל הפרויקטים באופן אוטומטי כשמגדירים את Agent Registry.
אפליקציות AI	מוגבלים לפרויקט שבו הם נוצרו	משאבי `AiApplication` לקריאה בלבד ותצוגות הרכיבים המקושרות שלהם מוגבלים לפרויקט ולמיקום שבהם נוצרה האפליקציה.

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

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

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

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

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

סוג הרכיב	המוצרים והשירותים שבהם אפשר להגדיר את החיוב
נציגים	‫Agent Runtime ב-Gemini Enterprise Agent Platform Google Workspace Gemini Enterprise פריסות של Google Kubernetes Engine‏ (GKE), כולל תווית ספציפית של סוג פונקציונלי עומסי עבודה (workloads) ב-Cloud Run שמוגדרים עם דגל ספציפי של סוג פונקציונלי
שרתי MCP	‫Google ו Google Cloud שרתי MCP מרוחקים פריסות GKE שכוללות תווית ספציפית של סוג פונקציונלי שירותי Cloud Run שמוגדרים עם דגל ספציפי של סוג פונקציונלי
מיומנויות	סקילים שמנוהלים על ידי Google ניתנים לגילוי מכל הפרויקטים

רישום ידני

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

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

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