Автор: @41five
Box Mount тепер доступний у режимі приватного прев'ю.
Якщо ви створюєте AI-агента, який працює в пісочниці, змусити модель виконувати корисну роботу — це лише частина завдання. Агенту все одно потрібні документи для роботи, інструменти для їх обробки та місце, куди зберігати створені файли.
На перший погляд, переміщення цих документів виглядає як кілька API-викликів: завантажити вхідні дані, запустити агента, вивантажити результат. Але цей шар стає значно складнішим, коли файли можуть змінюватися під час робочого процесу, коли людям потрібно перевіряти результати або коли кілька агентів працюють із одним і тим самим контентом. Тоді вам доводиться ще й керувати синхронізацією, версіями, конфліктами та повторними спробами.
Box Mount створений саме для цієї частини робочого процесу. Він надає пісочниці агента POSIX-сумісний робочий простір Box, дозволяючи коду та інструментам усередині пісочниці працювати з контентом Box через звичні шляхи до файлів. Box Mount забезпечує передачу даних в обох напрямках, тоді як Box залишається контрольованою системою обліку.
Коли Box Mount — правильний вибір
Box Mount не призначений замінити кожен виклик Box API чи MCP. Якщо вашому агенту потрібно лише отримати документ і додати його до промпту, цих інтерфейсів може бути цілком достатньо.
Різниця полягає в тому, чи є документи просто контекстом, чи частиною робочого середовища агента.
Уявіть агента, який переглядає папку з контрактами, запускає інструменти обробки документів, створює меморандум за результатами перевірки, а потім чекає, поки юрист внесе зміни. Або робочий процес RFP, який бере дані з бібліотеки затверджених відповідей, створює чернетку та повертає її на юридичну перевірку й перевірку безпеки.
У таких випадках агент робить більше, ніж одноразово отримує контент. Він працює з набором файлів у зовнішньому середовищі виконання.
Саме на цей патерн орієнтований Box Mount: розробник готує пісочницю для агента, переносить контент Box у це середовище, а потім повертає результати роботи агента назад у Box.
Подивіться Box Mount у дії
Це коротке демо показує додаток для перевірки контрактів, який використовує Box Mount для перенесення контенту Box у пісочницю E2B, запуску агента в цьому робочому просторі та синхронізації завершеної перевірки назад у Box для перегляду людиною.
Тут показано багатагентну перевірку deal room, де Box Mount переносить корпоративний контент у пісочницю OpenAI Agents API, паралельно запускає головного агента та трьох спеціалізованих агентів для роботи з п'ятьма вихідними файлами й автоматично синхронізує чотири звіти назад у Box після внесення змін до базового MSA.
Це демо показує перевірку опитувальника з безпеки: Box Mount переносить затверджені політики у мікро-VM Vercel Sandbox, агент обробляє 12 пунктів, знаходить підтвердження для 10 правильних відповідей і позначає 2 для перевірки людиною, після чого готова книга Excel автоматично синхронізується назад у Box.
Це демо демонструє створення меморандуму due diligence для deal room: Box Mount надає агенту в пісочниці DigitalOcean звичайні шляхи до файлів хмарного контенту Box, що дозволяє читати документи deal room локально та записувати готовий меморандум назад у Box без написання логіки завантаження чи вивантаження.
Звичний робочий простір усередині пісочниці
Після монтування папки Box агент бачить звичайний каталог:
1/mnt/box2├── Incoming/3│ └── Acme-MSA.docx4├── Playbook/5│ └── approved-contract-playbook.md6└── Reviewed/
З цього моменту наявні бібліотеки та інструменти командного рядка можуть працювати з контентом без потреби створювати окремий інструмент Box для кожної операції. Наприклад, Node-додаток може використовувати ті самі API файлової системи, що й для локальних файлів:
1import { readFile, writeFile } from "node:fs/promises";23const playbook = await readFile(4 "/mnt/box/Playbook/approved-contract-playbook.md",5 "utf8",6);78const review = await reviewContract({9 contractPath: "/mnt/box/Incoming/Acme-MSA.docx",10 playbook,11});1213await writeFile(14 "/mnt/box/Reviewed/Acme-MSA-review.md",15 review,16);
Останній запис — це просто звичайна файлова операція з точки зору додатка. Box Mount синхронізує новий результат перевірки з Box, де людина може відкрити його, відредагувати, призначити завдання або створити нову версію.
Якщо хтось оновлює файл у Box, поки пісочниця ще працює, ця зміна може потрапити назад у змонтований робочий простір для наступного кроку агента. Це створює спільне робоче середовище для агентів і людей без необхідності для розробників писати власну логіку переміщення та синхронізації для кожного файлу.
Це також робить робочий процес менш залежним від конкретної моделі чи фреймворку для агентів. У пісочниці може працювати агент OpenAI, агент Anthropic, LangGraph, CrewAI, Python-скрипт, LibreOffice CLI або комбінація інструментів. Поки інструмент вміє працювати з файлами, він зможе працювати зі змонтованим робочим простором.
Як усе це працює разом
Ваш продукт або оркестратор відповідає за підготовку пісочниці та запуск агента. Box Mount працює всередині цієї пісочниці як headless-компонент синхронізації, забезпечуючи інтерфейс файлової системи та взаємодіючи з Box через Box API.
Агент працює через змонтований шлях, а не звертається до Box для кожної операції з документами. Box Mount підтримує актуальність папки, вивантажує зміни, виявляє конфліктні оновлення та виконує фінальну синхронізацію під час демонтування робочого простору.
Box продовжує забезпечувати контентний рівень, включно з правами доступу, версіями, класифікаціями, політиками зберігання, захистом Shield та історією аудиту. Пісочниця містить синхронізовану робочу копію, тому розробникам усе одно слід керувати цим середовищем і його локальними даними відповідно до власних вимог безпеки.
Продукт клієнта готує пісочницю та запускає агента. Box Mount з'єднує файловий робочий простір агента з Box через Box API.
Як використовувати Box Mount
Базовий робочий процес Box Mount потребує лише кількох команд. Спочатку налаштуйте свої облікові дані Box:
1box-mount config
Змонтуйте папку Box у пісочницю агента:
1mkdir -p /mnt/box2box-mount mount "/mnt/box" "<box-folder-id>"
Після монтування агент може використовувати звичайні інструменти файлової системи:
1find /mnt/box -type f2cat /mnt/box/Playbook/approved-contract-playbook.md3cp generated-review.md /mnt/box/Reviewed/
Ви можете перевірити активне монтування під час роботи агента:
1box-mount status
Коли виконання завершено, демонтуйте робочий простір і виконайте фінальну синхронізацію:
1box-mount unmount "/mnt/box"
Автентифікація та підготовка середовища залежатимуть від того, як ваш додаток запускає пісочниці. Документація для приватного прев'ю, що постачається разом із бінарним файлом, описує всі доступні варіанти конфігурації.
Що можна створити?
Перевірка контрактів — лише один приклад. Агент може порівнювати вхідні угоди із затвердженим playbook, записувати висновки назад у Box і передавати результат юристу. Якщо юрист змінить перевірку в Box, агент побачить оновлений файл у своєму робочому середовищі.
Цей самий патерн підходить для підготовки пропозицій і RFP, аналізу deal room, створення брифінгів для керівництва, синтезу досліджень, перевірки на відповідність вимогам та інших робочих процесів із великою кількістю документів. Кілька агентів також можуть працювати через спільну папку Box — наприклад, один створює чернетку, інший її перевіряє, а людина ухвалює фінальне рішення.
Модель і робочий процес можуть змінюватися, але базовий патерн залишається незмінним: контент Box потрапляє у зовнішню пісочницю, стає частиною робочого середовища агента, а результати роботи повертаються в Box.
Дослідіть приклад додатка
Приклад перевірки контракту з Box Mount демонструє повний робочий процес із використанням E2B.
Додаток створює пісочницю, встановлює Box Mount, монтує робочий простір контрактів Box і запускає Box AI або агента OpenAI. Потім він синхронізує згенеровану перевірку назад у Box, за бажанням призначає її людині-рецензенту та залишає пісочницю запущеною, щоб розробники могли перевірити результат перед її видаленням.
Наразі репозиторій є приватним і не містить бінарного файлу Box Mount. Учасникам приватного прев'ю потрібно буде отримати доступ до репозиторію та розмістити наданий їм бінарний файл у каталозі private/ проєкту перед запуском прикладу.
Приєднуйтесь до приватного прев'ю
Box Mount ще на ранній стадії, і ми шукаємо розробників, які створюють (або починають досліджувати) робочі процеси з агентами, що працюють у пісочницях із контентом Box.
Якщо це схоже на вашу архітектуру, ми хотіли б дізнатися, як ви переміщуєте контент сьогодні, що працює у вашій пісочниці та де поточний підхід починає створювати проблеми. Учасники приватного прев'ю отримають бінарний файл Box Mount та інструкції з налаштування, щоб випробувати його у власних робочих процесах.
https://bit.ly/box-mount-preview
Якщо контент Box має стати частиною робочого середовища вашого агента, ми будемо раді побачити, що ви створите.
