הגדרת Agent Registry

כדי לרשום ולגלות את סוכני ה-AI, שרתי Model Context Protocol‏ (MCP), מיומנויות עצמאיות ונקודות קצה ב-Agent Registry, צריך להפעיל את Agent Registry API בפרויקט Google Cloud . Agent Registry פועל ברמת הפרויקט, ומאפשר לכם לגלות ולנהל סוכנים, שרתים, סקילים ונקודות קצה שנפרסו בפרויקט הספציפי שבו ה-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. מוודאים שמותקנת הגרסה העדכנית של ה-CLI של gcloud:

    gcloud components update

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

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

מתן הרשאות

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

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

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

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

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

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

השבתת Agent Registry API

אם אתם לא צריכים יותר את מאגר הסוכנים, אתם יכולים להשבית את Agent Registry API בפרויקט:

המסוף

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

    מעבר אל Agent Registry API

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

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

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

gcloud 

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

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

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