חיפוש סוכנים וכלים

ככל שהמערכת האקולוגית של הסוכנים שלכם גדלה, חשוב מאוד למצוא את הסוכן או הכלי הנכונים. מאגר הסוכנים מספק יכולות חיפוש שמאפשרות לבצע חיפושים מתקדמים של מילות מפתח וקידומות בסוכנים ובשרתים של Model Context Protocol‏ (MCP).

במאמר הזה מוסבר איך ליצור שאילתות חיפוש כדי לגלות יכולות בסביבה שלכם.

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

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

כדי להשתמש בפקודות של ה-CLI של gcloud שמופיעות במסמך הזה, צריך לוודא שהגדרתם את סביבת ה-CLI של gcloud.

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

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

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

חיפוש לפי מילות מפתח

אתם יכולים לבצע חיפוש של מילות מפתח כדי למצוא משאבים שתואמים למונחים ספציפיים ביכולות שלהם, כמו כישורים של סוכן או כלים של שרת MCP. כדי להבין את המבנה של היכולות האלה במאגר, אפשר לעיין בסכימות JSON. רשימה מלאה של השדות שאפשר לחפש מופיעה בהפניית ה-API.

כדי לחפש לפי מילות מפתח, צריך לספק את הדגל --search-string. הפרמטר הזה מקבל שאילתות טקסט חופשי ותומך באופרטורים לוגיים: AND,‏ OR ו-NOT.

לדוגמה, אפשר לחפש סוכן שיכול לטפל בהזמנות של טיסות:

gcloud agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="flight OR booking"

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

gcloud agent-registry mcp-servers search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="database"

מחליפים את מה שכתוב בשדות הבאים:

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫REGION: האזור של המאגר.

חיפוש לפי קידומת

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

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

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

gcloud agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Best_A2A_*"

באופן דומה, אפשר לחפש שרתי MCP שהשם המוצג שלהם מתחיל בקידומת ספציפית, כמו Prod_Server_*:

gcloud agent-registry mcp-servers search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Prod_Server_*"

מחליפים את מה שכתוב בשדות הבאים:

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫REGION: האזור של המאגר.