Nach Agents und Tools suchen

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- und Präfixsuchen in Ihren Agenten und 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 oder Tools 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 und Tools 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.

Sie können eine Keyword-Suche durchführen, um Ressourcen zu finden, die bestimmten Begriffen in ihren Funktionen entsprechen, z. B. den Fähigkeiten eines Agenten oder den Tools 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.

Verwenden Sie das Flag --search-string, um nach Keywords zu suchen. Dieser Parameter akzeptiert Freitextabfragen und unterstützt logische Operatoren: AND, OR und NOT.

Beispiel: Nach einem Agenten suchen, der Flugbuchungen bearbeiten 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. Beispiel: Nach einem MCP-Server suchen, der Datenbanktools bietet:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die Projekt-ID.
  • REGION: Die Registry-Region.

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 Worts zu finden.

Beispiel: Nach Agenten 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_*"

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-ID.
  • REGION: Die Registry-Region.