# Comece a usar o AgentCore Code Interpreter
<a name="code-interpreter-getting-started"></a>

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.

**Topics**
+ [Pré-requisitos](#code-interpreter-prerequisites)
+ [Configurar credenciais](#code-interpreter-credentials-config)
+ [Usando o AgentCore Code Interpreter via AWS Fios](code-interpreter-using-strands.md)
+ [Usando o AgentCore Code Interpreter diretamente](code-interpreter-using-directly.md)

## Pré-requisitos
<a name="code-interpreter-prerequisites"></a>

Antes de começar, verifique se você tem:
+  AWS conta com credenciais configuradas. Consulte [Configuração de suas credenciais](#code-interpreter-credentials-config).
+ Python 3.10\+ instalado
+ Boto3 instalado. Consulte a documentação [do Boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html).
+ Função de execução do IAM com as permissões necessárias. Consulte [Configuração de suas credenciais](#code-interpreter-credentials-config).
+ Acesso ao modelo: Anthropic Claude Sonnet 4.0 [habilitado no console](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access-modify.html) Amazon Bedrock. Para obter informações sobre como usar um modelo diferente com os Strands Agents, consulte a seção *Model Providers* na [documentação do SDK do Strands Agents](https://strandsagents.com/latest/documentation/docs/).
+  AWS Região em que o Amazon Bedrock AgentCore está disponível. Consulte [AWS Regiões suportadas](agentcore-regions.md).

## Configurar credenciais
<a name="code-interpreter-credentials-config"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html).

1.  **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.

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

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

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

1. 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](runtime-getting-started.md).

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.