View a markdown version of this page

Commencez avec AgentCore Code Interpreter - Amazon Bedrock AgentCore
Conditions préalablesConfiguration de vos informations d’identification

Commencez 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 les réponses par le biais de l'exécution du code.

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

  • Utilisation de AWS Strands : infrastructure 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 offrant un meilleur contrôle sur 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 d'avoir :

Configuration de vos informations d’identification

Procédez comme suit 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 des fichiers d'identification dans la AWS CLI.

  2. Joindre les autorisations requises

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

    Note

    Remplacez <region> par la région que vous avez choisie (par exemple,us-west-2) et <account_id> par votre numéro de 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 à la vue JSON et collez la politique ci-dessus

  5. Nommez-le AgentCoreCodeInterpreterAccess et enregistrez

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 en matière de service. Pour plus d'informations, voir Commencer avec AgentCore Runtime.

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