כשרושמים סוכן, הוא הופך לרכיב שאפשר למצוא ב-Agent Registry. כשמפרסמים את היכולות A2A של הסוכן, עוזרים למפתחים אחרים ולסוכני תזמור בארגון למצוא את העבודה שלכם ולעשות בה שימוש חוזר, וכך מאיצים את פיתוח ה-AI הכולל.
Agent Registry משתלב בצורה חלקה עם פרוטוקול Agent2Agent (A2A) והמפרטים שלו. A2A הוא תקן פתוח שמאפשר לסוכנים להצהיר על היכולות והזהות שלהם. Agent Registry תומך בגרסאות 0.3 ו-1.0 של מפרט A2A. מידע נוסף זמין במאמר בנושא סכימת כרטיס הנציג.
בהתאם לזמני הריצה של הסוכנים, Agent Registry תומך בשני מנגנוני רישום עיקריים: רישום אוטומטי ורישום ידני.
בוחרים את מנגנון הרישום שמתאים לזמני הריצה של הסוכן.
רישום אוטומטי
סביבות זמן ריצה נתמכות Google Cloud רושמות את הסוכנים ב- Agent Registry באותו פרויקט, או כברירת מחדל או באמצעות שלב פריסה שבו המשתמש מאשר את הרישום. הרשמה אוטומטית פועלת ברמת הפרויקט, ולא מתבצע גילוי אוטומטי של סוכנים שנפרסו בפרויקטים אחרים. Google Cloud
הרשמה אוטומטית נתמכת בסביבות זמן הריצה הבאות: Google Cloud
- Agent Runtime ב-Gemini Enterprise Agent Platform: סוכנים שנפרסו באמצעות ה-SDK נרשמים ללא הגדרה נוספת. מידע נוסף זמין במאמר בנושא רישום סוכנים מ-Agent Runtime.
- סוכני Google מובנים: סוכנים ש-Google מספקת ישירות, כמו סוכנים של Google Workspace ו-Gemini Enterprise, ניתנים לגילוי ללא צורך בהגדרה. מידע נוסף זמין במאמר בנושא רישום של סוכני Google מובנים.
- Google Kubernetes Engine (GKE): סוכנים בקונטיינרים שנפרסו ב-Google Kubernetes Engine (GKE) נרשמים כשמגדירים אותם עם התווית של סוג הפונקציה של סוכן ה-AI וההערה של כרטיס הסוכן. בקר זמן הריצה של אשכול GKE מבצע את סריקת הבדיקה ומפרסם את המטא-נתונים ב-Agent Registry. מידע נוסף זמין במאמר רישום סוכנים מ-GKE.
- Cloud Run: סוכנים מבוססי-קונטיינר שנפרסו בשירותים או במשימות של Cloud Run נרשמים כשפורסים אותם עם הדגלים של סוג הזהות והפונקציונליות. Cloud Run רושם באופן אוטומטי את השם, כתובת ה-URL והסוג של הסוכן (
AGENT) ב-Agent Registry. מידע נוסף זמין במאמר בנושא רישום סוכנים מ-Cloud Run.
המטא-נתונים והיכולות שמקוטלגים עבור סוכן במהלך הרישום תלויים בשאלה אם הסוכן מטמיע את פרוטוקול Agent2Agent (A2A):
- סוכנים שמטמיעים את פרוטוקול A2A: המערכת שולחת שאילתה לכרטיס הסוכן (
/.well-known/agent-card.json) כדי לחלץ באופן אוטומטי את היכולות והכישורים של A2A שפורסמו בקטלוג הרישום. - סוכנים שלא מטמיעים את פרוטוקול A2A (נקודות קצה רגילות של REST או gRPC): המערכת רושמת את כתובת ה-URL של הממשק של הסוכן ואת קישור התעבורה, אבל לא יכולה לחלץ באופן אוטומטי יכולות סמנטיות. כדי לשייך יכולות לנקודות קצה שאינן A2A, אפשר לתאר אותן באמצעות רישום ידני או לקשר אותן למיומנויות ולשרתי MCP עצמאיים בתוך אפליקציית AI.
מידע על Google Cloud זמני ריצה שתומכים ברישום אוטומטי זמין במאמר שימוש ברישום אוטומטי.
רישום ידני
אם הסוכנים מתארחים בפלטפורמות חיצוניות, בשרתים מקומיים, בסביבות זמן ריצה Google Cloud שלא תומכות בגילוי אוטומטי או בפרויקטים שונים Google Cloud , צריך להשתמש ברישום ידני.
כדי לרשום סוכן באופן ידני, צריך להשתמש ב-Agent Registry API, ב-Google Cloud CLI או ב-Terraform כדי ליצור משאב Service שמגדיר את נקודת הקצה וההגדרות של הסוכן. במשאב Service הזה, שאפשר לכתוב בו, מופיעים גם הפרטים הספציפיים של הסוכן. אחרי שיוצרים את Service, המאגר יוצר משאב Agent לקריאה בלבד שאפשר להשתמש בו לגילוי.
אפשר לרשום ידנית שני סוגים של סוכנים:
- סוכנים שתואמים ל-A2A: סוכנים שמטמיעים את המפרט של A2A (
A2A_AGENT_CARD). הרישום סורק את נקודת הקצה של כרטיס הסוכן (agent-card.json) כדי ליצור אינדקס של הכישורים שלהם ב-A2A. - סוכני REST רגילים: סוכנים מרוחקים שלא מטמיעים את המפרט A2A (
NO_SPEC), כמו נקודת קצה רגילה של REST API.
הוראות לרישום סוכנים באופן ידני מופיעות במאמר שימוש ברישום ידני.
שיקולים לגבי רישום בין פרויקטים
אם הארגון שלכם משתמש בארכיטקטורת ניהול מרכזית עם Agent Gateway, אתם יכולים לפרוס שער יציאה מסוכן לכל מקום בפרויקט ניהול מרכזי ולרשום סוכנים שנפרסו בפרויקטים מרובים של spoke או עומסי עבודה.
ההרשמה האוטומטית מגלה רק משאבים בפרויקט המקומי, ולכן צריך לרשום את הסוכנים המרוחקים במרשם של פרויקט השליטה המרכזי באופן ידני. רישום בין פרויקטים מאפשר לשער המרכזי לאתר את הסוכנים ולנהל אותם. הוראות מפורטות מופיעות במאמר רישום סוכן מפרויקט אחר.
שילוב של סקילים עצמאיים
מאגר הסוכנים מאפשר לכם לנהל ולפקח על כישורים עצמאיים של סוכנים כמשאבים ברמה העליונה.
מיומנויות עצמאיות רשומות כמשאבים Skill במאגר שלכם, ומאפשרות לאדמינים להחיל מדיניות גישה מפורטת ולנהל את היסטוריית הגרסאות באמצעות עדכוני מיומנויות.
כשיוצרים ומנהלים סוכנים ב-Gemini Enterprise, אפשר להשתמש במיומנויות הרשומות האלה כדי להרחיב את היכולות של הסוכן. מידע על הרשמה וניהול של מיומנויות עצמאיות זמין במאמרים בנושא הרשמת מיומנויות וניהול מיומנויות.