Qué es dsh-superagent y cómo funciona
El equipo DeepSeek Harness presentó dsh-superagent, un agente de programación proactivo diseñado para trabajar sobre repositorios de GitHub, organizar solicitudes y ejecutar varias tareas al mismo tiempo.
El proyecto está desarrollado en TypeScript, se distribuye bajo licencia MIT y se encuentra en su versión 0.1.0. Se publica como un paquete para DeepSeek Harness y sus responsables lo describen como un prototipo de investigación.
A diferencia de un agente que espera instrucciones constantes, dsh-superagent escucha los eventos de GitHub y, de forma opcional, los de Feishu. Cuando identifica una solicitud autorizada, puede convertirla en unidades de trabajo independientes y asignarlas a diferentes sesiones de agente.
Los resultados regresan a la conversación donde comenzó la solicitud, frecuentemente mediante una pull request, es decir, una propuesta de cambios en el código.
El proyecto también incorpora un panel web local que presenta únicamente la información que requiere la atención de una persona.
Un agente pensado para interrumpir menos
Según el README del proyecto, la idea central es obtener el máximo valor posible con la menor intervención humana necesaria.
Para conseguirlo, el agente sigue un comportamiento definido: confirma una solicitud una sola vez, continúa trabajando sin enviar actualizaciones innecesarias y vuelve a comunicarse cuando dispone de un resultado, necesita hacer una pregunta o encuentra un fallo.
Este enfoque busca que la conversación sirva para tomar decisiones y recibir entregas, mientras las tareas de programación avanzan en sesiones separadas.
Arquitectura Router-Worker: cómo reparte las tareas
dsh-superagent utiliza una arquitectura de dos capas que separa la comunicación con el usuario de la ejecución del trabajo.
La primera capa es el Router, una sesión de larga duración encargada de recibir eventos, gestionar las interacciones y distribuir las tareas. Utiliza el preset dsh-superagent-router, que dispone de un conjunto reducido de herramientas.
La segunda capa está formada por los Workers, sesiones aisladas que realizan las tareas asignadas. Cada una utiliza el preset dsh-superagent-worker.
Esta separación permite mantener una sesión principal dedicada a coordinar el sistema mientras diferentes Workers avanzan en trabajos independientes.
Del evento de GitHub a una tarea autorizada
El funcionamiento se organiza en cuatro elementos:
- Source → Trigger: GitHub o Feishu generan eventos que el sistema recibe como posibles solicitudes.
- Eval: evalúa si un conjunto de eventos requiere crear un nuevo trabajo.
- Ticket: representa una unidad de trabajo autorizada. Incluye un Mandate inmutable que establece por qué el agente tiene permiso para continuar.
- Subscription: permite enviar comentarios posteriores de una pull request al Worker correspondiente, sin necesidad de mencionar nuevamente al agente.
El sistema también gestiona comandos de shell que pasan a ejecutarse en segundo plano después de cinco segundos.
Tres modos para controlar el trabajo proactivo
dsh-superagent incluye tres modos de aceptación que determinan cómo responde a posibles tareas:
- off: desactiva la aceptación de trabajo proactivo.
- observe: registra qué tareas habría aceptado el agente, sin aceptarlas realmente. Es el modo predeterminado.
- auto: permite aceptar trabajo proactivo automáticamente.
Estos controles forman parte del mecanismo que regula cuándo una solicitud puede convertirse en una tarea ejecutable.
Resultados de la simulación: tiempos y carga del Router
DeepSeek evaluó el prototipo mediante simulaciones con mensajes sintéticos y herramientas simuladas.
Cada ejecución incluía aproximadamente 300 mensajes, de los cuales unos 20 correspondían a solicitudes reales de trabajo. Cada esquema se ejecutó cinco veces.
Las cifras son autoinformadas y proceden de informes secundarios del informe de DeepSeek.
Comparación de rendimiento
| Escenario o métrica | Resultado comunicado |
|---|---|
| dsh-superagent, tiempo de finalización p50 | 12,4 minutos |
| dsh-superagent, tiempo de finalización p95 | 15,7 minutos |
| Sesión única con subagentes y prompt neutro, tiempo de finalización p95 | 29,5 minutos |
| Invocaciones de subagentes con el prompt neutro de referencia | 0 en 5 ejecuciones |
| Tamaño medio de lote del Router | De 1,0 a 2,8 |
| Latencia por petición del Router | De 2,5 a 3,9 segundos |
| Decisiones del Router al retirar el paso directo de eventos | Aumento aproximado del 30 % |
| Tokens de lectura de caché al retirar el paso directo de eventos | Aumento aproximado del 37 %, de 23,23 a 31,77 millones |
Nota: p50 representa la mediana de los tiempos y p95 el percentil 95. La comparación con la sesión única comunica únicamente el valor p95 de esa configuración.
Qué muestran los resultados
En las simulaciones comunicadas, dsh-superagent alcanzó un p95 de 15,7 minutos, frente a los 29,5 minutos de la sesión única con subagentes y un prompt neutro.
También se observó que esa configuración de referencia no llegó a invocar subagentes durante sus cinco ejecuciones.
En cuanto a la capacidad del Router para gestionar eventos, DeepSeek simuló un aumento en la tasa de llegada desde aproximadamente un evento por minuto hasta 40 por minuto.
Con ese incremento, el tamaño medio de los lotes pasó de 1,0 a 2,8, mientras que la latencia por petición aumentó de 2,5 a 3,9 segundos.
Otra comparación examinó el efecto de retirar el mecanismo de paso directo de eventos. Según los resultados comunicados, esa modificación elevó aproximadamente un 30 % las decisiones del Router y un 37 % los tokens de lectura de caché.
Estas mediciones describen el comportamiento del sistema bajo cargas simuladas. La evaluación se centró en mensajes sintéticos y herramientas simuladas, y la calidad del código producido en tareas reales quedó fuera de las métricas estudiadas.
Límites del prototipo y requisitos técnicos
dsh-superagent se presenta como un prototipo de investigación que funciona con acceso completo del usuario al sistema operativo.
Por ese motivo, conviene ejecutarlo en un entorno aislado antes de utilizarlo, debido al alcance de sus permisos.
Para ejecutarlo en una máquina propia como un perfil dedicado de DeepSeek Harness, el proyecto establece los siguientes requisitos:
- Node.js 22.19+ o 24+.
- Git 2.32 o posterior.
- Python 3.8 o posterior.
- tmux.
- GitHub CLI 2.48 o posterior.
El proyecto también plantea tres ideas que van más allá de su implementación como prototipo.
La primera es incorporar un Watchdog externo, encargado de supervisar el funcionamiento del sistema. La segunda consiste en separar el almacenamiento del cómputo. La tercera propone un bucle ReAct asíncrono.
Estas propuestas forman parte de la evolución conceptual del proyecto, mientras que su implementación actual se centra en la coordinación de eventos, la autorización de tareas y la ejecución mediante sesiones Worker.
En contexto
dsh-superagent es un paquete del equipo DeepSeek Harness, publicado como prototipo de investigación bajo licencia MIT. Su diseño combina un Router persistente, sesiones Worker aisladas y eventos de GitHub o Feishu para organizar trabajo de programación con una intervención humana reducida.
