כשרושמים סוכן, הוא הופך לרכיב שאפשר למצוא במאגר הסוכנים. כשמפרסמים את היכולות A2A של הסוכן, עוזרים למפתחים אחרים ולסוכני תזמור בארגון למצוא את העבודה שלכם ולעשות בה שימוש חוזר, וכך מאיצים את פיתוח ה-AI הכולל.
מאגר הסוכנים משתלב בצורה חלקה עם פרוטוקול 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 נרשמים ללא הגדרה נוספת.
- סוכני Google מובנים: סוכנים ש-Google מספקת ישירות, כמו סוכני Google Workspace ו-Gemini Enterprise, ניתנים לגילוי ללא צורך בהגדרה.
- Google Kubernetes Engine: סוכנים בקונטיינרים שנפרסים ב-Google Kubernetes Engine (GKE) נרשמים כשהם כוללים תווית ספציפית של סוג פונקציונלי של Agent Registry.
המטא-נתונים והיכולות של סוכן A2A שנרשמו במהלך ההרשמה שלו תלויים בפרוטוקול של הסוכן:
- סוכנים שמיישמים את פרוטוקול Agent2Agent (A2A): A2A הוא תקן פתוח שמאפשר לסוכנים להצהיר על היכולות והזהות שלהם. אם הסוכן שלכם מיישם את הפרוטוקול הזה, Agent Registry מחלץ אוטומטית את הכישורים של הסוכן A2A מכרטיס הסוכן שלו ומאכלס את המרשם.
- סוכנים שלא מטמיעים את פרוטוקול A2A: Agent Registry רושם את הסוכן, אבל לא יכול לתעד באופן אוטומטי מטא-נתונים כמו כתובת ה-URL של ההסקה ומיומנויות A2A. כדי לספק את המידע הזה ולאפשר לאנשים למצוא את הסוכן שלכם, צריך להשתמש ברישום ידני.
מידע על 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, אתם יכולים לפרוס שער יציאה מסוג Agent-to-Anywhere בפרויקט ניהול מרכזי ולרשום סוכנים שנפרסו בכמה פרויקטים של spoke או workload.
ההרשמה האוטומטית מגלה רק משאבים בפרויקט המקומי, ולכן צריך לרשום את הסוכנים המרוחקים במרשם של פרויקט השליטה המרכזי באופן ידני. רישום בין פרויקטים מאפשר לשער המרכזי לאתר את הסוכנים ולנהל אותם. הוראות מפורטות מופיעות במאמר רישום סוכן מפרויקט אחר.
שילוב של מיומנויות עצמאיות
מאגר הסוכנים מאפשר לכם לנהל ולפקח על מיומנויות עצמאיות של סוכנים כמשאבים ברמה העליונה.
מיומנויות עצמאיות רשומות כמשאבים Skill במאגר שלכם, ומאפשרות לאדמינים להחיל מדיניות גישה מפורטת ולנהל את היסטוריית הגרסאות באמצעות עדכוני מיומנויות.
כשמפתחים ומנהלים סוכנים ב-Gemini Enterprise, אפשר להשתמש במיומנויות הרשומות האלה כדי להרחיב את היכולות של הסוכן. מידע על הרשמה וניהול של מיומנויות עצמאיות זמין במאמרים בנושא הרשמת מיומנויות וניהול מיומנויות.