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 à utiliser les instances à l'aide de la console
Ce didacticiel explique comment héberger un agent sur le type de ** calcul ** Instances à l'aide de la console AWS de gestion. Vous créez d'abord un fournisseur de [ capacité ](runtime-instances-how-it-works.md#runtime-instances-capacity-provider) qui définit l'infrastructure EC2, puis vous créez un environnement d'exécution d'agent qui l'utilise, puis vous appelez et surveillez l'agent.
Pour connaître les prérequis, consultez la section [ Commencer à utiliser les instances](runtime-instances-getting-started.md).
## Étape 1 : Création d'un fournisseur de capacités
1. Ouvrez la AgentCore console Amazon Bedrock et choisissez ** Runtime**.
1. Dans l'**onglet Fournisseurs de ** capacité, choisissez ** Créer un fournisseur de capacité**.
1. Dans Détails du fournisseur de ** capacité**, entrez un ** nom**. Les caractères valides sont les lettres, les chiffres et les traits de soulignement ; le nom doit commencer par une lettre et peut comporter jusqu'à 48 caractères.
1. Dans Système d'**exploitation**, choisissez le système d'exploitation de vos instances EC2 (par exemple, ** Linux (64 bits x86)). ** Cela permet de déterminer quels logiciels et applications sont compatibles avec votre environnement.
1. Pour les types d'instance ** autorisés**, choisissez jusqu'à 30 types d'instances EC2 qui répondent à vos exigences en matière de charge de travail. Filtrez par vCPU, mémoire et fabricant du processeur pour trouver une correspondance.
1. Sous ** Sécurité**, choisissez le ** VPC ** qui contrôle l'accès réseau de vos instances. Vous pouvez également configurer les sous-réseaux et le mode réseau de conteneurs sous Détails ** ** supplémentaires.
1. (Facultatif) Dans Configuration du ** stockage**, choisissez ** Ajouter un volume ** pour associer un volume Amazon EBS à des fins de stockage permanent. Configurez le type, la taille, le débit, les IOPS et le chiffrement du volume. Cela permet d'enregistrer la configuration du volume et de AgentCore créer chaque volume lors du premier lancement de la session.
1. Sous Accès au ** service**, choisissez le profil d'instance associé à l'instance EC2 (utilisé AgentCore pour collecter les journaux système ; il n'autorise pas l'accès à votre code d'agent) et le rôle ** Infrastructure ** (utilisé par AgentCore pour gérer les instances EC2 en votre nom). Vous pouvez utiliser les rôles existants ou laisser la console en créer de nouveaux.
1. Choisissez ** Créer un fournisseur de capacité**. Le fournisseur de capacité démarre dans un `CREATING` état et devient une `ACTIVE` fois sa configuration validée.
**Note**
Une fois qu'un fournisseur de capacité est créé, seule sa description peut être modifiée. Pour modifier d'autres configurations telles que les types d'instance, la mise en réseau ou le stockage, dupliquez le fournisseur de capacité et effectuez vos mises à jour dans le flux de duplication.
## Étape 2 : créer un environnement d'exécution d'agent qui utilise le fournisseur de capacité
1. Sur la ** page ** Runtime, choisissez ** Create runtime ** (ou, sur la page détaillée du fournisseur de capacité, choisissez ** Host agent/tool**).
1. Entrez le ** nom de ** l'agent ou de l'outil.
1. Pour Type de ** calcul**, choisissez ** Instances**.
1. Pour Fournisseur ** de capacité**, choisissez un fournisseur de capacité existant ou choisissez Création ** rapide pour en ** créer un avec des paramètres par défaut préconfigurés en ligne.
1. Dans la section ** Agent/tool Source**, choisissez votre type de source et indiquez l'artefact :
+ **Source S3 ** : partez d'un modèle, chargez un `.zip` fichier ou choisissez un objet existant dans un compartiment S3.
+ **Conteneur ECR ** — Fournissez un URI d'image de conteneur Amazon ECR.
1. (Facultatif) Configurez l'authentification ** entrante**, les configurations ** avancées ** (sécurité, variables d'environnement) et ** les autorisations ** (rôle d'exécution IAM et chiffrement KMS).
1. Choisissez ** Créer un environnement d'exécution**. AgentCore crée la version 1 et un `DEFAULT` point de terminaison qui pointe vers celle-ci.
**Note**
Vous ne pouvez pas modifier le type de calcul après avoir créé le runtime.
## Étape 3 : Invoquer et surveiller
1. Sur la page détaillée de l'environnement d'exécution, choisissez ** Tester ** et fournissez une charge utile, ou utilisez l'**extrait de code d'invocation ** View pour appeler l'agent depuis votre propre application.
1. Le premier appel pour une nouvelle session provisionne une instance EC2 dans votre compte et lance l'agent. Cela prend donc généralement plus de temps que les appels ultérieurs. Les appels ultérieurs à la même session sont beaucoup plus rapides. AgentCore provisionne l'instance en tant qu'instance gérée par [ Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html), qui est masquée dans les vues de votre console EC2 et `DescribeInstances` par défaut. Pour plus d'informations sur la visibilité des instances gérées, consultez le paramètre de visibilité des ressources [ gérées](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html#managed-resource-visibility-settings).
1. Utilisez les ** mesures ** d'observabilité, les ** journaux et le suivi ** sur la page détaillée de l'environnement d'exécution pour surveiller les sessions, les appels, le taux d'erreur et la consommation de ressources.
## Étape 4 : nettoyer
Pour éviter des frais permanents pour les instances Amazon EC2 et les volumes Amazon EBS provisionnés sur votre compte, nettoyez les ressources que vous avez créées pour ce didacticiel lorsque vous aurez terminé :
1. Supprimez la session afin de AgentCore déprovisionner l'instance EC2 et ses volumes persistants. L'arrêt de l'exécution d'un seul agent sur une session ne met pas fin à l'instance. Pour plus d'informations sur les opérations d'API, consultez [ Commencer à utiliser les instances à l'aide de l' AWS interface de ligne de commande ou du SDK](runtime-instances-get-started-cli.md).
1. Dissociez le moteur d'exécution du fournisseur de capacité en supprimant le moteur d'exécution, ses points de terminaison ou ses versions.
1. Supprimez le fournisseur de capacité une fois qu'aucun environnement d'exécution ne le fait référence.
## Étapes suivantes
+ [Instances](runtime-instances-how-it-works.md)
+ [Comparez les types de calcul ](runtime-instances-how-it-works.md#runtime-instances-compute-comparison)
+ [Modèle de sécurité et autorisations pour les instances d'exécution ](runtime-instances-security.md)