Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Commencez avec le déploiement direct du code Amazon Bedrock AgentCore Runtime
Le déploiement direct du code vous permet d'intégrer votre agent à Amazon Bedrock AgentCore Runtime simplement en empaquetant le code de l'agent et ses dépendances dans une archive de fichiers .zip. Votre agent doit toujours respecter les exigences AgentCore d'exécution.
Pour créer votre package de déploiement sous forme d'archive de fichier .zip, vous pouvez utiliser l'AgentCore interface de ligne de commande zip de ligne de commande dans un environnement Linux ou macOS. Pour utiliser les mêmes commandes sous Windows, vous pouvez installer le sous-système Windows pour Linux
Notez que AgentCore Runtime utilise les autorisations de fichier POSIX. Vous devrez donc peut-être définir des autorisations pour le dossier du package de déploiement
Rubriques
Concepts de déploiement direct de code
Découvrez les concepts clés liés au déploiement direct de code avec Amazon Bedrock AgentCore Runtime.
Rubriques
Amazon Bedrock AgentCore Runtime avec déploiement direct de code utilise un modèle de responsabilité partagée similaire à AWS Lambda. AgentCore Runtime gère l'environnement d'exécution du langage et applique automatiquement les correctifs de sécurité, tandis que vous vous concentrez sur le code de votre agent et ses dépendances.
Si vous utilisez des images de conteneur pour déployer vos agents, AgentCore Runtime est chargé de patcher uniquement le noyau de calcul. Dans ce cas, vous êtes chargé de reconstruire l'image de conteneur de votre agent à partir de la dernière image sécurisée et de redéployer l'image de conteneur.
Ceci est résumé dans le tableau suivant :
| Mode de déploiement | AgentCore Responsabilité de Runtime | Votre responsabilité |
|---|---|---|
|
Mode de déploiement direct |
Publiez une nouvelle version de Language Runtime contenant les derniers correctifs pour Language Runtime. Appliquez des correctifs d'exécution du langage au déploiement direct existant de AgentCore Runtime. |
Mettez à jour le code de votre agent, y compris les dépendances, pour corriger les éventuelles failles de sécurité. |
|
Image de conteneur |
Corrigez automatiquement le noyau du système d'exploitation de calcul sous-jacent avec la dernière version. |
Mettez à jour le code de votre agent, y compris les dépendances, pour corriger les éventuelles failles de sécurité. Reconstruisez et redéployez régulièrement votre image de conteneur à l’aide de la dernière image de base. |
Pour plus d'informations sur la responsabilité partagée avec AWS, voir Modèle de responsabilité partagée
AgentCore Runtime tient à jour chaque environnement d'exécution de déploiement direct de code avec des mises à jour de sécurité, des corrections de bogues, de nouvelles fonctionnalités, des améliorations de performances et la prise en charge des versions mineures. Ces mises à jour d'exécution sont publiées en tant que versions d'exécution. AgentCore Runtime applique les mises à jour d'exécution de déploiement de code direct aux agents en migrant les agents d'une version d'exécution antérieure vers une nouvelle version d'exécution.
Pour les environnements d'exécution de déploiement direct, AgentCore Runtime applique automatiquement les mises à jour d'exécution. Grâce aux mises à jour automatiques, AgentCore Runtime prend en charge la charge opérationnelle liée à l'application de correctifs aux versions d'exécution. Pour la plupart des clients, cela devrait être un choix sûr, car seuls les correctifs d'exécution du langage seront automatiquement appliqués et les clients sont responsables de l'importation et de la gestion de leurs dépendances de code. AgentCore Runtime ne prend actuellement pas en charge la modification de ce comportement d'application automatique des correctifs.
AgentCore Runtime s'efforce de fournir des mises à jour d'exécution rétrocompatibles avec les fonctions existantes. Cependant, comme pour les correctifs logiciels, il existe de rares cas dans lesquels une mise à jour de l’environnement d’exécution peut avoir un impact négatif sur une fonction existante. Par exemple, les correctifs de sécurité peuvent exposer un problème sous-jacent à une fonction existante qui dépend du comportement précédent, non sécurisé. Si, dans de très rares cas, ce risque n'est pas acceptable, utilisez des images de conteneur pour déployer votre agent.
Certaines dimensions de comparaison permettent de voir en quoi une option diffère de l'autre, il est donc utile de choisir la bonne option
-
Processus de déploiement : le déploiement direct du code permet de déployer des agents à l'aide de fichiers ZIP plutôt que de conteneurs, ce qui permet d'accélérer les itérations de développement.
-
Durée de déploiement : bien qu'il n'y ait pas beaucoup de différence lors du premier déploiement d'un agent, les mises à jour ultérieures de l'agent sont nettement plus rapides grâce au déploiement direct du code.
-
Personnalisation : le code direct prend en charge les dépendances personnalisées par le biais de ZIP-based l'empaquetage tout en préservant la simplicité du déploiement, tandis que la base d'un conteneur dépend d'un fichier Docker.
-
Taille du package : le déploiement direct du code limite la taille du package à 250 Mo, tandis que les packages basés sur des conteneurs peuvent atteindre 2 Go.
-
Taux de création de sessions : le déploiement direct du code permet de créer 25 nouvelles sessions, sessions/second contre 1,6 pour les déploiements basés sur des conteneurs. sessions/second
Nos conseils généraux sont les suivants :
-
Si la taille du package de déploiement dépasse 250 Mo, que vous disposez de CI/CD pipelines de conteneurs existants et que vous avez besoin de dépendances et de packages hautement spécialisés, les déploiements basés sur des conteneurs constituent une bonne option.
-
Si la taille du package de déploiement est petite, si le code et le package ne sont pas complexes à créer et utilisent des frameworks et des langages communs, et si vous avez besoin d'un prototypage et d'une itération rapides, le déploiement direct du code est l'option idéale.
Il peut également exister une option hybride dans laquelle les développeurs utilisent le déploiement direct de code pour expérimenter et prototyper rapidement des agents, puis passer à des déploiements basés sur des conteneurs (pour les raisons ci-dessus) pour développer, tester et déployer en production.
