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. # Génération, exécution et test du code de votre application en activant l’interprétation du code L’interprétation du code permet à votre agent de générer et d’exécuter le code de votre application, et d’en résoudre les problèmes, dans un environnement de test sécurisé. Grâce à l’interprétation du code, vous pouvez utiliser le modèle de fondation de l’agent pour générer du code afin d’implémenter des fonctionnalités de base tout en vous concentrant sur le développement d’applications d’IA générative. Vous pouvez effectuer les tâches suivantes avec l’interprétation du code dans Amazon Bedrock : + Comprendre les demandes des utilisateurs pour des tâches spécifiques, générer du code capable d’exécuter les tâches demandées par l’utilisateur, exécuter le code et fournir le résultat d’exécution du code + Comprendre les requêtes utilisateur génériques, générer et exécuter du code pour fournir une réponse à l’utilisateur + Générer du code pour permettre l’analyse, la visualisation et l’évaluation des données + Extraire les informations des fichiers chargés par l’utilisateur, traiter les informations et répondre aux requêtes utilisateur + Générer du code en fonction des conversations interactives avec l’utilisateur pour un prototypage rapide Par défaut, le nombre maximum d’interprétations de code actives simultanément par session et par Compte AWS est de 25. Cela signifie que chaque Compte AWS peut avoir jusqu’à 25 conversations simultanées avec les agents à l’aide de l’interpréteur de code. Voici quelques cas d’utilisation dans lesquels l’interprétation du code peut être utile en générant et en exécutant le code dans un Amazon Bedrock : 1. Analyse des transactions financières à partir d’un fichier de données tel qu’un fichier .csv afin de déterminer si elles ont généré un profit ou une perte 1. Conversion d’un format de date, tel que *14 mars 2020*, au format API standard `YYYY-MM-DD` pour les formats de fichiers tels que .txt ou .csv 1. Analyse des données sur une feuille de calcul (XLS) pour calculer des métriques telles que le chiffre d’affaires trimestriel/annuel de l’entreprise ou le taux de croissance démographique Pour utiliser l’interprétation du code dans Amazon Bedrock, procédez comme suit : + Activez l’interprétation du code lorsque vous créez votre agent. Une fois que vous avez activé l’interprétation du code, vous pouvez commencer à l’utiliser. + Commencez à utiliser l’interprétation du code dans Amazon Bedrock en fournissant des invites. Par exemple, vous pouvez demander « calcule la racine carrée de pi à 127 chiffres ». L’interprétation du code génère et exécute du code python pour fournir une réponse. + Vous pouvez également joindre des fichiers. Vous pouvez utiliser les informations contenues dans les fichiers pour poser des questions et récapituler ou analyser les données. Vous pouvez joindre les fichiers à partir de votre ordinateur ou à partir d’un compartiment Amazon S3. **Régions prises en charge** L’interprétation du code pour les agents Amazon Bedrock est prise en charge dans les régions suivantes : **** | Région | | --- | | USA Est (Virginie du Nord) | | USA Ouest (Oregon) | | Europe (Francfort) | **Prise en charge de fichiers** Avec l’interprétation du code, vous pouvez joindre des fichiers, puis les utiliser pour poser des questions et récapituler ou analyser les données en fonction de leur contenu. Vous pouvez joindre jusqu’à 5 fichiers maximum. La taille totale de tous les fichiers peut atteindre 10 Mo. + **Types de fichiers d’entrée pris en charge** : CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT et PDF + **Types de fichiers de sortie pris en charge** : CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT, PDF et PNG # Activation de l’interprétation du code dans Amazon Bedrock Vous pouvez activer l’interprétation du code dans la console Amazon Bedrock lorsque vous [créez](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html) ou [mettez à jour](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-manage.html#agents-edit) votre agent. Si vous utilisez une API ou SDKs, vous pouvez activer l'interprétation du code lorsque vous [créez](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html) ou [mettez à jour](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html) un groupe d'actions. Pour savoir comment activer l’interprétation du code dans Amazon Bedrock, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] **Pour activer l’interprétation du code pour votre agent** 1. Si vous n’êtes pas encore dans le créateur d’agents, procédez comme suit : 1. Connectez-vous au AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ouvrez ensuite la console Amazon Bedrock à l'adresse [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. Dans le volet de navigation de gauche, sélectionnez **Agents**. Choisissez ensuite un agent dans la section **Agents**. 1. Choisissez **Modifier dans le créateur d’agents**. 1. Développez la section **Paramètres supplémentaires**. 1. Pour **Interpréteur de code**, sélectionnez **Activer**. 1. Assurez-vous d’abord de cliquer sur **Enregistrer**, puis sur **Préparer** pour appliquer les modifications que vous avez apportées à l’agent avant de le tester. ------ #### [ API ] Pour permettre à votre agent d'interpréter le code, envoyez une [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)demande (voir le lien pour les formats de demande et de réponse et les détails des champs) avec un point de [terminaison prédéfini Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et spécifiez les champs suivants : **** | Champ | Description abrégée | | --- | --- | | actionGroupName | Nom du groupe d’actions | | parentActionGroupSignature | Spécifiez AMAZON.CodeInterpreter pour permettre à l’agent de générer et de tester le code | | actionGroupState | Spécifiez ENABLED pour autoriser l’agent à invoquer l’interprétation du code | Ce qui suit montre le format général des champs obligatoires pour permettre l'interprétation du code dans le cadre d'une [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)demande. ``` CreateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "ENABLED" } ``` ------ # Test de l’interprétation du code dans Amazon Bedrock Avant de tester l’interprétation du code dans Amazon Bedrock, assurez-vous de préparer votre agent à appliquer les modifications que vous venez d’apporter. Lorsque l’interprétation du code est activée, lorsque vous commencez à tester votre agent, vous pouvez éventuellement joindre des fichiers et choisir la manière dont vous souhaitez que les fichiers que vous joignez soient utilisés par l’interprétation du code. En fonction de votre cas d’utilisation, vous pouvez demander à l’interprétation du code d’utiliser les informations contenues dans les fichiers joints afin de résumer le contenu du fichier et de répondre aux questions concernant le contenu du fichier lors d’une conversation interactive par chat. Vous pouvez également demander à l’interprétation du code d’analyser le contenu des fichiers joints et de fournir des statistiques et des rapports de visualisation des données. **Joindre des fichiers** Pour apprendre à joindre des fichiers à des fins d’interprétation du code, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] **Pour joindre des fichiers à des fins d’interprétation du code,** 1. Si vous n’êtes pas encore dans le créateur d’agents, procédez comme suit : 1. Connectez-vous au AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ouvrez ensuite la console Amazon Bedrock à l'adresse [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. Dans le volet de navigation de gauche, sélectionnez **Agents**. Choisissez ensuite un agent dans la section **Agents**. 1. Choisissez **Modifier dans le créateur d’agents** 1. Développez **Paramètres supplémentaires** et vérifiez que l’**interpréteur du code** est activé. 1. Assurez-vous que l’agent est prêt. 1. Si la fenêtre de test n’est pas ouverte, choisissez **Test**. 1. Au bas de la fenêtre de test, sélectionnez l’icône en forme de trombone pour joindre des fichiers. 1. Sur la page **Joindre des fichiers**, 1. **Pour **Choisir une fonction**, spécifiez les éléments suivants :** + Si vous joignez des fichiers que l’agent doit utiliser pour répondre à vos requêtes et résumer le contenu, choisissez **Joindre des fichiers au Chat (plus rapide)**. + Si vous joignez des fichiers à des fins d’interprétation de code afin d’analyser le contenu et de fournir des mesures, choisissez **Joindre des fichiers à l’interpréteur du code**. 1. **Dans **Choisir la méthode de téléchargement**, choisissez l’endroit depuis lequel vous souhaitez télécharger vos fichiers :** + Si vous effectuez le téléchargement depuis votre ordinateur, choisissez **Choisir des fichiers** et sélectionnez les fichiers à joindre. + Si vous effectuez un téléchargement depuis Amazon S3, choisissez **Parcourir S3**, sélectionnez les fichiers, choisissez **Sélectionner**, puis **Ajouter**. 1. Choisissez **Attacher**. ------ #### [ API ] Pour tester l'interprétation du code, envoyez une [InvokeAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_InvokeAgent.html)demande (voir le lien pour les formats de demande et de réponse et les détails des champs) avec un point de terminaison [Agents for Amazon Bedrock au moment de la création.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) **Pour joindre des fichiers que l’agent utilisera pour répondre à vos questions et résumer le contenu, spécifiez les champs suivants :** **** | Champ | Description abrégée | | --- | --- | | name | Nom du fichier joint. | | sourceType | Emplacement du fichier à joindre. Spécifiez s3 si votre fichier se trouve dans le compartiment Amazon S3. Spécifiez byte\$1content si votre fichier se trouve sur votre ordinateur. | | Emplacement S3 | Le chemin S3 où se trouve votre fichier. Obligatoire si sourceType est S3. | | mediaType | Type de fichier du fichier joint. **Types de fichiers d’entrée pris en charge** : CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT et PDF | | data | Chaîne codée en Base64. Taille maximale du fichier : 10 Mo. Si vous utilisez le SDK, il vous suffit de fournir le contenu en octets du fichier. AWS Le SDK code automatiquement les chaînes en base64. | | useCase | Comment souhaitez-vous que les fichiers joints soient utilisés. Valeurs valides : CHAT \$1 CODE\$1INTERPRETER | L’exemple suivant montre le format général permettant de spécifier les champs obligatoires pour joindre des fichiers au chat. ``` "sessionState": { "promptSessionAttributes": { "string": "string" }, "sessionAttributes": { "string": "string" }, "files": [ { "name": "banking_data", "source": { "sourceType": "S3", "s3Location": "uri": "s3Uri" } }, "useCase": "CHAT" }, { "name": "housing_stats.csv", "source": { "sourceType": "BYTE_CONTENT", "byteContent": { "mediaType": "text/csv", "data": "file byte content" } }, "useCase": "CHAT" } ] } ``` L’exemple suivant montre le format général permettant de spécifier les champs obligatoires pour joindre des fichiers à des fins d’interprétation du code. ``` "sessionState": { "promptSessionAttributes": { "string": "string" }, "sessionAttributes": { "string": "string" }, "files": [ { "name": "banking_data", "source": { "sourceType": "S3", "s3Location": { "uri": "s3Uri" } }, "useCase": "CODE_INTERPRETER" }, { "name": "housing_stats.csv", "source": { "sourceType": "BYTE_CONTENT", "byteContent": { "mediaType": "text/csv", "data": "file byte content" } }, "useCase": "CODE_INTERPRETER" } ] } ``` ------ # Désactivation de l’interprétation du code dans Amazon Bedrock Vous pouvez désactiver l’interprétation du code dans Amazon Bedrock à tout moment. Pour savoir comment désactiver l’interprétation du code, choisissez l’onglet correspondant à votre méthode préférée, puis suivez les étapes : ------ #### [ Console ] **Pour désactiver l’interprétation du code,** 1. Connectez-vous au AWS Management Console avec une identité IAM autorisée à utiliser la console Amazon Bedrock. Ouvrez ensuite la console Amazon Bedrock à l'adresse [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. Dans le volet de navigation de gauche, sélectionnez **Agents**. Choisissez ensuite un agent dans la section **Agents**. 1. Choisissez **Modifier dans le créateur d’agents**. 1. Développez la section **Paramètres supplémentaires**, choisissez **Désactiver** pour **Interprète de code**. 1. Sélectionnez **Préparer** en haut de la page. Ensuite, sélectionnez **Enregistrer** pour enregistrer les modifications apportées à votre agent. ------ #### [ API ] Pour désactiver l'interprétation du code, envoyez une [UpdateAgentActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html)demande (voir le lien pour les formats de demande et de réponse et les détails des champs) avec un point de [terminaison Agents for Amazon Bedrock au moment de la création](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) et spécifiez les champs suivants : **** | Champ | Description abrégée | | --- | --- | | actionGroupName | Nom du groupe d’actions | | parentActionGroupSignature | Spécifiez AMAZON.CodeInterpreter pour désactiver l’interprète de code | | actionGroupState | Spécifiez DISABLED pour désactiver l’interprète de code | L’exemple suivant montre le format général permettant de spécifier les champs obligatoires pour désactiver l’interprétation du code. ``` UpdateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "DISABLED" } ``` ------ Après avoir désactivé l'interprétation du code pour votre agent, assurez-vous d'envoyer une [PrepareAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_PrepareAgent.html)demande (voir le lien pour les formats de demande et de réponse et les détails des champs) via un point de terminaison [Agents for Amazon Bedrock au moment de la création.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)