DEV Community

Cover image for Plugin de entrega en vivo de Qwen: cómo ejecutar tareas largas de agente que puedes controlar en tiempo real
Roobia
Roobia

Posted on Originally published at apidog.com

Plugin de entrega en vivo de Qwen: cómo ejecutar tareas largas de agente que puedes controlar en tiempo real

Qwen Live Delivery Plugin: entregas vivas para tareas largas de agentes con Codex CLI

El Qwen Live Delivery Plugin es un plugin de código abierto para Codex CLI del equipo de Qwen que hace que una tarea larga de agente entregue una primera versión utilizable desde el principio, y luego la mejore versión a versión mientras añades requisitos desde un banco de trabajo en el navegador. Es Apache-2.0, versión 0.1.0, y funciona en Linux y macOS con Node.js 22+.

Prueba Apidog hoy

Esa es la respuesta corta. El resto de esta guía cubre qué hay dentro del plugin, cómo instalarlo, cómo funcionan los presupuestos de tiempo, la configuración de sandbox que no deberías cambiar a la ligera, y cómo hacer que tu agente demuestre cada versión entregada contra una API real con Apidog CLI.

¿Qué es el Qwen Live Delivery Plugin?

El Qwen Live Delivery Plugin es un complemento ligero para tareas largas de agentes de programación. En lugar de dejar que el agente trabaje en una caja negra durante una hora, le impone un ritmo: planificar un hito pequeño y utilizable, construirlo, verificarlo, publicar una versión congelada y luego planificar el siguiente a partir de los resultados y tus comentarios. Puedes dirigirlo en cualquier momento.

Live Delivery

El equipo de Qwen de Alibaba lo lanzó junto con la versión general de Qwen4-Max el 2026-11-16, donde la publicación de lanzamiento llama a la idea "Live Delivery": entregar una versión funcional desde el principio y seguir mejorándola lanzamiento a lanzamiento mientras el usuario la dirige. Si necesitas primero el contexto sobre el modelo, lee qué es Qwen4-Max y cómo usar Qwen4-Max.

La ventaja: un giro equivocado cuesta una versión, no toda la ejecución, porque un artefacto utilizable permanece sobre la mesa todo el tiempo.

Qué hay dentro del plugin

El repositorio de Qwen-Live-Delivery-Plugin contiene cuatro partes que funcionan en conjunto:

Parte Qué es Qué hace
Skill Live Delivery $ld:go Indica al agente que elija una primera versión mínima y utilizable, planifique cada versión siguiente a partir de resultados reales y ejecute comprobaciones en cada iteración
Servidor MCP ld_begin, ld_publish, ld_status, ld_done Gestiona el plan de entrega, congela instantáneas de versiones con una entrada de vista previa, informa del presupuesto restante y cierra la tarea
Hooks del ciclo de vida SessionStart, UserPromptSubmit, PostToolUse, Stop, Interrupt, SessionEnd Incorporan tus comentarios al contexto, bloquean los turnos de "ya terminé" prematuros mientras quede presupuesto y apoyan el cierre
Banco de trabajo en el navegador Interfaz web local Muestra el plan, previsualiza y descarga versiones, recoge nuevos requisitos, ajusta el presupuesto o detiene la tarea

Las cuatro herramientas MCP son el protocolo que sigue el skill:

  • ld_begin inicia la tarea con el objetivo completo, un título y un primer hito. Cada hito lleva un id, un alcance, criterios de aceptación y un target_after, un tiempo medido desde el inicio de la tarea.
  • ld_publish congela una versión: los archivos, un preview_entry explícito (por ejemplo, un index.html para un sitio), una nota de cambios y una lista de checks. Cada comprobación tiene una label, un result de passed, failed o not_run, y una evidence opcional.
  • ld_status lee el plan, el presupuesto restante, los comentarios en cola y el estado de detención, o publica un mensaje público de una línea en el banco de trabajo.
  • ld_done cierra la tarea con un resumen.

El skill indica al agente que nunca marque una comprobación fallida o no ejecutada como superada. El host verifica las copias de las instantáneas y sus hashes, pero los resultados de aceptación los informa el propio agente. Cerraremos ese hueco con una prueba de API real más adelante.

Los hooks son el volante. Para una tarea iniciada desde el navegador, el host interrumpe al agente y reanuda el mismo hilo de Codex para que tu mensaje llegue a través de UserPromptSubmit. Para una tarea iniciada en la CLI, los comentarios llegan en la siguiente herramienta compatible o en el límite del turno.

Cómo ejecuta Live Delivery una tarea larga

Diagrama del bucle Live Delivery

Aquí está el bucle, en orden:

  1. Escribes una solicitud $ld:go con el resultado que quieres.
  2. El agente llama a ld_begin con el objetivo completo y un primer hito. No hay paso de aprobación de plan aparte.
  3. Construye el hito y ejecuta sus criterios de aceptación.
  4. Llama a ld_publish, que congela la versión 1 con sus archivos y su entrada de vista previa.
  5. Abres el banco de trabajo, pruebas la versión y escribes los cambios en el panel izquierdo.
  6. El agente replanifica: compara lo entregado con el objetivo completo, incorpora tus comentarios y llama a ld_begin con el siguiente hito.
  7. Los pasos 3 a 6 se repiten hasta que se agote el presupuesto o pulses Stop task. Entonces publica cualquier mejora lista y llama a ld_done.

Dos reglas destacan. No hay un número fijo de versiones, así que el agente decide el alcance en cada ronda según el valor. Y terminar los hitos planificados no pone fin a la tarea mientras quede tiempo autorizado: el agente sigue buscando la siguiente mejora útil.

Cómo instalar el Qwen Live Delivery Plugin

Comprueba primero los requisitos:

  • Codex CLI (el único entorno compatible en el lanzamiento; probado con Codex 0.166.0 y 0.167.1)
  • Linux o macOS
  • Node.js 22 o superior

El plugin no incluye ningún modelo ni clave de API. Usa el modelo, la autenticación y la configuración de aprobación que ya tengas en Codex. Consulta la documentación de Codex CLI de OpenAI si aún no has configurado Codex.

Clona el repositorio y ejecuta el instalador sobre tu proyecto:

git clone https://github.com/QwenLM/Qwen-Live-Delivery-Plugin.git
cd Qwen-Live-Delivery-Plugin
./live-delivery/install.sh --workspace /path/to/project
Enter fullscreen mode Exit fullscreen mode

Pulsa Enter y el plugin se instala, configura los hooks y abre Codex. La versión no necesita npm install. Si Codex ya estaba abierto, inicia una nueva sesión.

Banderas útiles del instalador:

  • --install-only instala sin abrir Codex
  • --doctor revisa una instalación existente

También puedes pedirle a Codex que lea el README y siga su skill de instalación; tras la instalación, $ld:install se encarga de la configuración y el diagnóstico. Para desinstalar, ejecuta codex plugin remove ld@live-delivery-local --json y codex plugin marketplace remove live-delivery-local --json. Tus espacios de trabajo y registros de entrega se conservan.

Inicio rápido: tu primera tarea dirigible

Inicia Codex en tu proyecto con un presupuesto de tiempo:

cd /path/to/project
QWEN_LD_TIME_BUDGET=12m codex
Enter fullscreen mode Exit fullscreen mode

Luego escribe la solicitud. El ejemplo del README:

$ld:go Build an offline pendulum experiment. Let me adjust the length, pause the
animation, and understand how length affects the period. Make it work on mobile too.
Enter fullscreen mode Exit fullscreen mode

La CLI imprime una URL del banco de trabajo. Ábrela. Ese enlace otorga acceso al banco de trabajo, así que trátalo como una contraseña y no lo pegues en tickets ni chats. Tras un reinicio, usa el enlace más reciente que imprima la CLI.

En el banco de trabajo:

  1. Tras la primera entrega, selecciona una versión a la derecha y abre Files para previsualizar o descargar archivos individuales.
  2. Añade requisitos a la izquierda. Enter envía; Shift+Enter añade un salto de línea.
  3. Usa Time budget en la cabecera para cambiar el tiempo total, o Stop task para finalizar.

Presupuestos de tiempo, sandbox y otras configuraciones

El presupuesto de tiempo es el tiempo total de ejecución que el agente puede gastar. Configúralo con QWEN_LD_TIME_BUDGET antes de iniciar Codex, o cámbialo después en la cabecera del banco de trabajo. Los valores que importan:

Configuración Valor
Presupuesto por defecto (sin la variable) 30 minutos (1 800 segundos en la configuración del plugin)
Unidades aceptadas minutos, horas o días, como 15m, 3h, 2d
Máximo 7 días
Quién puede ampliarlo Solo tú; las herramientas del modelo no pueden elevar el límite autorizado
Comportamiento al detener Espera a que termine la llamada a la herramienta en curso

Ahora la advertencia. Las tareas iniciadas en el navegador usan por defecto el sandbox workspace-write de Codex. Establecer QWEN_LD_TASK_SANDBOX=danger-full-access desactiva el sandbox y la aprobación por comando, de modo que el agente puede tocar cualquier cosa fuera del espacio de trabajo con los permisos de tu cuenta del sistema operativo. El instalador nunca lo activa por ti. Mantén el valor por defecto a menos que ejecutes dentro de una máquina virtual o contenedor desechable.

Usa el banco de trabajo en una red confiable. Para acceso solo local o reenvío de puertos por SSH, establece QWEN_LD_BIND_HOST=127.0.0.1 antes de iniciar Codex.

Limitaciones que debes conocer antes de depender de él

Esta es una versión 0.1.0, y el README es claro sobre su alcance:

  • Solo Codex CLI. El soporte para otros entornos de agentes está en la lista de pendientes, sin fecha.
  • Solo Linux y macOS. No hay soporte listado para Windows.
  • Tu modelo, tu cuota. El plugin usa el modelo que tenga configurado Codex. Un presupuesto de siete días en un modelo de frontera gasta dinero real, así que revisa los precios de Qwen4-Max o el Qwen4-Max Token Plan si ese es el modelo detrás de tu entorno, o Qwen4-Max gratis para las vías de cuota gratuita.
  • Las comprobaciones son autoreportadas. El host verifica las instantáneas de archivos, no si tus criterios de aceptación realmente se cumplen.
  • Las tareas de la CLI reciben los comentarios más tarde. Las tareas iniciadas en la CLI ven los comentarios del navegador solo en límites de herramientas o de turnos.

Haz que cada versión entregada se demuestre a sí misma con Apidog CLI

Live Delivery exige comprobaciones veraces en cada versión, pero una comprobación que diga "la API funciona" vale lo que valga la prueba que la respalda. Si tu agente está construyendo una API, o una aplicación que consume una, como la API de Qwen4-Max, haz que ejecute una prueba real con Apidog CLI antes de cada ld_publish y pegue el resultado como evidencia.

Diagrama de apidog run con ld_publish

Configúralo una vez:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick Codex when prompted
Enter fullscreen mode Exit fullscreen mode

Luego añade un prompt a la solicitud $ld:go, o envíalo desde el banco de trabajo a mitad de la tarea:

Before every ld_publish: in Apidog project <projectId>, keep an environment
"Qwen Singapore" with base URL https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1
and a secret DASHSCOPE_API_KEY. Keep a test case for POST /chat/completions with
model qwen4-max that asserts status 200, a non-empty choices array and a usage object.
Run it, and turn each assertion into an ld_publish check with the report as evidence.
Never mark a failed assertion passed.
Enter fullscreen mode Exit fullscreen mode

El agente lee cada esquema de payload antes de escribir, y luego ejecuta el caso en cada versión:

apidog environment create "Qwen Singapore" --project <projectId> --base-url https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json --out-dir ld-reports
Enter fullscreen mode Exit fullscreen mode

El reporter cli imprime en el registro si pasa o falla; json escribe un informe en ld-reports que el agente cita en la evidence de cada comprobación. Si lo que se está construyendo es tu propia API, cambia el endpoint por el tuyo y añade las rutas nuevas de la versión al caso en cada ronda. Añade --upload-report para ver las ejecuciones en la app de Apidog. Para más prompts de Codex, consulta Apidog CLI en Codex, y lleva el mismo apidog run ... -r junit a CI con la guía de CI/CD de Apidog CLI. El plan gratuito de Apidog cubre hasta 4 usuarios.

Preguntas frecuentes

¿El Qwen Live Delivery Plugin funciona con Claude Code o Cursor? Todavía no. En el lanzamiento solo es compatible con Codex CLI. Otros entornos están en la lista de pendientes del proyecto, sin fecha.

¿Necesito una clave de API de Qwen para usarlo? No. El plugin no incluye ningún modelo ni clave. Funciona con el modelo y la autenticación que tu instalación de Codex ya usa.

¿Cuál es el presupuesto de tiempo por defecto? 30 minutos si no estableces QWEN_LD_TIME_BUDGET. Puedes fijar minutos, horas o días, hasta 7 días, y cambiarlo desde la cabecera del banco de trabajo.

¿Qué pasa cuando pulso Stop task? El agente termina la llamada a la herramienta en curso, no inicia un nuevo alcance, publica cualquier mejora lista cuyas comprobaciones pasen y llama a ld_done. Cada versión entregada queda disponible.

¿Es seguro ejecutarlo con acceso total? Solo en un entorno desechable. danger-full-access elimina el sandbox y la aprobación por comando. El instalador nunca lo activa, y el sandbox por defecto workspace-write es la opción sensata para la mayoría de los trabajos.

Top comments (0)