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

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

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

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

משאבי API

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

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

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

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

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

מיומנויות עצמאיות לא משתמשות במודל Service ההקרנה. במקום זאת, אתם יכולים לנהל את הכישורים, לשלוט בגרסאות שלהם ולפרט אותם ישירות באמצעות משאבי ה-API‏ Skill, SkillRevision ו-Publisher.

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

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

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

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

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

בטבלה הבאה מפורטים המוצרים והרכיבים שנרשמים אוטומטית במאגר הסוכנים:

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

רישום ידני

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

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

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

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