Voltar
Adapter fx agora roda o harness no host e deixa só filesystem e shell isolados no sandbox

Adapter fx agora roda o harness no host e deixa só filesystem e shell isolados no sandbox

Aprofundamento CEVIU

Aprofundamento

O adapter fx do HarnessAgent, camada do AI SDK, mudou de arquitetura. Agora o harness e as requisições ao modelo rodam no mesmo processo da aplicação (o host). Só as operações integradas de filesystem e shell continuam isoladas no sandbox.

A base técnica é a libfx, a biblioteca TypeScript do fx. Na prática, saem três peças do caminho: instalar o fx dentro do sandbox, executar um sandbox bridge e expor uma porta do sandbox. As credenciais do modelo ficam no host, sem ser repassadas ao sandbox. A reescrita também traz filtragem de built-in tools, mid-turn steering, structured output, image tool results via toModelOutput() e sessões que podem ser salvas e retomadas em um novo processo do host. Para usar, basta atualizar o @ai-sdk/harness-fx para a versão mais recente.

O que mudou

Em 27 de outubro de 2026, o CEVIU noticiou "HarnessAgent, do AI SDK, passa a aceitar imagens como entrada em todos os harness adapters". Naquele caso, a novidade era imagem entrando no agente. Agora, no adapter fx, o foco é a arquitetura (host separado do sandbox) e também imagem saindo de tools para o modelo, via toModelOutput(). São mudanças diferentes na mesma camada do AI SDK, publicadas com um dia de intervalo.

Por que isso importa

Para quem opera agentes em produção, manter as credenciais do modelo fora do sandbox reduz a superfície de risco, e dispensar bridge e porta exposta simplifica a infraestrutura. Na leitura editorial, o isolamento passa a cobrir apenas o que é de fato perigoso (arquivos e comandos), enquanto a lógica do agente fica perto do código da aplicação, o que tende a facilitar depuração e retomada de sessões.

Linha do tempo

  1. HarnessAgent, do AI SDK, passa a aceitar imagens como entrada em todos os harness adapters.

  2. Adapter fx passa a rodar o harness no host e isola só filesystem e shell no sandbox.

Perguntas frequentes

O que muda no adapter fx do HarnessAgent?

O harness e as requisições ao modelo passam a rodar no mesmo processo da aplicação. Filesystem e shell integrados continuam isolados no sandbox. O adapter usa a libfx, biblioteca TypeScript do fx.

Ainda preciso instalar o fx no sandbox?

Não. O adapter não precisa mais instalar o fx dentro do sandbox, executar um sandbox bridge nem expor uma porta do sandbox.

Onde ficam as credenciais do modelo?

Ficam no host. Elas não são mais repassadas ao sandbox, que cuida apenas das operações de filesystem e shell.

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 mais detalhes sobre os novos recursos, como filtragem de built-in tools, structured output e retomada de sessões.

Fontes

Avalie este artigo:
Categoria
CEVIU Web Dev
Publicado
28 de outubro de 2026
Editoria
CEVIU Web Dev

Quer receber mais sobre CEVIU Web Dev?

Conteúdo curado diariamente, direto no seu e-mail.

Conteúdo curado diariamenteDiversas categoriasCancele quando quiser