View a markdown version of this page

Comece a usar o AgentCore Code Interpreter - Amazon Bedrock AgentCore
Pré-requisitosConfigurar credenciais

Comece a usar o AgentCore Code Interpreter

AgentCore O Code Interpreter permite que seus agentes executem código Python em um ambiente seguro e gerenciado. O agente pode realizar cálculos, analisar dados, gerar visualizações e validar respostas por meio da execução de código.

Esta página aborda os pré-requisitos e fornece duas abordagens para começar:

  • Usando AWS Strands - uma estrutura de agente de alto nível que simplifica a criação de agentes de IA com integração de ferramentas incorporadas, gerenciamento de conversas e tratamento automático de sessões.

  • Uso direto - abordagens de SDK e Boto3 que fornecem mais controle sobre o gerenciamento de sessões e a execução de código para implementações personalizadas.

Tópicos

Pré-requisitos

Antes de começar, verifique se você tem:

Configurar credenciais

Execute as etapas a seguir para configurar suas AWS credenciais e anexar as permissões necessárias.

  1. Verifique suas AWS credenciais

    Confirme se suas AWS credenciais estão configuradas:

    aws sts get-caller-identity
    nota

    Anote o usuário ou as credenciais retornadas aqui, pois você as usará ao anexar as permissões necessárias.

    Se esse comando falhar, configure suas credenciais. Para obter mais informações, consulte Configurações e configurações do arquivo de credenciais na AWS CLI.

  2. Anexe as permissões necessárias

    Seu usuário ou função do IAM precisa de permissões para usar o AgentCore Code Interpreter. Anexe essa política à sua identidade do IAM:

    nota

    <region>Substitua pela região escolhida (por exemplo,us-west-2) e <account_id> pelo ID da sua AWS conta na política abaixo:

    {
    "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/*"
        }
    ]
}

Para anexar esta política

Siga estas etapas:

  1. Acesse o console do IAM.

  2. Encontre seu usuário ou função a partir da resposta retornada para a operação get-caller-identity da API.

  3. Escolha Adicionar permissões e, em seguida, escolha Criar política embutida

  4. Mude para a visualização JSON e cole a política acima

  5. Dê um nome AgentCoreCodeInterpreterAccess e salve

nota

Se você estiver implantando agentes no Amazon Bedrock AgentCore Runtime, também precisará criar uma função de execução do IAM com uma política de confiança do serviço. Para obter mais informações, consulte Introdução ao AgentCore Runtime.

As seções a seguir mostram como usar o Amazon Bedrock AgentCore Code Interpreter com e sem a estrutura do agente. Usar o interpretador de código diretamente sem uma estrutura de agente é especialmente útil quando você deseja executar trechos de código específicos de forma programática.