Concevoir des agents dans Agent Studio

Cette page explique comment utiliser Agent Studio dans la Google Cloud console.

Agent Studio est un outil de conception visuelle low-code dans la Google Cloud console qui simplifie le développement d'agents. Vous pouvez mapper visuellement les workflows d'agents, tester les réponses en temps réel et tester différentes configurations avant de déployer ou de passer au code.

Ce document présente Agent Studio et explique comment configurer votre environnement, créer et tester des agents, puis les déployer directement dans un environnement d'exécution de production.

Configurer votre environnement

Avant d'utiliser Agent Studio, configurez Google Cloud.

Obtenir les rôles requis

Pour obtenir les autorisations nécessaires pour utiliser Agent Studio, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur de la plate-forme d'agents (roles/aiplatform.user) sur votre 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.

Créer un agent

Procédez comme suit pour concevoir et tester un agent dans Agent Studio :

  1. Dans la Google Cloud console, accédez à la page Agents.

    Accéder aux agents

  2. Cliquez sur Create agent (Créer un agent) pour ouvrir le canevas Agent Studio pour un nouvel agent.

  3. Concevez votre agent dans le canevas Agent Studio. Vous pouvez basculer entre les onglets suivants :

    • Flux : créez l'agent principal et les sous-agents à l'aide d'une représentation visuelle du workflow et de la logique de contrôle de votre agent.

      1. Cliquez sur un agent pour ouvrir le panneau Details (Détails) de cet agent. Vous pouvez également cliquer sur Add a subagent (Ajouter un sous-agent) (+) pour ajouter des sous-agents.

      2. Configurez votre agent principal et vos sous-agents dans le panneau Details (Détails) :

        1. Name (Nom) : ajoutez un nom pour identifier l'agent.

        2. Description : résumé de l'objectif de votre agent.

        3. Instructions : ajoutez des instructions pour guider votre agent.

        4. Model (Modèle) : sélectionnez le modèle pour alimenter votre agent.

        5. Tools (Outils) : cliquez sur Add tools (Ajouter des outils) (+) pour ajouter des outils permettant à l'agent d'effectuer des tâches. Pour en savoir plus, consultez Configurer et ajouter des outils.

    • Preview (Aperçu) : testez les fonctionnalités et la réponse de l'agent à mesure que vous le créez. Discutez avec votre agent pour tester ses fonctionnalités.

  4. Cliquez sur Get code (Obtenir le code) pour afficher le code de votre agent. Si vous souhaitez continuer à développer votre agent ailleurs, vous pouvez copier le code et le coller dans l'éditeur de code de votre choix. Consultez les tutoriels ADK pour découvrir d'autres options permettant de continuer à développer votre agent.

Une fois votre agent terminé, vous pouvez le déployer directement depuis Agent Studio. Pour en savoir plus, consultez Déployer un agent depuis Agent Studio.

Configurer et ajouter des outils dans Agent Studio

Vous pouvez configurer les outils suivants pour votre agent :

  • Google Search (Recherche Google) : permet à l'agent d'effectuer des recherches sur le Web à l'aide de la recherche Google. Activé par défaut.

  • URL context (Contexte de l'URL) : permet au modèle d'analyser les URL des prompts envoyés à l'agent. Activé par défaut.

  • Agent Platform Search Data Store (Datastore de recherche de la plate-forme d'agents) : cliquez sur Add (Ajouter) (+) pour permettre à votre agent d'accéder aux informations indexées dans votre datastore Agent Search.

    Si vous ne disposez pas d'un data store existant, consultez Premiers pas avec la recherche personnalisée pour en créer un. Accordez ensuite l'accès au compte de service à la recherche de la plate-forme d'agents :

    1. Dans la Google Cloud console, accédez à la page IAM.

      Accéder à Identity and Access Management (IAM)

    2. Cliquez sur Grant access (Accorder l'accès).

    3. Dans le champ New principals (Nouveaux comptes principaux), saisissez les informations suivantes sur le compte de service : service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com.

    4. Sélectionnez + Add roles (+ Ajouter des rôles). Recherchez et sélectionnez Discovery Engine User (Utilisateur de Discovery Engine). Cliquez sur Apply (Appliquer), puis sur Save (Enregistrer).

  • MCP Server (Serveur MCP) : cliquez sur Add (Ajouter) (+) pour ajouter des outils MCP en vous connectant à un serveur MCP.

    1. MCP display name (Nom à afficher MCP) : saisissez un nom pour votre serveur MCP.

    2. Endpoint URL (URL du point de terminaison) : saisissez une URL de point de terminaison pour le serveur MCP.

    3. Authentication (Authentification) : rempli automatiquement avec la valeur None (Aucune). Agent Studio n'est compatible qu'avec les serveurs MCP qui ne nécessitent pas d'authentification.

    Votre agent peut utiliser tous les outils de votre serveur MCP connecté.

Déployer un agent depuis Agent Studio

Une fois que vous avez créé et prévisualisé un agent, vous pouvez le déployer en production. Procédez comme suit pour déployer un agent depuis Agent Studio :

  1. Dans la page de liste Agents, cliquez sur l'agent que vous souhaitez déployer. La page de détails de l'agent s'affiche pour l'agent sélectionné.

  2. Cliquez sur Deploy (Déployer) pour ouvrir la boîte de dialogue Deploy to an Agent Runtime instance (Déployer dans une instance Agent Runtime).

  3. (Facultatif) Modifiez le Display name (Nom à afficher) ou la Description de votre agent.

  4. Sélectionnez une région de déploiement dans la liste des régions disponibles, puis cliquez sur OK.

  5. Cliquez sur Deploy (Déployer).

Le déploiement crée une instance d'exécution et peut prendre jusqu'à cinq minutes. En cas de réussite, un message s'affiche dans l'onglet Flow (Flux) du canevas Agent Studio. Votre agent est désormais disponible en production et peut s'intégrer de manière sécurisée à vos applications externes.

Afficher un agent déployé

Pour afficher votre agent déployé :

  1. Dans la Google Cloud console, accédez à la page Agent Platform.

    Accéder à la plate-forme d'agents

  2. Utilisez la liste Region (Région) pour filtrer par région de déploiement.

  3. Les agents déployés qui font partie du projet sélectionné s'affichent dans la liste.

  4. Cliquez sur le nom de l'agent spécifié. La page Metrics (Métriques) de l'agent s'ouvre.

Pour en savoir plus sur les métriques disponibles pour votre agent, consultez Afficher les métriques de votre agent déployé.