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

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

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

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

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

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

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

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

רישום נציג מדומה

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

כדי לרשום את הנציג, פועלים לפי השלבים הבאים:

  1. במסוף Google Cloud , נכנסים לדף Agent Registry:

    כניסה ל-Agent Registry

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

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

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

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

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

    • סוג: בוחרים באפשרות A2A.
    • Region: בוחרים באפשרות 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. בכרטיסייה Agents, מאתרים את הנציג המדומה ברשימה.
  2. לוחצים על שם הסוכן כדי לראות את הפרטים שלו.
  3. מוודאים שהסקילים BookFlight ו-SearchHotels של A2A מופיעים בכרטיסייה סקירה כללית.

הסרת המשאבים

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

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

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