Sandboxin turvallisuusrajoitukset
Tällä sivulla
Suunnitelmallisesti eristetty ympäristö
Code Execution -Python-sandbox on suunniteltu turvallisuus edellä. Koodi suoritetaan eristetyssä ympäristössä, joka suojaa sekä xAI:n infrastruktuuria että dataasi. Näiden rajoitusten ymmärtäminen on välttämätöntä, jotta voit suunnitella toimivia integraatioita ja tietää, milloin Code Execution sopii tarpeisiisi.
Viisi perusrajoitusta
1. Ei verkkoyhteyttä
Sandboxilla ei ole yhteyttä internetiin tai ulkoiseen verkkoon. Koodi ei voi:
- Tehdä HTTP-pyyntöjä (ei
requests, eiurllib) - Yhdistää etätietokantoihin
- Kutsua ulkoisia API-rajapintoja
- Ladata tiedostoja verkosta
- Lähettää sähköposteja tai ilmoituksia
Tämä rajoitus on kaikkein tiukin. Jos käyttötapauksesi vaatii ulkoista dataa, sinun on syötettävä se kehotteeseen tai haettava se ennalta Web Search -työkalulla.
2. Rajoitettu tiedostojärjestelmän käyttö
Koodi suoritetaan väliaikaisessa hakemistossa, jossa tiedostojärjestelmän käyttö on rajoitettua:
- Luku- ja kirjoitusoikeus vain väliaikaiseen työhakemistoon
- Ei pääsyä järjestelmätiedostoihin
- Ei pääsyä muiden käyttäjien hakemistoihin
- Suoritusten jälkeen luodut tiedostot poistetaan
3. Väliaikainen ja tilaton konteksti
Jokainen suoritus on itsenäinen. Kahden API-pyynnön välillä ei ole pysyvyyttä:
- Yhden suorituksen aikana määritellyt muuttujat eivät ole olemassa seuraavassa
- Luodut tiedostot poistetaan
- Muistiin ladatut kirjastot nollataan
- Suoritushistoriaa ei säilytetä
Tämä tarkoittaa, että et voi rakentaa interaktiivista istuntoa, jossa yhden laskennan tulokset syötettäisiin automaattisesti seuraavaan. Tämän tilan simuloimiseksi sinun on sisällytettävä edelliset tulokset uuteen kehotteeseesi.
4. Suoritusajan rajoitukset
Sandbox asettaa koodin suoritukselle aikakatkon. Jos laskenta kestää liian kauan, se pysäytetään. Tästä seuraa:
- Ei äärettömiä silmukoita (ne pysäytetään)
- Ei erittäin pitkiä laskentoja (suuret datajoukot, raskaat simulaatiot)
- Ei odotusoperaatioita (
time.sleeppitkillä kestolla)
Malli on yleensä tietoinen näistä rajoista ja kirjoittaa optimoitua koodia, mutta erittäin vaativat pyynnöt voivat epäonnistua aikakatkon vuoksi.
5. Muistirajoitukset
Sandboxin käytettävissä oleva muisti on rajallinen. Hyvin suurten datamäärien käsittely voi epäonnistua:
- Miljoonia rivejä sisältävät Pandas DataFramet voivat ylittää muistirajan
- Erittäin suurulotteiset NumPy-matriisit voivat aiheuttaa ongelmia
- Operaatiot, jotka duplikoivat dataa muistissa, kasvattavat riskiä
Suunnitteluvaikutukset
Missä Code Execution on hyvä
- Tarkat matemaattiset ja tilastolliset laskelmat
- Kohtuukokoisten datajoukkojen analyysi (sadoista tuhansiin riveihin)
- Kaavojen ja algoritmien varmistus
- Kaavioiden ja visualisointien tuottaminen
- Laskentalogiikan nopea prototyyppaus
Missä Code Execution ei ole hyvä
- Suurten datamäärien (big data) käsittely
- Vuorovaikutus ulkoisten järjestelmien kanssa
- Iteratiiviset laskelmat useiden pyyntöjen yli
- Koneoppiminen ja mallien kouluttaminen
- Pitkät operaatiot (> muutama sekunti)
Rajoitusten kiertäminen
Jos sinun on ylitettävä nämä rajoitukset:
- Ulkoiset data: Käytä Web Searchia datan hakemiseen ja sen jälkeen Code Executionia sen analysoimiseen.
- Suuret määrät: Poimi edustava otos ja analysoi se sandboxissa, ja sovella tuloksia koko aineistoon omassa ympäristössäsi.
- Tila pyyntöjen välillä: Tallenna välitulokset asiakaspuolelle ja syötä ne myöhempiin pyyntöihin.
Keskeiset asiat
- Sandbox on eristetty: ei verkkoyhteyttä, ei pysyvyyttä, ei järjestelmäpääsyä
- Jokainen suoritus on itsenäinen (tilaton)
- Aika- ja muistirajoitukset ovat voimassa
- Code Execution loistaa tarkoissa laskelmissa ja kohtuukokoisen datan analyysissä
- Poikkeustapauksissa yhdistä Code Execution muihin työkaluihin tai omaan infrastruktuuriisi