Utiliser l'enregistrement automatique

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

Ce document explique comment activer la découverte pour les agents sur les runtimes 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 depuis 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 le registre d'agents 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 sur 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 les agents Google intégrés

Les agents Google intégrés, tels que les agents Google Workspace et Gemini Enterprise, sont automatiquement intégrés au registre d'agents. 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écouverte dans votre registre.

Enregistrer des agents depuis GKE

Vous pouvez enregistrer les agents déployés sur Google Kubernetes Engine en ajoutant l'annotation apphub.cloud.google.com/functional-type: "AGENT" à 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 fichier manifeste de déploiement de l'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 de les synchroniser directement dans le modèle de données du registre d'agents.

Valider l'enregistrement

Vous pouvez vérifier que le registre d'agents a bien enregistré vos agents en les listant :

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 et leurs détails, tels que le nom, l'identifiant, la description, le temps d'exécution et l'emplacement.

  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

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 identifiant (URN) unique au niveau mondial, vous pouvez utiliser agentId='urn:agent:AGENT_URN'.

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