רישום של סוכן ADK בהתאמה אישית

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

לפני שמתחילים

  1. הגדרת Agent Registry.

  2. משיגים את מזהה הפרויקט של פרויקט הפיקוח שבו מופעל Agent Registry.

  3. כדי להשתמש בפקודות של Google Cloud CLI שמופיעות במאמר הזה, צריך להגדיר את סביבת ה-CLI של gcloud.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות לרישום סוכני ADK בהתאמה אישית ב-Agent Registry, בקשו מהאדמין להקצות לכם את התפקיד עריכה באמצעות Agent Registry API (roles/agentregistry.editor) ב-IAM בפרויקט הפיקוח שבו Agent Registry מופעל. להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

נקודת הקצה של Agent Card

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

לפי מפרט ה-A2A, נציגים צריכים להציג כרטיס נציג, שהוא מסמך JSON שמתאר את הזהות והכלים של הנציג, בנקודת קצה ספציפית, בדרך כלל /.well-known/agent-card.json.

כשאתם משתמשים בפלאגינים או במודולים הספציפיים של שרת A2A ב-ADK כדי לרשום את הנציג, ה-framework יכולה ליצור ולהציג באופן אוטומטי את כרטיס הנציג הזה על סמך ההגדרה של Agent ו-tools שאתם מספקים בקוד.

רישום הסוכן החשוף

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

בפריסות בהתאמה אישית צריך לבצע רישום ידני, ולכן יוצרים משאב Service במרשם. שומרים את כרטיס הסוכן שנוצר כקובץ JSON מקומי, לדוגמה, agent-card.json.

משתמשים ב-CLI של gcloud כדי לרשום את הנציג באמצעות הפקודה gcloud agent-registry services create, ומקפידים לציין את סוג המפרט 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

גודל הקובץ המקסימלי של קובץ המפרט הוא 10KB.

מחליפים את מה שכתוב בשדות הבאים:

  • ‫AGENT_NAME: השם שרוצים לתת לנציג, לדוגמה my-custom-agent.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום או האזור של המאגר.
  • ‫DISPLAY_NAME: השם הקריא לאנשים של הנציג.

אחרי שנוצר המשאב Service, ‏Agent Registry מנתח את כרטיס הסוכן, יוצר משאב Agent לקריאה בלבד ומוסיף לאינדקס את המיומנויות של A2A שמוגדרות בקוד Python של ADK, כדי שמפתחים אחרים יוכלו לחפש אותן.