מושגים מרכזיים

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

סקיל A2A

השוו עם מיומנות.

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

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

סוכן

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

ישות מורשית של סוכן

הזהות הייחודית של ניהול הזהויות והרשאות הגישה (IAM) שמוקצית לסוכן, ומאפשרת לו להחזיק בהרשאות, לגשת למשאבים במורד הזרם וליצור יומני ביקורת. הוא מורכב מ Google Cloud חשבון שירות או מזהות מנוהלת של עומס עבודה, כמו מזהה SPIFFE, שניתנים לאימות ומקושרים ישירות לסביבת זמן הריצה של הסוכן.

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

במאמר חשבונות משתמשים של סוכנים מוסבר בהרחבה על התחביר ועל בקרת הגישה.

רכיב של סוכן

ישות מודולרית ופונקציונלית בתוך סביבה עסקית של AI, שאתם יכולים לרשום, לגלות ולנהל באמצעות Agent Registry. הרשימה מסווגת את הרכיבים של הסוכנים לארבעה סוגים עיקריים: סוכן, שרת MCP, נקודת קצה (endpoint) ומיומנות.

מידע נוסף זמין במאמר מחזור החיים והגילוי של רכיבים.

תהליך עבודה מבוסס-סוכנים

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

ספק אימות

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

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

קישור

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

למידע נוסף, ראו קישורים.

משאב נתונים

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

גילוי

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

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

נקודת קצה (endpoint)

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

ממצא

בעיית אבטחה שזוהתה, כמו נקודת חולשה בהוראה או סוד שנחשף, שמשויכת לגרסה של מיומנות ב-Agent Registry, ומיוצגת כמשאב Finding לקריאה בלבד. בממצא מדווחים חומרת הבעיה, סוג הממצא (VULNERABILITY או SECRET), הקבצים שהושפעו, מספרי השורות ותיאור הבעיה.

מידע נוסף זמין במאמר סריקת מיומנויות לאיתור בעיות אבטחה.

פרויקט פיקוח

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

היקף הפיקוח

הגבול הגיאוגרפי והארכיטקטוני שבו המשאבים של Agent Registry רשומים ומנוהלים.

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

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

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

תחום ניהול

אוסף של פרויקט אחד או יותר ב- Google Cloud שמגדיר את הגבולות הניהוליים של סביבת ה-AI, ומיוצג במנהל המשאבים על ידי המשאב Boundary. גבול הניהול מוגדר בארגון או בתיקייה ב-Resource Manager. אתם יכולים לכלול את כל הפרויקטים הצאצאים בתיקייה או בארגון, או לסנן את הפרויקטים הצאצאים לפי תג אופציונלי. גבולות הניהול מאפשרים לכם להפעיל גילוי ופיקוח מרכזיים של רכיבים מבוססי-סוכנים בכמה פרויקטים חברים.

ב-Agent Registry נעשה שימוש במשאבים BoundaryConfig,‏ Boundary ו-CapabilityConfig ב-Resource Manager כדי לתמוך בתצוגות בפרויקטים שונים ובכללי מדיניות גישה ריכוזיים. במאמר סקירה כללית על גבולות ויכולות הניהול תוכלו לקרוא מידע נוסף על המשאבים האלה של מנהל המשאבים.

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

פרויקט ניהול

פרויקט ב- Google Cloud שמשמש כפרויקט הניהול המרכזי של גבולות הניהול, ומרכז את המשימות האדמיניסטרטיביות, את נקודות הקצה ל-API ואת המטא-נתונים בגבולות הניהול. בפרויקט הניהול אתם מגדירים את Agent Registry, את החיוב ואת המכסות, ושולחים שאילתות לגבי מאגרי נתונים מצטברים של סוכנים וכלים בפרויקטים החברים.

מידע נוסף זמין במאמר פרויקט ניהול.

Model Context Protocol‏ (MCP)

תקן פתוח שמשמש לחיבור מודלים של AI למקורות נתונים ולכלים, ומחליף פלאגינים מותאמים אישית.

שרת MCP

תוכנה שמטמיעה את Model Context Protocol (MCP) כדי לחשוף יכולות סטנדרטיות של כלים ומשאבי נתונים לסוכן AI. ב-Agent Registry, שרת MCP רשום מיוצג כמשאב גילוי McpServer לקריאה בלבד.

Publisher

ישות שיוצרת ורושמת מיומנות, שמיוצגת כמשאב Publisher ב-Agent Registry. בעל האפליקציה קובע את הבעלות ואת התחביר של מזהה המיומנות של המיומנות.

מיומנויות שמנוהלות על ידי Google משתמשות בדומיינים של שירותים. מיומנויות שנוצרות באופן ידני מוגדרות באופן אוטומטי לבעל האפליקציה private עם הקידומת private-.

מידע נוסף זמין במאמר בעלי תוכן דיגיטלי.

הרשמה

תהליך ההוספה של רכיב מבוסס-סוכן, כמו סוכן, שרת MCP, נקודת קצה או מיומנות, ל-Agent Registry.

ב-Agent Registry יש תמיכה בשני מודלים של רישום:

  • רישום אוטומטי: הטמעה אוטומטית של סוכנים, שרתי MCP וסקילים שמנוהלים על ידי Google מסביבות זמן ריצה נתמכות של Google Cloud , כמו Agent Runtime ב-Gemini Enterprise Agent Platform, שנפרסו בפרויקט הפיקוח שבו Agent Registry מופעל, או נאספו בפרויקטים חברים כשהגדרתם גבול ניהול.
  • רישום ידני: רישום מפורש של סוכנים מרוחקים או מותאמים אישית, שרתי MCP, נקודות קצה ומיומנויות פרטיות עצמאיות, כולל רכיבים שמתארחים בפרויקטים נפרדים של Google Cloud בלי גבולות ניהול, בסביבות מקומיות, בעננים חיצוניים או בסביבות זמן ריצה לא נתמכות, על ידי יצירת משאבים במאגר של פרויקט הפיקוח.

להשוואה מפורטת של הארכיטקטורה, ראו מודלים של רישום.

מזהה המרשם

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

לפורמטים מפורטים של תחביר URN, ראו מזהי מרשם.

הפניה לסביבת זמן הריצה

המיקום הפיזי של סביבת זמן הריצה או תשתית המחשוב שמארחת נציג, שרת MCP או נקודת קצה (endpoint), שמיוצגים ב-Agent Registry באמצעות המאפיין agentregistry.googleapis.com/system/RuntimeReference. לדוגמה, הפניה לסביבת זמן ריצה יכולה להצביע על מנוע חשיבה רציונלית של Agent Runtime, על פריסה של Google Kubernetes Engine (GKE) או על שירות Cloud Run.

נתיב ההפניה של סביבת זמן הריצה מוטמע בישות המורשית של הסוכן כדי להעריך את מדיניות ה-IAM. מידע נוסף זמין במאמר הפניות לסביבת זמן ריצה.

משאב שירות

המשאב שניתן לכתיבה ב-Agent Registry, שמזוהה לפי שם המשאב שלו, ומשמש לפעולות ניהול כשרושמים באופן ידני נציג, שרת MCP או נקודת קצה (endpoint). המשאב Service מאחסן את המטא-נתונים של הרכיב, כולל סוג הרכיב מבוסס-הסוכן ופרטי ההגדרה, כמו כתובת ה-URL של הממשק, התיאור, הקישור לפרוטוקול ומפרט היכולות. רכיב שנרשם באופן אוטומטי או מיומנות עצמאית לא משתמשים במשאב Service.

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

מיומנות

השוו עם מיומנות A2A.

חבילה עצמאית שרשומה כמשאב Skill ברמה העליונה ב-Agent Registry, שמרחיבה את היכולות של נציג על ידי מתן הוראות ספציפיות וסקריפטים אופציונליים להשלמת משימה. מיומנות מכילה קובץ הוראות של SKILL.md, סקריפטים אופציונליים ונכסי מטא-נתונים.

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

לפרטים על הארכיטקטורה, האריזה ומחזור החיים, ראו ארכיטקטורת מיומנויות.

גרסת הסקיל

תמונת מצב (snapshot) של גרסה קבועה של חבילת מיומנויות, שמיוצגת כמשאב SkillRevision ב-Agent Registry. גרסה של מיומנות מאפשרת לעדכן את ההוראות או הסקריפטים האופציונליים של המיומנות בלי לשנות את מזהה המיומנות הראשי או לשבש את יחסי התלות הקיימים של הנציג.

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

כלי

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