Rechercher des agents et des outils

À mesure que votre écosystème agentique se développe, il devient essentiel de trouver l'agent ou l'outil adapté. Agent Registry fournit des fonctionnalités de recherche qui vous permettent d'effectuer des recherches avancées par mot clé et par préfixe dans vos agents et vos serveurs MCP (Model Context Protocol).

Ce document explique comment construire des requêtes de recherche pour découvrir les fonctionnalités de votre environnement.

Avant de commencer

Avant de rechercher des agents ou des outils dans Agent Registry, enregistrez un agent ou un serveur MCP. Vous aurez également besoin de l'ID de votre projet pour effectuer ces tâches.

Pour utiliser les commandes gcloud CLI de ce document, assurez-vous d'avoir configuré votre environnement Google Cloud CLI.

Rôles requis

Pour obtenir les autorisations nécessaires pour rechercher des agents et des outils dans le registre d'agents, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de l'API Agent Registry (roles/agentregistry.viewer) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Vous pouvez effectuer une recherche par mot clé pour trouver des ressources correspondant à des termes spécifiques dans leurs capacités, comme les compétences d'un agent ou les outils d'un serveur MCP. Pour comprendre comment ces capacités sont structurées dans le registre, consultez Schémas JSON. Pour obtenir la liste complète des champs pouvant faire l'objet d'une recherche, consultez la documentation de référence de l'API.

Pour effectuer une recherche par mots clés, indiquez l'indicateur --search-string. Ce paramètre accepte les requêtes en texte libre et est compatible avec les opérateurs logiques : AND, OR et NOT.

Par exemple, recherchez un agent capable de gérer les réservations de vols :

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

Vous pouvez également rechercher un serveur MCP en fonction des outils spécifiques qu'il propose ou de sa description. Par exemple, recherchez un serveur MCP qui fournit des outils de base de données :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • REGION : région du registre.

Les recherches par préfixe sont fortement optimisées pour la latence, ce qui permet à vos applications de récupérer dynamiquement les agents et les outils pertinents au fur et à mesure de la saisie de l'utilisateur.

Si vous créez une interface d'orchestrateur ou une fonctionnalité de saisie semi-automatique, vous pouvez effectuer des recherches par préfixe dans le Registre d'agents pour obtenir des résultats correspondant au début d'une chaîne de requête. Les recherches par préfixe utilisent le symbole générique de suffixe (*) pour faire correspondre le début d'un mot.

Par exemple, recherchez les agents dont le nom à afficher commence par un préfixe spécifique, tel que Best_A2A_* :

gcloud agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Best_A2A_*"

De même, vous pouvez rechercher des serveurs MCP dont le nom à afficher commence par un préfixe spécifique, tel que Prod_Server_* :

gcloud agent-registry mcp-servers search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Prod_Server_*"

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • REGION : région du registre.