View a markdown version of this page

Création d'un interpréteur AgentCore de code - Amazon Bedrock AgentCore

Création d'un interpréteur AgentCore de code

Vous pouvez créer un interpréteur de code à l'aide de la AgentCore console, de la AWS CLI ou du AWS SDK Amazon Bedrock.

Exemple
Console

  1. ====== Pour créer un interpréteur de code à l'aide de la console

  2. Ouvrez la AgentCore console à l'adresse https://console.aws.amazon.com/bedrock-agentcore/home#.

  3. Dans le volet de navigation, sélectionnez Built-in Outils.

  4. Choisissez l'outil Create Code Interpreter.

  5. Indiquez un nom d'outil unique et une description facultative.

  6. Sous Paramètres réseau, choisissez l'une des options suivantes :

    • Sandbox : environnement avec accès limité au réseau externe

    • Réseau public - Permet d'accéder aux ressources Internet publiques

  7. Sous Autorisations, spécifiez un rôle d'exécution IAM qui définit les AWS ressources auxquelles l'interpréteur de code peut accéder.

  8. Choisissez Créer.

    Après avoir créé un outil d'interprétation de code, la console affiche des informations importantes sur l'outil :

Tool Resource ARN

<Region>Le nom de ressource Amazon (ARN) qui identifie de manière unique la ressource de l'outil Code Interpreter (par exemple, arn:aws:bedrock-agentcore ::123456789012:code- --interpreter-custom). interpreter/code

Code Interpreter Tool ID

Identifiant unique de l'outil d'interprétation de code, utilisé dans les appels d'API (par exemple, code-interpreter-custom-abc123).

IAM Role

Rôle IAM assumé par l'interpréteur de code lors de l'exécution du code, déterminant les AWS ressources auxquelles il peut accéder.

Network Mode

Configuration réseau de l'interpréteur de code (Sandbox ou Public).

Creation Time

Date et heure de création de l'outil d'interprétation de code.

AWS CLI

  1. Pour créer un interpréteur de code à l'aide de la AWS CLI, utilisez la create-code-interpreter commande suivante :

    aws bedrock-agentcore create-code-interpreter \
  --region <Region> \
  --name "my-code-interpreter" \
  --description "My Code Interpreter for data analysis" \
  --network-configuration '{
    "networkMode": "PUBLIC"
  }' \
  --execution-role-arn "arn:aws:iam::123456789012:role/my-execution-role"
Boto3

  1. Pour créer un interpréteur de code à l'aide du AWS SDK pour Python, utilisez la create_code_interpreter méthode suivante :

    import boto3

# Initialize the boto3 client
cp_client = boto3.client(
    'bedrock-agentcore-control',
    region_name="<Region>",
    endpoint_url="https://bedrock-agentcore-control.<Region>.amazonaws.com"
)

# Create a Code Interpreter
response = cp_client.create_code_interpreter(
    name="myTestSandbox1",
    description="Test code sandbox for development",
    executionRoleArn="arn:aws:iam::123456789012:role/my-execution-role",
    networkConfiguration={
        "networkMode": "PUBLIC"
    }
)

# Print the Code Interpreter ID
code_interpreter_id = response["codeInterpreterId"]
print(f"Code Interpreter ID: {code_interpreter_id}")
API

  1. Pour créer une nouvelle instance d'interpréteur de code à l'aide de l'API, utilisez l'appel suivant :

    # Using awscurl
awscurl -X PUT "https://bedrock-agentcore-control.<Region>.amazonaws.com/code-interpreters" \
-H "Content-Type: application/json" \
--region <Region> \
--service bedrock-agentcore \
-d '{
    "name": "codeinterpreter'$(date +%m%d%H%M%S)'",
    "description": "Test code sandbox for development",
    "executionRoleArn": "'${ROLE_ARN}'",
    "networkConfiguration": {
        "networkMode": "PUBLIC"
    }
}'