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

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

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

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

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

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

המסוף

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

כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של Service Usage' (roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאה serviceusage.services.enable. איך מקצים תפקידים

להפעלת ה-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. בכלי לבחירת פרויקטים, בוחרים את הפרויקט שבו הגדרתם את Agent Registry. Google Cloud

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

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

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

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

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

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

    {
  "schemaVersion": "0.3",
  "agent": {
    "name": "mock-travel-agent",
    "description": "A mock agent that plans travel itineraries.",
    "skills": [
      {
        "name": "BookFlight",
        "description": "Books a flight to a destination."
      },
      {
        "name": "SearchHotels",
        "description": "Searches for hotels in a destination city."
      }
    ]
  }
}

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

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

אימות הרישום

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

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

הסרת המשאבים

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

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

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