Gérer les agents

Pour gérer efficacement votre parc d'agents, vous devez maintenir l'exactitude du registre en affichant et en mettant à jour les détails des agents à mesure que vos charges de travail évoluent, en remplaçant les métadonnées ou en supprimant les agents qui ne sont plus utilisés.

Ce document explique comment afficher et modifier les détails et la configuration de votre agent enregistré.

Avant de commencer

Avant de gérer les agents, assurez-vous que vos agents sont enregistrés dans Agent Registry. Vous avez é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 gérer les agents enregistrés dans Agent Registry, demandez à votre administrateur de vous accorder le rôle IAM Éditeur de l'API Agent Registry (roles/agentregistry.editor) 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.

Découvrir les agents disponibles

Après avoir enregistré des agents, vous pouvez les découvrir dans votre environnement et afficher leurs configurations détaillées, telles que leurs points de terminaison, leurs compétences et les métadonnées associées.

Lister et afficher les agents

Vous pouvez répertorier tous les agents enregistrés dans votre environnement et afficher leurs configurations détaillées, telles que leurs points de terminaison, leurs compétences et les métadonnées associées :

Console

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

    Accéder à Agent Registry

  2. Dans l'outil de sélection 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. La liste inclut le nom, l'identifiant, type, la description, la version, l'environnement d'exécution et l'emplacement de l'agent.

  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.

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 l'outil de sélection 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. La liste inclut le nom, l'identifiant, type, la description, la version, l'environnement d'exécution et l'emplacement de l'agent.

  4. Filtrez la liste par emplacement de l'agent ou par ressource d'environnement 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 métadonnées spécifiques à l'aide de l'option --filter :

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

Remplacez FILTER_EXPRESSION par l'expression de filtre pour les agents que vous souhaitez filtrer. Par exemple, vous pouvez utiliser les filtres suivants :

  • Pour filtrer par nom à afficher, utilisez displayName='DISPLAY_NAME'.
  • Pour effectuer une recherche par identifiant unique global (URN), utilisez agentId='urn:agent:AGENT_URN'.

Afficher les détails d'un agent

Affichez les détails d'un agent spécifique, y compris ses protocoles, ses compétences et son identité :

Console

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

    Accéder à Agent Registry

  2. Dans l'outil de sélection 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. La liste inclut le nom, l'identifiant, type, la description, la version, l'environnement d'exécution et l'emplacement de l'agent.

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

    La page d'informations 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 Évaluation 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 AGENT_NAME par le nom de votre agent, par exemple my-custom-agent.

Mettre à jour les métadonnées et les points de terminaison de l'agent

Si l'URL de l'environnement d'exécution de votre agent change ou si vous souhaitez remplacer son nom à afficher, sa description ou sa spécification, vous pouvez mettre à jour les métadonnées de l'agent.

Pour l'API Agent Registry, les ressources Agent sont utilisées pour la découverte. Par conséquent, vous devez mettre à jour directement la ressource Service enregistrée.

Utilisez la Google Cloud CLI avec des options spécifiques pour modifier les paramètres de l'agent :

  • Mettre à jour le nom à afficher et la description : utilisez les options --display-name et --description, par exemple :

    gcloud alpha agent-registry services update AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="New display name" \
  --description="Updated description of the agent's purpose."

    Remplacez les éléments suivants :

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

  • Mettre à jour l'URL du point de terminaison : utilisez l'option --interfaces pour spécifier le nouveau point de terminaison, par exemple :

    gcloud alpha agent-registry services update AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

    Remplacez les éléments suivants :

    • ENDPOINT_URL: nouvelle URL du point de terminaison de l'agent, par exemple https://new-api.example.com/agent.
    • PROTOCOL: liaison de protocole pour le point de terminaison. Les valeurs valides sont HTTP_JSON, GRPC ou JSONRPC.

  • Mettre à jour la spécification de l'agent : utilisez l'option --agent-spec-content, par exemple si vous disposez d'une nouvelle carte d'agent :

    gcloud alpha agent-registry services update AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --agent-spec-content=AGENT_SPEC

    Remplacez AGENT_SPEC par le nom de la nouvelle spécification de l'agent, par exemple new-agent-card.json.

Supprimer un agent

Pour supprimer les agents qui ont été enregistrés automatiquement dans Agent Registry, vous devez supprimer l'agent sous-jacent dans son environnement d'exécution spécifique Google Cloud . L'agent est ensuite automatiquement supprimé du registre.

Pour supprimer un agent enregistré manuellement du registre, vous devez supprimer la ressource Service sous-jacente. Cette action supprime l'agent des résultats de recherche et le rend indétectable pour les autres outils :

gcloud alpha agent-registry services delete AGENT_NAME \
  --project=PROJECT_ID \
  --location=REGION

Remplacez les éléments suivants :

  • AGENT_NAME: nom de l'agent que vous souhaitez supprimer, par exemple my-support-agent.
  • PROJECT_ID : ID du projet.
  • REGION : région du registre.

Étape suivante