Por Cameron Voss e West Mao · Atualizado em 2 de novembro de 2026 · 12 min de leitura

DeepSeek SuperAgent: GitHub, instalação, provedores de modelos e custos

Um guia prático do protótipo de pesquisa: o que ele faz, como começar, quanto as chamadas ao modelo podem custar e como ele se compara ao agente em nuvem do GitHub Copilot.

O que é o DeepSeek SuperAgent?

O DeepSeek SuperAgent é um protótipo de pesquisa para executar tarefas de programação em um repositório do GitHub. Uma pessoa autorizada da equipe pode acionar o agente no GitHub. O protótipo cria um item de trabalho, inicia uma sessão de execução e responde na mesma conversa. Ele também pode receber solicitações pelo Feishu.

Existem dois materiais relacionados, mas diferentes: o artigo de design do Super-agent, que apresenta uma arquitetura mais ampla, e o dsh-superagent-prototype público, que implementa apenas parte dessas ideias. O código público é diferente da implementação interna da equipe e do que é descrito no artigo. Algumas ideias ainda não foram implementadas.

Como funciona a arquitetura do SuperAgent?

Uma solicitação pode chegar pelo GitHub ou por outra fonte configurada. O sistema verifica a solicitação de acordo com suas regras e decide se deve criar uma tarefa. Uma sessão principal coordena as tarefas; sessões de execução executam os tickets atribuídos em diretórios separados, e enviam o resultado para a conversa original.

Uma pessoa ainda precisa revisar o trabalho. O guia de instalação recomenda deixar a mesclagem automática desativada enquanto a equipe aprende como o agente se comporta.

Onde fica o GitHub oficial do SuperAgent?

O repositório oficial é deepseek-ai/dsh-superagent-prototype. O código é distribuído sob a licença MIT; mantenha os avisos de direitos autorais e de licença exigidos ao usar ou redistribuir o projeto.

Para instalar, consulte o arquivo SETUP.md e o guia de implantação no repositório. Esses documentos podem mudar à medida que o protótipo e o Harness evoluem.

Como instalar o DeepSeek SuperAgent?

Antes de começar, prepare uma máquina sob seu controle, um repositório de teste, uma conta do GitHub separada para o agente e um provedor de modelos. O guia de instalação lista Node.js 22.19+ ou 24+, pnpm, Git 2.32+, tmux, Python 3.8+, GitHub CLI 2.48+ e uma versão compatível do DeepSeek Harness. O Feishu exige componentes adicionais.

1. Prepare um ambiente isolado. Comece com um repositório de teste, uma conta dedicada ao agente e permissões limitadas. Escolha quem poderá solicitar tarefas.
2. Instale o Harness e o protótipo. Siga a versão e os comandos do guia de implantação atual. Instale e compile o pacote e adicione-o a um perfil dedicado ao SuperAgent.
3. Configure o perfil e o provedor de modelos. Ajuste a configuração da máquina e conecte uma rota de modelo funcional nesse perfil. Não coloque credenciais em comentários de issues ou logs compartilhados.
4. Conecte o GitHub e defina as regras. Configure o repositório, a identidade do agente e os usuários autorizados. Comece apenas com o GitHub se não precisar do Feishu.
5. Faça um teste pequeno. Peça ao agente uma alteração de escopo limitado no repositório de teste. Confira o registro da tarefa, as alterações, os logs, os testes e o uso do modelo antes de ampliar o acesso.

Atenção ao atualizar: o comando oficial de criação de perfil substitui um perfil existente e pode apagar sua configuração. Ele é destinado a uma instalação nova, não a uma atualização de rotina. Consulte o guia de implantação antes de executá-lo novamente.

Como configurar um provedor de modelos para o SuperAgent?

O SuperAgent usa o modelo padrão de seu perfil no Harness, a menos que as configurações de avaliação ou execução indiquem outro. Configure o provedor no perfil que executa o agente e consulte o guia de implantação para conferir as configurações atuais do perfil e do painel.

Opção 1: usar a API oficial da DeepSeek

Na interface Web do Harness, abra Settings → Models, insira sua chave de API no cartão da DeepSeek e salve. Selecione um modelo disponível e faça um teste pequeno. A configuração do provedor e a do SuperAgent são etapas distintas: confirme que a chave e o modelo estão disponíveis no perfil que realmente executa o agente.

Opção 2: usar outro provedor ou um gateway personalizado

A documentação do Harness descreve provedores integrados e a opção Custom model API. Para uma rota personalizada, informe o ID do provedor, a URL base, o protocolo compatível, a credencial e o ID do modelo. Use o protocolo correto para o endpoint e teste uma chamada simples antes de atribuir uma tarefa ao agente. Um modelo aparecer na lista de configuração não garante que o endpoint aceite todas as solicitações.

Quanto custa executar o DeepSeek SuperAgent?

O código é aberto, mas as chamadas ao modelo e a máquina que executa o agente podem gerar custos. A conta depende do modelo, da quantidade de contexto em cada solicitação, do uso de cache, da saída gerada e do número de sessões de execução. Uma tarefa com várias tentativas pode custar mais do que uma tarefa simples. Meça sua própria carga de trabalho antes de estimar o gasto mensal.

Exemplo de preço da API oficial da DeepSeek

O cálculo abaixo é um exemplo ilustrativo da API oficial. Não é o preço de um Coding Plan nem o resultado medido de uma tarefa real do SuperAgent. Na consulta de 2 de novembro de 2026, a página oficial informava para deepseek-flash, em horário de pico, US$ 0,30 por milhão de tokens de entrada não encontrados no cache e US$ 1,20 por milhão de tokens de saída. Os tokens de entrada encontrados no cache custavam US$ 0,006 por milhão de tokens. Fora do pico, os preços são menores; confira os horários e valores atuais do provedor.

Calcule os tokens de entrada encontrados no cache separadamente, pela tarifa aplicável. O exemplo não inclui hospedagem nem outras cobranças, e uma tarefa real pode usar mais ou menos tokens. Os Coding Plans têm suas próprias janelas de uso e limites; o cálculo por uso da API não descreve esses planos.

Como controlar o consumo?

• Comece com uma tarefa pequena e bem definida e registre o consumo informado pelo provedor antes e depois.
• Limite o número de sessões de execução simultâneas e confira os logs em busca de novas tentativas ou chamadas repetidas com contexto longo.
• Use os controles de orçamento ou alerta do provedor, quando disponíveis, e acompanhe o saldo e os limites do plano escolhido.
• Compare o custo de um resultado útil e revisado com o trabalho que ele economizou, em vez de olhar apenas para o preço de uma solicitação.

DeepSeek SuperAgent vs. agente em nuvem do GitHub Copilot: qual é a diferença?

Esta comparação aborda o fluxo de trabalho; não é um avaliação comparativa da qualidade do código. Recursos, modelos disponíveis e franquias do GitHub podem mudar.

Perguntas frequentes

O DeepSeek SuperAgent é gratuito?

O código-fonte do protótipo está disponível sob a licença MIT. Sua execução ainda pode gerar custos de modelos, máquina ou servidor e outros serviços.

O SuperAgent é um modelo da DeepSeek?

Não. Ele é um protótipo de agente de programação construído sobre o DeepSeek Harness. Para fazer chamadas ao modelo, precisa de um provedor configurado separadamente.

É necessário ter uma chave de API da DeepSeek?

É necessário configurar um provedor de modelos. A documentação do Harness também descreve provedores de terceiros e personalizados. O funcionamento de cada provedor depende do protocolo, do modelo e da versão utilizada.

Posso usá-lo com um Coding Plan que já tenho?

Possivelmente, mas a compatibilidade entre esse protótipo e nossos Coding Plans não foi verificada aqui. Confira o endpoint, a rota do modelo, as regras do plano e o funcionamento real antes de depender dessa configuração.

Devo deixar o agente mesclar pull requests automaticamente?

Inicialmente, revise e mescle as alterações por conta própria. O guia oficial recomenda manter a mesclagem automática desativada enquanto você aprende como o agente se comporta.

Preços e documentação podem mudar. O DeepSeek V4 Hub é um site independente e não é afiliado à DeepSeek nem ao GitHub e não tem o endosso dessas empresas.