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 intrinsecamente mais inteligente ou mais fraco. Em vez disso, cada modo altera o ambiente em torno do modelo: que ferramentas pode utilizar, como essas ferramentas são orquestradas, quanta assistência o harness fornece e se o agente está a executar 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 executar 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 depende 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 realizar.

Se está a comparar o DeepSeek com outro ambiente persistente de agentes, o nosso guia sobre plugins 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 com uma linha de comandos ligada. O harness situa-se entre o modelo e o ambiente, decidindo o que o modelo pode ver, que ferramentas estão 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 dizendo 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, utilizando o mesmo modelo subjacente. O Standard disponibiliza o ambiente completo do agente para utilização quotidiana. O Code preserva 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 conseguinte, 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? Que parte 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 atribuir 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 de 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.

Isto cria o ciclo de agente familiar: 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 é qualquer ferramenta isolada dessa lista. É a capacidade de continuar a avançar pelo ambiente à medida que surgem novas informações. A arquitetura de plug-ins do DeepSeek torna estas capacidades combináveis, em vez de tratar o agente como uma aplicação fixa; a cobertura do lançamento descreveu-o como um ambiente de execução de agentes com plug-ins combináveis.

Para a maioria dos utilizadores, isso faz do Modo padrão a escolha 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 sistema compensam as suas limitações, o resultado final mostra o desempenho do sistema de agentes. Não mostra de forma clara o desempenho do modelo base com o mínimo de assistência externa.

2. Modo de código — Permita que o DeepSeek transforme 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 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 ao modelo expressar ciclos, filtragem, ramificações e várias operações dependentes entre ferramentas como um programa, em vez de uma longa sequência de chamadas isoladas a ferramentas.

Imagine uma tarefa que exige pesquisar centenas de ficheiros, filtrar correspondências por caminho, ler apenas um subconjunto, extrair valores e, depois, executar a mesma verificação em cada resultado. O Standard Mode consegue realizar esse fluxo de trabalho, mas grande parte da orquestração ocorre em interações repetidas 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
→ 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 para a executar. 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 dariam origem, de outro modo, a muitas chamadas sucessivas 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 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 para avaliações públicas do Code Agent, reportadas com o V4-Flash. Essa utilização torna a intenção muito mais clara: o Minimal foi concebido para reduzir a estrutura envolvente do agente quando os investigadores pretendem obter uma visão 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 forte, 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 igualmente que a capacidade deve ser interpretada ao nível da configuração do modelo e do harness, em vez de atribuir automaticamente todo o resultado apenas aos pesos do modelo.

Isto dá ao Modo Mínimo um objetivo de otimização muito diferente do Modo Normal. O Modo Normal 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?»

Para o trabalho quotidiano, descartar deliberadamente capacidades úteis pode ser contraproducente. Se o objetivo for corrigir um repositório da forma mais rápida e fiável possível, o Modo Mínimo está geralmente 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 maximizar a conclusão de tarefas.

4. Modo de Criação — Use o DeepSeek Harness para alterar o Harness

O Modo de Criação altera o objeto com que está a trabalhar. O Modo Normal utiliza principalmente um ambiente de agente; o Modo de Criação foi concebido para criar e experimentar esse ambiente. Inclui as capacidades do Modo Normal, acrescentando inspeção do ambiente de execução, experimentação de plugins 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 plugins que podem ser selecionados, substituídos ou recompostos. O kernel Cordis gere a montagem, desmontagem e as dependências dos plugins, o que significa que expandir o DSH não requer necessariamente modificar um núcleo de agente monolítico privilegiado. É por isso que o conceito mais amplo explica a importância da afirmação do projeto de que «tudo é um plugin», mais do que a existência, por si só, de quatro predefinições.

Suponha que quisesse um agente especificamente para gerir um servidor doméstico. O ambiente útil poderia incluir acesso à shell, permissões restritas no sistema de ficheiros, operações 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 de Criação foi concebido para experimentar capacidades deste tipo e combiná-las numa predefinição de agente reutilizável.

inspecionar o ambiente de execução atual
→ adicionar ou testar plugins
→ 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 oferecem pouco valor. Creator torna-se útil quando a pergunta muda de “O agente consegue realizar 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 se limita a acrescentar mais capacidade. A relação real é multidimensional: Standard dá ênfase à execução geral, Code altera a orquestração, Minimal reduz deliberadamente a assistência e 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 o ambiente amplo de agente, mas Code altera a forma como o trabalho com ferramentas em várias etapas pode ser expresso. Minimal move-se intencionalmente na direção oposta, reduzindo a superfície de ferramentas. Creator parte de Standard e acrescenta capacidades para a composição do ambiente de execução, em vez de simplesmente adicionar outra ferramenta de produtividade diária.

É também por isso que dois testes que utilizem o mesmo modelo DeepSeek podem produzir resultados diferentes se as configurações do 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 ao realizar uma 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 é realmente necessário um ambiente de execução mais especializado. Começar pelo Minimal apenas por parecer 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 dos resultados das 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 estiver relacionada com o modelo, e não com 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 tratam o DeepSeek Harness como infraestrutura para construir um novo agente, em vez de simplesmente operar o agente predefinido.

Se o seu objetivo mais amplo é criar capacidades de agente reutilizáveis 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 pertencer ao mesmo nível que 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 de planeamento opcional por agente que altera as orientações fornecidas ao modelo.

A documentação do subsistema do DeepSeek descreve explicitamente o Plan Mode como orientação flexível. Enquanto está ativo, é incluída nas solicitações ao modelo uma secção de prompt relacionada com o planeamento. 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 runtime: 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 runtime

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 de runtime principais, enquanto o Plan Mode é um mecanismo de planeamento opcional e separado, e não uma quinta predefinição de runtime 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. O Standard centra-se na execução. O Code centra-se na orquestração. O Minimal centra-se na avaliação. O Creator centra-se na composição. Em conjunto, mostram que a DeepSeek trata o harness como uma parte ativa do comportamento do agente, e não como uma camada invisível de ligação 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 novas tentativas, as competências, a memória ou a composição do runtime pode mudar aquilo que o mesmo modelo consegue realizar. Se está interessado em expandir essas capacidades em vez de reconstruir todo o runtime, 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 vistas 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 uma orquestração programática. Um agente especializado em servidores domésticos poderá eventualmente merecer a sua própria predefinição.

O DeepSeek Harness ainda está numa 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. Observe o harness que determina como esse modelo pode agir.