Escrito por @41five
O Box Mount agora está disponível em prévia privada.
Se você está construindo um agente de IA que roda dentro de um sandbox, fazer o modelo executar um trabalho útil é apenas parte da tarefa. O agente ainda precisa de documentos para trabalhar, ferramentas para aplicar a eles e um lugar para guardar os arquivos que cria.
À primeira vista, mover esses documentos pode parecer apenas algumas chamadas de API: baixar a entrada, rodar o agente e enviar o resultado. Mas essa camada fica mais complicada quando os arquivos podem mudar durante o fluxo de trabalho, quando as pessoas precisam revisar o resultado ou quando vários agentes compartilham o mesmo conteúdo. Aí você também passa a lidar com sincronização, versões, conflitos e retentativas.
O Box Mount foi criado para essa parte do fluxo de trabalho. Ele oferece ao sandbox do agente um espaço de trabalho do Box compatível com POSIX, permitindo que códigos e ferramentas dentro do sandbox trabalhem com o conteúdo do Box por meio de caminhos de arquivo familiares. O Box Mount cuida do movimento nas duas direções, enquanto o Box continua sendo o sistema de registro governado.
Quando o Box Mount é a escolha certa
O Box Mount não serve para substituir todas as chamadas de API ou MCP do Box. Se o seu agente só precisa recuperar um documento e adicioná-lo a um prompt, essas interfaces já podem oferecer tudo o que você precisa.
A diferença está em saber se os documentos são apenas contexto ou se fazem parte do ambiente de trabalho do agente.
Imagine um agente que revisa uma pasta de contratos, executa ferramentas de processamento de documentos, cria um memorando de revisão e depois espera que um advogado faça alterações. Ou um fluxo de RFP que puxa dados de uma biblioteca de respostas aprovadas, cria um rascunho e o envia de volta para revisão jurídica e de segurança.
Nesses casos, o agente faz mais do que apenas recuperar o conteúdo uma vez. Ele trabalha com uma coleção de arquivos dentro de um runtime externo.
Esse é o padrão que o Box Mount atende: um desenvolvedor provisiona um sandbox de agente, traz o conteúdo do Box para esse ambiente e devolve o trabalho do agente para o Box.
Veja o Box Mount em ação
Esta demonstração rápida mostra um aplicativo de revisão de contratos usando o Box Mount para levar o conteúdo do Box para um sandbox E2B, rodar um agente nesse espaço de trabalho e sincronizar a revisão finalizada de volta ao Box para análise humana.
Isso mostra uma revisão de deal room com múltiplos agentes usando o Box Mount para levar conteúdo corporativo a um sandbox da API OpenAI Agents, rodar um agente líder e três agentes especialistas em paralelo sobre cinco arquivos de origem e sincronizar quatro relatórios de volta ao Box automaticamente quando o MSA subjacente é revisado.
Esta demonstração mostra uma revisão de questionário de segurança usando o Box Mount para levar documentos de políticas aprovadas a uma microVM do Vercel Sandbox, rodar um agente sobre 12 itens para apresentar evidências de 10 respostas aprovadas e sinalizar 2 para revisão humana, além de sincronizar a planilha Excel finalizada de volta ao Box automaticamente.
Esta demonstração mostra um memorando de diligência de deal room usando o Box Mount para dar a um agente em sandbox da DigitalOcean caminhos de arquivo comuns para o conteúdo na nuvem do Box, ler documentos do deal room localmente e gravar o memorando finalizado de volta no Box sem precisar criar nenhuma lógica de download ou upload.
Um espaço de trabalho familiar dentro do sandbox
Depois que uma pasta do Box é montada, o agente vê um diretório comum:
1/mnt/box2├── Incoming/3│ └── Acme-MSA.docx4├── Playbook/5│ └── approved-contract-playbook.md6└── Reviewed/
A partir daí, bibliotecas e ferramentas de linha de comando existentes podem trabalhar com o conteúdo sem precisar de uma ferramenta específica do Box para cada operação. Um aplicativo Node, por exemplo, pode usar as mesmas APIs de sistema de arquivos que usaria para arquivos locais:
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);
Essa última gravação é apenas uma operação de arquivo normal do ponto de vista do aplicativo. O Box Mount sincroniza a nova revisão com o Box, onde uma pessoa pode abri-la, editá-la, atribuir uma tarefa ou criar outra versão.
Se alguém atualizar o arquivo no Box enquanto o sandbox ainda estiver rodando, essa alteração pode fluir de volta para o espaço de trabalho montado para a próxima etapa do agente. Isso cria um ambiente de trabalho compartilhado para agentes e pessoas, sem exigir que os desenvolvedores criem lógicas personalizadas de movimentação e sincronização para cada arquivo.
Também torna o fluxo de trabalho menos dependente de qualquer modelo ou framework de agente específico. O sandbox pode rodar um agente OpenAI, um agente Anthropic, LangGraph, CrewAI, um script Python, a CLI do LibreOffice ou uma combinação de ferramentas. Desde que a ferramenta saiba trabalhar com arquivos, ela pode trabalhar com o espaço de trabalho montado.
Como as peças se encaixam
Seu produto ou orquestrador é responsável por provisionar o sandbox e rodar o agente. O Box Mount roda dentro desse sandbox como um componente de sincronização headless, fornecendo a interface de sistema de arquivos e se comunicando com o Box por meio das APIs do Box.
O agente trabalha pelo caminho montado em vez de chamar o Box para cada operação de documento. O Box Mount mantém a pasta atualizada, envia alterações, detecta atualizações conflitantes e conclui uma sincronização final quando o espaço de trabalho é desmontado.
O Box continua fornecendo a camada de conteúdo, incluindo permissões, versões, classificações, retenção, proteções Shield e histórico de auditoria. O sandbox contém uma cópia de trabalho sincronizada, então os desenvolvedores ainda devem gerenciar esse ambiente e seus dados locais de acordo com seus próprios requisitos de segurança.
O produto do cliente provisiona o sandbox e roda o agente. O Box Mount conecta o espaço de trabalho do sistema de arquivos do agente ao Box por meio das APIs do Box.
Usando o Box Mount
O fluxo de trabalho básico do Box Mount exige apenas alguns comandos. Primeiro, configure suas credenciais do Box:
1box-mount config
Monte uma pasta do Box no sandbox do agente:
1mkdir -p /mnt/box2box-mount mount "/mnt/box" "<box-folder-id>"
Uma vez montada, o agente pode usar ferramentas comuns de sistema de arquivos:
1find /mnt/box -type f2cat /mnt/box/Playbook/approved-contract-playbook.md3cp generated-review.md /mnt/box/Reviewed/
Você pode verificar a montagem ativa enquanto o agente está rodando:
1box-mount status
Quando a execução terminar, desmonte o espaço de trabalho e conclua a sincronização final:
1box-mount unmount "/mnt/box"
A autenticação e o provisionamento dependerão de como seu aplicativo inicia seus sandboxes. A documentação da prévia privada incluída com o binário cobre as opções de configuração disponíveis.
O que você poderia construir?
A revisão de contratos é um exemplo. Um agente pode comparar acordos recebidos com um playbook aprovado, gravar suas descobertas de volta no Box e entregar o resultado a um advogado. Se o advogado alterar a revisão no Box, o agente poderá ver o arquivo atualizado em seu ambiente de trabalho.
O mesmo padrão pode dar suporte à elaboração de propostas e RFPs, análise de deal rooms, criação de briefings executivos, síntese de pesquisas, revisão de conformidade e outros fluxos de trabalho intensivos em documentos. Vários agentes também podem trabalhar em uma pasta compartilhada do Box — por exemplo, um criando um rascunho, outro revisando-o e uma pessoa tomando a decisão final.
O modelo e o fluxo de trabalho podem mudar, mas o padrão subjacente permanece o mesmo: o conteúdo do Box entra em um sandbox externo, torna-se parte do ambiente de trabalho do agente e o trabalho resultante retorna ao Box.
Explore o aplicativo de exemplo
O exemplo de revisão de contratos do Box Mount mostra um fluxo de trabalho completo usando o E2B.
O aplicativo cria um sandbox, instala o Box Mount, monta um espaço de trabalho de contratos do Box e roda o Box AI ou um agente OpenAI. Em seguida, sincroniza a revisão gerada de volta ao Box, opcionalmente a atribui a um revisor humano e deixa o sandbox rodando para que os desenvolvedores possam inspecionar o resultado antes de encerrá-lo.
O repositório atualmente é privado e não inclui o binário do Box Mount. Os participantes da prévia privada precisarão de acesso ao repositório e devem colocar o binário fornecido no diretório private/ do projeto antes de rodar o exemplo.
Participe da prévia privada
O Box Mount ainda está em fase inicial, e estamos procurando desenvolvedores que estão construindo (ou começando a explorar) fluxos de trabalho de agentes que rodam em sandboxes e trabalham com conteúdo do Box.
Se isso parece com a sua arquitetura, gostaríamos de saber como você move conteúdo hoje, o que roda dentro do seu sandbox e onde a abordagem atual começa a se tornar dolorosa. Os participantes da prévia privada receberão o binário do Box Mount e orientações de configuração para poderem testá-lo com seus próprios fluxos de trabalho.
https://bit.ly/box-mount-preview
Se o conteúdo do Box precisa se tornar parte do ambiente de trabalho do seu agente, adoraríamos ver o que você vai construir.
