מחזור החיים של הרכיב וגילוי הרכיב

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

המערכת האקולוגית של ה-AI

אתם יכולים לרשום, לגלות ולנהל ארבעה סוגים של רכיבים מודולריים של סוכני AI כדי לשלב את סביבת ה-AI שלכם:

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

ייצוג של רכיב מבוסס-סוכן ב-Agent Registry

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

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

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

האופן שבו Agent Registry יוצר ומעדכן את משאבי הגילוי האלה תלוי באופן שבו הרכיב רשום:

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

במאמר משאבי שירות ומשאבי גילוי מוסבר איך דגלי מפרט המשאבים של Service ממופים לאוספי משאבים לקריאה בלבד.

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

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

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

מודלים של רישום

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

מאפיין רישום אוטומטי רישום ידני
היקף הרכיבים שנפרסו מוגבלים לפרויקט אחד. סוכנים מובנים של Google, שרתי MCP של Google ושרתי MCP מרוחקים של Google Cloud , וסקילים שמנוהלים על ידי Google זמינים בכל הפרויקטים. מוגדרים לפרויקט אחד או מרוכזים בכמה פרויקטים.
Configuration ‫Agent Runtime ב-Gemini Enterprise Agent Platform, סוכנים מובנים של Google, שרתי MCP של Google ושרתי MCP מרוחקים, וסקילים שמנוהלים על ידי Google נרשמים באופן אוטומטי. Google Cloud כדי להשתמש בעומסי עבודה ב-Google Kubernetes Engine ‏ (GKE) וב-Cloud Run, צריך להוסיף תווית או דגל לפריסה. צריך ליצור משאב מסוג Service או Skill ב-Agent Registry.
זמני ריצה ‫Agent Runtime,‏ GKE,‏ Cloud Run וסביבות זמן ריצה שמנוהלות על ידי Google. ‫Compute Engine,‏ GKE,‏ Cloud Run, מערכות מקומיות ופלטפורמות ענן חיצוניות.
רכיבי יעד סוכנים, שרתי MCP ומיומנויות עצמאיות בניהול Google. סוכנים בהתאמה אישית או סוכנים חיצוניים, שרתי MCP, נקודות קצה וסקילים פרטיים עצמאיים.
עדכוני מטא-נתונים מסונכרנים אוטומטית מסביבת זמן הריצה או מנקודות הקצה של Agent Card. צריך לעדכן ידנית את המשאב Service או להעלות משאב SkillRevision חדש ב-Agent Registry.

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

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

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

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

רישום ידני

רישום ידני מאפשר לכם לרשום סוכנים מרוחקים או מותאמים אישית, שרתי MCP, נקודות קצה ומיומנויות פרטיות עצמאיות על ידי יצירת משאבים ישירות ב-Agent Registry. אתם יכולים לרשום באופן ידני סוכנים, שרתי MCP או נקודות קצה ל-API בארכיטקטורת REST שמתארחים ב-Compute Engine, ב-GKE, ב-Cloud Run, בתשתית מקומית או בפלטפורמות ענן חיצוניות, כולל סוכנים שלא מטמיעים את פרוטוקול A2A. רישום ידני גם מאפשר לרשום רכיבים מרוחקים שנפרסו בפרויקטים נפרדים של Google Cloud במאגר מרכזי של פרויקט פיקוח, כדי לאפשר גילוי ופיקוח מרכזיים.

כדי לרשום באופן ידני סוכן, שרת MCP או נקודת קצה, יוצרים משאב Service ב-Agent Registry ומציינים את כתובת ה-URL של הממשק של הרכיב, את הקישור לפרוטוקול ואת דגל המפרט --agent-spec-type,‏ --mcp-server-spec-type או --endpoint-spec-type. כדי לרשום מיומנות עצמאית באופן ידני, יוצרים משאב Skill עם מטען ייעודי (payload) של ארכיון ZIP.

למידע נוסף על הגדרת רישום ידני, ראו שימוש ברישום ידני של נציגים, רישום נקודות קצה ורישום מיומנויות.

סוגי הגילוי

ב- Google Cloud, החיפוש ב-Agent Registry שונה מהחיפוש בכלי ניהול התשתית:

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

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

קשרים בין רכיבים

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

קישורים

קישור מגדיר חיבור ישיר בין סוכן מקור למשאב יעד באמצעות מזהי הרישום שלהם (URN):

  • קישורים בין סוכנים: הגדרת נתיבי העברת סמכויות שמאפשרים לסוכן הראשי להפעיל סוכני משנה ייעודיים.
  • קישורים בין סוכנים לשרתי MCP: מחברים סוכן לשרת MCP, ומשייכים את הסוכן לכלים ולמשאבי הנתונים שפורסמו בשרת.
  • קישורים בין נציגים לנקודות קצה (endpoint): מחברים נציג לנקודת קצה חיצונית רשומה, כמו API בארכיטקטורת REST.

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

ספקי אימות

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

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

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