מדריך למתחילים: רישום סוכן

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

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

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

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

מפעילים את Agent Registry API:

המסוף

תפקידים שנדרשים להפעלת ממשקי API

כדי להפעיל ממשקי API, נדרשת ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

להפעלת ה-API

gcloud

מפעילים את Agent Registry API בפרויקט:

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

מחליפים את PROJECT_ID במזהה הפרויקט.

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

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

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

רישום סוכן מדומה

כדי לנסות את Agent Registry, אפשר לרשום ידנית סוכן מדומה על ידי הדבקה של כרטיס סוכן לדוגמה של Agent2Agent (A2A).

כדי לרשום את הסוכן:

  1. במסוף Google Cloud , עוברים אל Agent Registry:

    כניסה ל-Agent Registry

    אם מופיעה בקשה, לוחצים על הפעלה כדי להפעיל את Agent Registry API.

  2. בבורר הפרויקטים, בוחרים את Google Cloud הפרויקט שבו הגדרתם את Agent Registry.

  3. לוחצים על הכרטיסייה סוכנים.

  4. לוחצים על הוספת סוכן.

  5. בחלונית פרטי הסוכן, מזינים את הפרטים הבאים:

    • סוג: בוחרים באפשרות A2A.
    • אזור: בוחרים באפשרות global (גלובלי).

  6. בוחרים בכרטיסייה הדבקת JSON.

  7. מעתיקים ומדביקים את התוכן הבא של כרטיס הסוכן:

    {
  "supportedInterfaces": [
    {
      "url": "https://example.com/mock-travel-agent",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0.0"
    }
  ],
  "name": "mock-travel-agent",
  "description": "A mock agent that plans travel itineraries.",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"],
  "skills": [
    {
      "id": "BookFlight",
      "name": "BookFlight",
      "description": "Books a flight to a destination.",
      "tags": ["travel", "booking"]
    },
    {
      "id": "SearchHotels",
      "name": "SearchHotels",
      "description": "Searches for hotels in a destination city.",
      "tags": ["travel", "accommodation"]
    }
  ]
}

  8. לוחצים על Save.

Agent Registry מעבדת את כרטיס הסוכן ורושמת את הסוכן.

אימות הרישום

כדי לוודא שהסוכן הדמה נרשם בהצלחה:

  1. בכרטיסייה סוכנים, מאתרים את הסוכן המדומה ברשימה.
  2. לוחצים על השם של הסוכן כדי לראות את הפרטים שלו.
  3. מוודאים שכישורי ה-A2A‏ BookFlight ו-SearchHotels מוצגים בכרטיסייה סקירה כללית.

הסרת המשאבים

כדי למנוע השארת משאבים מדומים בפרויקט, צריך למחוק את הסוכן הרשום:

  1. בכרטיסייה סוכנים, מאתרים את הסוכן המדומה ברשימה.
  2. לוחצים על תפריט אפשרויות נוספות בעמודה פעולות של הסוכן המדומה, ובוחרים באפשרות מחיקה.
  3. בתיבת הדו-שיח לאישור, מקלידים DELETE כדי לאשר את הפעולה.
  4. לוחצים על Delete.

המאמרים הבאים