Execução de código do mecanismo do agente

Muitas tarefas do agente, como cálculos financeiros e fluxos de trabalho de ciência de dados, exigem que um agente gere e execute código. A execução de código do Agent Engine permite que seu agente execute código em um ambiente de sandbox seguro, isolado e gerenciado.

Os recursos de execução de código incluem:

  • É possível criar e executar código em menos de um segundo.

  • Os ambientes de simulação aceitam entrada e saída de arquivos de até 100 MB para toda a solicitação ou resposta.

  • Os sandbox mantêm o estado de execução (memória) por até 14 dias. Essa configuração de time to live (TTL) é configurável.

A execução de código faz parte do pacote do Agent Engine. No entanto, não é necessário implantar o agente no Agent Engine para usar a execução de código. O agente pode ser executado em qualquer lugar, até mesmo localmente.

A execução de código funciona com qualquer framework de agente e modelo generativo.

Estas são as principais operações para trabalhar com uma sandbox de execução de código:

  • Criar sandbox: cria um espaço seguro e isolado para executar códigos não confiáveis ou potencialmente prejudiciais. Esse isolamento reduz os riscos de segurança, impedindo que o código toque nos recursos, arquivos ou rede do sistema. Um sandbox é essencial quando você precisa executar código com segurança, como para agentes de ciência de dados, scripts de orquestração ou durante testes de desenvolvimento. A sandbox oferece um sistema de arquivos limitado e não tem acesso à rede.

  • Receber sandbox: mostra a configuração e o status de um sandbox de execução de código específico. É possível verificar detalhes como o estado atual (por exemplo, em execução ou parado) e time to live (TTL). Assim, é possível acompanhar seus ambientes de simulação e verificar o status deles antes ou depois de executar o código.

  • Listar sandboxes: lista todas as sandboxes de execução de código no seu projeto. Você pode filtrar os resultados por critérios como status ou tipo de sandbox. Isso ajuda a verificar, monitorar e gerenciar muitas caixas de simulação no seu projeto.

  • Executar código: envia seu código com os arquivos de entrada necessários para o sandbox para execução segura. A resposta inclui os resultados, como saída padrão (stdout), erro padrão (stderr) e todos os arquivos gerados pelo código. A sandbox também pode manter o estado, o que permite que as chamadas Execute Code subsequentes sejam criadas com base em chamadas anteriores. Isso é crucial para sessões interativas ou tarefas complexas que precisam que o ambiente mantenha o estado em várias execuções de código.

A seguir