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'agent, 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'agent (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 à Agents

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

  3. Concevez et enregistrez 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 Détails de cet agent. Vous pouvez également cliquer sur Ajouter un sous-agent (+) pour ajouter des sous-agents.

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

        1. 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. Modèle : sélectionnez le modèle pour alimenter votre agent.

        5. Outils : cliquez sur 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.

      3. Pour enregistrer votre agent, cliquez sur Enregistrer dans l'en-tête du canevas et suivez les instructions. Pour en savoir plus, consultez Enregistrer un agent.

    • Onglet "Aperçu" : discutez avec votre agent dans le volet d'aperçu pour tester ses capacités et ses réponses.

  4. Cliquez sur 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.

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.

Enregistrer un agent

Vous devez enregistrer un agent avant de pouvoir le prévisualiser ou le déployer, car un agent non enregistré n'a pas encore d'identité. Pour enregistrer un agent pour la première fois :

  1. Dans le canevas Agent Studio, cliquez sur Enregistrer.

  2. Dans la boîte de dialogue Enregistrer l'agent, saisissez un Nom de l'agent.

  3. Cliquez sur Enregistrer.

Après le premier enregistrement, Agent Studio enregistre automatiquement toutes les modifications que vous apportez. Si vous essayez de quitter le canevas avant d'enregistrer un nouvel agent, Agent Studio vous invite à l'enregistrer d'abord.

Configurer et ajouter des outils dans Agent Studio

Vous pouvez configurer les outils suivants pour votre agent :

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

  • 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 : cliquez sur 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. Ensuite, accordez l'accès au compte de service à la recherche de la plate-forme d'agent :

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

      Accéder à Identity and Access Management (IAM)

    2. Cliquez sur Accorder l'accès.

    3. Dans le champ 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 + Ajouter des rôles. Recherchez et sélectionnez Utilisateur de Discovery Engine. Cliquez sur Appliquer , puis sur Enregistrer.

  • Serveur MCP : connectez directement un serveur MCP (Model Context Protocol).

    1. Pour ajouter des outils MCP en vous connectant à un serveur MCP, cliquez sur Ajouter (+) à côté de Serveur MCP.
    2. Nom à afficher MCP : saisissez un nom pour votre serveur MCP.
    3. URL du point de terminaison : saisissez une URL de point de terminaison pour le serveur MCP.
    4. Authentification : rempli automatiquement avec la valeur 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

Après avoir 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 Déployer pour ouvrir la boîte de dialogue Déployer dans une instance Agent Runtime.

  3. (Facultatif) Modifiez le 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 OK.

  5. Cliquez sur 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 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 Plate-forme d'agent.

    Accéder à la plate-forme d'agent

  2. Utilisez la liste 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 Métriques de l'agent s'ouvre.

  5. Sélectionnez l'onglet Bac à sable pour tester votre agent.

  6. Saisissez une requête de test dans le volet de chat pour vérifier que l'agent s'exécute correctement.

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