Restrições de segurança da sandbox
Nesta página
Um ambiente isolado por conceção
A sandbox de execução de código Python foi concebida para garantir a segurança. O código é executado num ambiente isolado que protege tanto a infraestrutura da xAI como os seus dados. Compreender estas restrições é essencial para criar integrações que funcionem corretamente e para saber quando a Execução de Código se adequa às suas necessidades.
As cinco restrições fundamentais
1. Sem acesso à rede
A sandbox não tem ligação à Internet ou a qualquer rede externa. O código não pode:
- Efetuar pedidos HTTP (sem
requests, semurllib) - Ligar-se a bases de dados remotas
- Chamar APIs externas
- Transferir ficheiros da Web
- Enviar e-mails ou notificações
Esta é a restrição mais limitativa. Se o seu caso de utilização exigir dados externos, deverá fornecê-los no prompt ou utilizar a Pesquisa na Web antecipadamente para os obter.
2. Acesso limitado ao sistema de ficheiros
O código é executado num diretório temporário com acesso restrito ao sistema de ficheiros:
- Leitura/escrita apenas no diretório de trabalho temporário
- Sem acesso a ficheiros do sistema
- Sem acesso a diretórios de outros utilizadores
- Os ficheiros criados são eliminados após a execução
3. Contexto temporário e sem estado
Cada execução é independente. Não existe persistência entre dois pedidos de API:
- As variáveis definidas durante uma execução não existem na seguinte
- Os ficheiros criados são eliminados
- As bibliotecas carregadas na memória são repostas
- Não é mantido qualquer histórico de execução
Isto significa que não pode criar uma sessão interativa onde os resultados de um cálculo alimentam o seguinte — pelo menos não automaticamente. Para simular este estado, deve incluir os resultados anteriores no seu novo prompt.
4. Restrições de tempo de execução
A sandbox impõe um tempo limite (timeout) à execução do código. Se um cálculo demorar demasiado tempo, será interrompido. Isto implica:
- Sem loops infinitos (serão interrompidos)
- Sem cálculos extremamente longos (conjuntos de dados grandes, simulações pesadas)
- Sem operações de espera (
time.sleeppara longas durações)
O modelo está geralmente ciente destes limites e gera código otimizado, mas pedidos muito ambiciosos podem falhar devido ao tempo limite.
5. Limitações de memória
A sandbox dispõe de uma quantidade limitada de memória. Operações em volumes de dados muito grandes podem falhar:
- DataFrames do Pandas com milhões de linhas arriscam exceder a memória
- Matrizes NumPy de dimensão muito elevada podem causar problemas
- Operações que duplicam dados na memória aumentam o risco
Implicações para o desenvolvimento
O que a Execução de Código faz bem
- Cálculos matemáticos e estatísticos precisos
- Análise de conjuntos de dados de dimensão moderada (centenas a milhares de linhas)
- Verificação de fórmulas e algoritmos
- Geração de gráficos e visualizações
- Prototipagem rápida de lógica de cálculo
O que a Execução de Código não faz bem
- Processamento de grandes volumes de dados (big data)
- Interações com sistemas externos
- Cálculos iterativos através de múltiplos pedidos
- Aprendizagem automática (machine learning) e treino de modelos
- Operações longas (> alguns segundos)
Soluções para contornar limitações
Se precisar de ultrapassar estas restrições:
- Dados externos: utilize a Pesquisa na Web para obter dados e, em seguida, a Execução de Código para os analisar
- Grandes volumes: extraia uma amostra representativa e analise-a na sandbox; aplique depois os resultados ao conjunto completo no seu próprio ambiente
- Estado entre pedidos: guarde os resultados intermédios no lado do cliente e injete-os nos pedidos subsequentes
Pontos-chave
- A sandbox é isolada: sem rede, sem persistência, sem acesso ao sistema
- Cada execução é independente (sem estado)
- Aplicam-se limites de tempo e de memória
- A Execução de Código destaca-se em cálculos precisos e análise de dados moderados
- Para casos limite, combine a Execução de Código com outras ferramentas ou com a sua própria infraestrutura