‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

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

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

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

חיפוש סוכנים, כלים ומיומנויות: צפייה ב-Agent Registry API ‏(roles/agentregistry.viewer)
חיפוש מיומנויות עצמאיות וצפייה בהן: משתמש במרשם הסוכנים (roles/agentregistry.user)

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

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

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

כדי לגלות יכולות במאגר, אתם יכולים לחפש סוכנים ושרתי MCP רשומים במסוף Google Cloud , ב-CLI של gcloud או ב-API בארכיטקטורת REST.

כשמחפשים נציגים או שרתי MCP, אפשר להזין בשאילתה את השם המוצג, התיאור או מילות מפתח שקשורות ליכולות:

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

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

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

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

המסוף

במסוף Google Cloud , נכנסים לדף Agent Registry:

כניסה ל-Agent Registry
בכלי לבחירת פרויקטים, בוחרים את הפרויקט ב- Google Cloud .
בסרגל Search your registry שבחלק העליון של הדף, מזינים שאילתת מילת מפתח באורך של שלושה תווים לפחות, כמו flight או database, או מסנן שדה, כמו Name:booking, ולוחצים על Enter.

בטבלה Search results מוצגים הסוכנים, שרתי ה-MCP והמיומנויות העצמאיות שתואמים למיקומים שבחרתם.

gcloud

מציינים את הדגל --search-string בפקודה gcloud agent-registry agents search או gcloud agent-registry mcp-servers search.

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

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

מחפשים שרת MCP שמספק כלים למסדי נתונים:

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

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

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

REST

שולחים בקשת POST לנקודת הקצה agents:search או mcpServers:search עם השדה searchString בגוף הבקשה.

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

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{"searchString": "flight OR booking"}' \
    "https://agentregistry.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/agents:search"

מחפשים שרת MCP שמספק כלים למסדי נתונים:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{"searchString": "database"}' \
    "https://agentregistry.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/mcpServers:search"

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

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

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

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

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

gcloud

מריצים את הפקודה gcloud agent-registry agents search או gcloud agent-registry mcp-servers search עם ביטוי קידומת.

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

REST

מעבירים את ביטוי הקידומת בשדה searchString של גוף הבקשה:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{"searchString": "displayName:Best_A2A_*"}' \
    "https://agentregistry.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/agents:search"

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

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

חיפוש בין מערכות שונות

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

gcloud agent-registry agents search \
    --project=MANAGEMENT_PROJECT_ID \
    --location=LOCATION \
    --search-string="analytics"

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

‫MANAGEMENT_PROJECT_ID: המזהה של פרויקט הניהול.
‫LOCATION: המיקום שבו רוצים לחפש בגבולות הניהול, למשל אזור כמו us-central1, מספר אזורים כמו us או eu, או global. ב-Agent Registry נאספים משאבים באותו מיקום בפרויקט הניהול ובכל הפרויקטים החברים בגבול.

כדי לצמצם את התוצאות בפרויקט הניהול לפרויקט חבר ספציפי, מעבירים את הדגל --filter כשהוא מוגדר ל-"project_id=MEMBER_PROJECT_ID". כדי לחפש רק בפרויקט אחד בלי לאסוף נתונים מפרויקטים אחרים, צריך לציין את המזהה של הפרויקט בדגל --project.

כשמבצעים חיפוש מפרויקט הניהול:

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

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

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

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

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

מצבי חיפוש

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

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

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

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

שם השדה	התנהגות של בקשות תמיכה	חיפוש לפי קידומת	חיפוש בכל השדות	תיאור
`displayName`	לא תלוי-רישיות	כן	כן	השם המוצג של המיומנות. אפשר להשתמש בשדה הזה כדי לחפש שמות נפוצים.
`description`	לא תלוי-רישיות	לא	כן	תיאור מפורט של המטרה והפונקציונליות של המיומנות. אפשר להשתמש בשדה הזה כדי לחפש מילות מפתח.
`name`	לא תלוי-רישיות	כן	כן	שם המשאב של המיומנות. אפשר להשתמש בשדה הזה כדי לחפש לפי שם המשאב.
`skillId`	לא תלוי-רישיות	כן	כן	מזהה המיומנות של המיומנות. אתם יכולים להשתמש בשדה הזה כדי למצוא נכסים של בעל תוכן דיגיטלי ספציפי. לדוגמה, הפורמט של סקילים שמנוהלים על ידי Google הוא `urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID`.
`publisher`	לא תלוי-רישיות	כן	לא	הגורם המדווח שקשור למיומנות. בשדה הזה אפשר לסנן לפי הארגון המפרסם.
`frontmatter.name`	לא תלוי-רישיות	לא	לא	שם המיומנות שמוגדרת ב-front matter של קובץ `SKILL.md`.
`frontmatter.description`	לא תלוי-רישיות	לא	לא	תיאור המיומנות שמוגדרת ב-front matter של הקובץ `SKILL.md`.
`frontmatter.compatibility`	לא תלוי-רישיות	לא	לא	התאימות של הסקיל שמוגדרת ב-front matter של הקובץ `SKILL.md`.
`frontmatter.license`	לא תלוי-רישיות	לא	לא	הרישיון של המיומנות שמוגדרת ב-front matter של קובץ ה-`SKILL.md`.
`frontmatter.allowed_tools`	לא תלוי-רישיות	לא	לא	הכלים המותרים של המיומנות שמוגדרת ב-front matter של הקובץ `SKILL.md`.
`frontmatter.metadata.KEY`	לא תלוי-רישיות	לא	לא	רשומה של צמד מפתח/ערך של מטא-נתונים בהתאמה אישית שמוגדרת ב-`metadata` ב-front matter של הקובץ `SKILL.md`. תמיכה באופרטור `:` בשאילתות חיפוש ובהתאמות מדויקות (`=` ו-`!=`) במסננים.
`state`	לא תלוי-רישיות	לא	לא	מצב מחזור החיים הנוכחי של הסקיל, למשל `ACTIVE`,‏ `DRAFT`,‏ `DISABLED`,‏ `DEPRECATED` או `DECOMMISSIONED`. השדה הזה זמין רק במסננים ותומך בהתאמות מדויקות (`=` ו-`!=`).
`targetState`	לא תלוי-רישיות	לא	לא	מצב מחזור החיים של המיומנות, למשל `ACTIVE`,‏ `DRAFT`,‏ `DISABLED`,‏ `DEPRECATED` או `DECOMMISSIONED`. השדה הזה זמין רק במסננים ותומך בהתאמות מדויקות (`=` ו-`!=`).
`defaultRevisionFindingCount`	לא רלוונטי	לא	לא	מספר ממצאי האבטחה שזוהו בגרסת ברירת המחדל של המיומנות. השדה הזה זמין רק במסננים ותומך בהתאמות מדויקות (`=` ו-`!=`) ובאופרטורים של טווחים (`<`,‏ `<=`,‏ `>` ו-`>=`), כמו `defaultRevisionFindingCount = 0` או `defaultRevisionFindingCount > 0`.
`createTime`	לא רלוונטי	לא	לא	חותמת הזמן של מועד יצירת המיומנות. השדה הזה זמין רק במסננים. תמיכה באופרטורים של טווחים, כמו `<`, `>` והתאמות מדויקות.
`updateTime`	לא רלוונטי	לא	לא	חותמת הזמן של העדכון האחרון של המיומנות. השדה הזה זמין רק במסננים. תמיכה באופרטורים של טווחים, כמו `<`, `>` והתאמות מדויקות.

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

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

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

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

gcloud

מריצים את הפקודה gcloud agent-registry skills search עם --search-type=keyword:

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

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

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

REST

שולחים בקשת POST לנקודת הקצה skills:search עם השדות searchString ו-searchType בגוף הבקשה:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "searchString": "displayName:cloud-* AND description:database",
      "searchType": "KEYWORD"
    }' \
    "https://agentregistry.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/skills:search"

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

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

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

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

gcloud

מריצים את הפקודה gcloud agent-registry skills search עם --search-type=semantic:

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

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

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

REST

שולחים בקשת POST לנקודת הקצה skills:search עם השדות searchString ו-searchType בגוף הבקשה:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "searchString": "manage and configure relational databases",
      "searchType": "SEMANTIC"
    }' \
    "https://agentregistry.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/skills:search"

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

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

מיומנויות שמנוהלות על ידי Google

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

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

אתם יכולים גם לגלות כל רכיב ב-Agent Registry, כולל נקודות קצה (endpoints) רשומות, על ידי הצגת האוסף שלו וסינון לפי שדות מטא-נתונים מובְנים:

גילוי נקודות קצה (endpoints): מכיוון שמשאבי Endpoint לא תומכים בשאילתות :search, אתם מגלים אותם על ידי עיון בכרטיסייה Endpoints במסוףGoogle Cloud , הפעלת gcloud agent-registry endpoints list --filter או קריאה ל-method‏ REST‏ endpoints.list. הוראות מלאות מופיעות במאמר ניהול וגילוי של נקודות קצה (endpoint).
סינון נציגים, שרתי MCP ומיומנויות: אם אתם יודעים את מזהה הרישום (URN), השם המוצג או המאפיין של רכיב מסוים, אתם יכולים לסנן את האוסף במסוףGoogle Cloud או להעביר את --filter אל gcloud agent-registry agents list, אל gcloud agent-registry mcp-servers list או אל gcloud agent-registry skills list. פרטים נוספים זמינים במאמרים ניהול נציגים, ניהול שרתים וכלים של MCP וניהול מיומנויות.

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

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

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

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

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

המסוף

gcloud

REST

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

gcloud

REST

חיפוש בין מערכות שונות

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

מצבי חיפוש

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

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

gcloud

REST

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

gcloud

REST

מיומנויות שמנוהלות על ידי Google

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

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