Execução de código do motor 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 motor do agente permite que o seu agente execute código num ambiente de sandbox seguro, isolado e gerido.

As funcionalidades da execução de código incluem:

  • As caixas de areia podem ser criadas e executar código em menos de um segundo.

  • As caixas de areia suportam a entrada e a saída de ficheiros até 100 MB para todo o pedido ou resposta.

  • As caixas de areia mantêm o respetivo estado de execução (memória) durante um período máximo de 14 dias. Esta definição de tempo de vida (TTL) é configurável.

A execução de código faz parte do conjunto do motor do agente. No entanto, não tem de implementar o seu agente no Agent Engine para usar a execução de código. O seu agente pode ser executado em qualquer lugar, mesmo localmente.

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

Seguem-se 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ódigo não fidedigno ou potencialmente prejudicial. Este isolamento reduz os riscos de segurança, impedindo que o código aceda aos recursos, aos ficheiros ou à rede do seu sistema. Uma sandbox é essencial quando precisa de executar código em segurança, como para agentes de ciência de dados, scripts de orquestração ou testes durante o desenvolvimento. A sandbox oferece um sistema de ficheiros limitado e nenhum acesso à rede.

  • Get sandbox: mostra a configuração e o estado de uma sandbox de execução de código específica. Pode verificar detalhes como o estado atual (por exemplo, em execução ou parado) e o tempo de vida (TTL). Isto permite-lhe monitorizar as suas caixas de areia e verificar o respetivo estado antes ou depois de executar o código.

  • List sandboxes: liste todas as sandboxes de execução de código no seu projeto. Pode filtrar os resultados por critérios como o estado ou o tipo da sandbox. Isto ajuda a verificar, monitorizar e gerir muitas caixas de areia no seu projeto.

  • Executar código: envia o seu código juntamente com todos os ficheiros de entrada necessários para a caixa de areia para execução segura. A resposta inclui os resultados, como a saída padrão (stdout), o erro padrão (stderr) e todos os ficheiros que o código gera. A área de testes também pode manter o estado, o que permite que as chamadas Execute Code subsequentes se baseiem nas chamadas anteriores. Isto é fundamental para sessões interativas ou tarefas complexas que precisam que o ambiente mantenha o estado em várias execuções de código.

O que se segue?