DeepSeek Harness: início, quatro modos e limites de plugins
Inicie o DeepSeek Harness em uma pasta isolada, escolha entre Standard, PTC, Minimal e Creation e revise permissões antes de adicionar plugins.
DeepSeek Harness é um ambiente open source para montar um agente com partes substituíveis: modelo, ferramentas, skills, sessão, sandbox, armazenamento, agent loop, agendamento e UI. A DeepSeek classifica o projeto como Developer Preview. Por isso, o primeiro objetivo deve ser uma execução observável em uma pasta isolada, e não a adoção imediata em um repositório de produção.
Se você pretende conectar um modelo por um API endpoint personalizado, verifique protocolo, Base URL e autenticação antes de instalar plugins. BetterToken.ai oferece interfaces OpenAI-compatible e Anthropic-compatible para ferramentas que aceitam Base URL próprio, mas isso não comprova compatibilidade com todo plugin do Harness. Confira o schema do provider e o API Key na documentação da BetterToken e execute uma pequena tarefa read-only.
O que a DeepSeek publicou
O repositório oficial usa licença MIT e é baseado no Cordis. O Cordis carrega e descarrega plugins e gerencia dependências; as capacidades do agente são fornecidas pelos plugins. Assim, é possível testar separadamente uma troca de modelo, de ferramentas ou de sessão.
Primeiro início em uma pasta descartável
Depois de instalar o Node.js, inicie a Web UI:
- Crie uma pasta vazia ou um clone limpo, sem segredos e sem alterações não commitadas.
- Escolha o modo Standard.
- Peça uma tarefa read-only, como localizar o entry point ou explicar a estrutura.
- Compare a resposta com os arquivos reais e revise o Trajectory antes de permitir edições.
O isolamento é uma prática de engenharia; ele não significa que o Harness torne qualquer comando shell seguro.
Como escolher o modo
- Standard: agente completo com edição de arquivos, shell, busca, skills, planos, metas, subagentes e workflows. É o ponto de partida recomendado.
- PTC: inclui o Standard e o Code Mode SDK, no qual o modelo compõe chamadas de ferramentas em um programa TypeScript. Revise o programa e os limites de cada chamada.
- Minimal: mantém apenas bash persistente e
str_replace_editor. Serve para ambiente mínimo e baseline de benchmark. - Creation: acrescenta inspeção do runtime, experimentos de plugins Cordis em memória e criação de presets. Use quando for construir uma configuração própria.
PTC não garante uma resposta melhor; sua vantagem é tornar a orquestração legível e reproduzível. Minimal é uma referência diagnóstica, não apenas um Standard menor.
Trajectory como trilha de auditoria
Segundo a DeepSeek, o contexto visto pelo modelo e os eventos da execução são registrados em um log de sessão append-only: system prompts, tool calls e resultados, agendamento de subagentes e injeções de contexto. No Trajectory, verifique quais arquivos e saídas o agente realmente viu, onde surgiu uma chamada inesperada e se a execução parou por falta de permissão, ferramenta, instrução ou contexto.
Antes de instalar um plugin, registre qual lacuna ele resolve, quais dados e serviços acessa, como detectar regressão e como fazer rollback. Leia o código-fonte e as dependências de plugins da comunidade. Consulte novamente o quickstart oficial antes de trabalhar com dados reais, pois mudanças incompatíveis são esperadas no Developer Preview.