Développer et déployer des agents sur Agent Runtime avec Agent Development Kit

Développer et déployer des agents sur Agent Runtime avec Agent Development Kit

Agent Runtime vous permet d'héberger des agents développés avec l'Agent Development Kit (ADK). Ce document explique comment créer, déployer et tester un agent à l'aide de l'ADK.

Ce guide de démarrage rapide vous guide tout au long des étapes suivantes :

• configurer votre projet Google Cloud  ;
• Installez le SDK Agent Platform pour Python et l'ADK.
• Développez un agent de change.
• Déployez l'agent sur Agent Runtime.
• Testez l'agent déployé.

Vous pouvez également utiliser les guides de démarrage rapide alternatifs suivants pour ADK :

• Guide de démarrage rapide de l'ADK : le guide de démarrage rapide de l'ADK s'exécute entièrement sur votre machine et suppose que vous utilisez un IDE local et un accès au terminal.
• Agent Starter Pack : collection de modèles d'agents d'IA générative prêts pour la production et conçus pour Agent Platform.

Pour obtenir un guide de démarrage rapide utilisant des frameworks compatibles autres qu'Agent Development Kit, consultez Développer et déployer des agents sur Agent Runtime.

Avant de commencer

Remarque : Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous ne disposez pas de cette autorisation, demandez à votre administrateur de vous attribuer le rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin).

Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Platform and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Platform and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Pour obtenir les autorisations nécessaires à l'utilisation d'Agent Runtime, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

• Utilisateur de la plate-forme d'agents (roles/aiplatform.user)
• Administrateur de l'espace de stockage (roles/storage.admin)

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.

Installer et initialiser le SDK Agent Platform pour Python

1. Exécutez la commande suivante pour installer le SDK Agent Platform pour Python et d'autres packages requis :

   pip install --upgrade --quiet google-cloud-aiplatform[agent_engines,adk]>=1.112

2. S'authentifier en tant qu'utilisateur

   Interface système locale

   Exécutez la commande suivante :

   gcloud auth application-default login

   Colab

   Exécutez le code suivant :

   from google.colab import auth
   
   auth.authenticate_user(project_id="PROJECT_ID")
   

   Cloud Shell

   Aucune action n'est requise.

3. Exécutez le code suivant pour importer Agent Platform et initialiser le SDK :

   Projet Google Cloud

   import vertexai
   
   client = vertexai.Client(
       project="PROJECT_ID",               # Your project ID.
       location="LOCATION",                # Your cloud region.
   )
   

   Où :

   • PROJECT_ID correspond à l'ID de projet Google Cloud sous lequel vous développerez et déploierez des agents.

   • LOCATION désigne l'une des régions compatibles.

Développer un agent

1. Développez un outil de change pour votre agent :

   def get_exchange_rate(
       currency_from: str = "USD",
       currency_to: str = "EUR",
       currency_date: str = "latest",
   ):
       """Retrieves the exchange rate between two currencies on a specified date."""
       import requests
   
       response = requests.get(
           f"https://api.frankfurter.app/{currency_date}",
           params={"from": currency_from, "to": currency_to},
       )
       return response.json()
   

2. Instanciez un agent :

   from google.adk.agents import Agent
   from vertexai import agent_engines
   
   agent = Agent(
       model="gemini-2.0-flash",
       name='currency_exchange_agent',
       tools=[get_exchange_rate],
   )
   
   app = agent_engines.AdkApp(agent=agent)
   

3. Testez l'agent localement :

   Remarque : Les tests locaux d'un agent ADK utilisent des sessions en mémoire.

   async for event in app.async_stream_query(
       user_id="USER_ID",
       message="What is the exchange rate from US dollars to SEK today?",
   ):
       print(event)
   

   où USER_ID est un ID défini par l'utilisateur, dont la limite de caractères est de 128.

Déployer un agent

Déployez l'agent en créant une ressource reasoningEngine dans Agent Platform :

Remarque : Le déploiement d'un agent ADK sur la plate-forme Agent génère automatiquement une ressource de session gérée. Vous pouvez supprimer la ressource de session gérée en même temps que l'agent dans la section "Nettoyage".

remote_agent = client.agent_engines.create(
    agent=app,
    config={
        "requirements": ["google-cloud-aiplatform[agent_engines,adk]"],
        "staging_bucket": "STAGING_BUCKET",
        "identity_type": types.IdentityType.AGENT_IDENTITY,
    }
)

où STAGING_BUCKET est un bucket Cloud Storage préfixé par gs://.

Utiliser un agent

Testez l'agent déployé en envoyant une requête :

async for event in remote_agent.async_stream_query(
    user_id="USER_ID",
    message="What is the exchange rate from US dollars to SEK today?",
):
    print(event)

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , procédez comme suit :

remote_agent.delete(force=True)

Étapes suivantes

Guide

Configurer Agent Platform Runtime

Configurez votre environnement pour utiliser Agent Platform Runtime.

Guide

Déployer des agents

Découvrez les cinq façons de déployer un agent sur Agent Platform Runtime en fonction de vos besoins de développement.

Guide

Gérer les agents déployés

Découvrez comment gérer les agents déployés sur le runtime géré Agent Platform.

Guide

Utiliser un agent

Utilisez un agent avec Agent Platform Runtime.

Ressource

Obtenir de l'aide

Trouvez des ressources et de l'aide pour Google Agent Platform.