רישום סוכנים

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

בהתאם לזמני הריצה של הסוכנים, 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.

המטא-נתונים והכישורים של סוכן שנרשמו במהלך הרישום שלו תלויים בפרוטוקול של הסוכן:

  • סוכנים שמיישמים את פרוטוקול Agent2Agent‏ (A2A): ‫A2A הוא תקן פתוח שמאפשר לסוכנים להצהיר על היכולות והזהות שלהם. אם הסוכן שלכם מיישם את הפרוטוקול הזה, מאגר הסוכנים יחלץ באופן אוטומטי את הכישורים של הסוכן מכרטיס הסוכן שלו ויאכלס את המאגר.
  • סוכנים שלא מיישמים את פרוטוקול A2A: Agent Registry רושם את הסוכן, אבל לא יכול לתעד אוטומטית מטא-נתונים כמו כתובת ה-URL של ההסקה והמיומנויות. כדי לספק את המידע הזה ולאפשר לאנשים למצוא את הסוכן שלכם, צריך להשתמש ברישום ידני.

מידע על Google Cloud זמני ריצה שתומכים ברישום אוטומטי זמין במאמר שימוש ברישום אוטומטי.

רישום ידני

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

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

אפשר לרשום באופן ידני שני סוגים של סוכנים:

  • סוכנים שתואמים ל-A2A: סוכנים שמטמיעים את המפרט של Agent2Agent‏ (A2A) (A2A_AGENT_CARD). הרישום סורק את נקודת הקצה של כרטיס הסוכן (agent-card.json) כדי ליצור אינדקס של הכישורים שלהם.
  • סוכני REST רגילים: סוכנים מרוחקים שלא מטמיעים את המפרט A2A (NO_SPEC), כמו נקודת קצה רגילה של REST API.

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