אם אתם יוצרים סוכן בהתאמה אישית באמצעות ערכה לפיתוח סוכנים (ADK) ומארחים אותו בתשתית משלכם, אתם יכולים לחשוף כרטיס סוכן ולרשום ידנית את נקודת הקצה שלו כדי שיהיה אפשר לגלות אותו במאגר הסוכנים.
במאמר הזה מוסבר איך לוודא שהסוכן שלכם ב-ADK תואם לפרוטוקול Agent2Agent (A2A), כדי שהמאגר יוכל לבצע אינדקס של הכישורים שלו.
נקודת הקצה של כרטיס הסוכן
כדי שממשק Agent Registry יוכל להבין את היכולות של הסוכן המותאם אישית, הסוכן צריך לחשוף את המטא-נתונים והכישורים הזמינים שלו באמצעות הפרוטוקול Agent2Agent (A2A).
במפרט A2A נדרש מסוכנים להציג כרטיס סוכן, שהוא מסמך JSON שמתאר את הזהות והכלים של הסוכן, בנקודת קצה ספציפית, בדרך כלל /.well-known/agent-card.json.
כשמשתמשים בתוספים או במודולים ספציפיים של שרת A2A ב-ADK כדי לרשום את הסוכן, המסגרת יכולה ליצור ולהציג באופן אוטומטי את כרטיס הסוכן הזה על סמך ההגדרה Agent והמידע tools שסיפקתם בקוד.
רישום הסוכן שנחשף
אחרי שפורסים את סוכן ה-ADK בסביבת האירוח והוא מציג בהצלחה את נקודות הקצה של REST, צריך להנחות את Agent Registry לגלות אותו.
מכיוון שפריסות בהתאמה אישית דורשות רישום ידני, צריך ליצור משאב Service במרשם. שומרים את כרטיס הסוכן שנוצר כקובץ JSON מקומי, למשל, agent-card.json.
משתמשים ב-Google Cloud CLI כדי לרשום את הסוכן, מקפידים לציין את סוג המפרט a2a-agent-card ומעלים את הקובץ המקומי באמצעות הדגל --agent-spec-content:
gcloud agent-registry services create AGENT_NAME \
--project=PROJECT_ID \
--location=LOCATION \
--display-name="DISPLAY_NAME" \
--agent-spec-type=a2a-agent-card \
--agent-spec-content=agent-card.json
גודל הקובץ המקסימלי של קובץ המפרט הוא 10 KB.
מחליפים את מה שכתוב בשדות הבאים:
-
AGENT_NAME: השם שרוצים לתת לסוכן, לדוגמה,my-custom-agent. -
PROJECT_ID: מזהה הפרויקט. -
LOCATION: המיקום או האזור של המאגר. -
DISPLAY_NAME: השם של הסוכן שקריא לאנשים.
אחרי שנוצר משאב Service, מאגר הסוכנים מנתח את כרטיס הסוכן, יוצר משאב Agent שניתן לחיפוש ומבצע אינדוקס של הכישורים שמוגדרים בקוד Python של ADK, כדי שמפתחים אחרים יוכלו לחפש אותם.