DeepSeek libera o DeepSeek Harness, framework de agentes em que tudo é plugin

O que é o DeepSeek Harness

A DeepSeek liberou o DeepSeek Harness v0.1 em prévia para desenvolvedores (developer preview) e publicou o código-fonte completo sob a licença MIT. O projeto é distribuído como dsh e está disponível no repositório deepseek-ai/deepseek-harness no GitHub.

Um harness (“arreio”, em tradução livre) é a camada que fica entre o modelo e o ambiente onde ele atua — as ferramentas, arquivos, sandboxes e o loop de controle que permitem a um agente continuar trabalhando. A DeepSeek sintetiza a ideia na fórmula “Agente = Modelo + Harness”.

A maioria dos harnesses engessa essa camada: o loop do agente, o registro de ferramentas e o armazenamento de sessões são fixos, e a extensão só acontece nos pontos que os autores expuseram. O Harness segue o caminho oposto, anunciado logo nas primeiras linhas do README: tudo é um plugin. Modelos, ferramentas, skills, sessões, sandboxes, storage, loops, agendamento e a interface ficam atrás das fronteiras de plugin do Cordis, e qualquer um deles pode ser selecionado, trocado ou estendido via configuração, sem alterar o código-fonte do Harness.

O kernel Cordis

O Harness roda sobre o Cordis, um meta-framework cujo desenho está descrito no texto “A Programming Paradigm for Spatiotemporal Composability”. O kernel cuida da montagem, desmontagem e das dependências dos plugins. As capacidades vivem nos plugins, não em um núcleo privilegiado.

Quatro modos de execução

O projeto oferece quatro modos, cada um carregando um conjunto diferente de plugins:

• Standard: o agente de codificação completo, com edição de arquivos, shell, busca em arquivos e na web, skills, planejamento, metas, subagentes e fluxos de trabalho.
• Code mode: expõe as ferramentas por meio de um Code Mode SDK, permitindo combinar operações em várias etapas em um único programa TypeScript.
• Minimal: mantém apenas duas ferramentas — um bash persistente e str_replace_editor — para avaliar modelos em um ambiente enxuto.
• Creator mode: adiciona inspeção em tempo de execução, experimentos de plugins em memória e orientação para criar presets.

Toda execução é rastreável

Tudo o que o modelo vê é gravado em um log de sessão append-only (somente acréscimo). Isso inclui prompts de sistema, raciocínio, chamadas de ferramentas e resultados, agendamento de subagentes e cada injeção de contexto. A visão Trajectory inspeciona esses registros por origem, e as operações de retomar, bifurcar, buscar e reproduzir atuam sobre o mesmo fluxo de eventos. A maioria dos frameworks de agentes registra chamadas de ferramentas; gravar cada injeção de contexto é a reivindicação mais forte do Harness.

Roteamento de modelos também é plugin

Em Configurações → Modelos, uma chave de API da DeepSeek passa a valer na próxima requisição, sem reiniciar o servidor. O catálogo instalado adiciona provedores como Anthropic e OpenAI por chave de API. Bedrock, Vertex, Azure e Codex exigem credenciais nativas. Provedores personalizados aceitam qualquer URL base compatível com OpenAI. As chaves são somente gravação e ficam em $DSH_HOME/.credentials.yaml.

Como executar

O comando npx @deepseek-ai/dsh web inicia a interface web, servida em http://127.0.0.1:3080 por padrão. A partir de um checkout: git clone, pnpm install, pnpm run build e pnpm dsh web. Um SDK Python chamado deepseek-harness-sdk exige Python 3.10 ou mais recente, em Linux x64/arm64 ou macOS 14+ (arm64).

Para quem é (e para quem não é)

O v0.1 é uma prévia para desenvolvedores — infraestrutura de desenvolvimento, não um produto de agente pronto para produção. Faz sentido para startups nativas de IA e equipes de plataforma em empresas de médio e grande porte que já rodam ferramentas internas. Empresas reguladas podem pilotar localmente por ser MIT e auto-hospedado. Entre as aplicações estão agentes de código internos sobre repositórios privados, avaliação de modelos em um ambiente controlado de duas ferramentas, observabilidade e replay de execuções, e o empacotamento de ferramentas internas como plugins reutilizáveis.