Guide de démarrage rapide : découvrir un agent

La découverte est le mécanisme de base pour accélérer le développement avec des charges de travail agentives. En effectuant une recherche dans Agent Registry, vous pouvez trouver des agents existants possédant les compétences dont vous avez besoin, comme un "agent de politique d'entreprise" ou un "agent de réservation de vols", au lieu de créer des intégrations dupliquées à partir de zéro.

Ce guide de démarrage rapide vous explique comment découvrir des agents enregistrés dans Agent Registry.

Avant de commencer

Avant de commencer ce guide de démarrage rapide, enregistrez un agent dans Agent Registry. 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 découvrir des agents 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.

Répertorier les agents disponibles

Affichez la liste complète de tous les agents enregistrés et indexés dans le registre :

Console

  1. Dans la Google Cloud console, accédez à Agent Registry:

    Accéder à Agent Registry

  2. Dans le sélecteur de projets, sélectionnez le Google Cloud projet dans lequel vous avez configuré Agent Registry.

  3. Sélectionnez l'onglet Agents.

    La page affiche la liste de tous les agents enregistrés et leurs détails, tels que le nom, l'identifiant, la description, l'environnement d'exécution et l'emplacement.

  4. Pour afficher tous les détails d'un agent, cliquez sur son nom.

gcloud

Pour répertorier tous les agents dans un emplacement spécifique, utilisez la commande agents list :

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION

Remplacez les éléments suivants :

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

Le résultat ressemble à l'exemple suivant :

- name: projects/1234567890/locations/us-central1/agents/my-travel-agent
  displayName: Travel Orchestrator Agent
  description: 'Decomposes natural language travel requests into sub-tasks.'
  version: 1.0.0
  protocols:
    - type: A2A_AGENT
      protocolVersion: "0.3"
      interfaces:
        - url: https://api.example.com/.well-known/agent-card.json
          protocolBinding: HTTP_JSON
  attributes:
    agentregistry.googleapis.com/system/Framework:
      framework: "google-adk"
    agentregistry.googleapis.com/system/RuntimeIdentity:
      identity: "principal://..."
  card:
    type: A2A_AGENT_CARD
    content: {...}

Le champ card contient l'intégralité du contenu de la fiche d'agent A2A, le cas échéant.

Filtrer les agents enregistrés

Si vous avez plusieurs agents ou si vous souhaitez confirmer l'enregistrement d'un agent spécifique, vous pouvez filtrer la liste par métadonnées de l'agent :

Console

  1. Dans la Google Cloud console, accédez à Agent Registry:

    Accéder à Agent Registry

  2. Dans le sélecteur de projets, sélectionnez le Google Cloud projet dans lequel vous avez configuré Agent Registry.

  3. Sélectionnez l'onglet Agents.

    La page affiche la liste de tous les agents enregistrés et leurs détails, tels que le nom, l'identifiant, la description, l'environnement d'exécution et l'emplacement.

  4. Filtrez la liste par emplacement de l'agent ou par ressource d'exécution :

    • Pour filtrer par emplacement, cliquez sur le menu Emplacement, sélectionnez les emplacements que vous souhaitez filtrer, puis cliquez sur Appliquer.
    • Pour filtrer par environnement d'exécution, cliquez sur le menu Environnement d'exécution, sélectionnez les environnements d'exécution que vous souhaitez filtrer, puis cliquez sur Appliquer.

    La page affiche une liste filtrée des agents enregistrés pour les conditions que vous avez sélectionnées.

gcloud

Filtrez votre liste d'agents pour ne renvoyer que les ressources correspondant à des paires clé-valeur spécifiques à l'aide de l'option --filter :

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • REGION : région du registre.
  • FILTER_EXPRESSION: expression de filtre pour les agents que vous souhaitez filtrer. Par exemple, pour filtrer par nom à afficher, vous pouvez utiliser displayName='DISPLAY_NAME'. Pour filtrer par l' identifiant unique global (URN), vous pouvez utiliser agentId='urn:agent:AGENT_URN'.

Afficher les détails de l'agent

Si vous avez identifié un agent que vous souhaitez utiliser, vous pouvez récupérer ses métadonnées complètes, y compris son point de terminaison d'exécution et la liste complète de ses compétences :

Console

  1. Dans la Google Cloud console, accédez à Agent Registry:

    Accéder à Agent Registry

  2. Dans le sélecteur de projets, sélectionnez le Google Cloud projet dans lequel vous avez configuré Agent Registry.

  3. Sélectionnez l'onglet Agents.

    La page affiche la liste de tous les agents enregistrés et leurs détails, tels que le nom, l'identifiant, la description, l'environnement d'exécution et l'emplacement.

  4. Cliquez sur le nom de l'agent que vous souhaitez afficher.

    La page de détails comporte des onglets pour les détails de l'agent.

  5. Cliquez sur l'onglet correspondant pour afficher les détails spécifiques de l'agent.

    La disponibilité des fonctionnalités dépend de votre environnement d'exécution. Les onglets tels que Sessions, Playground, Memories et Evaluation sont des fonctionnalités spécifiques qui s'affichent pour les agents créés sur des environnements d'exécution gérés, tels que Vertex AI Agent Engine :

    • Présentation : détails de base de l'agent, y compris son nom, identifiant, emplacement, sa description et son environnement d'exécution. La présentation affiche également les compétences et l' URI de la ressource, dont vous avez besoin pour créer des requêtes dans le graphique de topologie.
    • Observabilité : insights axés sur les applications, tels que la latence, le trafic, les erreurs et les dépenses en jetons. Cet onglet s'intègre aux outils Google Cloud Observability pour afficher les métriques de performances en temps réel et l'utilisation au niveau du système afin de vous aider à gérer les coûts et l'expérience utilisateur. Pour en savoir plus, consultez la présentation d'Observability.
    • Traces : chemin exact d'une étape de conversation, y compris le formatage détaillé des messages d'entrée et d'assistant pour déboguer les boucles de raisonnement multi-agents complexes ou les erreurs d'appel d'outil en temps réel. Pour en savoir plus, consultez Afficher les traces d'agent.
    • Sécurité : résultats de Model Armor et de Security Command Center, y compris les violations du règlement relatif au contenu, les risques de fuite de données et les évaluations de conformité. Pour en savoir plus sur la sécurité, consultez Afficher les résultats de sécurité.
    • Topologie : carte visuelle des relations et des flux de trafic entre un agent, sa passerelle d'agent attribuée et les serveurs MCP avec lesquels il interagit. Pour en savoir plus sur la passerelle d'agent, consultez la présentation de la passerelle d'agent. Pour en savoir plus sur la topologie, consultez Afficher les graphiques d'un agent enregistré.
    • Identité : le principal de l'agent utilisé pour l'application des règles. Vous utilisez cette identité, par exemple, pour configurer les liaisons de fournisseur d'authentification pour l'authentification auprès des outils et des ressources.
    • Sessions : historique des conversations persistantes et suivi des interactions actives avec l'agent.
    • Playground : interface de chat directe pour tester le comportement de l'agent.
    • Memories : fonctionnalités de personnalisation à long terme qui génèrent ou rappellent des détails de conversations passées avec l'agent pour préserver le contexte entre les interactions.
    • Évaluation : détails de toutes les tâches d'évaluation de l'agent. Cet onglet vous permet de créer des tâches d'évaluation, d'importer des métriques et d'évaluer les performances cognitives de l'agent et la fiabilité du modèle par rapport au trafic en direct ou à des simulations synthétiques.

gcloud

Pour afficher les métadonnées détaillées d'un agent spécifique, utilisez la commande agents describe :

gcloud alpha agent-registry agents describe AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION

Remplacez les éléments suivants :

  • AGENT_NAME: nom de votre agent, par exemple my-travel-agent.
  • PROJECT_ID : ID du projet.
  • REGION : région du registre.

Avec le point de terminaison de l'agent, les définitions de compétences et les métadonnées en sortie seule, telles que le framework sous-jacent, l'identité d'exécution et la charge utile complète de la fiche d'agent A2A, vous pouvez lier votre agent en toute sécurité à vos workflows d'orchestration à l'aide d' Agent Development Kit (ADK) ou de requêtes API standards.

Étape suivante