

# Execute código e analise dados usando o Amazon Bedrock AgentCore Code Interpreter
<a name="code-interpreter-tool"></a>

O Amazon Bedrock AgentCore Code Interpreter permite que agentes de IA escrevam e executem códigos com segurança em ambientes sandbox, aprimorando sua precisão e expandindo sua capacidade de resolver tarefas complexas de ponta a ponta. Isso é fundamental em aplicativos de IA da Agentic, nos quais os agentes podem executar códigos arbitrários que podem levar ao comprometimento dos dados ou a riscos de segurança. A ferramenta AgentCore Code Interpreter fornece execução segura de código, o que ajuda a evitar esses problemas.

O Code Interpreter vem com tempos de execução predefinidos para vários idiomas e recursos avançados, incluindo suporte a arquivos grandes, acesso à Internet e recursos de registro. CloudTrail Para upload em linha, o tamanho do arquivo pode ser de até 100 MB. E para fazer o upload para o Amazon S3 por meio de comandos de terminal, o tamanho do arquivo pode chegar a 5 GB.

Os desenvolvedores podem personalizar ambientes com propriedades de sessão e modos de rede para atender aos requisitos corporativos e de segurança. O AgentCore Code Interpreter reduz a intervenção manual e permite o desenvolvimento sofisticado de IA sem comprometer a segurança ou o desempenho.

**Topics**
+ [Visão geral do](#code-interpreter-overview)
+ [Por que usar o Code Interpreter no desenvolvimento de agentes](#code-interpreter-why-important)
+ [Práticas recomendadas](#code-interpreter-best-practices)
+ [Pre-installed bibliotecas](code-interpreter-preinstalled-libraries.md)
+ [Comece a usar o AgentCore Code Interpreter](code-interpreter-getting-started.md)
+ [Execute código no Code Interpreter a partir de agentes](code-interpreter-building-agents.md)
+ [Gravar arquivos em uma sessão](code-interpreter-file-operations.md)
+ [Usando comandos de terminal com uma função de execução](code-interpreter-s3-integration.md)
+ [Gerenciamento de recursos e sessões](code-interpreter-resource-session-management.md)
+ [Exemplos de referência da API Code Interpreter](code-interpreter-api-reference-examples.md)
+ [Observabilidade](code-interpreter-observability.md)
+ [Configurar a autoridade de certificação raiz para o Amazon Bedrock AgentCore Code Interpreter](code-interpreter-root-ca-certificates.md)
+ [Solucionar problemas do interpretador AgentCore de código](code-interpreter-troubleshooting.md)

## Visão geral do
<a name="code-interpreter-overview"></a>

O AgentCore Code Interpreter é um recurso que permite que agentes de IA escrevam, executem e depurem códigos com segurança em ambientes de sandbox. Ele fornece uma ponte entre a compreensão da linguagem natural e a execução computacional, permitindo que os agentes manipulem dados e realizem cálculos programaticamente.

O AgentCore Code Interpreter é executado em um ambiente conteinerizado dentro do Amazon Bedrock AgentCore, garantindo que a execução do código permaneça isolada e segura.

![Arquitetura mostrando a oferta de ferramentas integradas e as ferramentas de navegador e CI.](http://docs.aws.amazon.com/pt_br/bedrock-agentcore/latest/devguide/images/code-interpreter.png)


## Por que usar o Code Interpreter no desenvolvimento de agentes
<a name="code-interpreter-why-important"></a>

O AgentCore Code Interpreter aprimora o desenvolvimento do agente das seguintes maneiras:
+ Execute o código com segurança: desenvolva agentes que possam realizar fluxos de trabalho e análises de dados complexos em ambientes de sandbox, enquanto acessam fontes de dados internas sem expor dados confidenciais ou comprometer a segurança.
+ Várias linguagens de programação: O Code Interpreter oferece suporte a várias linguagens de programação, incluindo Python TypeScript e JavaScript, tornando-o versátil para diferentes casos de uso.
+ Monitoramento e processamento de dados em grande escala: acompanhe e solucione problemas de execução de código. Ao trabalhar com grandes conjuntos de dados, você pode facilmente referenciar arquivos armazenados no Amazon S3, permitindo o processamento eficiente de dados em escala de gigabytes sem limitações de API.
+ Facilidade de uso: use um modo padrão totalmente gerenciado com tempos de execução predefinidos que suportam linguagens de programação populares com bibliotecas comuns pré-instaladas.
+ Amplia os recursos de resolução de problemas: permite que os agentes resolvam problemas computacionais difíceis de resolver apenas com o raciocínio e permite cálculos matemáticos precisos e processamento de dados em grande escala.
+ Suporte de longa duração de execução: a ferramenta Code Interpreter fornece suporte para um tempo de execução padrão de 15 minutos, que pode ser estendido por até oito horas.
+ Manipula dados estruturados: processa CSV, Excel, JSON e outros formatos de dados e executa limpeza e análise de dados.
+ Permite fluxos de trabalho complexos: permite a solução de problemas em várias etapas que combina raciocínio com computação e facilita o desenvolvimento e a depuração iterativos.

O AgentCore Code Interpreter torna os agentes mais poderosos ao complementar suas habilidades de raciocínio com a execução computacional, permitindo que eles lidem com uma gama muito maior de tarefas de forma eficaz.

## Práticas recomendadas
<a name="code-interpreter-best-practices"></a>

Para tirar o máximo proveito do interpretador de AgentCore código:
+ Mantenha os trechos de código concisos e focados em tarefas específicas
+ Use comentários para documentar seu código
+ Otimize o código para desempenho ao trabalhar com grandes conjuntos de dados
+ Salve resultados intermediários ao realizar operações complexas
+ Use o gerenciador de `code_session` contexto para garantir a limpeza adequada
+ Inclua try/except blocos no código para lidar com erros normalmente
+ Os resultados da execução do código são retornados e processados como fluxos
+ Limpe arquivos temporários quando não forem mais necessários
+ Encerre as sessões quando terminar de liberar recursos