View a markdown version of this page

Démarrez avec AgentCore Code Interpreter - Base rocheuse de l'Amazonie AgentCore
Conditions préalablesConfiguration de vos informations d’identification

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.

Démarrez avec AgentCore Code Interpreter

AgentCore L'interpréteur de code permet à vos agents d'exécuter du code Python dans un environnement géré et sécurisé. L'agent peut effectuer des calculs, analyser des données, générer des visualisations et valider des réponses grâce à l'exécution de code.

Cette page décrit les prérequis et propose deux approches pour démarrer :

  • Utilisation de AWS Strands  : un framework d'agents de haut niveau qui simplifie la création d'agents IA grâce à l'intégration d'outils intégrés, à la gestion des conversations et à la gestion automatique des sessions.

  • Utilisation directe  : approches SDK et Boto3 qui permettent de mieux contrôler la gestion des sessions et l'exécution du code pour les implémentations personnalisées.

Rubriques

Conditions préalables

Avant de commencer, assurez-vous de disposer des éléments suivants :

Configuration de vos informations d’identification

Effectuez les étapes suivantes pour configurer vos AWS informations d'identification et associer les autorisations requises.

  1. Vérifiez vos AWS informations d'identification

    Vérifiez que vos AWS informations d'identification sont configurées :

    aws sts get-caller-identity
    Note

    Prenez note de l'utilisateur ou des informations d'identification renvoyées ici, car vous les utiliserez pour associer les autorisations requises.

    Si cette commande échoue, configurez vos informations d'identification. Pour plus d'informations, consultez la section Configuration et paramètres du fichier d'informations d'identification dans l' AWS interface de ligne de commande.

  2. Joindre les autorisations requises

    Votre utilisateur ou rôle IAM a besoin d'autorisations pour utiliser l'interpréteur de AgentCore code. Joignez cette politique à votre identité IAM :

    Note

    <region>Remplacez-la par la région que vous avez choisie (par exempleus-west-2) et <account_id> par l'identifiant de votre AWS compte dans la politique ci-dessous :

    {
    "Version":"2012-10-17",	
    "Statement": [
        {
            "Sid": "BedrockAgentCoreCodeInterpreterFullAccess",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateCodeInterpreter",
                "bedrock-agentcore:StartCodeInterpreterSession",
                "bedrock-agentcore:InvokeCodeInterpreter",
                "bedrock-agentcore:StopCodeInterpreterSession",
                "bedrock-agentcore:DeleteCodeInterpreter",
                "bedrock-agentcore:ListCodeInterpreters",
                "bedrock-agentcore:GetCodeInterpreter",
                "bedrock-agentcore:GetCodeInterpreterSession",
                "bedrock-agentcore:ListCodeInterpreterSessions"
            ],
            "Resource": "arn:aws:bedrock-agentcore:<region>:++<account_id>++:code-interpreter/*"
        }
    ]
}

Pour joindre cette politique

Procédez comme suit :

  1. Accédez à la console IAM.

  2. Trouvez votre utilisateur ou votre rôle à partir de la réponse renvoyée pour l'opération get-caller-identity d'API.

  3. Choisissez Ajouter des autorisations, puis choisissez Créer une politique en ligne

  4. Passez en mode JSON et collez la politique ci-dessus

  5. Nommez-le AgentCoreCodeInterpreterAccess et sauvegardez

Note

Si vous déployez des agents sur Amazon Bedrock AgentCore Runtime, vous devez également créer un rôle d'exécution IAM avec une politique de confiance des services. Pour plus d'informations, consultez la section Commencer à utiliser AgentCore Runtime.

Les sections suivantes vous montrent comment utiliser l'interpréteur de AgentCore code Amazon Bedrock avec et sans l'infrastructure d'agent. L'utilisation directe de l'interpréteur de code sans framework d'agent est particulièrement utile lorsque vous souhaitez exécuter des extraits de code spécifiques par programmation.