Fx adapter passa a executar o harness no host e separa host de sandbox
Aprofundamento CEVIU
Aprofundamento
O adapter fx do HarnessAgent, do AI SDK, mudou de arquitetura. Agora o harness e as requisições ao modelo rodam no mesmo processo da aplicação. Só as operações integradas de filesystem e shell continuam isoladas no sandbox. O adapter usa a libfx, a biblioteca TypeScript do fx.
Na prática, saem três peças: instalar o fx dentro do sandbox, manter uma bridge de sandbox e expor uma porta do sandbox. As credenciais do modelo ficam no host e não são encaminhadas ao sandbox. A reescrita traz ainda filtro de ferramentas integradas, steering no meio do turno (novas instruções com o turno em andamento), saída estruturada por schema e retorno de imagens ao modelo via toModelOutput(). Sessões podem ser salvas e retomadas em outro processo do host. Para usar, atualize o pacote @ai-sdk/harness-fx para a versão mais recente. O status é de lançamento oficial disponível, segundo o changelog da Vercel.
O que mudou
Em 28 de outubro de 2026, o CEVIU noticiou "Adapter fx agora roda o harness no host e deixa só filesystem e shell isolados no sandbox", com a mesma mudança central de arquitetura. A nota de 30 de outubro de 2026 trata do mesmo anúncio e reforça o lançamento oficial disponível. Antes disso, em 4 de maio de 2026, o CEVIU publicou "O Agent Harness Pertence Fora do Sandbox", que discutia as implicações de segurança de rodar o harness dentro ou fora do sandbox. O adapter segue essa linha de separação.
Por que isso importa
Para quem opera agentes em produção, manter credenciais do modelo fora do sandbox reduz a superfície de exposição se o código executado for comprometido. Menos componentes (sem bridge, sem porta exposta) também significam menos coisa para manter e depurar. A retomada de sessões em novo processo é útil para quem precisa de execuções longas ou de reinício de infraestrutura.
Linha do tempo
CEVIU publica "O Agent Harness Pertence Fora do Sandbox", sobre harness dentro ou fora do sandbox.
CEVIU noticia o adapter fx rodando o harness no host, com filesystem e shell isolados no sandbox.
Lançamento oficial do adapter fx com harness no host e separação entre host e sandbox.
Perguntas frequentes
O que muda no fx adapter do AI SDK?
O harness e as requisições ao modelo passam a rodar no mesmo processo da aplicação, via libfx. Filesystem e shell integrados continuam isolados no sandbox. Não é mais preciso instalar o fx no sandbox, rodar bridge ou expor porta.
As credenciais do modelo ficam expostas ao sandbox?
Não. Segundo a Vercel, as credenciais ficam no host e não são encaminhadas ao sandbox.
Quais recursos novos vêm com a reescrita?
Filtro de ferramentas integradas, steering no meio do turno, saída estruturada por schema e imagens como resultado de ferramenta via toModelOutput(). Também é possível salvar sessões e retomá-las em um novo processo do host.
Como atualizar para o novo adapter?
Atualize o pacote @ai-sdk/harness-fx para a versão mais recente. A documentação do fx harness traz os detalhes de uso.
Fontes
- vercel.comfonte original
- Categoria
- CEVIU IA
- Publicado
- 30 de outubro de 2026
- Editoria
- CEVIU IA

