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

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

מיומנות A2A

השוואה לכישורים.

בלוק מטא-נתונים של יכולות הצהרתיות שמוצג בתוך כרטיס הסוכן (agent-card.json) של סוכן. מיומנויות A2A מתארות ממשקי תקשורת בין סוכנים ויכולות ברמה גבוהה שיש לסוכן שתואם ל-A2A.

מאגר הנציגים תומך בגרסאות 0.3 ו-1.0 של מפרט Agent2Agent‏ (A2A).

סוכן

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

מזהה הסוכן

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

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

  • ‫Agent Runtime on Gemini Enterprise Agent Platform: urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID
  • שירותי Cloud Run: urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME
  • פריסות של GKE: urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME
  • ‫Gemini Enterprise: urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root
  • ‫Google Workspace: urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a
  • סוכנים שנרשמו באופן ידני: urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID

הגורם העיקרי של הסוכן

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

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

principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID

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

רכיב פעולות סוכן

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

תהליך עבודה אג'נטי

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

ספק אימות

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

קישור

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

משאב נתונים

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

Discovery

תהליך שליחת שאילתות ל-Registry כדי למצוא סוכנים, כלים של MCP או נקודות קצה קיימים על סמך תיאורים, תגים או כישורים.

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

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

נקודת קצה (endpoint)

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

Model Context Protocol‏ (MCP)

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

שרת MCP (או שרת)

שירות שמטמיע את Model Context Protocol‏ (MCP) כדי לספק כלים ומשאבי נתונים סטנדרטיים לסוכני AI.

מזהה שרת ה-MCP

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

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

  • Google Cloud שרתי MCP מרוחקים: urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME
  • שרתי MCP רשומים באופן ידני: urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVER_ID

הרשמה

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

  • רישום אוטומטי: הוספה אוטומטית של משאבי AI נתמכים שלGoogle Cloud , כמו Agent Runtime. רישום אוטומטי פועל במסגרת פרויקט יחיד.
  • רישום ידני: צירוף ידני של רכיבים מותאמים אישית או חיצוניים של סוכנים, או סוכנים שנפרסו בכמה Google Cloud פרויקטים לגילוי וניהול מרכזיים.

‫URI של מקור מידע

המיקום הפיזי של זמן הריצה או התשתית שמארחים סוכן או שרת MCP. מזהה משאב אחיד (URI) הוא רצף ייחודי של תווים שמזהה את משאב זמן הריצה הזה. לדוגמה, URI של משאב יכול להיות נקודת קצה של Agent Runtime, פריסה של Google Kubernetes Engine‏ (GKE) או שירות Cloud Run.

ה-URI של המשאב שונה ממזהה הסוכן או ממזהה שרת ה-MCP. הערכים האלה הם השמות הייחודיים בפורמט URN שמזהים את הסוכנים ואת שרתי ה-MCP שלכם במרשם. לעומת זאת, ה-URI של המשאב מצביע על משאב המחשוב בפועל שבו פועל הסוכן או השרת.

הנתיב ל-URI של משאב של סוכן מוטמע במחרוזת agent principal כדי לזהות באופן ייחודי את המשאב הזה במדיניות IAM. ברישומים בין פרויקטים, ה-URI של המשאב מפנה לפרויקט שבו נמצא משאב המחשוב.

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

אפשר להשתמש ב-URI של המשאב כדי ליצור שאילתות בגרף הטופולוגיה כדי להמחיש את זרימות התנועה והקשרים של סוכנים ספציפיים. ב-Agent Registry API, הערך הזה מיוצג על ידי המאפיין agentregistry.googleapis.com/system/RuntimeReference.

שירות

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

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

תמיד משתמשים במשאב Service כדי ליצור, לערוך או למחוק רשומות במאגר. עם זאת, כדי לקבל, לפרט או לחפש את הערכים האלה, צריך לשלוח שאילתה למשאבי הקריאה בלבד Agent, McpServer או Endpoint.

מיומנות

השוואה למיומנויות A2A.

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

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

  • מיומנויות שנוצרו על ידי Google: urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID. לדוגמה, urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing.
  • כישורים שנרשמו באופן ידני: urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID. לדוגמה, urn:skill:projects-123456789:locations:global:private-create-docs.

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

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

גרסה קודמת של מיומנות

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

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

Publisher

ישות שיוצרת ורושמת מיומנויות במאגר הסוכנים.

בעלי תוכן דיגיטלי שאוכלסו מראש כוללים בעלי תוכן דיגיטלי של Google, כמו cloud.google.com ו-discoveryengine.googleapis.com, ושותפים מאומתים. אחרי שמגדירים את Agent Registry, אפשר לראות מיד את המיומנויות שנוצרו על ידי Google מהמוציאים לאור האלה.

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

בודקים את פרטי בעל התוכן הדיגיטלי של הכישורים הרשומים.

כלי

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