DeepSeek Harness: o que «tudo é um plugin» realmente entrega

Updated August 16, 2026 · first published August 16, 2026

A DeepSeek AI publicou o deepseek-harness (dsh), um harness de agentes licenciado sob MIT cujo lema de projeto é que tudo é um plugin. Essa frase é usada com folga no ecossistema de ferramentas de agentes, então vale precisar o que ela significa aqui e onde muda a economia de operar agentes.

Cordis, não um framework com hooks

O harness roda sobre o Cordis, um runtime de plugins cujo modelo é que plugins contribuem serviços, eventos tipados e efeitos reversíveis a um contexto compartilhado. O documento de arquitetura é explícito: não há núcleo privilegiado. Adaptadores de modelo, registros de ferramentas, logs de sessão e o próprio laço do agente são todos plugins. Nada fica embaixo deles como motor imóvel.

Isso importa porque a forma usual de um framework de agentes «extensível» é um núcleo fixo mais uma superfície de hooks. Você observa e decora, mas não substitui. Substituir significa bifurcar. O Cordis inverte isso: as peças que você gostaria de substituir são as unidades de composição.

Costuras de capacidade: a parte que importa na operação

O harness formaliza isso com o que chama de costura de capacidade (capability seam). Uma costura é uma interface de serviço com mais de uma implementação, e cada serviço ocupa um de três papéis:

Nem todo serviço é uma costura. A documentação distingue três tipos: costuras substituíveis (ctx.llm, ctx.subprocess), serviços de núcleo com owner único (ctx.sessions, ctx.agents) e pontos de composição que coordenam outros serviços (ctx.agentLoop). Saber qual é qual diz onde você pode substituir comportamento e onde não pode.

As quatro costuras com consequências de custo

• ctx.llm, a costura do modelo. Pertence ao pacote llm; as implementações incluem llm-deepseek, llm-pi-ai e llm-replay. O laço do agente consome um serviço de stream neutro quanto ao provedor e não sabe qual backend está rodando. llm-replay é o interessante para trabalho de custo: permite reexecutar uma sessão gravada sem pagar inferência de novo.
• ctx.fs, a costura do sistema de arquivos. Os provedores são fs-local (sistema de arquivos do host), fs-sandbox (mutações confinadas) e fs-e2b (uma máquina Linux remota em sandbox). A costura desacopla as ferramentas que o modelo enxerga de onde a execução acontece fisicamente.
• ctx.sandbox, a costura de execução. Consumidores entregam argv; implementações envolvem a execução sob política. sandbox-local aplica no host, sandbox-policy centraliza padrões de implantação.
• ctx.subagents, a costura de delegação. Seis implementações cobrindo spawn em processo, fork, pontes ACP, Codex, Claude Code e agentes baseados em SDK. É aqui que um harness normalmente fixa uma suposição; aqui é uma troca.

Toda alavanca de custo relevante num sistema de agentes é uma troca de provedor: rotear para um modelo mais barato, mover a execução para um sandbox mais barato, substituir um transporte de subagentes por um local. Quando isso são costuras, a mudança é uma edição de configuração. Quando não são, a mudança é uma bifurcação que você passa a manter.

Por que isso é assunto de FinOps e não só de arquitetura

A falha recorrente em programas de custo de agentes não é a equipe escolher um modelo caro. É o harness tornar a escolha cara estrutural. Uma vez que a seleção de modelo, o local de execução das ferramentas e o transporte de delegação estão assados no código da aplicação, cada otimização vira um projeto de engenharia com cronograma e risco de regressão próprios. As equipes então adiam a otimização, e o gasto se acumula.

Um harness baseado em costuras move essas decisões para a composição. Isso não as torna gratuitas, mas as converte de refatorações em configuração, que é a diferença entre uma iniciativa trimestral e uma tarde.

A ressalva que vale dizer sem rodeios

O DeepSeek Harness está em developer preview e seu README diz, sem suavizar, que haverá mudanças que quebram compatibilidade. Construir agora ferramentas de custo de produção diretamente sobre suas interfaces internas significa assinar embaixo de correr atrás delas. Avalie, prototipe, mas fixe as versões e conte com movimento.

Related

• O que é DeepSeek Harness? Guia completo
• O log de sessão como registro de custos (EN)
• Onde colocar os limites de gasto (EN)
• Instalação, perfis e primeira execução (EN)

Want this applied to your own LLM spend? FinOps LLM runs a free audit of your AI costs and shows where the savings are. Book free audit →

Back to research