כשרושמים סוכן, הוא הופך לרכיב שאפשר למצוא במאגר הסוכנים. כשמפרסמים את היכולות של הסוכן, עוזרים למפתחים אחרים ולסוכני תזמור בארגון למצוא את העבודה שלכם ולעשות בה שימוש חוזר, וכך מאיצים את פיתוח ה-AI הכולל.
Agent Registry משתלב בצורה חלקה עם פרוטוקול Agent2Agent (A2A) והמפרטים שלו. A2A הוא תקן פתוח שמאפשר לסוכנים להצהיר על היכולות והזהות שלהם. Agent Registry תומך בגרסאות 0.3 ו-1.0 של מפרט A2A. מידע נוסף זמין במאמר בנושא סכימת כרטיס הנציג.
בהתאם לזמני הריצה של הסוכנים, 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: אם הסוכן שלכם מטמיע את פרוטוקול A2A, מאגר הסוכנים יחלץ אוטומטית את הכישורים של הסוכן מכרטיס הסוכן שלו ויאכלס את המאגר.
- סוכנים שלא מטמיעים את פרוטוקול A2A: רישום הסוכנים רושם את הסוכן, אבל לא יכול לתעד אוטומטית מטא-נתונים כמו כתובת ה-URL של ההסקה והכישורים. כדי לספק את המידע הזה ולאפשר לאנשים למצוא את הסוכן שלכם, צריך להשתמש ברישום ידני.
מידע על Google Cloud זמני ריצה שתומכים ברישום אוטומטי זמין במאמר שימוש ברישום אוטומטי.
רישום ידני
אם הסוכנים מתארחים בפלטפורמות חיצוניות, בשרתים מקומיים או בסביבות זמן ריצה שלא תומכות בגילוי אוטומטי, צריך להשתמש ברישום ידני. Google Cloud
כדי לרשום סוכן באופן ידני, משתמשים ב-Agent Registry API, ב-Google Cloud CLI או ב-Terraform כדי ליצור Service משאב שמגדיר את נקודת הקצה וההגדרות של הסוכן. במשאב Service הזה, שאפשר לכתוב בו, מופיעים גם הפרטים הספציפיים של הסוכן. אחרי שיוצרים את Service, המאגר יוצר משאב Agent לקריאה בלבד שאפשר להשתמש בו לגילוי.
אפשר לרשום ידנית שני סוגים של סוכנים:
- סוכנים שתואמים ל-A2A: סוכנים שמטמיעים את המפרט של A2A (
A2A_AGENT_CARD). הרישום סורק את נקודת הקצה של כרטיס הסוכן שלהם (agent-card.json) כדי ליצור אינדקס של הכישורים שלהם. - סוכני REST רגילים: סוכנים מרוחקים שלא מטמיעים את המפרט A2A (
NO_SPEC), כמו נקודת קצה רגילה של REST API.
הוראות לרישום סוכנים באופן ידני מופיעות במאמר שימוש ברישום ידני.