O DeepSeek Harness tem 4 modos: Standard, Code, Minimal e Creator explicados

O DeepSeek Harness tem quatro modos de execução: Standard, Code, Minimal e Creator. Não são quatro níveis de desempenho, e escolher um modo diferente não torna o modelo DeepSeek subjacente inerentemente mais inteligente ou mais fraco. Em vez disso, cada modo altera o ambiente em torno do modelo: quais as ferramentas que pode utilizar, como essas ferramentas são orquestradas, quanta assistência o harness fornece e se o agente está a realizar trabalho, a ser avaliado ou a modificar o próprio harness.

A forma mais simples de memorizar a diferença é esta: o Standard serve para realizar o trabalho, o Code para orquestrar o trabalho, o Minimal para avaliar o modelo e o Creator para alterar o harness. Esta distinção é importante porque o desempenho de um agente resulta de mais do que apenas os pesos do modelo. A superfície de ferramentas, o ciclo de execução, a memória, as permissões, o sistema de planeamento e outros componentes do harness influenciam tudo o que um agente consegue fazer.

Se estiver a comparar o DeepSeek com outro ambiente de agente persistente, o nosso guia sobre complementos Hermes para agentes DeepSeek mostra o mesmo princípio de outra perspetiva: alterar a camada do agente pode acrescentar visão, memória, acesso a dados privados e outras capacidades sem substituir o modelo base.

Porque é que o DeepSeek Harness precisa de quatro modos diferentes?

O DeepSeek Harness baseia-se na ideia de que um agente não é apenas um modelo de linguagem ligado a uma linha de comandos. O harness situa-se entre o modelo e o ambiente, determinando o que o modelo pode ver, quais as ferramentas disponíveis, como as ações são executadas, como as sessões são registadas e o que acontece ao longo de vários passos. O DeepSeek resume esta relação afirmando que um agente é composto por um modelo e um harness.

É também por isso que os quatro modos de execução do DeepSeek Harness podem comportar-se de formas tão diferentes, embora utilizem o mesmo modelo subjacente. O Standard disponibiliza o ambiente completo do agente para utilização quotidiana. O Code mantém essas capacidades, mas altera a forma como o modelo orquestra as ferramentas. O Minimal remove deliberadamente a maior parte da assistência do harness. O Creator acrescenta a capacidade de inspecionar e reformular o próprio ambiente de execução.

Por isso, estes modos não devem ser interpretados como uma progressão do básico ao avançado. O Minimal não está abaixo do Standard, e o Creator não é simplesmente um Standard Mode mais potente. Cada predefinição otimiza uma questão diferente: Como deve o agente trabalhar? Como deve coordenar as ferramentas? Quanto do resultado pertence ao próprio modelo? Ou como deve o ambiente do agente ser reconstruído?

1. Modo padrão — O ambiente completo de agente DeepSeek predefinido

O Modo padrão é o ponto de partida natural quando o seu objetivo é simplesmente dar uma tarefa ao DeepSeek e fazê-lo concluí-la. Inclui o ambiente completo de agente de programação: edição de ficheiros, acesso à shell, pesquisa em ficheiros e na web, competências, planeamento, objetivos, subagentes e fluxos de trabalho. Em vez de exigir que decida manualmente cada passo seguinte, o modelo pode inspecionar o ambiente, agir, observar o resultado e continuar.

Isso cria o ciclo familiar de um agente: inspecionar um repositório, procurar ficheiros relevantes, ler código, fazer uma alteração, executar um comando, inspecionar um erro e rever o resultado. A capacidade importante não é uma única ferramenta dessa lista. É a capacidade de continuar a avançar pelo ambiente à medida que surgem novas informações. A arquitetura de plugins do DeepSeek torna estas capacidades combináveis, em vez de tratar o agente como uma aplicação fixa; a cobertura do lançamento descreveu-a como um runtime de agentes combinável através de plugins.

Para a maioria dos utilizadores, isso faz do Modo padrão a opção predefinida correta. Se quiser que o DeepSeek investigue um erro, compreenda um repositório, implemente uma funcionalidade, inspecione vários ficheiros ou coordene uma tarefa normal de programação com várias etapas, há poucas razões para remover deliberadamente as ferramentas antes de saber que estão a causar um problema.

O Modo padrão torna-se menos adequado quando o objetivo da sessão é a avaliação, e não a produtividade. Se um modelo tem sucesso porque a pesquisa, o planeamento, as competências, os subagentes e outros componentes do harness compensam as suas limitações, o resultado final mostra o desempenho do sistema de agentes. Não mostra claramente o desempenho do modelo base com assistência externa mínima.

2. Modo de código — Deixe o DeepSeek transformar a orquestração de ferramentas num programa

O Code Mode é o mais fácil de interpretar erradamente dos quatro modos. Não significa “Standard Mode, mas apenas para tarefas de programação”. De acordo com a definição atual do DeepSeek, o Code Mode mantém todas as capacidades do Standard Mode. A alteração está na forma como as ferramentas são expostas ao modelo: o DeepSeek pode utilizar o SDK Code Mode para combinar várias operações num programa TypeScript gerado pelo modelo.

Num ciclo normal de um agente, uma tarefa complexa pode exigir trocas repetidas entre o modelo e ferramentas individuais. O agente pesquisa, recebe um resultado, decide o que deve ler, lê-o, processa esse resultado, chama outra ferramenta e continua. O SDK Code Mode transfere parte desse fluxo de controlo para código executável, permitindo que o modelo exprima ciclos, filtragem, ramificações e várias operações dependentes de ferramentas como um programa, em vez de uma longa sequência de chamadas de ferramentas isoladas.

Imagine uma tarefa que exige pesquisar centenas de ficheiros, filtrar correspondências por caminho, ler apenas um subconjunto, extrair valores e, em seguida, executar a mesma verificação em cada resultado. O Standard Mode continua a conseguir realizar esse fluxo de trabalho, mas grande parte da orquestração ocorre em sucessivos turnos do agente. O Code Mode é apelativo quando a própria orquestração começa a assemelhar-se a um pequeno programa.

pesquisar ficheiros
→ filtrar caminhos correspondentes
→ percorrer os resultados num ciclo
→ ler ficheiros selecionados
→ processar os dados devolvidos
→ executar operações de seguimento

A palavra importante é complexidade, não “programação”. Uma edição simples não se torna automaticamente melhor só porque o Code Mode consegue gerar TypeScript à sua volta. O Standard Mode pode ser mais fácil de acompanhar quando estão envolvidas apenas algumas ferramentas. O Code Mode torna-se mais interessante quando operações repetidas, transformações estruturadas, lógica condicional ou processamento dos resultados das ferramentas criariam, de outro modo, muitas chamadas consecutivas ao modelo.

3. Minimal Mode — Remover o Harness e Ver Mais do Modelo

O Minimal Mode não é uma opção leve destinada a PCs mais lentos ou a servidores domésticos mais pequenos. É um ambiente de agente deliberadamente limitado. Atualmente, o DeepSeek define-o como um agente de programação com duas ferramentas, com bash persistente e str_replace_editor, removendo a superfície mais ampla de pesquisa, competências, subagentes e fluxos de trabalho disponível no Standard Mode.

A razão dessa restrição é a avaliação. O próprio DeepSeek utilizou o DeepSeek Harness Minimal Mode em benchmarks públicos de agentes de código reportados com o V4-Flash. Esse uso torna a intenção muito mais clara: o Minimal foi concebido para reduzir a infraestrutura envolvente do agente quando os investigadores pretendem obter uma perspetiva mais restrita do que o modelo consegue fazer com um conjunto pequeno e controlado de ferramentas.

Esta distinção é importante porque os benchmarks modernos de agentes podem medir mais do que o modelo. Um planeador competente, uma melhor montagem de contexto, a pesquisa no repositório, competências especializadas, políticas de repetição ou a delegação a subagentes podem alterar o sucesso de uma tarefa. A investigação sobre a avaliação de harnesses defende de forma semelhante que a capacidade deve ser interpretada ao nível da configuração modelo-harness, em vez de atribuir automaticamente todo o resultado apenas aos pesos do modelo.

Isto confere ao Modo Mínimo um objetivo de otimização muito diferente do do Modo Padrão. O Modo Padrão pergunta: “Que ambiente oferece a este agente a melhor probabilidade de concluir trabalho útil?” O Modo Mínimo pergunta: “O que acontece quando removemos grande parte desse ambiente e deixamos o modelo com uma superfície de execução mais pequena?”

No trabalho quotidiano, eliminar deliberadamente capacidades úteis pode ser contraproducente. Se o objetivo é corrigir um repositório tão rápida e fiavelmente quanto possível, o Modo Mínimo geralmente está a resolver o problema errado. O seu valor surge quando a reprodutibilidade, a comparação, a depuração ou a compreensão do comportamento bruto do modelo são mais importantes do que a conclusão máxima das tarefas.

4. Modo Criador — Use o DeepSeek Harness para alterar o Harness

O Modo Criador altera o objeto com que está a trabalhar. O Modo Padrão utiliza principalmente um ambiente de agente; o Modo Criador foi concebido para criar e experimentar esse ambiente. Inclui as capacidades do Modo Padrão e acrescenta a inspeção do runtime, a experimentação de plug-ins em memória e orientação para criar predefinições personalizadas.

Isto decorre diretamente da arquitetura subjacente ao DSH. A DeepSeek descreve modelos, ferramentas, competências, sessões, sandboxes, armazenamento, ciclos, agendamento e até a interface de utilizador como plug-ins que podem ser selecionados, substituídos ou recombinados. O kernel Cordis gere a montagem, desmontagem e as dependências dos plug-ins, o que significa que a extensão do DSH não exige necessariamente a modificação de um núcleo de agente monolítico privilegiado. É por isso que a afirmação do projeto de que “tudo é um plug-in” é mais importante do que a existência de quatro predefinições por si só.

Suponha que pretende um agente especificamente para gerir um servidor doméstico. O respetivo ambiente útil pode incluir acesso à shell, permissões restritas no sistema de ficheiros, operações do Docker, documentação de infraestrutura, ferramentas de monitorização e algumas competências especializadas. Essa combinação não é idêntica à de um agente de programação genérico. O Modo Criador foi concebido para experimentar capacidades deste tipo e combiná-las numa predefinição de agente reutilizável.

inspecionar o runtime atual
→ adicionar ou testar plug-ins
→ observar serviços e dependências
→ ajustar a composição
→ guardar uma predefinição especializada
→ iniciar novamente esse ambiente

Isto torna o Modo Creator mais especializado do que o Modo Standard, mas não automaticamente melhor para a utilização diária. Se apenas pretende que o DeepSeek altere três ficheiros e execute um conjunto de testes, a inspeção do ambiente de execução e a criação de predefinições acrescentam pouco valor. O Creator torna-se útil quando a pergunta muda de “O agente consegue executar esta tarefa?” para “Que capacidades deve ter este tipo de agente?”

Standard vs Code vs Minimal vs Creator: o que muda realmente?

O maior erro é organizar os quatro modos numa progressão como Minimal → Standard → Code → Creator. Isso sugere que cada etapa simplesmente acrescenta mais capacidade. A relação real é multidimensional: o Standard dá ênfase à execução geral, o Code altera a orquestração, o Minimal reduz deliberadamente a assistência e o Creator expõe o próprio harness como algo a configurar.

A comparação torna-se mais clara quando os modos são avaliados com base nas mesmas perguntas, em vez da contagem de funcionalidades. Standard e Code mantêm ambos o ambiente abrangente para agentes, mas o Code altera a forma como o trabalho com ferramentas em várias etapas pode ser expresso. O Minimal move-se deliberadamente na direção oposta, reduzindo a superfície de ferramentas. O Creator parte do Standard e acrescenta capacidades para a composição do ambiente de execução, em vez de simplesmente adicionar outra ferramenta de produtividade quotidiana.

É também por isso que dois testes que utilizem o mesmo modelo DeepSeek podem produzir resultados diferentes se as configurações do respetivo harness forem diferentes. As primeiras análises do DSH já destacaram a importância de registar a configuração do modelo e do harness, em vez de comparar apenas os nomes dos modelos. O acesso a ferramentas, as permissões, a construção do contexto, os ciclos do agente e outras opções do ambiente de execução podem alterar o percurso que o modelo segue numa tarefa.

Que modo do DeepSeek Harness deve realmente utilizar?

Para a maioria das tarefas normais, comece pelo Modo Standard. Este disponibiliza o amplo conjunto de capacidades que o DSH foi concebido para coordenar e permite-lhe descobrir se é sequer necessário um ambiente de execução mais especializado. Começar pelo Minimal apenas porque parece mais leve pode remover precisamente as capacidades que tornam um agente útil.

Mude para o Code Mode quando o próprio fluxo de trabalho com ferramentas se tornar complexo. Pesquisas repetidas, ciclos sobre muitos ficheiros, filtragem de resultados de ferramentas, transformações estruturadas e ações condicionais são razões mais fortes para utilizar o Code Mode do que o simples facto de a sua tarefa envolver desenvolvimento de software.

Utilize o Minimal Mode quando a questão for o modelo, e não a produtividade máxima. É a opção mais adequada para comparações controladas, reprodução de benchmarks, experiências com prompts e situações em que pretende saber se o sucesso depende do modelo ou de um harness mais completo à sua volta.

Utilize o Creator Mode quando quiser alterar o ambiente do agente. Destina-se a experiências com plugins, predefinições especializadas e programadores que encaram o DeepSeek Harness como uma infraestrutura para criar um novo agente, em vez de simplesmente operarem o agente predefinido.

Se o seu objetivo mais amplo é criar capacidades reutilizáveis para agentes em torno de dados privados, em vez de modificar o próprio DSH, o nosso guia sobre competências de agentes de IA para bases de conhecimento locais explica como as competências podem reunir fluxos de trabalho repetíveis de recuperação, análise, evidência e conhecimento num sistema autoalojado.

O Plan Mode não é um quinto modo de execução do DeepSeek Harness

Existe outra funcionalidade do DSH que torna a terminologia confusa: o Plan Mode. Parece que deveria estar ao lado de Standard, Code, Minimal e Creator, mas a arquitetura atual do DeepSeek trata-o de forma diferente. Os quatro modos acima são predefinições ou composições de execução. O Plan Mode é um estado opcional de planeamento por agente que altera a orientação fornecida ao modelo.

A documentação do subsistema do DeepSeek descreve explicitamente o Plan Mode como orientação flexível. Enquanto está ativo, é incluída uma secção relacionada com o planeamento nos pedidos enviados ao modelo. O modo sandbox e a política de aprovação impõem restrições de forma independente, e o próprio ciclo do agente não depende do Plan Mode.

Isto atribui funções diferentes aos dois conceitos. Standard, Code, Minimal e Creator respondem a perguntas sobre a composição do ambiente de execução: que capacidades existem e como o agente funciona. O Plan Mode responde a uma questão comportamental: o agente deve permanecer num estado de colaboração orientado para o planeamento antes de prosseguir com a execução?

Standard / Code / Minimal / Creator
= composição do ambiente de execução

Plan Mode
= estado de planeamento e orientação

Por isso, se alguém perguntar se o DeepSeek Harness tem quatro modos ou cinco, a resposta útil é: o DSH disponibiliza atualmente quatro modos principais de execução, enquanto o Plan Mode é um mecanismo opcional de planeamento separado, e não um quinto modo de execução equivalente.

Os quatro modos revelam o que o DeepSeek Harness está realmente a construir

A parte mais interessante do DSH não é oferecer aos utilizadores quatro botões à escolha. Os modos expõem quatro camadas diferentes da engenharia de agentes. Standard centra-se na execução. Code centra-se na orquestração. Minimal centra-se na avaliação. Creator centra-se na composição. Em conjunto, mostram que a DeepSeek encara o harness como uma parte ativa do comportamento do agente, e não como uma simples camada invisível em torno do modelo.

Isto é importante porque as melhorias nos sistemas de agentes não têm de resultar apenas do treino de um modelo maior. Alterar a apresentação das ferramentas, a gestão do contexto, as políticas de execução, o comportamento de repetição, as competências, a memória ou a composição do ambiente de execução pode mudar aquilo que o mesmo modelo consegue realizar. Se está interessado em expandir essas capacidades em vez de reconstruir todo o ambiente de execução, a pilha de plug-ins DeepSeek e Hermes é outro exemplo de como o sistema de agentes envolvente pode acrescentar capacidades totalmente novas.

Isto também significa que as quatro predefinições devem ser encaradas como configurações iniciais, e não como respostas universais. Um ambiente de avaliação quer menos assistência. Um agente de produção pode querer mais ferramentas e permissões mais rigorosas. Um fluxo de trabalho complexo com ferramentas pode beneficiar de orquestração programática. Um agente especializado para servidores domésticos poderá, eventualmente, merecer a sua própria predefinição.

O DeepSeek Harness ainda está em pré-visualização para programadores, e a DeepSeek afirma que os seus plug-ins e APIs principais continuarão a evoluir. Por isso, as predefinições e interfaces exatas podem mudar. Mas a distinção arquitetural já é útil: quando um agente se comporta de forma diferente, não olhe apenas para o modelo. Veja o harness que determina como esse modelo pode agir.