L'API Managed Agents sur Agent Platform vous permet de créer des agents autonomes gérés avec un seul appel d'API. Grâce au harnais Antigravity, chaque agent s'exécute dans un environnement de bac à sable où il raisonne, planifie, utilise des compétences d'agent, exécute du code, effectue des recherches sur le Web, et lit et écrit des fichiers.
Architecture du système
L'API Managed Agents sur Agent Platform exploite deux interfaces clés :
| API | Description |
|---|---|
| API Agents | Le plan de contrôle pour la gestion des agents. Utilisez-le pour créer des agents à partir de configurations et configurer leurs environnements d'exécution, y compris l'installation de sources de données externes et la définition de listes d'autorisation réseau. Le système applique ces configurations à l'environnement d'exécution du bac à sable de l'agent. La connexion de sources de données et d'outils externes nécessite une authentification, avec les limites décrites dans Sécurité et bonnes pratiques. |
| API Interactions | Il s'agit du plan de données, qui sert d'interface principale pour communiquer et interagir avec vos agents déployés au moment de l'exécution. Il se connecte à l'agent créé à l'aide de l'API Agents. |
Pour une sécurité renforcée, chaque agent fonctionne dans un environnement de bac à sable isolé. Lorsque vous personnalisez l'environnement avec des sources externes, telles que Cloud Storage, le système charge ces fichiers directement dans le système de fichiers du conteneur à la demande, et l'agent peut réécrire les résultats dans Cloud Storage. Pour en savoir plus, consultez la documentation de référence de l'API Managed Agents sur l'environnement de bac à sable Agent Platform.
Sécurité et bonnes pratiques
Par défaut, chaque agent effectue des actions dans un environnement de bac à sable sans accès aux systèmes, réseaux ou identifiants externes. L'agent ne peut interagir qu'avec les fichiers, les packages et les données de son propre bac à sable.
Cela signifie que l'agent ne peut pas effectuer d'appels réseau, accéder à des bases de données ni atteindre votre infrastructure de production.
Toute connectivité en dehors du bac à sable doit être explicitement configurée par vous, le développeur. Pour en savoir plus, consultez Configurer l'accès au réseau.
Accès au réseau
N'activez cette option que si votre cas d'utilisation l'exige, et limitez l'accès autant que possible.
Lorsque vous activez l'accès réseau pour un environnement, l'agent peut accéder aux API externes, cloner des dépôts publics et télécharger des packages. Avant d'activer l'accès réseau, tenez compte des points suivants :
- Évitez d'exposer des points de terminaison sensibles. Ne dirigez pas l'agent vers des services internes, des panneaux d'administration ou des bases de données, sauf si vous avez examiné les risques et que vous êtes prêt à surveiller l'activité de l'agent.
- Examiner les actions de l'agent Lorsque l'accès au réseau est activé, surveillez les interactions de l'agent, en particulier lors du développement initial, pour vérifier qu'il n'accède qu'aux ressources que vous avez prévues.
Bonnes pratiques concernant les identifiants
Si votre workflow nécessite que l'agent s'authentifie auprès de services externes, tels que des serveurs MCP, vous êtes responsable du provisionnement et de la définition du champ d'application de ces identifiants. Suivez ces consignes pour réduire les risques :
- Utilisez des identifiants selon le principe du moindre privilège. Créez des comptes de service ou des clés API avec uniquement les autorisations dont votre agent a besoin. Évitez de transmettre des identifiants disposant d'un accès étendu ou d'un accès administrateur.
- Privilégiez les jetons de courte durée. Dans la mesure du possible, utilisez des identifiants ou des jetons à durée limitée qui expirent, plutôt que des clés API à longue durée de vie.
- Ne transmettez jamais d'identifiants que vous ne souhaitez pas que l'agent utilise. L'agent peut utiliser tous les identifiants auxquels il a accès pour effectuer la tâche que vous lui avez confiée. Ne fournissez que des identifiants dont vous êtes prêt à accorder l'intégralité du niveau d'accès.
- Effectuez une rotation régulière des identifiants. Traitez les identifiants partagés avec l'agent de la même manière que vous traiteriez n'importe quel identifiant automatisé : effectuez une rotation régulière.
Connecter des outils et des API externes
L'API Agents permet de connecter des outils et des API externes (comme des serveurs MCP) pour étendre les capacités de l'agent. Dans ce cas :
- Évaluez attentivement les sources des outils. Ne connectez que des outils provenant de sources fiables. Un outil malveillant ou mal écrit peut exposer des données ou effectuer des actions involontaires.
- Limiter les autorisations des outils Configurez les outils avec les autorisations minimales requises pour votre cas d'utilisation. Si un outil est compatible avec le mode lecture seule, utilisez-le, sauf si un accès en écriture est nécessaire.
- Effectuez d'abord un test isolé. Avant de connecter un outil à une source de données de production, testez-le avec des exemples de données ou des données synthétiques pour vérifier que l'agent l'utilise comme prévu.
Supervision humaine
Les agents peuvent raisonner, planifier et exécuter des workflows en plusieurs étapes avec un degré élevé d'autonomie. Bien que cette fonctionnalité soit puissante, elle implique également que vous devez appliquer une surveillance appropriée, en particulier pour les tâches qui modifient des données ou interagissent avec des systèmes externes.
Vérifiez toujours les résultats critiques (comme le code généré, les transformations de données ou les modifications de configuration) avant de les déployer.
Assistance et commentaires
Envoyez un e-mail au groupe de discussion public à l'adresse managed-agents-in-agent-platform@google.com pour obtenir de l'aide et envoyer des commentaires sur l'API Managed Agents sur Agent Platform.
Étapes suivantes
Créer et gérer des agents
Découvrez comment créer, modifier, lister, obtenir et supprimer des agents à l'aide de l'API REST.
API Managed Agents sur l'environnement de bac à sable Agent Platform
Découvrez le conteneur de bac à sable isolé, les autorisations et les packages/outils préinstallés.
Évaluer les agents
Découvrez comment évaluer les agents créés avec l'API Managed Agents à l'aide de GenAI Evaluation Service.