Guia · Atualizado em 10 de novembro de 2026 · Por Cameron Voss e West Mao

Como configurar o DeepSeek SuperAgent no GitHub: do Issue ao Pull Request (novembro de 2026)

Um caminho prático de uma conta de agente dedicada para uma Pull Request pequena e revisável.

Resposta rápida

Execute o protótipo em um ambiente dedicado, conecte um repositório e uma conta GitHub exclusiva para o agente e autorize apenas um solicitante confiável. Depois, peça ao agente que resolva um Issue pequeno. Revise o ticket, o branch, os testes e o Pull Request. O modo Observe não impede que uma solicitação explícita inicie o trabalho.

DeepSeek SuperAgent é um protótipo de pesquisa construído no DeepSeek Harness, não um produto oficial da DeepSeek ou software pronto para produção. Ele precisa de um provedor de modelo configurado separadamente. Este guia segue a documentação publicada; não executamos uma implantação completa para este artigo.

Uma primeira tarefa útil é pequena o suficiente para ser revisada em minutos: corrigir um comando desatualizado no README de um repositório de teste. O exemplo abaixo é um plano de teste, não uma execução registrada. O agente pode fazer perguntas, falhar em uma verificação ou não produzir nenhuma Pull Request.

O que você precisa antes de conectar o GitHub?

O guia de implantação publicado exige Node.js 22.19+ ou 24+, pnpm, Git 2.32+, Python 3.8+, tmux, GitHub CLI 2.48+, uma instalação compatível do DeepSeek Harness e um provedor de modelo configurado. A documentação indica @deepseek-ai/dsh@0.2.1-rc.3 como exemplo; verifique a atual gama engines.dsh do protótipo antes de escolher outra versão. O projeto tem como alvo um repositório no github.com; GitHub Enterprise Server não é compatível com a fonte documentada.

Preparar	Por que é importante
Conta de sistema operacional separada ou host isolado	Os trabalhadores são executados com as permissões do sistema operacional da conta de serviço. Mantenha credenciais pessoais e arquivos não relacionados fora do alcance.
Repositório de teste	Use um repositório pequeno sem segredos de produção ou privilégios de implantação. Mantenha um clone local para árvores de trabalho por ticket.
Usuário GitHub dedicado	O agente precisa de sua própria identidade de usuário e acesso ao repositório. A fonte documentada lê as notificações dessa conta.
Solicitante confiável	Comece com seu próprio login do GitHub na lista de permitidos. Mantenha a mesclagem automática desativada e use a proteção de ramificação.
Provedor de modelo	Configure um provedor funcional no Harness. As taxas de modelo e hospedagem são separadas do código licenciado pelo MIT.

A identidade do GitHub e a conta do sistema operacional resolvem problemas diferentes. Credenciais separadas do GitHub não impedem que um trabalhador leia arquivos que sua conta do sistema operacional pode acessar.

Como você prepara o tempo de execução e a conta do agente?

Instale as ferramentas necessárias no ambiente que executará o serviço. Verifique suas versões com node -v, pnpm -v, git --version, python3 --version, tmux -V, gh --version e dsh --version.
Dê ao usuário dedicado do GitHub do agente acesso ao repositório de teste. Assine o wrapper GitHub CLI do agente nessa conta, não em sua conta pessoal, e confirme o login retornado.
Clone e construa o repositório deepseek-ai/dsh-superagent-prototype dentro do ambiente de serviço. O SETUP.md do projeto descreve uma configuração assistida por agente; seu guia de implantação fornece etapas manuais.
Crie um perfil separado do SuperAgent Harness apenas para uma nova instalação, instale o pacote e configure o diretório e painel de estado do perfil. Não recrie um perfil existente: o comando documentado de criação de perfil substitui sua configuração.
Inicie o serviço e verifique scripts/dsh-superagent status. Na primeira inicialização, podem ser esperadas informações de configuração ausentes; resolva-o antes de enviar uma tarefa.

Para um perfil novo, o exemplo de implantação publicado usa a sequência a seguir. Execute-o dentro do ambiente de serviço isolado após revisar o repositório e os pré-requisitos. Substitua REPOSITORY_URL pela URL do repositório público deepseek-ai/dsh-superagent-prototype.

npm install -g @deepseek-ai/dsh@0.2.1-rc.3
git clone REPOSITORY_URL dsh-superagent
cd dsh-superagent
pnpm install && pnpm build
# New profile only: this replaces an existing superagent profile.
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"

A configuração manual publicada requer então uma configuração de máquina baseada em examples/profile.cordis.patch.yml. Defina um stateDir absoluto e as configurações de ligação local do painel antes de iniciar o serviço. Revise o exemplo e o guia de implantação atual no repositório com check-out em vez de copiar espaços reservados em uma configuração em execução.

scripts/dsh-superagent start
scripts/dsh-superagent status

Mantenha segredos fora do problema, da transcrição do bate-papo e do repositório. Defina credenciais por meio do fluxo de login pretendido e verifique a conta e as permissões em seu próprio ambiente.

Quais configurações transformam um Issue em ticket?

No painel SuperAgent, configure o GitHub Source com o repositório e o wrapper CLI do agente. De acordo com a política, adicione o login do GitHub do solicitante à lista de permitidos. Configure a execução com uma fonte de checkout e um comando de preparação que fornece a cada ticket sua própria árvore de trabalho. Uma árvore de trabalho mantém as alterações organizadas; não é uma sandbox de segurança.

Comece com observe como modo de aceitação para atividade inferida e mantenha a mesclagem automática desativada. Verifique se os relatórios de origem estão prontos e se o status não informa mais a configuração ausente. O painel poderá utilizar uma redação diferente numa versão posterior; registre suas versões instaladas antes da solução de problemas.

O que escrever no primeiro Issue do GitHub?

Na conta do solicitante permitida, adicione um comentário que se dirija ao agente. Substitua o nome pelo login real do seu agente:

@agent-login Please update the README installation example to match the current package name. Limit the change to the README, run the relevant documentation check, and open a pull request for human review. Do not merge.

Esta é uma solicitação explícita. Se aceito, ele poderá ser executado mesmo enquanto o trabalho inferido estiver em observe. O intervalo de pesquisa padrão documentado é de um minuto, mas um ticket ou PR não é garantido. Se o corpo de um problema foi editado para adicionar uma menção e nada acontecer, poste a menção como um comentário.

Como revisar o ticket e o Pull Request?

Abra a visão geral e procure o ticket. Confirme se o problema, o solicitante e a descrição da tarefa correspondem ao que você pretendia.
Inspecione se o ticket está na fila, funcionando, bloqueado ou aguardando revisão. Uma pergunta ou status bloqueado precisa de uma pessoa; não é evidência de uma correção concluída.
Abra o branch proposto e o PR. Verifique os arquivos alterados, confirme a identidade e a comparação exata. Confirme se nenhum segredo ou alteração não relacionada foi adicionado.
Execute ou inspecione as verificações relevantes de forma independente. Solicite uma correção no fio existente quando necessário; mantenha a solicitação dentro do escopo da tarefa original.
Somente uma pessoa com autoridade de repositório apropriada deve aprovar e mesclar o resultado revisado nesta primeira tentativa.

E se nenhum ticket aparecer?

Sintoma	Primeira verificação
Nenhuma resposta a uma menção	Verifique se a fonte está habilitada, o processamento não está pausado e o solicitante está permitido. Use um novo comentário em vez de um corpo de problema editado.
A CLI do agente não pode ler sua conta	Verifique o wrapper configurado e assine esse wrapper na conta de agente dedicada.
O agente não pode ler ou enviar	Confirme o nome do repositório e o acesso real da conta do agente.
Falha no comando de preparação	Ler o erro do ticket; verifique o caminho do clone, o destino da árvore de trabalho e a configuração do Git.
O status retorna 3	O serviço está aguardando configuração. Leia o requisito ausente em vez de reiniciar repetidamente.

Um Coding Plan pode executar este protótipo?

O SuperAgent usa o provedor de modelo configurado no Harness. Não verificamos se este protótipo funciona com os Coding Plans deste site, portanto verifique o endpoint, modelo e compatibilidade de autenticação antes de comprar um plano para este fluxo de trabalho. Comece com o guia de configuração e custo ou compare os Coding Plans disponíveis.

Perguntas frequentes

O modo de observação interrompe a solicitação de uma pessoa permitida?

Não. Registra decisões positivas para candidatos inferidos sem aceitá-los; solicitações explícitas continuam possíveis.

Uma instância pode abranger vários repositórios?

O protótipo público está documentado para um repositório GitHub. Trate qualquer adaptação de vários repositórios como um projeto separado para avaliação.

Um Pull Request comprova que a tarefa foi concluída?

Não. Revise a comparação e os resultados do teste e verifique a alteração em relação ao problema antes de mesclar.

Veja os preços dos Coding Plans