À mesure que votre écosystème agentique se développe, il devient essentiel de trouver l'agent ou l'outil approprié. 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 serveurs MCP (Model Context Protocol).
Ce document explique comment créer 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 votre ID de 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 Agent Registry, 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.
Rechercher par mots clés
Vous pouvez effectuer une recherche par mots clés pour trouver des ressources qui correspondent à des termes spécifiques dans leurs fonctionnalités, comme les compétences d'un agent ou les outils d'un serveur MCP. Pour comprendre comment ces fonctionnalités sont structurées dans le registre, consultez Schémas JSON. Pour obtenir la liste complète des champs dans lesquels vous pouvez effectuer des recherches, consultez la documentation de référence de l'API.
Pour effectuer une recherche par mots clés, fournissez 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 alpha 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 alpha 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.
Rechercher par préfixe
Les recherches par préfixe sont hautement optimisées pour la latence, ce qui permet à vos applications de récupérer des agents et des outils pertinents de manière dynamique à mesure que l'utilisateur saisit du texte.
Si vous créez une interface d'orchestrateur ou une fonctionnalité de saisie semi-automatique, vous pouvez effectuer des recherches par préfixe dans Agent Registry pour obtenir des résultats correspondant au début d'une chaîne de requête. Les recherches par préfixe utilisent le symbole de caractère générique de suffixe (*) pour correspondre au 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 alpha 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 alpha 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.