Liivakast ja turvalisuse piirangud
Sellel lehel
Uuendatud 2. novembril 2026 OpenAI dokumentatsiooni põhjal: Code Interpreteri tööriist nõuab nüüd parameetrit
container(lisatud kõigile näidetele). Vaikimisi suletud konteinerivõrk saab nüüd avaneda domeenide lubatud nimekirja jaoks. Konteineri elutsükli reeglid (mälu, aegumine, taaskasutus) järgivad ametlikku juhendit. Sõnumiga seotud failid laaditakse üles eesmärgigauser_data, nagu OpenAI mudeli sisendite jaoks soovitab. Allikad: Code Interpreter · Container Network Access · Containers API · Files API.
Liivakast ja turvalisuse piirangud
Liivakasti piirangud ei ole vead, mida tuleks mööda hiilida: need on omadused, mis teevad genereeritud koodi käivitamise vastuvõetavaks. Võrgust isoleeritud keskkond lühikese eluea ja ressursipiirangutega ei saa sinu andmeid varastada, jätta olekut määramata ajaks alles ega tarbida ressursse piiramatult.
Nende piirangute eelnev tundmine hoiab sind võimatuks osutuva silumisega tegelemast. Kolmel korduval küsimusel – miks pip install ebaõnnestub, miks mu fail kadus kõnede vahel, miks mu töötlemine suure failiga kokku jookseb – on allpool vastused ja ükski neist pole viga.
Liivakasti arhitektuur
Code Interpreter käivitab koodi konteineris, mis on OpenAI poolt majutatud isoleeritud virtuaalmasin järgmiste omadustega:
- Võrk vaikimisi suletud: väljuvaid päringuid pole, välja arvatud sõnaselgelt avatud lubatud domeenide nimekiri (vt allpool)
- Lühike eluiga: konteiner aegub pärast 20-minutilist tegevusetust ja kõik selles olev kustutatakse seejärel
- Piiratud mälu: vaikimisi 1 GB või taotluse korral 4, 16 või 64 GB (
memory_limit), kusjuures igal tasemel on oma hinnakujundus
from openai import OpenAI
client = OpenAI()
# Ilma lubatud nimekirjata allalaadimine ebaõnnestub: võrguühendus puudub
response = client.responses.create(
model="gpt-5.6-terra",
input="Download the content of https://example.com using requests",
tools=[{"type": "code_interpreter", "container": {"type": "auto"}}]
)
# Mudel selgitab, et võrguühendus pole saadaval
print(response.output_text)
Mis on saadaval
Eelinstalleeritud teegid
OpenAI ei avalda konteineri pakettide ametlikku nimekirja ja see muutub aja jooksul. Arendaja poolt OpenAI foorumis avaldatud uuring novembris 2025 loendas 389 paketti, sealhulgas analüüsiks oodatavad teegid: andmete jaoks pandas, numpy, scipy ja statsmodels; visualiseerimiseks matplotlib, seaborn ja plotly; piltide jaoks Pillow; sümbolmatemaatika jaoks sympy; Exceli jaoks openpyxl. Eeldamise asemel lase mudelil need projekti alguses loetleda:
response = client.responses.create(
model="gpt-5.6-terra",
input="List the installed Python packages with their versions, "
"then display the Python version.",
tools=[{"type": "code_interpreter", "container": {"type": "auto"}}]
)
print(response.output_text)
Versioonid on sama olulised kui nimed: sama uuring näitas pandas 1.5.3, mis on vanem kui pandas 2.0. Kui sinu töötlemine sõltub hiljutisest funktsioonist, veendu selle olemasolus enne sellele tuginedes ehitamist.
Failisüsteem
Kood loeb ja kirjutab faile konteineri sees. Mudeli loodud failidele viidatakse selle vastuses ja need laaditakse alla kasutades 10. õppetükist pärit funktsioone fichiers_generes ja telecharger:
# Mudel saab luua faile konteineri sees
response = client.responses.create(
model="gpt-5.6-terra",
input="Create a CSV file with 100 lines of test data "
"(name, age, city, salary) and return it.",
tools=[{"type": "code_interpreter", "container": {"type": "auto"}}]
)
for ann in fichiers_generes(response):
telecharger(client, ann, ann.filename)
Mis on piiratud
Võrguühendus
Vaikimisi puudub konteineril väljuv juurdepääs: ei pip install, ei API väljakutseid, ei allalaadimisi. See on kõige struktuurnem piirang ja see on tahtlik: genereeritud kood ei saa midagi kuhugi saata. See, mida sinu töötlemine vajab, peab olema konteineris olemas või sinu poolt üles laaditud – ja kui andmed on veebis, toob veebiotsingu tööriist need sageli ise.
# Ilma lubatud nimekirjata (vaikjuhtum), võimatu:
# - requests.get(), urllib.request
# - socket, http.client
# - pip install (allalaadimisi pole)
# - Juurdepääs välistele API-dele
# - E-kirjade saatmine
Juurdepääsu avamine on olemas, kuid otsustatakse kahel tasandil. Administraator määrab esmalt organisatsiooni lubatud nimekirja armatuurlaual; iga päring deklareerib seejärel network_policy, mis saab seda ainult veelgi piirata – päring, mis küsib organisatsiooni nimekirjas puuduvat domeeni, ebaõnnestub.
response = client.responses.create(
model="gpt-5.6-terra",
input="Update pandas with pip, then display the installed version.",
tools=[{
"type": "code_interpreter",
"container": {
"type": "auto",
"network_policy": {
"type": "allowlist",
"allowed_domains": ["pypi.org", "files.pythonhosted.org"],
},
},
}],
)
Domeenide avamisel on hind ja OpenAI ütleb seda selgelt: see on uks andmete varastamiseks vihjesüsteemi süstimise (prompt injection) kaudu. Autoriseeri ainult usaldusväärseid domeene, mida ründaja ei saa kasutada andmete vastuvõtmiseks – ja hoia silm peal jagatud hostimisel, kus igaüks saab püsti panna serveri, mis logib sinu päringuid.
Püsivus kõnede vahel
Püsivuse puudumine üllatab enamikku kõnede aheldamisel: esimeses kõnes laaditud DataFrame teises enam ei eksisteeri. Täpne reegel sõltub režiimist auto: see loob uue konteineri, välja arvatud juhul, kui mudeli kontekst sisaldab juba Code Interpreteri kõnet, mille konteiner on veel aktiivne – sel juhul kasutatakse seda uuesti. Kaks sõltumatut kõnet töötavad seega kumbki oma omas, samas kui eelmisega aheldatud kõne (kasutades previous_response_id) leiab oma, kui see pole aegunud. Ühe kõne piires jagavad mitu koodi käivitust sama seanssi.
# Esimene kõne: loob faili
response1 = client.responses.create(
model="gpt-5.6-terra",
input="Create a variable x = 42 and save it to a file",
tools=[{"type": "code_interpreter", "container": {"type": "auto"}}]
)
# Teine kõne, esimesest sõltumatu: uus konteiner
response2 = client.responses.create(
model="gpt-5.6-terra",
input="Read the file created previously",
tools=[{"type": "code_interpreter", "container": {"type": "auto"}}]
)
# -> Viga: faili ei leitud
Tulemuste säilitamiseks kõnede vahel, sõltumata kontekstist, pane need töötlema samasse konteinerisse. Loo see selgesõnaliselt Containers API abil ja edasta selle ID igale kõnele: ühe sammu käigus loodud failid jäävad järgmise jaoks kättesaadavaks. Vaikimisi aegub see pärast 20-minutilist tegevusetust ja selle andmed lähevad seejärel jäädavalt kaduma: laadi alla, mida soovid säilitada, ja kustuta see ise.
def pipeline_avec_persistance(etapes: list[str]) -> list:
"""Executes successive steps in the same container."""
conteneur = client.containers.create(name="pipeline")
resultats = []
for etape in etapes:
response = client.responses.create(
model="gpt-5.6-terra",
input=etape,
tools=[{"type": "code_interpreter", "container": conteneur.id}],
)
resultats.append(response.output_text)
# Pärast kasulike failide allalaadimist (õppetükk 10)
client.containers.delete(conteneur.id)
return resultats
Ära tagasta genereeritud faile kui input_file: nende ID-d (cfile_…) viitavad konteineri failidele, mitte Files API failidele.
Mälu ja mahukas töötlemine
Dokumentatsioon ei avalda maksimaalset täitmise kestust; konkreetne piirang on konteineri mälu, mis valitakse loomisel ja kehtib kogu selle eluea jooksul. Suure faili jaoks vali sobiv tase ja lase töö osadeks jagada. Sellest kaugemale – mudeli treenimine, massiivsed arvutused – pead kasutama oma taristut, kusjuures konteiner jääb interaktiivse analüüsi tööriistaks.
# Muster mahukaks töötlemiseks: rohkem mälu, töö jagamine
with open("transactions.csv", "rb") as f:
fichier = client.files.create(file=f, purpose="user_data")
response = client.responses.create(
model="gpt-5.6-terra",
input=[{
"role": "user",
"content": [
{"type": "input_text", "text": (
"Process this 500,000-line CSV file in batches of 50,000. "
"For each batch, calculate statistics and accumulate results."
)},
{"type": "input_file", "file_id": fichier.id}
]
}],
tools=[{"type": "code_interpreter", "container": {"type": "auto", "memory_limit": "4g"}}],
instructions="If processing risks being long, split it into steps "
"and display progress."
)
Andmete turvalisus
Tundlikud andmed
Konteinerisse kopeeritud andmed kustutatakse selle aegumisel või kustutamisel. See ei kehti Files API kaudu üles laaditud faili kohta: see jääb sinna, kuni sa selle kustutad, välja arvatud juhul, kui määrad aegumise (expires_after, vahemikus üks tund kuni kolmkümmend päeva). Ja vastavuspõhjendus ei peatu seal: sinu andmed on lahkunud sinu taristust, et töödelda kolmanda osapoole poolt. Pseudonüümimine enne saatmist maksab paar rida koodi ja vähendab seda, mis lahkub – sest kliendi ID, mis kunagi ei lahku, ei saa probleemi tekitada.
Võtmega räsi (HMAC) annab ühest saatmisest teiseni stabiilsed pseudonüümid, mida keegi ei saa ilma võtmeta algsete väärtustega siduda. GDPR-i kohaselt jääb tulemus pseudonüümitud isikuandmeteks, mitte anonüümseks: võti peab jääma sinu juurde.
import hashlib
import hmac
import os
import pandas as pd
CLE = os.environ["CLE_PSEUDONYMISATION"].encode() # saladus hoitakse väljaspool koodi
def pseudonyme(valeur) -> str:
return hmac.new(CLE, str(valeur).encode(), hashlib.sha256).hexdigest()[:16]
def analyser_donnees_sensibles(fichier_path: str, colonnes_a_masquer: list[str]):
"""Pseudonymizes data before sending to Code Interpreter."""
df = pd.read_csv(fichier_path)
for col in colonnes_a_masquer:
if col in df.columns:
df[col] = df[col].map(pseudonyme)
fichier_pseudo = "/tmp/donnees_pseudonymisees.csv"
df.to_csv(fichier_pseudo, index=False)
# Saada automaatse aegumisega pärast ühte tundi
with open(fichier_pseudo, "rb") as f:
fichier = client.files.create(
file=f,
purpose="user_data",
expires_after={"anchor": "created_at", "seconds": 3600},
)
response = client.responses.create(
model="gpt-5.6-terra",
input=[{
"role": "user",
"content": [
{"type": "input_text", "text": "Analyze trends in this data"},
{"type": "input_file", "file_id": fichier.id}
]
}],
tools=[{"type": "code_interpreter", "container": {"type": "auto"}}]
)
client.files.delete(fichier.id) # ilma aegumist ootamata
return response.output_text
Genereeritud kood
Isolatsioon kaitseb sinu süsteemi, mitte tulemuse õigsust: kood käivitatakse OpenAI-s, utiliseeritavas konteineris ja ei puuduta kunagi sinu masinaid. Risk nihkub sellele, mida sa selle väljunditega teed. Kui tood koodi tagasi, et seda oma poolt käivitada, vaata see üle nagu kolmanda osapoole kood. Ja kui konteineril on lubatud nimekiri, pea meeles, et pahatahtlik fail võib sisaldada juhiseid, mis sunnivad mudelit saatma andmeid nendele domeenidele.
Käivitamisvigade käsitlemine
Kood võib liivakastis ebaõnnestuda. Mudel püüab üldjuhul parandada:
response = client.responses.create(
model="gpt-5.6-terra",
input="Calculate the inverse matrix of a singular matrix [[1,2],[2,4]]",
tools=[{"type": "code_interpreter", "container": {"type": "auto"}}],
instructions="If the code produces an error, explain why "
"and propose an alternative."
)
# Mudel käivitab koodi, tuvastab LinAlgError,
# selgitab seejärel, et maatriks on singulaarne ja pakub
# Moore-Penrose'i pseudopöördmaatriksi
Parimad tavad
# 1. Ole oma juhistes konkreetne
# Halb:
input_vague = "Analyze this data"
# Hea:
input_precis = ("Load this CSV with pandas. "
"Calculate the mean, median, and standard deviation of the 'amount' column. "
"Identify values greater than 3 standard deviations. "
"Generate a boxplot.")
# 2. Küsi kommenteeritud koodi
instructions = "Comment each step of the code. Display intermediate results."
# 3. Käitle suuri faile
instructions_lot = ("If the file exceeds 100,000 lines, "
"work on a representative sample of 10,000 lines "
"and indicate this in your response.")
Peamised punktid
- Konteiner on isoleeritud: võrk vaikimisi suletud, mälu piiratud, aegumine pärast 20-minutilist tegevusetust
- OpenAI ei avalda pakettide nimekirja: lase mudelil see loetleda
- Domeenide lubatud nimekiri avaneb kahel tasandil (organisatsioon, seejärel päring) ja seab ohtu andmete varastamise: pane sinna ainult usaldusväärsed domeenid
- Sammude aheldamiseks kasuta sama konteinerit uuesti (
client.containers.create, seejärel selle ID igal kõnel) ja kustuta see lõpus - Pseudonüümi tundlikud andmed enne saatmist ja kustuta üles laaditud failid pärast kasutamist
- Mudel käsitleb käivitamisvigu ja püüab ise ennast parandada