Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Restrições de segurança da sandbox

Aula 14 de 16 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. Um ambiente isolado por conceção
  2. As cinco restrições fundamentais
  3. Implicações para o desenvolvimento
  4. Soluções para contornar limitações
  5. Pontos-chave

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, sem urllib)
  • 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.sleep para 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