Wenn Ihr Agenten-Ökosystem wächst, wird es immer wichtiger, den richtigen Agenten oder das richtige Tool zu finden. Die Agent Registry bietet Suchfunktionen, mit denen Sie erweiterte Keyword-, Präfix- und semantische Suchen in Ihren Agenten, ihren Skills und Ihren MCP-Servern (Model Context Protocol) durchführen können.
In diesem Dokument wird erläutert, wie Sie Suchanfragen erstellen, um Funktionen in Ihrer Umgebung zu finden.
Hinweis
Bevor Sie in der Agent Registry nach Agenten, Tools oder Skills suchen, registrieren Sie einen Agenten oder einen MCP-Server. Außerdem benötigen Sie Ihre Projekt-ID, um diese Aufgaben auszuführen.
Wenn Sie die gcloud CLI-Befehle in diesem Dokument verwenden möchten, müssen Sie Ihre Google Cloud CLI-Umgebung eingerichtet haben.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die
Agent Registry API Viewer (roles/agentregistry.viewer) IAM-Rolle für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die
Sie zum Suchen nach Agenten, Tools und Skills in der Agent Registry benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Nach Agenten und Tools suchen
Wenn Sie Funktionen in Ihrer Registry finden möchten, können Sie nach registrierten Agenten und MCP-Servern suchen.
Bei der Suche nach Agenten werden die grundlegenden Metadaten, die Beschreibung und die beschreibenden A2A-Skills abgeglichen, die inline in der Agenten karte deklariert sind. Bei der Suche nach MCP-Servern werden die Beschreibung und die deterministischen Toolsabgeglichen.
Nach Keywords suchen
Sie können eine Keyword-Suche durchführen, um Ressourcen zu finden, die bestimmten Begriffen in ihren Funktionen entsprechen, z. B. einem A2A-Skill eines Agenten oder einem Tool eines MCP-Servers. Informationen zur Struktur dieser Funktionen in der Registry finden Sie unter JSON-Schemas. Eine vollständige Liste der durchsuchbaren Felder finden Sie in der API-Referenz.
Geben Sie das Flag --search-string an, um nach Keywords zu suchen. Dieser Parameter akzeptiert Freitextabfragen und unterstützt logische Operatoren: AND, OR und NOT.
Suchen Sie beispielsweise nach einem Agenten, der Flugbuchungen verarbeiten kann:
gcloud agent-registry agents search \
--project=PROJECT_ID \
--location=REGION \
--search-string="flight OR booking"
Sie können auch nach einem MCP-Server anhand der spezifischen Tools oder der Beschreibung suchen. Suchen Sie beispielsweise nach einem MCP-Server, der Datenbanktools bietet:
gcloud agent-registry mcp-servers search \
--project=PROJECT_ID \
--location=REGION \
--search-string="database"
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-IDREGION: die Registry-Region
Nach Präfix suchen
Präfixsuchen sind stark auf Latenz optimiert, sodass Ihre Anwendungen relevante Agenten und Tools dynamisch abrufen können, während ein Nutzer tippt.
Wenn Sie eine Orchestrator-Oberfläche oder eine Funktion zur automatischen Vervollständigung erstellen, können Sie Präfixsuchen in der Agent Registry durchführen, um Ergebnisse zu erhalten, die mit dem Anfang eines Abfragestrings übereinstimmen. Bei Präfixsuchen wird das Platzhaltersymbol für das Suffix (*) verwendet, um den Anfang eines Wortes abzugleichen.
Suchen Sie beispielsweise nach Agenten, deren Anzeigename mit einem bestimmten Präfix beginnt, z. B. Best_A2A_*:
gcloud agent-registry agents search \
--project=PROJECT_ID \
--location=REGION \
--search-string="displayName:Best_A2A_*"
Ebenso können Sie nach MCP-Servern suchen, deren Anzeigename mit einem bestimmten Präfix beginnt, z. B. Prod_Server_*:
gcloud agent-registry mcp-servers search \
--project=PROJECT_ID \
--location=REGION \
--search-string="displayName:Prod_Server_*"
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-IDREGION: die Registry-Region
Nach eigenständigen Skills suchen
Sie können nach eigenständigen Skills suchen, die in der Agent Registry registriert sind. Mit dieser Funktion können Sie wiederverwendbare Funktionen finden, die Sie Ihren Agenten zuweisen können.
Wenn Sie nach Skills suchen, suchen Sie nach der Standard revision des Skills. Informationen zum Aktualisieren der Standardversion eines Skills finden Sie unter Skill-Metadaten oder Standardversion aktualisieren.
Suchmodi
Je nach Ihren Anforderungen können Sie zwei Suchmodi für Skills verwenden:
- Keyword-Suche:Durchsucht nur grundlegende Metadatenattribute wie Anzeigename, Beschreibung, Name (URN) und Skill-ID. Dieser Modus ist für Suchen mit geringer Latenz, Abgleich und automatische Vervollständigung von Namen optimiert. Ein Beispiel finden Sie unter Nach Skills anhand von Keywords oder Ausdrücken suchen.
- Semantische Suche:Indexiert automatisch den vollständigen Inhalt der
SKILL.md-Nutzlast, einschließlich Anweisungen in natürlicher Sprache, Codestruktur und Assets. Dieser Modus gleicht konzeptionelle Themen ab und ist für Orchestrator-Agenten optimiert, die relevante Funktionspakete dynamisch anhand Ihrer Absicht finden. Ein Beispiel finden Sie unter Nach Skills anhand der semantischen Bedeutung suchen.
Suchfelder und Syntax
Bei der Suche nach Metadaten oder Keyword-Strings werden die folgenden Felder indexiert:
| Feldname | Verhalten bei Groß-/Kleinschreibung | Präfixsuche | Suche in allen Feldern | Beschreibung |
|---|---|---|---|---|
displayName |
Groß- und Kleinschreibung wird nicht berücksichtigt | Ja | Ja | Der für Nutzer sichtbare Name des Skills. Verwenden Sie dieses Feld, um nach allgemeinen Namen zu suchen. |
description |
Groß- und Kleinschreibung wird nicht berücksichtigt | Nein | Ja | Die detaillierte Beschreibung des Zwecks und der Funktionalität des Skills. Verwenden Sie dieses Feld, um Keywords abzugleichen. |
name |
Groß- und Kleinschreibung wird nicht berücksichtigt | Ja | Ja | Die programmatische ID des Skills. Verwenden Sie dieses Feld für Übereinstimmungen mit ID-Strings. |
skillId |
Groß- und Kleinschreibung wird nicht berücksichtigt | Ja | Ja | Der logische Uniform Resource Name (URN) des Skills.
Verwenden Sie dieses Feld, um Assets eines bestimmten Publishers zu finden. Das Format für von Google erstellte Skills ist beispielsweise
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID.
|
publisher |
Groß- und Kleinschreibung wird nicht berücksichtigt | Ja | Nein | Der mit dem Skill verknüpfte Publisher. Verwenden Sie dieses Feld, um nach der veröffentlichenden Organisation zu filtern. |
frontmatter.name |
Groß- und Kleinschreibung wird nicht berücksichtigt | Nein | Nein | Der Name des Skills, der in der Frontmatter der Datei SKILL.md definiert ist. |
frontmatter.description |
Groß- und Kleinschreibung wird nicht berücksichtigt | Nein | Nein | Die Beschreibung des Skills, die in der Frontmatter der Datei SKILL.md definiert ist. |
frontmatter.compatibility |
Groß- und Kleinschreibung wird nicht berücksichtigt | Nein | Nein | Die Kompatibilität des Skills, die in der Frontmatter der Datei SKILL.md definiert ist. |
frontmatter.license |
Groß- und Kleinschreibung wird nicht berücksichtigt | Nein | Nein | Die Lizenz des Skills, die in der Frontmatter der Datei SKILL.md definiert ist. |
createTime |
Nicht zutreffend | Nein | Nein | Der Zeitstempel, an dem der Skill erstellt wurde. Dieses Feld ist nur in Filtern verfügbar. Unterstützt Bereichsoperatoren wie <, > und genaue Übereinstimmungen. |
updateTime |
Nicht zutreffend | Nein | Nein | Der Zeitstempel, an dem der Skill zuletzt aktualisiert wurde. Dieses Feld ist nur in Filtern verfügbar. Unterstützt Bereichsoperatoren wie <, > und genaue Übereinstimmungen. |
Der Abfragestring wird über das Flag --query oder den query
Parameter an Befehle angehängt und akzeptiert logische Argumente. Sie können die folgenden Elemente in Ihren Suchanfragen verwenden:
- Boolesche Operatoren:Verwenden Sie die Operatoren
AND,ORoderNOT, um Anforderungen zu verknüpfen. - Feldspezifische Filter:Verwenden Sie den Operator
:, um ein Feld anzugeben, z. B.displayName:database. - Präfixabgleich:Verwenden Sie das Platzhaltersuffix
:*, um Übereinstimmungen zu finden, die mit einem bestimmten Präfix beginnen, z. B.skillId:db-*.
Nach Skills anhand von Keywords oder Ausdrücken suchen
Im folgenden Beispiel wird nach Skills gesucht, die einem bestimmten Präfix des Anzeigenamens und einem Keyword in der Beschreibung entsprechen:
gcloud alpha agent-registry skills search \
--project=PROJECT_ID \
--location=REGION \
--query="displayName:db-* AND description:sql"
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-IDREGION: die Registry-Region
Nach Skills anhand der semantischen Bedeutung suchen
Im folgenden Beispiel wird eine semantische Suche durchgeführt, um Skills zu finden, die sich auf die Verarbeitung von Datenbankabfragen beziehen und konzeptionellen Themen in der Abfrage in natürlicher Sprache entsprechen:
gcloud alpha agent-registry skills search \
--project=PROJECT_ID \
--location=REGION \
--query="find skills to handle database queries" \
--search-type=semantic
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-IDREGION: die Registry-Region
Öffentliche Skills
Die öffentlichen Skills von Google sind in allen Projekten global auffindbar. Eine Liste
der verfügbaren öffentlichen Skills finden Sie im
google/skills Repository auf
GitHub.
Wenn Sie eine Suche durchführen, schreibt die Agent Registry die logischen Ressourcennamen öffentlicher Skills in der Ausgabe dynamisch um, sodass es so aussieht, als wären sie in Ihrem lokalen Projekt gehostet. Dadurch wird die Integration vereinfacht.