הגדרת Agent Registry

כדי לרשום ולגלות את סוכני ה-AI, שרתי Model Context Protocol‏ (MCP) ונקודות הקצה ב-Agent Registry, צריך להפעיל את Agent Registry API בפרויקט Google Cloud . מאגר הסוכנים פועל ברמת הפרויקט, ומאפשר לכם לגלות ולנהל סוכנים שנפרסו בפרויקט הספציפי שבו ה-API מופעל.

במאמר הזה מוסבר איך להגדיר את Agent Registry ולהפעיל את ה-API הנדרש.

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

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

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

כדי לקבל את ההרשאות שדרושות להגדרת מאגר הסוכנים, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט Google Cloud :

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

הגדרת סביבת ה-CLI של gcloud

אם אתם מתכננים להשתמש ב-Google Cloud CLI בשביל Agent Registry, אתם צריכים לפעול לפי השלבים הבאים:

  1. במסוף Google Cloud , מפעילים את Cloud Shell.

    הפעלת Cloud Shell

    בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

  2. מתקינים את הרכיב alpha:

    gcloud components install alpha

  3. מוודאים שמותקנת הגרסה העדכנית של ה-CLI של gcloud:

    gcloud components update

הפעלת 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 במזהה הפרויקט.

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

מתן הרשאות

כדי לראות ולנהל משאבים במאגר הסוכנים, צריך להעניק למשתמשים את ההרשאות המתאימות בניהול הזהויות והרשאות הגישה (IAM).

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

  • Agent Registry API Viewer (roles/agentregistry.viewer): צפייה בסוכנים, בכלים ובמאפיינים שלהם.
  • Agent Registry API Editor (roles/agentregistry.editor): גישת עריכה למשאבי Agent Registry.
  • Agent Registry API Admin (roles/agentregistry.admin): ביצוע כל הפעולות, כולל רישום סוכנים באופן ידני ועדכון מטא-נתונים.

במאמר ניהול הגישה לפרויקטים, לתיקיות ולארגונים מוסבר איך מקצים תפקידי IAM בפרויקט.

שינוי הפרויקט של Agent Registry

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

השבתת Agent Registry API

אם אין לכם יותר צורך ב-Agent Registry, אתם יכולים להשבית את Agent Registry API בפרויקט:

המסוף

  1. במסוף Google Cloud , עוברים לדף הניהול של Agent Registry API:

    מעבר אל Agent Registry API

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

  3. לוחצים על השבתת ה-API.

  4. בתיבת הדו-שיח לאישור, לוחצים על השבתה.

gcloud 

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

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

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