O DeepSeek Harness funciona com a Novita AI ao iniciar a interface web do Harness localmente e adicionar a Novita AI como provedor de modelo personalizado compatível com OpenAI. Instale o Node.js, execute npx @deepseek-ai/dsh web, abra http://127.0.0.1:3080, depois use https://api.novita.ai/openai como URL base do provedor, uma chave de API da Novita AI como credencial e um ID de modelo da sua biblioteca de modelos da Novita AI. A configuração leva alguns minutos; o verdadeiro trabalho é escolher o modelo certo para codificação, análise de repositório, pesquisa ou tarefas de alto volume.
O Que é o DeepSeek Harness
O DeepSeek Harness é uma plataforma de agente (agent harness) de código aberto da DeepSeek AI construída em torno de uma arquitetura “tudo é um plugin”. A documentação oficial descreve o projeto como em pré-visualização para desenvolvedores e alerta que mudanças que quebram compatibilidade são prováveis, portanto a melhor postura para produção é fixar uma versão funcional, revisar as mudanças antes de atualizar e validar a integração após cada atualização.
A distinção entre o modelo e o harness fica mais fácil de perceber quando você os executa. Um LLM lê o prompt e decide o que fazer em seguida. Um harness dá a essa decisão um caminho de execução: um workspace, ferramentas, um shell, um navegador, sessões, armazenamento e uma maneira de observar o que aconteceu antes de escolher a próxima ação. O DeepSeek Harness empacota esse loop em uma interface web que você executa na sua própria máquina, enquanto o modelo de raciocínio pode permanecer como um serviço de API.
Esse design é adequado para vários tipos de trabalho:
- Alterações no código-fonte. Deixe o agente inspecionar arquivos, propor um patch, executar testes e revisar após falhas.
- Triagem de repositórios. Explore uma dependência desconhecida, mapeie caminhos de chamada, resuma áreas de risco e escreva tickets de acompanhamento.
- Pesquisa e relatórios. Combine navegação, saída de arquivos e resumos estruturados quando a resposta está espalhada por várias páginas.
- Experimentos operacionais. Elabore scripts, execute-os localmente com aprovação e registre o que mudou antes de escalar o fluxo de trabalho.
É menos adequado quando você precisa de uma chamada de API pequena e auditável, sem acesso a arquivos ou execução local. Um harness de agente é um ambiente de desenvolvimento, não apenas um endpoint de inferência. Se você precisa apenas de conclusões de chat, a API LLM da Novita AI direta é mais simples.
O Que Você Precisa Antes da Configuração
Você precisa de quatro coisas:
- Uma máquina com Node.js instalado.
- Uma conta na Novita AI.
- Uma chave de API da Novita AI.
- Um diretório de trabalho que o agente possa ler e, quando apropriado, editar.
Para confirmar que o Node.js está instalado, execute:
node --version
O repositório oficial do DeepSeek Harness atualmente declara suporte para Node.js ^22.19.0 || >=24.0.0. Se o comando imprimir uma versão mais antiga ou falhar, instale o Node.js em nodejs.org e execute a verificação novamente. Evite executar comandos como administrador do sistema se possível; se npx falhar porque não pode escrever no cache global, corrija as permissões do Node.js/npm em vez de abrir um shell como root.
Antes de sair da configuração, crie uma pasta de projeto dedicada e coloque-a sob controle de versão se o conteúdo importar. Um harness com acesso a ferramentas pode ser extremamente útil, mas “olhe este código” é um nível de risco diferente de “publique em produção”. Revise as ações propostas pelo agente e evite conectá-lo a credenciais que ele não precisa.
Como Conectar Modelos da Novita AI
Passo 1: Obtenha sua chave de API da Novita AI
Faça login na Novita AI, abra o Gerenciamento de Chaves, crie uma nova chave e copie-a imediatamente. Se o console mostrar a chave apenas uma vez, coloque-a em um gerenciador de senhas ou no cofre de segredos local que sua equipe já usa. Não cole em documentação, captura de tela, repositório de código ou chat compartilhado.
Para este guia, exporte-a no shell que iniciará o Harness:
export NOVITA_API_KEY="sua-chave"
A variável apenas facilita a configuração; a configuração do provedor na interface web na próxima seção é o que o Harness usa para fazer chamadas de modelo.
Passo 2: Execute a interface web do DeepSeek Harness
O README oficial fornece este caminho de inicialização npm:
npx @deepseek-ai/dsh web
A primeira execução baixa o pacote e suas dependências, portanto pode levar mais tempo que as execuções posteriores. O DeepSeek Harness então abre a interface web em http://127.0.0.1:3080 por padrão e a inicia no seu navegador padrão. Se você estiver trabalhando via SSH ou não quiser que o navegador seja aberto, o README oficial documenta a flag --no-open:
npx @deepseek-ai/dsh web --no-open
O DeepSeek Harness também pode ser executado a partir do código-fonte com pnpm install, pnpm run build e pnpm dsh web, mas o caminho npm é a rota mais rápida para uma interface web funcional e é o que este guia usa.
Passo 3: Adicione a Novita AI como provedor personalizado
Os rótulos exatos podem mudar conforme o DeepSeek Harness itera, mas o objetivo é o mesmo na interface web atual: abra as configurações de modelo/provedor e adicione um provedor personalizado compatível com OpenAI.
| Campo | Valor a usar |
|---|---|
| Nome de exibição | Novita AI |
| ID do provedor | novita ou outro identificador local estável |
| URL base | https://api.novita.ai/openai |
| Chave de API | Sua chave de API da Novita AI |
| Catálogo de modelos | Atualize ou adicione os IDs específicos dos modelos da Novita AI que você deseja |
Use https://api.novita.ai/openai, não um caminho para um modelo específico. Mantenha o ID do provedor estável; se você renomeá-lo depois, as configurações de sessão existentes podem apontar para um provedor que não existe mais. Após salvar o provedor, atualize o catálogo de modelos e torne o modelo visível no seletor de sessão.
O protocolo de API a escolher é openai-completions. O DeepSeek Harness documenta este protocolo para OpenAI Chat Completions e oferece openai-responses e anthropic-messages para gateways que usam esses formatos de requisição.
Passo 4: Selecione o modelo e o workspace
Abra um workspace na interface do DeepSeek Harness e escolha um dos modelos da Novita AI que você acabou de adicionar. Se a interface tiver uma ação “obter modelos”, use-a em vez de digitar um ID de modelo de memória. Os IDs de modelo são o contrato de integração: um ID errado pode parecer um problema de rede, um problema de permissão ou um catálogo vazio.
Em seguida, execute uma tarefa pequena antes de usar um código-fonte importante:
Liste os arquivos neste workspace, identifique o ponto de entrada principal e proponha uma melhoria de documentação de baixo risco.
Confirme que o agente pode ler o workspace, chamar o modelo e parar antes de uma ação que você não aprovou. Uma vez que esse loop funcione, passe para uma tarefa real.
Se a descoberta de modelos não preencher a lista, adicione o ID do modelo manualmente. O DeepSeek Harness documenta a descoberta como uma conveniência, pois nem todo gateway retorna o mesmo formato de listagem.
O Que Você Pode Executar Após a Configuração
O DeepSeek Harness oferece um lugar para definir e operar sessões de agente, não apenas fazer perguntas de acompanhamento. Alguns pontos de partida práticos:
Explique e refatore um caminho de código existente
Aponte o workspace para um serviço ou pacote e peça ao agente para rastrear um recurso de ponta a ponta. A saída útil não é apenas prosa; pode incluir um plano de mudança, os arquivos que tocaria, os testes que adicionaria e os sinais que provariam que a refatoração funcionou.
Trace como uma requisição de entrada chega à camada de banco de dados. Produza um fluxo numerado, liste os prováveis pontos de falha e proponha testes para os dois caminhos de maior risco.
Revise o plano antes de permitir edições. Um modelo pode escolher uma rota de aparência coerente através de um código-fonte que depende de um inicializador implícito, um caminho de configuração desatualizado ou uma API antiga que ainda tem chamadores em produção.
Prepare uma migração ou limpeza
O Harness é útil para tarefas de “preparar o trabalho”. Peça um inventário de dependências, uma lista de uso de API, uma lista de verificação de compatibilidade ou um plano de migração em etapas. Esses artefatos são mais fáceis de revisar do que um grande patch único, e preservam o julgamento necessário se a migração envolver outras equipes.
Execute um fluxo de pesquisa para arquivo
Para análises de mercado ou comparações técnicas, peça ao agente para coletar fontes, reconciliar datas, anotar divergências e escrever um rascunho de relatório em um arquivo local. Mantenha a entrega restrita: “produza uma tabela de candidatos com URLs e datas” é mais fácil de verificar do que “diga o que está acontecendo neste mercado”.
Construa um fluxo de trabalho local repetível
Depois que um prompt funcionar, salve-o como um prompt de projeto ou plugin se sua versão do Harness suportar. Um prompt reutilizável deve declarar o workspace, as entradas necessárias, o formato de saída e os limites de segurança. Essa última parte é importante quando o fluxo de trabalho executa comandos ou edita arquivos.
Como Escolher um Modelo para a Tarefa
A Novita AI suporta DeepSeek e outras famílias de modelos, portanto a questão não é “qual provedor tem um modelo?” mas “qual modelo esta etapa do fluxo de trabalho deve usar?” Comece com as listagens atuais na biblioteca de modelos da Novita AI e confirme o ID exato do modelo na página do modelo antes de salvá-lo no Harness. IDs de modelos e limites mudam conforme os catálogos são atualizados.
Use estes padrões de roteamento como ponto de partida:
- DeepSeek V4.1 Flash é útil quando você deseja raciocínio geral forte para análise de código, tarefas com uso intenso de matemática ou explicações de várias etapas sem o perfil de custo de um modelo principal.
- GLM 5.3 é o GLM principal na listagem no momento da escrita, enquanto GLM 5.3 Flash é a opção multimodal nativa orientada à eficiência. Verifique os limites de contexto e saída antes de colocar um repositório inteiro em uma única requisição.
- Qwen3.8 Flash e Qwen3.8 Max** cobrem as extremidades de eficiência e principal da linha atual Qwen3.8. Execute a mesma tarefa de patch em seu padrão para ver se a saída é mais fácil de revisar.
- Kimi K3 é o principal da Moonshot no catálogo Novita e pode se adequar a fluxos de trabalho de contexto longo, pesquisa e uso intenso de ferramentas. Confirme o comportamento exato da API para chamadas de ferramenta antes de confiar nele em produção.
- MiniMax M3 é a listagem mais recente do MiniMax e é um candidato para trabalho interativo eficiente e com entrada multimodal. Meça a latência e a qualidade da revisão em seus próprios prompts, em vez de assumir que um resultado de benchmark será transferido.
Para trabalho de agente em produção, três medições importam mais do que um ranking:
- Sucesso na tarefa. O patch passa nos testes? O relatório contém as seções solicitadas? A chamada de ferramenta realiza a ação pretendida?
- Custo por resultado aceito. Conte as tentativas, a saída desperdiçada e o tempo humano gasto revisando planos ruins.
- Modo de falha. O modelo recusa educadamente, alucina uma chamada de ferramenta ou toma uma ação errada com confiança? O último precisa de configurações de aprovação mais rigorosas.
Se você quiser comparar dois modelos sem editar o provedor a cada vez, adicione ambos ao mesmo provedor da Novita AI, salve seus IDs de modelo exatos e execute o mesmo conjunto de prompts representativo. Em seguida, inspecione os artefatos finais, não apenas a saída do chat.
Solução de Problemas Comuns de Configuração
A lista de modelos está vazia
Verifique se a URL base é exatamente https://api.novita.ai/openai, se a chave de API está atualizada e se sua conta tem acesso ao modelo. Se a interface tiver uma ação de atualização, atualize o catálogo após salvar o provedor. Em seguida, teste a chave fora do Harness com uma chamada de API direta.
Se a obtenção de modelos retornar um erro de autenticação, verifique a chave primeiro. A chamada de descoberta do Harness acessa o endpoint de listagem de modelos compatível com OpenAI e pode falhar ali enquanto chamadas normais de conclusão falham por um motivo diferente.
O provedor salva, mas as requisições falham
Confirme se o ID do modelo corresponde à página do modelo da Novita AI. Verifique também se o modelo selecionado suporta o tipo de requisição que o harness está fazendo; um modelo apenas de texto pode não suportar uma requisição de imagem, e um modelo sem suporte a ferramentas pode falhar em uma etapa de agente que espera chamadas de ferramenta.
npx trava ou falha na primeira inicialização
A primeira inicialização baixa as dependências e pode demorar um pouco. Se falhar, verifique sua rede, cache npm e versão do Node.js. Uma nova tentativa limpa é razoável; se o erro mencionar permissões, prefira uma instalação do Node.js em nível de usuário ou cache do gerenciador de pacotes em vez de executar o comando com privilégios elevados.
O navegador não abre
O servidor ainda pode estar em execução. Abra http://127.0.0.1:3080 manualmente, ou reinicie com npx @deepseek-ai/dsh web --no-open e visite a URL de um navegador na mesma máquina. Via SSH, o host encaminhado pode não ser 127.0.0.1, então use o endereço impresso pelo comando.
O agente fez uma alteração inesperada
Pare a execução, inspecione seu diff de controle de versão e reverta o que você não deseja. Em seguida, reduza o escopo das ferramentas ou execute a tarefa em um workspace descartável. Se sua equipe usa branches protegidos e credenciais de implantação, mantenha-os fora do alcance do agente até que você confie no fluxo de trabalho.
Perguntas Frequentes
O DeepSeek Harness suporta modelos da Novita AI?
O DeepSeek Harness suporta provedores personalizados compatíveis com OpenAI, e a Novita AI expõe uma API compatível com OpenAI. Este guia usa o caminho de provedor personalizado: https://api.novita.ai/openai como URL base, uma chave de API da Novita AI e o ID exato do modelo da página do modelo da Novita AI.
Preciso implantar meu próprio servidor de modelo?
Não. A Novita AI hospeda a API do modelo; o DeepSeek Harness é executado localmente e chama essa API. Você não precisa gerenciar GPUs para esta configuração. Você ainda precisa de recursos locais suficientes para o processo Node.js e quaisquer ferramentas que o agente execute.
O DeepSeek Harness está pronto para produção?
O repositório oficial descreve o DeepSeek Harness como uma pré-visualização para desenvolvedores e alerta sobre mudanças que quebram compatibilidade. Pode ser útil hoje, mas fixe versões, revise as notas de versão, mantenha trabalhos importantes sob controle de versão e teste as atualizações em um workspace não crítico antes de mudar um fluxo de trabalho de produção.
Posso usar mais de um modelo no mesmo projeto?
Sim, se a interface suportar a troca de modelos em sua sessão. Um padrão útil é um modelo para rascunho ou código de primeira passagem, outro para revisão ou análise mais profunda, e um modelo de menor custo para sumarização, classificação ou extração repetida.
Onde devo armazenar minha chave de API da Novita AI?
Coloque-a na configuração do provedor apenas quando necessário, e caso contrário mantenha-a em um gerenciador de segredos local ou em um armazenamento de ambiente criptografado. Nunca a submeta, compartilhe em capturas de tela ou conceda permissões mais amplas do que a tarefa necessita.
O que devo fazer antes de conectar um código-fonte real?
Coloque o workspace sob controle de versão, confirme as configurações de aprovação do agente e remova credenciais que não são necessárias. Comece com uma tarefa somente leitura ou de baixo risco, depois expanda o conjunto de ferramentas depois de entender como o agente se comporta com seu projeto.
Artigos Recomendados
- What Are Coding Agents? How They Work and How to Build One
- GLM 5.2 on Novita AI: Long-Context Launch, Pricing, and Developer Fit
- DeepSeek V4 Pro vs Flash on Novita AI: Pricing, Model ID, and API Choice
Fontes
- Repositório oficial do DeepSeek Harness, verificado em 10 de setembro de 2026: status de pré-visualização para desenvolvedores, comando de inicialização npm, porta da interface web, flag
--no-opene caminho de execução a partir do código-fonte. - Guia de configuração de modelo do DeepSeek Harness, verificado em 10 de setembro de 2026: campos de provedor personalizado, protocolo
openai-completions, IDs de provedor permanentes, descoberta de modelos e solução de problemas. - package.json do DeepSeek Harness, verificado em 10 de setembro de 2026: faixa de engine do Node.js.
- Biblioteca de modelos da Novita AI, verificado em 10 de setembro de 2026: catálogo de modelos hospedados e páginas de modelos.
- Gerenciamento de Chaves da Novita AI, verificado em 10 de setembro de 2026: criação e gerenciamento de chaves de API.
- API LLM da Novita AI, verificado em 10 de setembro de 2026: URL base compatível com OpenAI e posicionamento da API.
