הגדרת Agent Registry

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

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

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

מגדירים את Agent Registry בפרויקט אחד או בכמה פרויקטים:

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

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

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

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

הגדרת הסביבה של Google Cloud CLI

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

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

    הפעלת Cloud Shell

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

  2. מעדכנים את ה-CLI של gcloud לגרסה העדכנית ביותר באמצעות הפקודה gcloud components update:

    gcloud components update

  3. אם אתם מתכננים להשתמש בתכונות בגרסת תצוגה מקדימה, התקינו את הרכיב alpha באמצעות הפקודה gcloud components install:

    gcloud components install alpha

הפעלת Agent Registry API

משתמשים במזהה הפרויקט כדי להפעיל ממשקי API:

המסוף

כדי להפעיל את Agent Registry API בפרויקט אחד:

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

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

להפעלת ה-API

בכמה פרויקטים (גבולות ניהול), מפעילים את Resource Manager API בפרויקט שמשמש להגדרה:

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

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

להפעלת ה-API

gcloud

  • כדי להפעיל את Agent Registry API בפרויקט אחד, מריצים את הפקודה gcloud services enable:

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

  • בכמה פרויקטים (גבולות ניהול), מפעילים את Resource Manager API בפרויקט שמשמש להגדרה:

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

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

הגדרת גבולות ניהול לכמה פרויקטים

כדי להשתמש ב-Agent Registry בכמה פרויקטים ב- Google Cloud , צריך להגדיר גבול ניהול. גבול ניהול מקבץ פרויקטים חברים ב Google Cloud לפרויקט ניהול מרכזי שמשמש כפרויקט הפיקוח, כדי שתוכלו לגלות ולנהל סוכני AI, שרתי MCP וכלים בפרויקטים שונים.

אתם מגדירים גבול ניהול ב-Resource Manager. להוראות מפורטות, קראו את המאמר הגדרת גבולות ניהול במשאבי העזרה של מנהל המשאבים.

במאמר גבולות בין פרויקטים מופיעה סקירה כללית על האופן שבו המשאבים של BoundaryConfig,‏ Boundary ו-CapabilityConfig פועלים יחד.

כשיוצרים משאב CapabilityConfig באמצעות agent-management, מנהל המשאבים מפעיל באופן אוטומטי את agentregistry.googleapis.com בפרויקט הניהול. אחרי שקובעים את גבולות הניהול:

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

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

מתן הרשאות

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

מקצים למשתמשים אחד או יותר מהתפקידים הבאים ב-Agent Registry:

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

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

שינוי הפרויקט ב-Agent Registry

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

השבתת Agent Registry API

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

המסוף

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

    כניסה ל-Agent Registry API

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

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

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

gcloud

משביתים את Agent Registry API בפרויקט באמצעות הפקודה gcloud services disable:

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

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

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