Utiliser l'enregistrement automatique

Agent Registry peut détecter et enregistrer des agents hébergés sur des environnements d'exécution compatibles Google Cloud sans que vous ayez à appeler manuellement l'API Agent Registry. Selon l'environnement d'exécution, ce processus d'enregistrement est automatique ou nécessite une étape de configuration d'activation lors du déploiement.

Ce document explique comment activer la détection des agents sur les environnements d'exécution compatibles. Si vous hébergez un agent en externe ou sur un environnement d'exécution non compatible, consultez Utiliser l'enregistrement manuel.

Les métadonnées et les compétences extraites d'un agent lors de son enregistrement dépendent du protocole de l'agent. Pour en savoir plus, consultez Enregistrer des agents.

Enregistrer des agents à partir de Vertex AI Agent Engine

Si vous développez des agents avec Vertex AI Agent Engine et que vous les déployez à l'aide du SDK Vertex AI, l'enregistrement dans Agent Registry est automatique.

Le protocole Agent2Agent (A2A) est une norme ouverte qui permet aux agents de déclarer leurs capacités et leur identité. L'exemple suivant montre comment déployer un agent implémentant le protocole A2A dans Vertex AI Agent Engine. Pour en savoir plus, consultez Déployer un agent.

# Create and deploy the agent
# This action automatically registers the agent in Agent Registry
remote_agent = client.agent_engines.create(
    agent=my_a2a_agent, # Your defined A2A object
    config={
        "display_name": "my-support-agent",
        "description": "An agent that handles support tickets.",
        "requirements": ["google-cloud-aiplatform[agent_engines,langchain]"],
    },
)

Lorsque vous mettez à jour ou supprimez votre agent dans Vertex AI Agent Engine, Agent Registry synchronise automatiquement ces modifications.

Enregistrer des agents Google intégrés

Les agents Google intégrés, tels que Google Workspace et Gemini Enterprise agents, sont automatiquement intégrés à Agent Registry. Vous n'avez pas besoin d'effectuer d'étapes de configuration ni de déploiement. Ces agents sont ingérés et disponibles pour la détection dans votre registre.

Enregistrer des agents à partir de GKE

Vous pouvez enregistrer des agents déployés sur Google Kubernetes Engine en ajoutant l'apphub.cloud.google.com/functional-type: "AGENT" annotation à vos déploiements. Cette annotation identifie le déploiement comme un agent d'IA, ce qui permet à Agent Registry d'effectuer une analyse d'introspection.

L'exemple suivant montre un manifeste de déploiement d'agent GKE. Pour en savoir plus, consultez Déployer et orchestrer des agents d'IA.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-agent
  annotations:
    # Identifies the workload as an AI agent
    apphub.cloud.google.com/functional-type: "AGENT"
spec:
  selector:
    matchLabels:
      app: my-agent
  template:
    metadata:
      labels:
        app: my-agent
    spec:
      containers:
      - name: server
        image: gcr.io/my-project/my-agent:1.0.0

Lorsque le déploiement est appliqué, le cluster GKE tente automatiquement d'extraire les métadonnées de l'agent et les synchronise directement dans le modèle de données Agent Registry.

Vérifier l'enregistrement

Vous pouvez vérifier qu'Agent Registry a bien enregistré vos agents en les listant :

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'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

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

Pour ce faire, assurez-vous d'avoir configuré votre environnement Google Cloud CLI pour Agent Registry, puis exécutez la commande suivante :

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'.

Les services Google intégrés utilisent un format URN qui dépend de l'endroit où l'agent est déployé. Par exemple, vous pouvez découvrir les agents Google Workspace intégrés en filtrant votre liste pour l'éditeur googleapis.com à l'aide de --filter="agentId:'urn:agent:googleapis.com:*'"