Guide de démarrage rapide : enregistrer un agent

Enregistrer un agent dans Agent Registry vous permet de transformer un composant isolé en une partie détectable de votre écosystème d'IA. En publiant les compétences A2A de votre agent, vous aidez les autres développeurs et agents d'orchestration de votre organisation à trouver et à réutiliser votre travail.

Dans ce guide de démarrage rapide, vous allez enregistrer manuellement un agent fictif dans Agent Registry à l'aide de la console Google Cloud . Pour en savoir plus sur les mécanismes d'enregistrement des agents dans Agent Registry, consultez Enregistrer des agents.

Avant de commencer

  1. Configurer le registre d'agents.
  2. Obtenez l'ID du projet pour le projet de gouvernance dans lequel Agent Registry est activé.

Rôles requis

Pour obtenir les autorisations nécessaires pour enregistrer des agents 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 de gouvernance où Agent Registry est activé. 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.

Enregistrer un agent fictif

Pour tester Agent Registry, vous pouvez enregistrer manuellement un agent fictif en collant un exemple de carte d'agent Agent2Agent (A2A).

Pour enregistrer l'agent, procédez comme suit :

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

    Accéder au registre d'agents

    Si vous y êtes invité, cliquez sur Activer pour activer l'API Agent Registry.

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

  3. Sélectionnez l'onglet Agents.

  4. Cliquez sur Ajouter un agent.

  5. Dans le panneau Détails de l'agent, saisissez les informations suivantes :

    • Type : sélectionnez A2A.
    • Région : sélectionnez global (Global).

  6. Sélectionnez l'onglet Coller le code JSON.

  7. Collez l'exemple de contenu de fiche d'agent suivant :

    {
  "supportedInterfaces": [
    {
      "url": "https://example.com/mock-travel-agent",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0.0"
    }
  ],
  "name": "mock-travel-agent",
  "description": "A mock agent that plans travel itineraries.",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"],
  "skills": [
    {
      "id": "BookFlight",
      "name": "BookFlight",
      "description": "Books a flight to a destination.",
      "tags": ["travel", "booking"]
    },
    {
      "id": "SearchHotels",
      "name": "SearchHotels",
      "description": "Searches for hotels in a destination city.",
      "tags": ["travel", "accommodation"]
    }
  ]
}

  8. Cliquez sur Enregistrer.

Agent Registry traite la fiche d'agent et enregistre l'agent.

Vérifier l'enregistrement

Pour vérifier que votre agent fictif a bien été enregistré, procédez comme suit :

  1. Dans l'onglet Agents, recherchez l'agent fictif dans la liste.
  2. Cliquez sur le nom de l'agent pour afficher ses détails.
  3. Vérifiez que les compétences A2A BookFlight et SearchHotels s'affichent dans l'onglet Présentation.

Effectuer un nettoyage

Pour éviter de laisser des ressources fictives dans votre projet, supprimez l'agent enregistré :

  1. Dans l'onglet Agents, recherchez l'agent fictif dans la liste.
  2. Cliquez sur le menu Plus d'options dans la colonne Actions de l'agent fictif, puis sélectionnez Supprimer.
  3. Dans la boîte de dialogue de confirmation, saisissez DELETE pour confirmer l'action.
  4. Cliquez sur Supprimer.

Étapes suivantes