Gérer les agents

Pour gérer efficacement votre parc d'agents, vous devez veiller à ce que le registre soit précis en consultant et en mettant à jour les informations sur les agents à mesure que votre écosystème d'IA évolue, 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 informations 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 le registre des agents. Vous aurez également besoin de l'ID de votre projet pour effectuer ces tâches.

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

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les agents enregistrés dans le registre d'agents, 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 lister 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 console Google Cloud , accédez à Agent Registry :

    Accéder au registre d'agents

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

  3. Sélectionnez l'onglet Agents.

    La page affiche la liste de tous les agents enregistrés. La liste inclut le nom, l'identifiant, le type, la description, la version, le runtime et l'emplacement de l'agent.

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

gcloud

Pour lister tous les agents d'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 console Google Cloud , accédez à Agent Registry :

    Accéder au registre d'agents

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

  3. Sélectionnez l'onglet Agents.

    La page affiche la liste de tous les agents enregistrés. La liste inclut le nom, l'identifiant, le type, la description, la version, le runtime et l'emplacement de l'agent.

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

    • Pour filtrer par zone géographique, cliquez sur le menu Zone géographique, sélectionnez les zones géographiques à filtrer, puis cliquez sur Appliquer.
    • Pour filtrer par durée, cliquez sur le menu Durée, sélectionnez les durées 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 la liste de vos agents pour n'afficher que les ressources correspondant à des métadonnées spécifiques, à l'aide de l'indicateur --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 console Google Cloud , accédez à Agent Registry :

    Accéder au registre d'agents

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

  3. Sélectionnez l'onglet Agents.

    La page affiche la liste de tous les agents enregistrés. La liste inclut le nom, l'identifiant, le type, la description, la version, le runtime et l'emplacement de l'agent.

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

    La page d'informations inclut des onglets pour les informations sur l'agent.

  5. Cliquez sur l'onglet correspondant pour afficher les informations spécifiques à l'agent.

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

    • Présentation : informations de base sur l'agent, y compris son nom, son identifiant, son emplacement, sa description et son environnement d'exécution. La vue d'ensemble affiche également les compétences et l'URI de ressource dont vous avez besoin pour créer des requêtes dans le graphique de topologie.
    • Observabilité : insights axés sur les applications, comme 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. Il vous aide ainsi à gérer les coûts et l'expérience utilisateur. Pour en savoir plus, consultez la présentation de l'observabilité.
    • Traces : chemin exact d'une conversation, étape par étape, y compris la mise en forme détaillée des messages d'entrée et de l'assistant pour déboguer en temps réel les boucles de raisonnement multi-agents complexes ou les erreurs d'appel d'outil. Pour en savoir plus, consultez Afficher les traces de l'agent.
    • Sécurité : résultats de Model Armor et Security Command Center, y compris les cas de non-respect des règles relatives 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 Agent Gateway, consultez la présentation d'Agent Gateway. Pour en savoir plus sur la topologie, consultez Afficher les graphiques d'un agent enregistré.
    • Identité : principal de l'agent utilisé pour l'application des règles. Vous utilisez cette identité, par exemple, pour configurer des liaisons de fournisseur d'authentification pour l'authentification aux outils et ressources.
    • Sessions : historique des conversations persistant et suivi des interactions actives avec l'agent.
    • Bac à sable : interface de chat direct pour tester le comportement de l'agent.
    • Souvenirs : fonctionnalités de personnalisation à long terme qui génèrent ou rappellent des détails des conversations passées avec l'agent pour préserver le contexte des interactions.
    • Évaluation : détails de toutes les tâches d'évaluation des agents. Cet onglet vous permet de créer des tâches d'évaluation, d'importer des métriques et d'évaluer les performances cognitives et la fiabilité du modèle de l'agent par rapport au trafic réel 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 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. Vous devez donc mettre à jour directement la ressource Service enregistrée.

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

  • Mettre à jour le nom à afficher et la description : utilisez les indicateurs --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.

  • Mettez à jour l'URL du point de terminaison : utilisez le flag --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 : URL du nouveau 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.

  • Mettez à jour la spécification de l'agent : utilisez l'indicateur --agent-spec-content, par exemple si vous avez 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 des agents qui ont été enregistrés automatiquement dans le registre d'agents, vous devez supprimer l'agent sous-jacent dans son environnement d'exécution Google Cloud spécifique. 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 par d'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.

Étapes suivantes