Guide de démarrage rapide : enregistrer un agent

L'enregistrement d'un agent le transforme d'un composant isolé en une partie intégrée et détectable de votre écosystème d'IA dans Agent Registry. En publiant les compétences de votre agent, vous permettez à d'autres développeurs et agents orchestrateurs de votre organisation de trouver et de réutiliser votre travail, ce qui accélère le développement global de l'IA.

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

Avant de commencer

Avant de commencer, configurez Agent Registry. Vous avez besoin de l'ID du projet pour effectuer ces tâches.

Rôles requis

Pour obtenir les autorisations nécessaires pour enregistrer des agents 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.

Enregistrer un agent factice

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

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

  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.

  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 du code JSON.

  7. Copiez et collez l'exemple de contenu de carte d'agent suivant :

    {
  "schemaVersion": "0.3",
  "agent": {
    "name": "mock-travel-agent",
    "description": "A mock agent that plans travel itineraries.",
    "skills": [
      {
        "name": "BookFlight",
        "description": "Books a flight to a destination."
      },
      {
        "name": "SearchHotels",
        "description": "Searches for hotels in a destination city."
      }
    ]
  }
}

  8. Cliquez sur Enregistrer.

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

Vérifier l'enregistrement

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

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

Libérer de l'espace

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

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

Étape suivante