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 Agents und MCP-Servern (Model Context Protocol) durchführen können.

In diesem Dokument wird beschrieben, wie Sie Suchanfragen erstellen, um Funktionen in Ihrer Umgebung zu ermitteln.

Hinweis

Bevor Sie in der Agent Registry nach Agents oder Tools suchen, müssen Sie einen 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 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 KI-Agenten oder den Tools 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 alpha agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="flight OR booking"

Sie können auch nach einem MCP-Server anhand der angebotenen Tools oder seiner Beschreibung suchen. Suchen Sie beispielsweise nach einem MCP-Server, der Datenbanktools bereitstellt:

gcloud alpha 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 Agents und Tools dynamisch abrufen können, während ein Nutzer tippt.

Wenn Sie eine Orchestrator-Schnittstelle 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 Beginn eines Abfragestrings übereinstimmen. Bei Präfixsuchen wird das Suffix-Platzhaltersymbol (*) verwendet, um den Anfang eines Wortes zu finden.

Sie können beispielsweise nach Agents suchen, deren Anzeigename mit einem bestimmten Präfix beginnt, z. B. Best_A2A_*:

gcloud alpha 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 alpha 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.