Beveiligingsbeperkingen van de sandbox
Op deze pagina
Een per ontwerp geïsoleerde omgeving
De Python-sandbox voor code-uitvoering is ontworpen met het oog op veiligheid. Code wordt uitgevoerd in een geïsoleerde omgeving die zowel de infrastructuur van xAI als uw gegevens beschermt. Inzicht in deze beperkingen is essentieel om integraties te ontwerpen die correct werken en om te bepalen wanneer code-uitvoering geschikt is voor uw behoeften.
De vijf fundamentele beperkingen
1. Geen netwerktoegang
De sandbox heeft geen verbinding met het internet of een extern netwerk. Code kan niet:
- HTTP-verzoeken uitvoeren (geen
requests, geenurllib) - Verbinden met externe databases
- Externe API’s aanroepen
- Bestanden van het web downloaden
- E-mails of meldingen verzenden
Deze beperking is het meest restrictief. Als uw use case externe gegevens vereist, moet u deze in de prompt opnemen of vooraf Web Search gebruiken om ze op te halen.
2. Beperkte toegang tot het bestandssysteem
Code wordt uitgevoerd in een tijdelijke map met beperkte toegang tot het bestandssysteem:
- Alleen lezen/schrijven in de tijdelijke werkmap
- Geen toegang tot systeembestanden
- Geen toegang tot mappen van andere gebruikers
- Aangemaakte bestanden worden na uitvoering verwijderd
3. Tijdelijke en stateless context
Elke uitvoering is onafhankelijk. Er is geen persistentie tussen twee API-verzoeken:
- Variabelen die tijdens één uitvoering zijn gedefinieerd, bestaan niet bij de volgende
- Aangemaakte bestanden worden verwijderd
- Bibliotheken die in het geheugen zijn geladen, worden gereset
- Er wordt geen uitvoeringsgeschiedenis bijgehouden
Dit betekent dat u geen interactieve sessie kunt opbouwen waarbij resultaten van de ene berekening worden doorgegeven aan de volgende, althans niet automatisch. Om deze state te simuleren, moet u eerdere resultaten in uw nieuwe prompt opnemen.
4. Beperkingen op uitvoeringstijd
De sandbox legt een time-out op aan de code-uitvoering. Als een berekening te lang duurt, wordt deze gestopt. Dit impliceert:
- Geen oneindige lussen (deze worden gestopt)
- Geen extreem lange berekeningen (grote datasets, zware simulaties)
- Geen wachthandelingen (
time.sleepvoor lange periodes)
Het model is zich over het algemeen bewust van deze limieten en schrijft geoptimaliseerde code, maar zeer ambitieuze verzoeken kunnen mislukken vanwege een time-out.
5. Geheugenbeperkingen
De sandbox heeft een beperkte hoeveelheid geheugen. Bewerkingen op zeer grote datavolumes kunnen mislukken:
- Pandas DataFrames met miljoenen rijen lopen het risico het geheugen te overschrijden
- NumPy-matrices met zeer grote dimensies kunnen problemen veroorzaken
- Bewerkingen die gegevens in het geheugen dupliceren, verhogen het risico
Implicaties voor het ontwerp
Waar code-uitvoering goed in is
- Precieze wiskundige en statistische berekeningen
- Analyse van datasets van gemiddelde grootte (honderden tot duizenden rijen)
- Verificatie van formules en algoritmen
- Genereren van grafieken en visualisaties
- Snel prototypen van berekeningslogica
Waar code-uitvoering minder goed in is
- Verwerken van grote datavolumes (big data)
- Interacties met externe systemen
- Iteratieve berekeningen over meerdere verzoeken heen
- Machine learning en modeltraining
- Lange bewerkingen (> enkele seconden)
Oplossingen voor beperkingen
Als u deze beperkingen moet omzeilen:
- Externe gegevens: gebruik Web Search om gegevens op te halen en vervolgens Code Execution om ze te analyseren
- Grote volumes: extraher een representatieve steekproef en analyseer deze in de sandbox; pas de resultaten vervolgens in uw eigen omgeving toe op de volledige set
- State tussen verzoeken: sla tussenresultaten client-side op en injecteer ze in daaropvolgende verzoeken
Belangrijkste punten
- De sandbox is geïsoleerd: geen netwerk, geen persistentie, geen systeemtoegang
- Elke uitvoering is onafhankelijk (stateless)
- Er gelden limieten voor tijd en geheugen
- Code-uitvoering blinkt uit in precieze berekeningen en gegevensanalyse van gemiddelde omvang
- Combineer voor randgevallen Code Execution met andere tools of uw eigen infrastructuur