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

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

סוכן

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

מזהה הסוכן

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

מזהי הסוכן נוצרים אוטומטית על ידי מאגר הסוכנים במהלך ההטמעה, והם בפורמט של שם משאב אחיד (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 של�0x0A>סוכן, שאליו הסוכן יכול לגשת כדי לבסס את התשובות שלו או לקבל מידע לפעולות שלו.

Discovery

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

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

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

נקודת קצה (endpoint)

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

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.
  • רישום ידני: צירוף ידני של רכיבים מותאמים אישית או חיצוניים של סוכנים.

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

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

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

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

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

כלי

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