Le déploiement d'un agent sur Agent Runtime le rend disponible à distance pour traiter les requêtes. Ce document explique comment déployer un agent en fonction de votre workflow de développement : à partir d'un objet d'exécution, de fichiers sources locaux, d'un fichier Dockerfile, d'une image de conteneur hébergée dans Artifact Registry ou directement via un dépôt Git connecté.
Pour déployer un agent sur Agent Runtime, vous avez le choix entre les méthodes suivantes :
Developer Connect
Recommandé pour les projets gérés dans un dépôt Git et associés via Developer Connect. Cette méthode simplifie le déploiement des agents directement à partir de votre code source et prend en charge de manière native le contrôle des versions, la collaboration en équipe et les pipelines CI/CD. Avant d'utiliser cette méthode, configurez le lien vers votre dépôt Git en suivant les instructions de la section Configurer le lien vers le dépôt Git Developer Connect.
Vous ne pouvez utiliser cette méthode de déploiement qu'avec Python.
Fichiers sources
Convient parfaitement aux workflows automatisés tels que les pipelines CI/CD et les outils Infrastructure as Code comme Terraform, ce qui permet des déploiements entièrement déclaratifs et automatisés. Il déploie votre agent directement à partir du code source local et ne nécessite pas de bucket Cloud Storage.
Vous ne pouvez utiliser cette méthode de déploiement qu'avec Python.
Dockerfile
Semblable au déploiement à partir de fichiers sources. Vous déployez votre agent directement à partir du code source local, sans avoir besoin d'un bucket Cloud Storage. Cette méthode est appropriée si vous devez définir et contrôler le serveur d'API déployé. Le conteneur déployé doit respecter le contrat d'exécution.
Vous pouvez utiliser cette méthode de déploiement avec n'importe quel langage. Les exemples de cette page utilisent Python.
Image de conteneur
Semblable au déploiement à partir de Dockerfile. Vous déployez une image de conteneur hébergée dans Artifact Registry. Utilisez cette méthode si vous avez besoin de contrôler le processus de compilation de l'image de conteneur et de réduire la latence de déploiement. L'image de conteneur doit respecter le contrat d'exécution.
Vous pouvez utiliser cette méthode de déploiement avec n'importe quel langage. Les exemples de cette page utilisent Python.
SDK Agent Platform
Idéal pour le développement interactif dans des environnements tels que Colab, permettant le déploiement d'objets local_agent en mémoire. Cette méthode est idéale pour les agents dont les structures ne contiennent pas de composants complexes non sérialisables.
Pour commencer, procédez comme suit :
- Effectuer les opérations prérequises
- Facultatif : Configurer votre agent pour le déploiement
- Créer une instance Agent Platform
- Facultatif : obtenir l'ID de ressource de l'agent
- Facultatif : Lister les opérations compatibles
- Facultatif : Accorder des autorisations à l'agent déployé
Prérequis
Avant de déployer un agent, assurez-vous d'avoir effectué les tâches suivantes :
Facultatif : Configurer votre agent pour le déploiement
Vous pouvez effectuer des configurations facultatives pour votre agent. Les exemples de cette section utilisent Python.