DEV Community

Cover image for Plugin de diffusion en direct Qwen : comment exécuter des tâches d'agent longues que vous pouvez piloter
Antoine Laurent
Antoine Laurent

Posted on Originally published at apidog.com

Plugin de diffusion en direct Qwen : comment exécuter des tâches d'agent longues que vous pouvez piloter

Plugin Qwen Live Delivery : livrez tôt, améliorez en continu avec Codex CLI

Le plugin Qwen Live Delivery est un plugin open source pour Codex CLI, développé par l'équipe Qwen, qui permet à une tâche d'agent de longue durée de livrer une première version utilisable rapidement, puis de l'améliorer version après version pendant que vous ajoutez des exigences depuis un atelier web (workbench). Il est sous licence Apache-2.0, en version 0.1.0, et fonctionne sous Linux et macOS avec Node.js 22 ou ultérieur.

Essayez Apidog dès aujourd'hui

C'est la réponse courte. Le reste de ce guide présente le contenu du plugin, son installation, le fonctionnement des budgets de temps, le paramètre de sandbox qu'il ne faut pas modifier à la légère, et comment faire en sorte que votre agent prouve chaque version livrée contre une API réelle avec Apidog CLI.

Qu'est-ce que le plugin Qwen Live Delivery ?

Le plugin Qwen Live Delivery est un module complémentaire léger pour les tâches d'agent de codage de longue durée. Plutôt que de laisser l'agent travailler pendant une heure dans une boîte noire, il impose un rythme : planifier une petite étape utilisable, la construire, la vérifier, publier une version figée, puis planifier la suivante à partir des résultats et de vos retours. Vous pouvez intervenir à tout moment.

Plugin Qwen Live Delivery

L'équipe Qwen d'Alibaba l'a publié en même temps que la sortie générale de Qwen4-Max le 16/11/2026 ; le billet de lancement appelle ce concept « Live Delivery » : livrer une version fonctionnelle tôt, puis continuer à l'améliorer release après release pendant que l'utilisateur pilote le processus. Si vous avez besoin d'abord du contexte sur le modèle, lisez ce qu'est Qwen4-Max et comment utiliser Qwen4-Max.

L'avantage : une mauvaise direction ne coûte qu'une version, et non toute l'exécution, car un livrable utilisable reste disponible en permanence.

Ce que contient le plugin

Le dépôt Qwen-Live-Delivery-Plugin contient quatre parties qui fonctionnent ensemble :

Composant De quoi s'agit-il À quoi il sert
Compétence Live Delivery $ld:go Indique à l'agent de choisir une première version minimale utilisable, de planifier chaque version suivante à partir des résultats réels et d'exécuter des vérifications à chaque itération
Serveur MCP ld_begin, ld_publish, ld_status, ld_done Gère le plan de livraison, fige les instantanés de version avec une entrée d'aperçu, signale le budget restant, conclut la tâche
Hooks de cycle de vie SessionStart, UserPromptSubmit, PostToolUse, Stop, Interrupt, SessionEnd Injectent vos retours dans le contexte, bloquent les tours « j'ai fini » prématurés tant que du budget reste, prennent en charge la clôture
Atelier web (workbench) Interface web locale Affiche le plan, permet de prévisualiser et de télécharger les versions, recueille de nouvelles exigences, ajuste le budget ou arrête la tâche

Les quatre outils MCP constituent le protocole suivi par la compétence :

  • ld_begin démarre la tâche avec l'objectif complet, un titre et une première étape. Chaque étape comporte un id, un périmètre, des critères d'acceptation et une target_after (heure cible) mesurée depuis le début de la tâche.
  • ld_publish fige une version : les fichiers, une preview_entry explicite (par exemple un index.html pour un site), une note de modifications et une liste de checks. Chaque vérification comporte une label (étiquette), un result parmi passed, failed ou not_run, et une evidence (preuve) facultative.
  • ld_status lit le plan, le budget restant, les retours en attente et l'état d'arrêt, ou publie un message d'activité public d'une ligne dans l'atelier.
  • ld_done clôt la tâche avec un résumé.

La compétence interdit à l'agent de marquer une vérification échouée ou non exécutée comme réussie. L'hôte vérifie les copies d'instantanés et les empreintes, mais les résultats d'acceptation restent déclarés par l'agent lui-même. Nous comblerons cette lacune plus tard avec un test sur une API réelle.

Les hooks servent de volant de direction. Pour une tâche démarrée depuis le navigateur, l'hôte interrompt l'agent et reprend le même thread Codex afin que votre message arrive via UserPromptSubmit. Pour une tâche démarrée en CLI, les retours arrivent au prochain outil pris en charge ou à la frontière du tour suivant.

Comment Live Delivery exécute une tâche longue

Diagramme de la boucle Live Delivery

Voici la boucle, dans l'ordre :

  1. Vous tapez une requête $ld:go avec le résultat souhaité.
  2. L'agent appelle ld_begin avec l'objectif complet et une première étape. Pas d'étape d'approbation de plan séparée.
  3. Il construit l'étape et exécute les vérifications d'acceptation de cette étape.
  4. Il appelle ld_publish, qui fige la version 1 avec ses fichiers et son entrée d'aperçu.
  5. Vous ouvrez l'atelier, essayez la version et tapez vos modifications dans le panneau de gauche.
  6. L'agent replanifie : il compare la livraison à l'objectif complet, intègre vos retours et appelle ld_begin avec l'étape suivante.
  7. Les étapes 3 à 6 se répètent jusqu'à épuisement du budget ou jusqu'à ce que vous cliquiez sur Stop task. L'agent publie alors toute amélioration prête et appelle ld_done.

Deux règles se détachent. Il n'y a pas de nombre de versions fixé à l'avance : l'agent décide du périmètre à chaque tour selon la valeur apportée. Et la fin des étapes planifiées ne met pas fin à la tâche tant qu'il reste du temps autorisé : l'agent continue de chercher la prochaine amélioration utile.

Comment installer le plugin Qwen Live Delivery

Vérifiez d'abord les prérequis :

  • Codex CLI (seul harness pris en charge au lancement ; testé avec Codex 0.166.0 et 0.167.1)
  • Linux ou macOS
  • Node.js 22 ou ultérieur

Le plugin n'embarque ni modèle ni clé API. Il utilise le modèle Codex, l'authentification et les paramètres d'approbation que vous avez déjà. Consultez la documentation de Codex CLI d'OpenAI si vous n'avez pas encore configuré Codex.

Clonez le dépôt et lancez l'installateur sur votre projet :

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

Appuyez sur Entrée et le plugin s'installe, les hooks sont configurés et Codex s'ouvre. La version livrée ne nécessite pas de npm install. Si Codex était déjà ouvert, démarrez une nouvelle session.

Options utiles de l'installateur :

  • --install-only installe sans ouvrir Codex
  • --doctor vérifie une installation existante

Vous pouvez aussi demander à Codex de lire le README et de suivre sa compétence d'installation ; après l'installation, $ld:install prend en charge la configuration et le diagnostic. Pour désinstaller, exécutez codex plugin remove ld@live-delivery-local --json puis codex plugin marketplace remove live-delivery-local --json. Vos workspaces et vos enregistrements de livraison sont conservés.

Prise en main : votre première tâche pilotable

Démarrez Codex dans votre projet avec un budget de temps :

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

Tapez ensuite la requête. L'exemple du 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 affiche une URL d'atelier. Ouvrez-la. Ce lien donne accès à l'atelier : traitez-le comme un mot de passe et ne le collez pas dans des tickets ou des discussions. Après un redémarrage, utilisez le dernier lien affiché par la CLI.

Dans l'atelier :

  1. Après la première livraison, sélectionnez une version à droite et ouvrez Files pour prévisualiser ou télécharger les fichiers individuellement.
  2. Ajoutez des exigences à gauche. Entrée envoie le message ; Maj+Entrée ajoute un retour à la ligne.
  3. Utilisez Time budget dans l'en-tête pour modifier le temps total, ou Stop task pour terminer.

Budgets de temps, sandbox et autres paramètres

Le budget de temps est la durée totale d'exécution que l'agent peut utiliser. Définissez-le avec QWEN_LD_TIME_BUDGET avant de démarrer Codex, ou modifiez-le plus tard dans l'en-tête de l'atelier. Les valeurs à connaître :

Paramètre Valeur
Budget par défaut (variable non définie) 30 minutes (1 800 secondes dans la configuration du plugin)
Unités acceptées minutes, heures ou jours, par exemple 15m, 3h, 2d
Maximum 7 jours
Qui peut l'augmenter Vous uniquement ; les outils du modèle ne peuvent pas relever la limite autorisée
Comportement à l'arrêt Attend la fin de l'appel d'outil en cours

Venons-en à l'avertissement. Les tâches démarrées depuis le navigateur utilisent par défaut la sandbox workspace-write de Codex. Définir QWEN_LD_TASK_SANDBOX=danger-full-access désactive la sandbox et l'approbation par commande, permettant à l'agent de toucher tout ce qui se trouve hors du workspace avec les permissions de votre compte système. L'installateur ne l'active jamais pour vous. Gardez le réglage par défaut, sauf si vous exécutez le tout dans une VM ou un conteneur jetable.

Utilisez l'atelier sur un réseau de confiance. Pour un accès strictement local ou une redirection de port SSH, définissez QWEN_LD_BIND_HOST=127.0.0.1 avant de démarrer Codex.

Limites à connaître avant d'en dépendre

C'est une version 0.1.0, et le README est transparent sur son périmètre :

  • Codex CLI uniquement. La prise en charge d'autres harness d'agent figure sur la liste à faire, sans date.
  • Linux et macOS uniquement. Aucune mention de Windows.
  • Votre modèle, votre quota. Le plugin utilise le modèle configuré dans Codex. Un budget de sept jours sur un modèle de pointe coûte réellement de l'argent : consultez les tarifs de Qwen4-Max ou le Qwen4-Max Token Plan si c'est le modèle derrière votre harness, ou Qwen4-Max gratuitement pour les pistes de quota.
  • Les vérifications sont autodéclarées. L'hôte vérifie les instantanés de fichiers, pas le fait que vos critères d'acceptation passent réellement.
  • Les tâches CLI reçoivent les retours plus tard. Les tâches démarrées en CLI ne voient les retours du navigateur qu'aux frontières d'outil ou de tour.

Faites prouver chaque version livrée avec Apidog CLI

Live Delivery demande des vérifications sincères à chaque version, mais une vérification du type « l'API fonctionne » ne vaut que le test qui la sous-tend. Si votre agent construit une API, ou une application qui en appelle une, comme l'API Qwen4-Max, faites-lui exécuter un test réel avec Apidog CLI avant chaque ld_publish et coller le résultat comme preuve.

Agent exécutant apidog run avant ld_publish

Configurez-le une seule fois :

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

Ajoutez ensuite une consigne à la requête $ld:go, ou envoyez-la depuis l'atelier en cours de tâche :

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

L'agent lit chaque schéma de payload avant d'écrire, puis exécute le cas de test à chaque version :

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

Le rapporteur cli affiche réussite ou échec dans le journal ; json écrit un rapport dans ld-reports que l'agent cite dans l'evidence de chaque vérification. Si c'est votre propre API qui est en cours de construction, remplacez le point de terminaison par le vôtre et ajoutez à chaque tour les nouvelles routes de la version au cas de test. Ajoutez --upload-report pour consulter les exécutions dans l'application Apidog. Pour plus de prompts Codex, voir Apidog CLI dans Codex, et déplacez le même apidog run ... -r junit vers votre CI avec le guide CI/CD d'Apidog CLI. Le plan gratuit d'Apidog couvre jusqu'à 4 utilisateurs.

FAQ

Le plugin Qwen Live Delivery fonctionne-t-il avec Claude Code ou Cursor ? Pas encore. Au lancement, il ne prend en charge que Codex CLI. Les autres harness figurent sur la liste à faire du projet, sans date.

Ai-je besoin d'une clé API Qwen pour l'utiliser ? Non. Le plugin n'inclut ni modèle ni clé. Il s'appuie sur le modèle et l'authentification que votre installation Codex utilise déjà.

Quel est le budget de temps par défaut ? 30 minutes si vous ne définissez pas QWEN_LD_TIME_BUDGET. Vous pouvez définir des minutes, des heures ou des jours, jusqu'à 7 jours, et le modifier depuis l'en-tête de l'atelier.

Que se passe-t-il quand je clique sur Stop task ? L'agent termine l'appel d'outil en cours, ne démarre aucun nouveau périmètre, publie toute amélioration prête dont les vérifications passent et appelle ld_done. Chaque version livrée reste disponible.

Est-il sûr de l'exécuter avec un accès complet ? Uniquement dans un environnement jetable. danger-full-access supprime la sandbox et l'approbation par commande. L'installateur ne l'active jamais, et la sandbox par défaut workspace-write est le choix raisonnable pour la plupart des travaux.

Top comments (0)