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

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

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

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

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

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

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

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

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

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

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

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

אתם יכולים לבצע חיפוש מילות מפתח כדי למצוא משאבים שתואמים למונחים ספציפיים ביכולות שלהם, כמו מיומנות A2A של סוכן או כלי של שרת 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: האזור של המאגר.

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

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

לדוגמה, אפשר לחפש סוכנים שהשם המוצג שלהם מתחיל בקידומת ספציפית, כמו 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: האזור של המאגר.

חיפוש סקילים עצמאיים

אפשר לחפש מיומנויות עצמאיות שרשומות במאגר הסוכנים. התכונה הזו מאפשרת לכם לגלות יכולות לשימוש חוזר שאפשר לצרף לסוכנים.

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

מצבי חיפוש

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

  • חיפוש מילות מפתח: החיפוש מתבצע רק במאפייני מטא-נתונים בסיסיים כמו השם המוצג, התיאור, השם (URN) ומזהה המיומנות. המצב הזה מותאם לחיפושים, להתאמות ולהשלמה אוטומטית של שמות עם זמן אחזור נמוך. דוגמה מופיעה במאמר חיפוש מיומנויות לפי מילת מפתח או ביטוי.
  • חיפוש סמנטי: יצירת אינדקס אוטומטית של כל התוכן במטען הייעודי (payload) של SKILL.md, כולל הוראות בשפה טבעית, מבנה קוד ונכסים. במצב הזה, המערכת מתאימה נושאים מושגיים ועוברת אופטימיזציה כדי לסייע לסוכני תזמור למצוא באופן דינמי חבילות יכולות רלוונטיות, על סמך הכוונה שלכם. דוגמה מופיעה במאמר בנושא חיפוש מיומנויות לפי משמעות סמנטית.

חיפוש שדות ותחביר

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

שם השדה התנהגות הבקשה חיפוש עם תחילית חיפוש בכל השדות תיאור
displayName ללא תלות ברישיות כן כן השם של המיומנות שמוצג למשתמש. אפשר להשתמש בשדה הזה כדי לחפש שמות נפוצים.
description ללא תלות ברישיות לא כן תיאור מפורט של המטרה והפונקציונליות של המיומנות. משתמשים בשדה הזה כדי להתאים מילות מפתח.
name ללא תלות ברישיות כן כן המזהה הפרוגרמטי של המיומנות. משתמשים בשדה הזה להתאמות של מחרוזות מזהים.
skillId ללא תלות ברישיות כן כן השם הלוגי של המשאב האחיד (URN) של הסקיל. בשדה הזה אפשר לחפש נכסים של שותף משני ספציפי. לדוגמה, הפורמט של מיומנויות שנוצרו על ידי Google הוא urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID.
publisher ללא תלות ברישיות כן לא הגורם המדווח שמשויך למיומנות. בשדה הזה אפשר לסנן לפי הארגון המפרסם.
frontmatter.name ללא תלות ברישיות לא לא השם של ה-Skill שמוגדר בקטע frontmatter של הקובץ SKILL.md.
frontmatter.description ללא תלות ברישיות לא לא התיאור של המיומנות מוגדר בקטע frontmatter בקובץ SKILL.md.
frontmatter.compatibility ללא תלות ברישיות לא לא התאימות של המיומנות שמוגדרת בקטע frontmatter של הקובץ SKILL.md.
frontmatter.license ללא תלות ברישיות לא לא הרישיון של ה-Skill מוגדר בקטע frontmatter בקובץ SKILL.md.
createTime לא רלוונטי לא לא חותמת הזמן שבה נוצר הסקיל. השדה הזה זמין רק במסננים. תומך באופרטורים של טווחים, כמו <, > והתאמות מדויקות.
updateTime לא רלוונטי לא לא חותמת הזמן של העדכון האחרון של המיומנות. השדה הזה זמין רק במסננים. תמיכה באופרטורים של טווחים, כמו <, > והתאמות מדויקות.

כדי לחפש מיומנויות, צריך לספק מחרוזת שאילתה באמצעות הדגל --query ב-CLI של gcloud או הפרמטר searchString ב-API בארכיטקטורת REST. אפשר להשתמש ברכיבי התחביר הבאים בבקשות החיפוש:

  • אופרטורים בוליאניים: כוללים את האופרטורים AND, OR או NOT לשרשור דרישות.
  • מסננים ספציפיים לשדה: כדי לטרגט שדה מסוים, משתמשים באופרטור :. לדוגמה, displayName:database.
  • התאמה לפי קידומת: משתמשים בתו הכללי לחיפוש של סיומת (*) כדי למצוא התאמות שמתחילות בקידומת ספציפית, לדוגמה, displayName:cloud-*.

חיפוש מיומנויות לפי מילת מפתח או ביטוי

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

gcloud alpha agent-registry skills search \
  --project=PROJECT_ID \
  --location=REGION \
  --query="displayName:cloud-* AND description:database" \
  --search-type=keyword

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

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

חיפוש מיומנויות לפי משמעות סמנטית

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

gcloud alpha agent-registry skills search \
  --project=PROJECT_ID \
  --location=REGION \
  --query="manage and configure relational databases" \
  --search-type=semantic

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

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

סקילים ציבוריים

מיומנויות ציבוריות שסופקו על ידי Google הן גלובליות ואפשר לגלות אותן מכל פרויקט. רשימה של כל המיומנויות הציבוריות הזמינות מופיעה במאגר google/skills ב-GitHub.

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