View a markdown version of this page

Criando um intérprete AgentCore de código - Amazon Bedrock AgentCore

Criando um intérprete AgentCore de código

Você pode criar um interpretador de código usando o AgentCore console, a AWS CLI ou o SDK do Amazon Bedrock. AWS

exemplo
Console

  1. ====== Para criar um interpretador de código usando o console

  2. Abra o AgentCore console em https://console.aws.amazon.com/bedrock-agentcore/home#.

  3. No painel de navegação, escolha Built-in ferramentas.

  4. Escolha a ferramenta Criar intérprete de código.

  5. Forneça um nome exclusivo da ferramenta e uma descrição opcional.

  6. Em Configurações de rede, escolha uma das seguintes opções:

    • Sandbox - Ambiente com acesso limitado à rede externa

    • Rede pública - Permite acesso a recursos públicos da Internet

  7. Em Permissões, especifique uma função de tempo de execução do IAM que define quais AWS recursos o interpretador de código pode acessar.

  8. Escolha Criar.

    Depois de criar uma ferramenta Code Interpreter, o console exibe detalhes importantes sobre a ferramenta:

Tool Resource ARN

<Region>O Amazon Resource Name (ARN) que identifica de forma exclusiva o recurso da ferramenta Code Interpreter (por exemplo, arn:aws:bedrock-agentcore ::123456789012:code- -interpreter-custom). interpreter/code

Code Interpreter Tool ID

O identificador exclusivo da ferramenta Code Interpreter, usado em chamadas de API (por exemplo, code-interpreter-custom-abc123).

IAM Role

A função do IAM que o interpretador de código assume ao executar o código, determinando quais AWS recursos ele pode acessar.

Network Mode

A configuração de rede para o interpretador de código (sandbox ou público).

Creation Time

A data e a hora em que a ferramenta Code Interpreter foi criada.

AWS CLI

  1. Para criar um interpretador de código usando a AWS CLI, use create-code-interpreter o comando:

    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. Para criar um interpretador de código usando o AWS SDK para Python, use o método: create_code_interpreter

    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. Para criar uma nova instância do Code Interpreter usando a API, use a seguinte chamada:

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