Ferramentas de execução de código para Cortex Agents em Native Apps

Esta novidade permite que provedores incluam ferramentas de sandbox para execução de código Python ou consultas SQL em agentes de IA criados dentro de uma Snowflake Native App.

Para que serve

Imagine que você desenvolveu um app que precisa analisar dados com scripts Python personalizados ou rodar consultas de leitura em dados do consumidor de forma segura.

• Executar código Python para cálculos, transformações e gráficos.
• Utilizar o conjunto completo de ferramentas de codificação (code_toolset_all), incluindo bash, manipulação de arquivos e comandos SQL de leitura.
• Processar análises avançadas mantendo restrições rígidas de direitos de chamada.

Como usar

Configure as ferramentas de sandbox na especificação do agente no script de configuração da sua aplicação.

CREATE OR REPLACE AGENT core.my_agent
  FROM SPECIFICATION $$
models:
  orchestration: auto
tools:
  - tool_spec:
      type: "code_execution"
$$;

O que acontece nesse código:

1. O comando cria ou substitui um agente chamado core.my_agent na aplicação.
2. A especificação define o modelo de orquestração como automático.
3. A ferramenta de sandbox em Python (code_execution) é integrada ao agente sem privilégios de execução direta de SQL.

Limitações e requisitos

• O sandbox não executa com os direitos do proprietário do app; aplica-se o modelo de restrição de direitos de chamada (RCR).
• O comando snowflake_sql_execute suporta apenas as instruções SELECT e SHOW.
• Executar o agente a partir de uma procedure com privilégios de proprietário remove as ferramentas de sandbox.
• O consumidor precisa conceder explicitamente permissões de acesso aos objetos do workspace e dados por meio de comandos GRANT CALLER.