Ограничения за сигурност в пясъчника
На тази страница
Изолирана среда по дизайн
Пясъчникът за изпълнение на Python код е проектиран с оглед на сигурността. Кодът се изпълнява в изолирана среда, която защитава както инфраструктурата на xAI, така и Вашите данни. Разбирането на тези ограничения е от съществено значение за проектирането на правилно функциониращи интеграции и за преценката кога изпълнението на код отговаря на Вашите нужди.
Петте фундаментални ограничения
1. Липса на мрежов достъп
Пясъчникът няма връзка с Интернет или външна мрежа. Кодът не може:
- Да прави HTTP заявки (няма
requests, нямаurllib) - Да се свързва с отдалечени бази данни
- Да извиква външни API
- Да изтегля файлове от уеб
- Да изпраща имейли или известия
Това ограничение е най-рестриктивното. Ако Вашият случай на употреба изисква външни данни, трябва да ги предоставите в подкана (prompt) или предварително да използвате Web Search, за да ги получите.
2. Ограничен достъп до файловата система
Кодът се изпълнява във временна директория с ограничен достъп до файловата система:
- Четене/запис само във временната работна директория
- Няма достъп до системни файлове
- Няма достъп до директории на други потребители
- Създадените файлове се изтриват след изпълнението
3. Временен и безсъстоятелен контекст
Всяко изпълнение е независимо. Няма постоянство между две API заявки:
- Променливите, дефинирани по време на едно изпълнение, не съществуват в следващото
- Създадените файлове се изтриват
- Библиотеките, заредени в паметта, се нулират
- Не се води история на изпълненията
Това означава, че не можете да изградите интерактивна сесия, при която резултатите от едно изчисление да се използват автоматично в следващото. За да симулирате това състояние, трябва да включите предишните резултати в новата си подкана.
4. Ограничения за време на изпълнение
Пясъчникът налага таймаут върху изпълнението на кода. Ако едно изчисление отнеме твърде много време, то се спира. Това означава:
- Никакви безкрайни цикли (те ще бъдат спрени)
- Никакви изключително дълги изчисления (големи набори от данни, тежки симулации)
- Никакви операции на изчакване (
time.sleepза дълги периоди)
Моделът обикновено е наясно с тези лимити и пише оптимизиран код, но много амбициозни заявки може да се провалят поради таймаут.
5. Ограничения на паметта
Пясъчникът разполага с ограничено количество памет. Операциите върху много големи обеми данни може да се провалят:
- Pandas DataFrames с милиони редове рискуват да надхвърлят паметта
- NumPy матрици с много големи размерности могат да причинят проблеми
- Операциите, които дублират данни в паметта, увеличават риска
Последици за проектирането
Какво изпълнението на код прави добре
- Прецизни математически и статистически изчисления
- Анализ на набори от данни с умерен размер (стотици до хиляди редове)
- Проверка на формули и алгоритми
- Генериране на графики и визуализации
- Бързо прототипиране на логика за изчисления
Какво изпълнението на код не прави добре
- Обработка на големи обеми данни (big data)
- Взаимодействия с външни системи
- Итеративни изчисления в рамките на множество заявки
- Машинно обучение и трениране на модели
- Дълги операции (> няколко секунди)
Заобикаляне на ограниченията
Ако трябва да надвишите тези ограничения:
- Външни данни: използвайте Web Search, за да получите данни, след което използвайте изпълнение на код за техния анализ
- Големи обеми: извлечете представителна извадка и я анализирайте в пясъчника, след което приложете резултатите към целия набор във Вашата собствена среда
- Състояние между заявките: съхранявайте междинните резултати на страната на клиента и ги инжектирайте в последващите заявки
Ключови изводи
- Пясъчникът е изолиран: няма мрежа, няма постоянство, няма достъп до системата
- Всяко изпълнение е независимо (без състояние)
- Прилагат се лимити за време и памет
- Изпълнението на код се отличава с прецизни изчисления и анализ на данни с умерен размер
- За специфични случаи комбинирайте изпълнението на код с други инструменти или Ваша собствена инфраструктура