Execução de código Python em Cortex Agents no Snowflake

A ferramenta de execução de código permite que os agentes rodem scripts Python de forma segura para realizar cálculos, processar dados e criar visualizações durante uma interação. O ambiente roda em um sandbox isolado que possui acesso apenas aos dados da sessão atual e a um stage de workspace montado.

Para que serve

Imagine que você precisa que um agente processe dados complexos e crie um gráfico com o resultado de uma consulta.

• Executar scripts Python sob demanda durante uma conversa.
• Processar dados e realizar cálculos matemáticos ou estatísticos.
• Gerar visualizações e gráficos utilizando bibliotecas populares.

Como usar

Configure a ferramenta na especificação do seu agente incluindo o tipo e os recursos correspondentes.

tools:
  - tool_spec:
      type: code_execution
      name: code_execution

tool_resources:
  code_execution:
    permission_policy:
      type: always_ask

O que acontece nesse código:

1. Define a inclusão da ferramenta de execução de código simples (code_execution) na lista de ferramentas do agente.
2. Configura a política de permissão do sandbox como always_ask, exigindo aprovação do usuário antes de executar comandos que modifiquem o estado.

Limitações e requisitos

• Estágio: General Availability (GA).
• O ambiente utiliza Python 3.12 com bibliotecas comuns pré-instaladas, como numpy, pandas, scipy, pyarrow, matplotlib e plotly.
• Chamadas a agentes que utilizam direitos do proprietário (owner's rights) não suportam execução de código; use os direitos do chamador (caller's rights).
• O sandbox é isolado a uma única thread de conversação e o estado em memória não persiste entre execuções separadas.