Bezpečnostní omezení sandboxu
Na této stránce
Izolované prostředí by design
Pythonovský sandbox pro spouštění kódu je navržen s důrazem na bezpečnost. Kód běží v izolovaném prostředí, které chrání jak infrastrukturu xAI, tak tvá data. Pochopení těchto omezení je klíčové pro návrh správně fungujících integrací a pro určení, kdy je spouštění kódu pro tvé potřeby vhodné.
Pět základních omezení
1. Žádný přístup k síti
Sandbox nemá žádné připojení k internetu ani k externí síti. Kód nemůže:
- Odesílat HTTP požadavky (žádné
requests, žádnéurllib) - Připojovat se ke vzdáleným databázím
- Volat externí API
- Stahovat soubory z webu
- Odesílat e-maily nebo oznámení
Toto omezení je nejpřísnější. Pokud tvůj případ použití vyžaduje externí data, musíš je poskytnout v promptu nebo je předem získat pomocí funkce Web Search.
2. Omezený přístup k souborovému systému
Kód běží v dočasném adresáři s omezeným přístupem k souborovému systému:
- Čtení/zápis pouze v dočasném pracovním adresáři
- Žádný přístup k systémovým souborům
- Žádný přístup do adresářů jiných uživatelů
- Soubory vytvořené během běhu jsou po dokončení smazány
3. Dočasný a bezstavový kontext
Každé spuštění je nezávislé. Mezi dvěma požadavky na API nedochází k přetrvávání stavu:
- Proměnné definované během jednoho spuštění v dalším neexistují
- Vytvořené soubory jsou smazány
- Knihovny načtené do paměti jsou resetovány
- Neuchovává se žádná historie spuštění
To znamená, že nemůžeš vytvořit interaktivní relaci, kde by výsledky jednoho výpočtu automaticky navazovaly na další. Chcete-li tento stav simulovat, musíš předchozí výsledky zahrnout do svého nového promptu.
4. Časová omezení spuštění
Sandbox ukládá na spuštění kódu časový limit. Pokud výpočet trvá příliš dlouho, bude zastaven. To implikuje:
- Žádné nekonečné smyčky (budou zastaveny)
- Žádné extrémně dlouhé výpočty (velké datové sady, náročné simulace)
- Žádné operace čekání (
time.sleeppro dlouhá trvání)
Model si těchto limitů obecně uvědomuje a píše optimalizovaný kód, ale velmi ambiciózní požadavky mohou kvůli vypršení časového limitu selhat.
5. Omezení paměti
Sandbox má k dispozici omezené množství paměti. Operace s velmi velkými objemy dat mohou selhat:
- Pandas DataFrame s miliony řádků riskují překročení paměti
- NumPy matice s velmi velkými rozměry mohou způsobit problémy
- Operace, které zdvojují data v paměti, zvyšují riziko selhání
Důsledky pro návrh
Co spouštění kódu zvládá dobře
- Přesné matematické a statistické výpočty
- Analýza datových sad střední velikosti (stovky až tisíce řádků)
- Ověřování vzorců a algoritmů
- Generování grafů a vizualizací
- Rychlé prototypování výpočetní logiky
Co spouštění kódu nezvládá dobře
- Zpracování velkých objemů dat (big data)
- Interakce s externími systémy
- Iterativní výpočty napříč více požadavky
- Strojové učení a trénování modelů
- Dlouhé operace (> několik sekund)
Obcházení omezení
Pokud potřebuješ tato omezení překonat:
- Externí data: použij Web Search k získání dat a následně Code Execution k jejich analýze
- Velké objemy: extrahuj reprezentativní vzorek, analyzuj jej v sandboxu a poté výsledky aplikuj na celou sadu ve svém vlastním prostředí
- Stav mezi požadavky: ukládej průběžné výsledky na straně klienta a vkládej je do následujících požadavků
Klíčové poznatky
- Sandbox je izolovaný: žádná síť, žádná perzistence, žádný přístup k systému
- Každé spuštění je nezávislé (bezstavové)
- Platí limity pro čas i paměť
- Spouštění kódu vyniká v přesných výpočtech a analýze dat středního rozsahu
- Pro hraniční případy kombinuj spouštění kódu s dalšími nástroji nebo vlastní infrastrukturou