Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Bezpečnostní omezení sandboxu

Lekce 14 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Izolované prostředí by design
  2. Pět základních omezení
  3. Důsledky pro návrh
  4. Obcházení omezení
  5. Klíčové poznatky

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.sleep pro 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