strands-agents/box

O que é?

Recursos principais

• 01Restringe o acesso do agente a arquivos, programas e à rede por meio do isolamento do sistema operacional.
• 02Avalia regras permit e forbid escritas em Dogwood, negando tudo por padrão.
• 03Compartilha um mecanismo de políticas e um histórico de eventos entre chamadas de shell, Python, rede e MCP.
• 04Verifica conexões de saída e solicitações HTTP com base no método e no caminho.
• 05Insere credenciais de API ou assinaturas AWS SigV4 para que o agente nunca veja os segredos.
• 06Registra decisões de política em OTLP JSON.

Casos de uso

• Executar um agente de programação que não deve ler segredos nem acessar hosts arbitrários.
• Limitar quais APIs externas um agente pode chamar e quais métodos HTTP pode usar.
• Manter chaves de API fora do processo do agente sem impedir que ele faça solicitações autorizadas.
• Auditar o que um agente tentou fazer por meio dos registros de decisões de política.

Início rápido

1. 1

   Execute o script oficial de download indicado no README

2. 2

   Confira a versão instalada

   ./box-core/box --version
3. 3

   Clone o repositório

   git clone https://github.com/strands-agents/box.git
4. 4

   Compile os binários do box a partir do código-fonte

   cargo build --release -p strands-box -p strands-box-containment

Antes de usar

• !É uma versão de prévia que, no momento, só oferece suporte à execução local no macOS com Apple silicon.
• !O guia de primeiros passos também exige Node.js 22.21 ou posterior e acesso ao Claude Opus 5 no Amazon Bedrock.

Em coleções

Tópicos

Perguntas frequentes

O que é box?

Um mecanismo open source de sandbox para agentes de IA, que restringe o que eles podem executar, ler, gravar e acessar na rede com políticas que negam tudo por padrão. O Strands Box executa agentes de IA em um sandbox do sistema operacional e adiciona políticas semânticas escritas em Dogwood. O acesso a arquivos, programas e à rede é configurado em box.toml, enquanto as regras em policy.dw definem quais operações são permitidas com base nos argumentos, nas ações anteriores e no tempo decorrido. As operações verificadas pelo mecanismo de políticas são negadas, a menos que uma regra permit permita executá-las, e regras forbid prevalecem sobre as permissões.

box é gratuito? Qual é a licença?

box é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

box ainda é mantido?

Manutenção ativa. O último commit de box foi em 6 de nov. de 2026.

Para que posso usar box?

Executar um agente de programação que não deve ler segredos nem acessar hosts arbitrários. Limitar quais APIs externas um agente pode chamar e quais métodos HTTP pode usar. Manter chaves de API fora do processo do agente sem impedir que ele faça solicitações autorizadas. Auditar o que um agente tentou fazer por meio dos registros de decisões de política.

Como instalar box?

Execute o script oficial de download indicado no README Confira a versão instalada: ./box-core/box --version Clone o repositório: git clone https://github.com/strands-agents/box.git Compile os binários do box a partir do código-fonte: cargo build --release -p strands-box -p strands-box-containment

Onde consigo box?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/strands-agents/box