O que é a profundidade da busca
DeepSeek tem código aberto o agente runtime DeepSeek Harness: a versão v0.1 é lançada no modo de visualização do desenvolvedor e está disponível sob a licença do MIT. O projecto é distribuído como o dsh pacote no repositório deepseek-ai/deepseek-harness.
Segundo os autores, Harness é uma camada entre o modelo e o ambiente em que atua. Ele inclui ferramentas, um sistema de arquivos, sandboxes e um loop de controle. A fórmula é simples: Agente = Modelo + Arnês. Em outras palavras, este não é um assistente pronto, mas um framework do qual esse assistente é montado.
É importante entender: v0.1 é especificamente a infraestrutura do desenvolvedor. Ainda não se destina a cargas de trabalho de produção, mas permite validar as ideias arquitetônicas do projeto em uma fase inicial e construir suas próprias soluções em cima delas.
Arquitetura: tudo é um plugin
A principal diferença da maioria dos arneses com uma camada fixa é a posição indicada literalmente nas primeiras linhas do README: tudo é um plugin. Modelos, ferramentas, habilidades, sessões, sandboxes, armazenamento, loops de execução, agendadores, e até mesmo a UI são todos externalizados como plugins Cordis.
Cordis é um meta-framework cujo design é descrito no artigo "Um Paradigma de Programação para Composabilidade Espacial". Seu núcleo é responsável apenas por montar e desmontar plugins e gerenciar suas dependências. Todas as capacidades vivem em plugins, não em um núcleo privilegiado — esta é uma decisão arquitetural chave.
A implicação prática: qualquer componente pode ser selecionado, substituído ou estendido diretamente na configuração sem tocar no próprio código fonte DeepSeek Harness. Na verdade, este é um construtor para runtimes agentic adaptados a uma tarefa específica, não um assistente de codificação fixo.
Quatro modos de execução
O projeto oferece quatro modos predefinidos:
- Padrão — um agente de codificação completo: edição de arquivos, shell, busca de arquivos e web, habilidades, planejamento, objetivos, subagentes e fluxos de trabalho.
- Código — as mesmas ferramentas, mas acessíveis através do modo de código SDK: o modelo reúne operações multi-step num único programa TypeScript.
- Mínimo — um ambiente "descascado" com apenas duas ferramentas (persistente bash e str replace editor), concebidas para benchmarking de modelos.
- Criador — um modo de inspeção em tempo de execução, experimentação de plugins de memória e dicas para criar predefinições.
Este conjunto de modos permite que você use o mesmo tempo de execução para agentes de produção, avaliação de modelos e depuração de seus próprios plugins — sem mudar para frameworks separados.
Rastreio total das corridas
Cada corrida em DeepSeek Harness é totalmente rastreável. O registro de sessão somente de apêndice registra tudo o que o modelo vê: prompts de sistema, raciocínio, chamadas de ferramenta e seus resultados, planejamento de subagentes e cada injeção de contexto. Este último é uma promessa notavelmente mais forte do que o registro de chamadas de ferramentas comuns.
Built on top of this event stream are a tractory view for browsing records by source, as well as resume, fork, search, and replay. Qualquer sessão pode ser revertida, bifurcada, encontrada pelo conteúdo e reproduzida — o que é fundamental para a depuração e para as ações do agente de auditoria.
Modelos e fornecedores
O roteamento do modelo também é um plugin, e esta é uma continuação lógica da arquitetura geral. Em Configurações → Modelos, uma chave API DeepSeek faz efeito a partir da próxima solicitação, sem reiniciar o servidor. O catálogo de fornecedores incorporado adiciona Anthropic e OpenAI através da chave API.
Para serviços de nuvem empresarial, são necessárias credenciais nativas: para Bedrock — credenciais AWS e uma região, para Vertex — um projeto com ADC, para Azure — api-versão, para Codex — OAuth. Além disso, provedores personalizados são suportados: basta especificar qualquer URL base compatível com OpenAI e protocolo.
Chaves são armazenadas com uma bandeira somente de gravação no $DSH_HOME/.credentials.yaml as configurações do arquivo; mantêm apenas uma referência às credenciais, não aos próprios segredos. Isso é conveniente tanto do ponto de vista da segurança quanto quando se trabalha em equipe.
Como executar e conectar o SDK
UI Web
A maneira mais simples de tentar o tempo de execução é o comando npx @deepseek-ai/dsh web, que inicia a interface Web em http://127.0.0.1:3080. Se preferir compilar a partir da fonte: git clone, então pnpm install, pnpm run build, e pnpm dsh web.
Python SDK
Para integração programática, o pacote deepseek-harness-sdk é fornecido. Ele requer Python 3.10 ou mais recente, e plataformas suportadas incluem Linux x64, Linux arm64 e macOS 14+ no arm64. Um bom detalhe: o tempo de execução incorporado não requer um sistema Node.js, então você não precisará configurar um ambiente adicional para executar agentes.
Para quem isto pode ser útil
O público-alvo do projeto são startups e equipes de plataforma e experiência de desenvolvedores de médias e grandes empresas. Empresas regulamentadas podem pilotar DeepSeek Harness localmente: é distribuído sob o MIT e é auto-hospedado, o que significa que dados sensíveis nunca saem do perímetro.
As indústrias onde tal tempo de execução parece apropriado incluem: desenvolvimento de software e devtools, serviços financeiros e seguros com sua necessidade de operações de agentes auditáveis, saúde e P&D farmacêutica, fornecedores de nuvem e semicondutores, e laboratórios de pesquisa acadêmico e industrial.
Casos de uso típico incluem agentes de codificação internos para repositórios privados, avaliação de modelos em um ambiente controlado, observação de agentes com replay de execução, sandbox personalizado e políticas de aprovação, e ferramentas internas de embalagem em plugins reutilizáveis. Tudo isso se encaixa na ideia geral: ao invés de pegar um assistente pronto, crie um tempo de execução adaptado às suas necessidades.
