Wenn Ihr Agenten-Ökosystem wächst, wird es immer wichtiger, den richtigen Agenten oder das richtige Tool zu finden. 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 ermitteln.
Hinweis
Bevor Sie in der Agent Registry nach KI-Agenten, Tools oder Skills suchen, müssen Sie einen KI-Agenten oder einen MCP-Server registrieren. 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 einrichten.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Registry API Viewer (roles/agentregistry.viewer) für das Projekt zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie zum Suchen nach Agents, 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 Agents und Tools suchen
Wenn Sie Funktionen in Ihrer Registry suchen möchten, können Sie nach registrierten KI-Agenten und MCP-Servern suchen.
Bei der Suche nach KI-Agenten werden die grundlegenden Metadaten, die Beschreibung und die beschreibenden A2A-Skills berücksichtigt, die inline auf der Agent Card deklariert sind. Bei der Suche nach MCP-Servern werden die Beschreibung und die deterministischen Tools berücksichtigt.
Nach Keywords suchen
Sie können eine Keyword-Suche durchführen, um Ressourcen zu finden, die bestimmten Begriffen in ihren Funktionen entsprechen, z. B. dem A2A-Skill eines KI-Agenten oder dem Tool eines MCP-Servers. Informationen zur Strukturierung dieser Funktionen in der Registrierung finden Sie unter JSON-Schemas. Eine vollständige Liste der durchsuchbaren Felder finden Sie in der API-Referenz.
Wenn Sie nach Keywords suchen möchten, geben Sie das Flag --search-string an. Dieser Parameter akzeptiert Freitextabfragen und unterstützt die logischen Operatoren AND, OR und NOT.
Suchen Sie beispielsweise nach einem Agenten, der Flugbuchungen vornehmen kann:
gcloud agent-registry agents search \
--project=PROJECT_ID \
--location=REGION \
--search-string="flight OR booking"
Sie können auch anhand der angebotenen Tools oder der Beschreibung nach einem MCP-Server suchen. Suchen Sie beispielsweise nach einem MCP-Server, der Datenbanktools bereitstellt:
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 Agents und Tools dynamisch abrufen können, während ein Nutzer tippt.
Wenn Sie eine Orchestrator-Benutzeroberfläche oder eine Funktion zur automatischen Vervollständigung entwickeln, 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 Suffix-Platzhaltersymbol (*) verwendet, um den Anfang eines Wortes abzugleichen.
Sie können beispielsweise nach Kundenservicemitarbeitern suchen, 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_*"
Sie können auch 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 diesem Feature können Sie wiederverwendbare Funktionen finden, die Sie an Ihre Agents anhängen können.
Wenn Sie nach Skills suchen, suchen Sie nach der Standard-Skill-Revision. Informationen zum Aktualisieren der Standardversion eines Skills finden Sie unter Skill-Metadaten oder Standardversion aktualisieren.
Suchmodi
Je nach Bedarf können Sie zwei Suchmodi für Skills verwenden:
- Schlüsselwortsuche:Es werden nur grundlegende Metadatenattribute wie Anzeigename, Beschreibung, Name (URN) und Skill-ID gescannt. Dieser Modus ist für Suchvorgänge mit geringer Latenz, Abgleich und automatische Vervollständigung von Namen optimiert. Ein Beispiel finden Sie unter Mit Suchbegriffen oder Ausdrücken nach Skills suchen.
- Semantische Suche:Der vollständige Inhalt der
SKILL.md-Nutzlast wird automatisch indexiert, einschließlich Anweisungen in natürlicher Sprache, Codestruktur und Assets. In diesem Modus werden konzeptionelle Themen abgeglichen. Er ist für Orchestrator-Agents optimiert, die basierend auf Ihrer Absicht dynamisch relevante Funktionsbündel ermitteln. Ein Beispiel finden Sie unter Nach Kompetenzen anhand der semantischen Bedeutung suchen.
Suchfelder und ‑syntax
Bei der Suche nach Metadaten oder Keyword-Strings werden die folgenden Felder indexiert:
| Feldname | Fallverhalten | 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. Mit diesem Feld können Sie nach gebräuchlichen Namen suchen. |
description |
Groß- und Kleinschreibung wird nicht berücksichtigt | Nein | Ja | Die detaillierte Beschreibung des Zwecks und der Funktionen des Skills. Mit diesem Feld können Sie Keywords abgleichen. |
name |
Groß- und Kleinschreibung wird nicht berücksichtigt | Ja | Ja | Die programmatische Kennung des Skills. Verwenden Sie dieses Feld für Übereinstimmungen mit Kennzeichnungsstrings. |
skillId |
Groß- und Kleinschreibung wird nicht berücksichtigt | Ja | Ja | Der logische Uniform Resource Name (URN) der Skill.
Mit diesem Feld können Sie nach Assets eines bestimmten Publishers suchen. 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. Mit diesem Feld können Sie nach der veröffentlichenden Organisation filtern. |
frontmatter.name |
Groß- und Kleinschreibung wird nicht berücksichtigt | Nein | Nein | Der Name des Skills, der im Frontmatter der Datei SKILL.md definiert ist. |
frontmatter.description |
Groß- und Kleinschreibung wird nicht berücksichtigt | Nein | Nein | Die Beschreibung des Skills, die im Frontmatter-Abschnitt der Datei SKILL.md definiert ist. |
frontmatter.compatibility |
Groß- und Kleinschreibung wird nicht berücksichtigt | Nein | Nein | Die Kompatibilität des Skills, der im Frontmatter der Datei SKILL.md definiert ist. |
frontmatter.license |
Groß- und Kleinschreibung wird nicht berücksichtigt | Nein | Nein | Die Lizenz des Skills, die im Frontmatter der Datei SKILL.md definiert ist. |
createTime |
Nicht zutreffend | Nein | Nein | Der Zeitstempel für den Zeitpunkt, zu dem der Skill erstellt wurde. Dieses Feld ist nur in Filtern verfügbar. Unterstützt Bereichsoperatoren wie < und > sowie genaue Übereinstimmungen. |
updateTime |
Nicht zutreffend | Nein | Nein | Der Zeitstempel, der angibt, wann der Skill zuletzt aktualisiert wurde. Dieses Feld ist nur in Filtern verfügbar. Unterstützt Bereichsoperatoren wie < und > sowie genaue Übereinstimmungen. |
Um nach Skills zu suchen, geben Sie einen Abfragestring mit dem Flag --query in der gcloud CLI oder dem Parameter searchString in der REST API an.
Sie können die folgenden Syntaxelemente in Ihren Suchanfragen verwenden:
- Boolesche Operatoren:Verwenden Sie die Operatoren
AND,ORoderNOT, um Anforderungen zu verketten. - Feldspezifische Filter:Mit dem Operator
:können Sie ein Feld als Ziel festlegen, z. B.displayName:database. - Präfixabgleich:Verwenden Sie das Suffix-Platzhaltersymbol (
*), um Übereinstimmungen zu finden, die mit einem bestimmten Präfix beginnen, z. B.displayName:cloud-*.
Nach Skills anhand von Begriffen oder Ausdrücken suchen
Suchen Sie beispielsweise nach Skills, die mit einem Anzeigenamen-Präfix und einem Keyword für die Beschreibung übereinstimmen:
gcloud alpha agent-registry skills search \
--project=PROJECT_ID \
--location=REGION \
--query="displayName:cloud-* AND description:database" \
--search-type=keyword
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-IDREGION: die Registry-Region
Nach Kompetenzen anhand der semantischen Bedeutung suchen
So finden Sie beispielsweise Fähigkeiten im Zusammenhang mit der Verwaltung relationaler Datenbanken mithilfe der semantischen Suche:
gcloud alpha agent-registry skills search \
--project=PROJECT_ID \
--location=REGION \
--query="manage and configure relational databases" \
--search-type=semantic
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-IDREGION: die Registry-Region
Öffentliche Skills
Öffentliche Skills von Google sind global und können in jedem Projekt gefunden werden.
Eine Liste der verfügbaren öffentlichen Skills finden Sie im google/skills-Repository auf GitHub.
Wenn Sie suchen, werden die Ressourcennamen öffentlicher Skills in der Agent Registry dynamisch in der Ausgabe umgeschrieben, sodass sie in Ihrem lokalen Projekt gehostet werden. Dieser Prozess vereinfacht die Integration.