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

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

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

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

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

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

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

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

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

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

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

לגבי רכיבים שרשומים באופן אוטומטי, מאגר הסוכנים מטמיע מטא-נתונים ישירות מסביבות זמן ריצה נתמכות ויוצר את משאב הגילוי בלי משאב 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.

הגדרות אופציונליות של מפתחות הצפנה בניהול הלקוח (CMEK) למיומנויות במיקום מסוים נקבעות באמצעות המשאב SkillEncryptionSpec. בעיות אבטחה שזוהו במהלך סריקת המיומנויות מוצגות כמשאבי Finding לקריאה בלבד. מידע נוסף זמין במאמרים הגדרת CMEK למיומנויות וסריקת מיומנויות לאיתור בעיות אבטחה.

מודל נתונים בכמה פרויקטים

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

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

קטגוריית משאב	היקף בתחום ניהול	תיאור
משאבים שזוהו באופן אוטומטי	צבירה מפרויקטים שחברים בקבוצה	סוכנים ושרתי MCP שמתגלים באופן אוטומטי בפרויקטים החברים נאספים לתצוגת פרויקט הניהול כשמציגים אותם או מחפשים אותם במיקום בפרויקט הניהול. כשמציגים, מפרטים או מחפשים נציג או שרת MCP, אפשר לציין בבקשה את מזהה הפרויקט לניהול או את מזהה הפרויקט של החבר. שם המשאב שומר על המזהה ש-Agent Registry מקצה לרכיב, ומשתמש בפרויקט שצוין בבקשה.
משאבים שנרשמו באופן ידני	מוגבלים לפרויקט שבו הם נוצרו	סוכנים בהתאמה אישית, שרתי MCP חיצוניים ונקודות קצה (endpoints) שנרשמו באופן ידני כמשאבי `Service` מוגבלים לפרויקט שבו הם נוצרו. אפשר ליצור אותם בפרויקט הניהול כדי שיהיו גלויים בכל גבולות הניהול, או בפרויקט חבר כדי שיהיו גלויים רק בפרויקט היחיד הזה.
קישורים	מוגבלים לפרויקט שבו הם נוצרו	המשאבים של `Binding` מוגבלים לפרויקט שבו הם נוצרו. אפשר ליצור אותם בפרויקט הניהול כדי שהם יהיו גלויים בכל הפרויקטים שבתחום, או בפרויקט חבר כדי שהם יהיו גלויים רק בפרויקט אחד.
מיומנויות ובעלי תוכן דיגיטלי עצמאיים	מוגבלים לפרויקט שבו הם נוצרו	המשאבים המותאמים אישית העצמאיים `Skill`,‏ `SkillRevision`,‏ `Publisher`,‏ `SkillEncryptionSpec` ו-`Finding` מוגדרים ברמת הפרויקט שבו הם נוצרו, והם לא נאספים מפרויקטים חברים לפרויקט הניהול. מיומנויות עצמאיות שמנוהלות על ידי 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)
מיומנויות	מיומנויות עצמאיות משלכם שנוצרו על ידי הארגון שלכם