View a markdown version of this page

Creating an AgentCore Code Interpreter - Amazon Bedrock AgentCore
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Creating an AgentCore Code Interpreter

You can create a Code Interpreter using the Amazon Bedrock AgentCore console, Amazon CLI, or Amazon SDK.

Example
Console

  1. ====== To create a Code Interpreter using the console

  2. Open the AgentCore console at https://console.aws.amazon.com/bedrock-agentcore/home#.

  3. In the navigation pane, choose Built-in tools.

  4. Choose Create Code Interpreter tool.

  5. Provide a unique Tool name and optional Description.

  6. Under Network settings , choose one of the following options:

    • Sandbox - Environment with limited external network access

    • Public network - Allows access to public internet resources

  7. Under Permissions , specify an IAM runtime role that defines what Amazon resources the Code Interpreter can access.

  8. Choose Create.

    After creating a Code Interpreter tool, the console displays important details about the tool:

Tool Resource ARN

The Amazon Resource Name (ARN) that uniquely identifies the Code Interpreter tool resource (e.g., arn:aws:bedrock-agentcore:<Region>:123456789012:code-interpreter/code-interpreter-custom).

Code Interpreter Tool ID

The unique identifier for the Code Interpreter tool, used in API calls (e.g., code-interpreter-custom-abc123).

IAM Role

The IAM role that the Code Interpreter assumes when executing code, determining what Amazon resources it can access.

Network Mode

The network configuration for the Code Interpreter (Sandbox or Public).

Creation Time

The date and time when the Code Interpreter tool was created.

Amazon CLI

  1. To create a Code Interpreter using the Amazon CLI, use the create-code-interpreter command:

    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. To create a Code Interpreter using the Amazon SDK for Python, use the create_code_interpreter method:

    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. To create a new Code Interpreter instance using the API, use the following call:

    # 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"
    }
}'