Guide de démarrage rapide : enregistrer un agent

Enregistrer un agent le transforme d'une charge de travail isolée en un composant détectable dans Agent Registry. En publiant les compétences de votre agent, vous permettez aux 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 de l'IA.

Ce guide de démarrage rapide vous explique comment enregistrer manuellement un agent fictif dans le registre d'agents à 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

Avant de commencer, configurez le registre d'agents. 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 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.

Enregistrer un agent fictif

Pour tester le registre d'agents, 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

  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.

  4. Cliquez sur Ajouter un agent.

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

    • Display name (Nom à afficher) : Mock Travel Agent
    • Description : A mock agent that plans travel itineraries.
    • Emplacement : sélectionnez global.
    • Type d'agent : sélectionnez A2A.

  6. Dans la section Spécification de l'agent, sélectionnez l'onglet Coller le JSON.

  7. Copiez et collez l'exemple de contenu de fiche 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.

Valider l'enregistrement

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

  1. Dans l'onglet Agents, recherchez Mock Travel Agent dans la liste.
  2. Cliquez sur Mock Travel Agent (Agent de voyage fictif) pour afficher ses détails.
  3. Vérifiez que les skills BookFlight et SearchHotels s'affichent dans l'onglet Aperçu.

Effectuer un nettoyage

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

  1. Dans l'onglet Agents, recherchez Mock Travel Agent dans la liste.
  2. Cliquez sur le menu Plus d'options à côté de Agent de voyage fictif, puis sélectionnez Supprimer.
  3. Dans la boîte de dialogue de confirmation, cliquez sur Supprimer.

Étapes suivantes