Guía · Actualizado el 10 de noviembre de 2026 · Por Cameron Voss y West Mao

Cómo configurar DeepSeek SuperAgent en GitHub: del Issue al Pull Request (noviembre de 2026)

Una ruta práctica desde una cuenta de agente dedicada a una pequeña Pull Request revisable.

Respuesta rápida

Ejecuta el prototipo en un entorno dedicado, conecta un repositorio y una cuenta de GitHub exclusiva para el agente y autoriza solo a un solicitante de confianza. Pídele que resuelva un Issue pequeño y revisa el ticket, la rama, las pruebas y el Pull Request. El modo Observe no impide que una solicitud explícita inicie el trabajo.

DeepSeek SuperAgent es un prototipo de investigación creado en DeepSeek Harness, no un producto oficial de DeepSeek ni un software listo para producción. Necesita un proveedor de modelo configurado por separado. Esta guía sigue la documentación publicada; No hemos ejecutado una implementación de un extremo a otro para este artículo.

Una primera tarea útil es lo suficientemente pequeña como para revisarla en minutos: corregir un comando desactualizado en el archivo README de un repositorio de pruebas. El siguiente ejemplo es un plan de prueba, no una ejecución registrada. El agente puede hacer preguntas, fallar una verificación o no generar ninguna Pull Request.

¿Qué necesitas antes de conectar GitHub?

La guía de implementación publicada requiere Node.js 22.19+ o 24+, pnpm, Git 2.32+, Python 3.8+, tmux, GitHub CLI 2.48+, una instalación compatible de DeepSeek Harness y un proveedor de modelo configurado. La documentación fija @deepseek-ai/dsh@0.2.1-rc.3 como ejemplo; Compruebe la gama engines.dsh actual del prototipo antes de elegir otra versión. El proyecto tiene como objetivo un repositorio en github.com; La fuente documentada no admite GitHub Enterprise Server.

Preparar	Por qué es importante
Cuenta de sistema operativo separada o host aislado	Los trabajadores se ejecutan con los permisos del sistema operativo de la cuenta de servicio. Mantenga las credenciales personales y los archivos no relacionados fuera de su alcance.
Repositorio de prueba	Utilice un repositorio pequeño sin secretos de producción ni privilegios de implementación. Mantenga un clon local para los árboles de trabajo por ticket.
Usuario dedicado de GitHub	El agente necesita su propia identidad de usuario y acceso al repositorio. La fuente documentada lee las notificaciones de esa cuenta.
Solicitante de confianza	Comience con su propio inicio de sesión de GitHub en la lista permitida. Mantenga desactivada la fusión automática y utilice la protección de ramas.
Proveedor de modelo	Configure un proveedor que funcione en Harness. Los cargos por modelo y alojamiento son independientes del código con licencia del MIT.

La identidad de GitHub y la cuenta del sistema operativo resuelven diferentes problemas. Las credenciales separadas de GitHub no impiden que un trabajador lea archivos a los que su cuenta de sistema operativo pueda acceder.

¿Cómo se prepara el tiempo de ejecución y la cuenta del agente?

Instale las herramientas necesarias en el entorno que ejecutará el servicio. Verifique sus versiones con node -v, pnpm -v, git --version, python3 --version, tmux -V, gh --version y dsh --version.
Otorgue al usuario de GitHub dedicado del agente acceso al repositorio de prueba. Firme el contenedor CLI de GitHub del agente en esa cuenta, no en su cuenta personal, y confirme el inicio de sesión que devuelve.
Clone y cree el repositorio deepseek-ai/dsh-superagent-prototype dentro del entorno de servicio. El SETUP.md del proyecto describe una configuración asistida por un agente; su guía de implementación proporciona pasos manuales.
Cree un perfil de SuperAgent Harness independiente solo para una nueva instalación, instale el paquete y configure el directorio de estado y el panel del perfil. No vuelva a crear un perfil existente: el comando de creación de perfil documentado reemplaza su configuración.
Inicie el servicio y verifique scripts/dsh-superagent status. En un primer inicio, es de esperar que falte información de configuración; resuélvelo antes de enviar una tarea.

Para un perfil nuevo, el ejemplo de implementación publicado utiliza la siguiente secuencia. Ejecútelo dentro del entorno de servicio aislado después de revisar el repositorio y los requisitos previos. Reemplace REPOSITORY_URL con la URL del repositorio 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"

La configuración manual publicada requiere una configuración de la máquina basada en examples/profile.cordis.patch.yml. Establezca un stateDir absoluto y la configuración de enlace local del panel antes de iniciar el servicio. Revise el ejemplo y la guía de implementación actual en el repositorio desprotegido en lugar de copiar marcadores de posición en una configuración en ejecución.

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

Mantén los secretos fuera del problema, la transcripción del chat y el repositorio. Configure las credenciales a través del flujo de inicio de sesión previsto y luego verifique la cuenta y los permisos en su propio entorno.

¿Qué ajustes convierten un Issue en un ticket?

En el panel SuperAgent, configure GitHub Source con el repositorio y el contenedor CLI del agente. Según la política, agregue el inicio de sesión de GitHub del solicitante a la lista permitida. Configure la ejecución con una fuente de pago y un comando de preparación que le da a cada ticket su propio árbol de trabajo. Un árbol de trabajo mantiene organizados los cambios; no es un entorno limitado de seguridad.

Comience con observe como modo de aceptación para la actividad inferida y mantenga desactivada la combinación automática. Verifique que la fuente informe que está lista y que el estado ya no indique que falta configuración. El panel podrá utilizar una redacción diferente en una versión posterior; registre sus versiones instaladas antes de solucionar el problema.

¿Qué debe decir el primer Issue de GitHub?

Desde la cuenta del solicitante permitido, agregue un comentario que se dirija al agente. Reemplace el nombre con el inicio de sesión real de su 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 es una solicitud explícita. Si se acepta, puede ejecutarse incluso mientras el trabajo inferido esté en observe. El intervalo de sondeo predeterminado documentado es de un minuto, pero no se garantiza un ticket o PR. Si se editó el cuerpo de un tema para agregar una mención y no sucede nada, publique la mención como un comentario.

¿Cómo revisar el ticket y el Pull Request?

Abra la descripción general y busque el ticket. Confirme que el problema, el solicitante y la descripción de la tarea coincidan con lo que pretendía.
Inspeccione si el ticket está en cola, funcionando, bloqueado o esperando revisión. Una pregunta o un estado bloqueado necesita una persona; no es evidencia de una solución completa.
Abra la rama propuesta y haga PR. Verifique los archivos modificados, confirme la identidad y la diferencia exacta. Confirme que no se agregaron secretos ni cambios no relacionados.
Ejecute o inspeccione las comprobaciones relevantes de forma independiente. Solicite una corrección en el hilo existente cuando sea necesario; mantenga la solicitud dentro del alcance de la tarea original.
Solo una persona con la autoridad de repositorio adecuada debe aprobar y fusionar el resultado revisado en esta primera prueba.

¿Qué pasa si no aparece ningún ticket?

Síntoma	Primera verificación
No hay respuesta a una mención	Verifique que la fuente esté habilitada, que el procesamiento no esté en pausa y que el solicitante esté autorizado. Utilice un comentario nuevo en lugar de un cuerpo de problema editado.
El agente CLI no puede leer su cuenta	Verifique el contenedor configurado y firme ese contenedor en la cuenta de agente dedicada.
El agente no puede leer ni enviar	Confirme el nombre del repositorio y el acceso real de la cuenta del agente.
Preparar comando falló	Error al leer el ticket; verifique la ruta del clon, el destino del árbol de trabajo y la configuración de Git.
El estado devuelve 3	El servicio está esperando la configuración. Lea el requisito que falta en lugar de reiniciar repetidamente.

¿Puede un Coding Plan ejecutar este prototipo?

SuperAgent utiliza el proveedor de modelo configurado en Harness. No hemos verificado que este prototipo funcione con los Coding Plans de este sitio, así que verifique la compatibilidad del punto final, el modelo y la autenticación antes de comprar un plan para este flujo de trabajo. Comience con la guía de configuración y costos o compare los Coding Plans disponibles.

Preguntas frecuentes

¿El modo de observación detiene la solicitud de una persona permitida?

No. Registra decisiones positivas para candidatos inferidos sin aceptarlas; las solicitudes explícitas siguen siendo posibles.

¿Puede una instancia abarcar varios repositorios?

El prototipo público está documentado para un repositorio de GitHub. Trate cualquier adaptación de múltiples repositorios como un proyecto separado para evaluar.

¿Un Pull Request demuestra que la tarea se completó?

No. Revise los resultados de las pruebas y diferencias, y verifique el cambio con respecto al problema antes de fusionar.

Ver precios de los Coding Plans