View a markdown version of this page

Commencez à utiliser les instances à l'aide de la console - Base rocheuse de l'Amazonie AgentCore
Étape 1 : Création d'un fournisseur de capacitésÉtape 2 : créer un environnement d'exécution d'agent qui utilise le fournisseur de capacitéÉtape 3 : Invoquer et surveillerÉtape 4 : nettoyerÉtapes suivantes

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é 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.

Étape 1 : Création d'un fournisseur de capacités

  1. Ouvrez la AgentCore console Amazon Bedrock et choisissez Runtime.

  2. Dans l'onglet Fournisseurs de capacité, choisissez Créer un fournisseur de capacité.

  3. 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.

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

  5. 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.

  6. 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.

  7. (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.

  8. 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.

  9. 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).

  2. Entrez le nom de l'agent ou de l'outil.

  3. Pour Type de calcul, choisissez Instances.

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

  5. 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.

  6. (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).

  7. 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.

  2. 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, 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.

  3. 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.

  2. Dissociez le moteur d'exécution du fournisseur de capacité en supprimant le moteur d'exécution, ses points de terminaison ou ses versions.

  3. Supprimez le fournisseur de capacité une fois qu'aucun environnement d'exécution ne le fait référence.

Étapes suivantes