View a markdown version of this page

Gestion des ressources et des sessions - Amazon Bedrock AgentCore
Autorisations IAMComment ça marcheCréation d'un interpréteur de code et démarrage d'une session

Gestion des ressources et des sessions

Les rubriques suivantes montrent comment fonctionne l'interpréteur de AgentCore code Amazon Bedrock et comment vous pouvez créer les ressources et gérer les sessions.

Rubriques

Autorisations IAM

La politique IAM suivante fournit les autorisations nécessaires pour utiliser l'interpréteur de AgentCore code :

{
"Version":"2012-10-17",
    "Statement": [
        {
            "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:us-east-1:111122223333:code-interpreter/*"
        }
    ]
}

Vous devez également ajouter la politique de confiance suivante au rôle d'exécution :

{
"Version":"2012-10-17",
    "Statement": [{
        "Sid": "BedrockAgentCoreBuiltInTools",
        "Effect": "Allow",
        "Principal": {
            "Service": "bedrock-agentcore.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
                "aws:SourceAccount": "111122223333"
            },
            "ArnLike": {
                "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:*"
            }
        }
    }]
}

Comment ça marche

  1. Création d'un interpréteur de code

    Créez votre propre interpréteur de code ou utilisez l'interpréteur de code système pour activer des fonctionnalités telles que l'écriture et l'exécution de code ou l'exécution de calculs complexes. L'interpréteur de code vous permet d'augmenter le temps d'exécution de votre agent pour exécuter le code en toute sécurité dans un environnement entièrement géré avec une faible latence.

  2. Intégrez-le au sein d'un agent pour l'invoquer

    Copiez l'ID de ressource d'outil intégré dans le code de votre agent d'exécution pour l'invoquer dans le cadre de votre session. Pour les outils d'interprétation de code, vous pouvez exécuter du code et afficher les résultats en temps réel.

  3. Évaluez les performances grâce à l'observabilité

    Surveillez les indicateurs clés pour chaque outil CloudWatch afin d'obtenir des informations sur les performances en temps réel.

Création d'un interpréteur de code et démarrage d'une session

  1. Création d'un interpréteur de code

    Lorsque vous configurez un interpréteur de code, vous pouvez choisir les paramètres réseau (Sandbox ou Public) et le rôle d'exécution qui définit les AWS ressources auxquelles l'interpréteur de code peut accéder.

  2. Démarrer une session

    L'interpréteur de code utilise un modèle basé sur les sessions. Après avoir créé un interpréteur de code, vous démarrez une session avec un délai d'expiration configurable (la valeur par défaut est de 15 minutes). Les sessions se terminent automatiquement après le délai imparti. Plusieurs sessions peuvent être actives simultanément pour un même interpréteur de code, chaque session conservant son propre état et son propre environnement.

  3. Exécuter le code

    Au cours d'une session active, vous pouvez exécuter du code dans les langages pris en charge (Python JavaScript,, TypeScript) et maintenir l'état entre les exécutions. Vous pouvez également effectuer des upload/download opérations sur les fichiers et utiliser le support fourni pour les commandes shell et les commandes AWS CLI.

  4. Arrêter la session et nettoyer

    Lorsque vous avez fini d'utiliser une session, vous devez l'arrêter pour libérer des ressources et éviter des frais inutiles. Vous pouvez également supprimer l'interpréteur de code si vous n'avez plus l'intention de l'utiliser.