Qwen Live Delivery Plugin: tarefas longas de agente com entregas contínuas
O Qwen Live Delivery Plugin é um plugin de código aberto para o Codex CLI, criado pela equipe do Qwen, que faz com que uma tarefa longa de agente entregue uma primeira versão utilizável cedo e depois a melhore versão por versão, enquanto você adiciona requisitos a partir de um workbench no navegador. Ele é Apache-2.0, versão 0.1.0, e roda em Linux e macOS com Node.js 22+.
Essa é a resposta curta. O restante deste guia cobre o que há dentro do plugin, como instalá-lo, como os orçamentos de tempo funcionam, a configuração de sandbox que você não deve alterar sem pensar, e como fazer seu agente provar cada versão entregue contra uma API real com o Apidog CLI.
O que é o Qwen Live Delivery Plugin?
O Qwen Live Delivery Plugin é um complemento leve para tarefas longas de agentes de programação. Em vez de deixar o agente trabalhar dentro de uma caixa-preta por uma hora, ele impõe um ritmo: planejar um pequeno marco utilizável, construí-lo, verificá-lo, publicar uma versão congelada e, em seguida, planejar o próximo marco com base nos resultados e no seu feedback. Você pode conduzir o processo a qualquer momento.
A equipe do Qwen, da Alibaba, lançou o plugin junto com o lançamento geral do Qwen4-Max em 16/11/2026, quando a publicação de lançamento descreve a ideia como "Live Delivery": entregar uma versão funcional cedo e continuar aprimorando-a release por release enquanto o usuário conduz o processo. Se você precisa primeiro entender o contexto do modelo, leia o que é o Qwen4-Max e como usar o Qwen4-Max.
A vantagem: um caminho errado custa uma versão, não a execução inteira, porque um artefato utilizável permanece disponível o tempo todo.
O que há dentro do plugin
O repositório Qwen-Live-Delivery-Plugin contém quatro partes que funcionam em conjunto:
| Parte | O que é | O que faz |
|---|---|---|
| Skill Live Delivery | $ld:go |
Instrui o agente a escolher uma primeira versão mínima utilizável, planejar cada próxima versão com base nos resultados reais e executar verificações em cada iteração |
| Servidor MCP |
ld_begin, ld_publish, ld_status, ld_done
|
Gerencia o plano de entrega, congela snapshots de versões com uma entrada de preview, informa o orçamento restante e encerra a tarefa |
| Hooks de ciclo de vida |
SessionStart, UserPromptSubmit, PostToolUse, Stop, Interrupt, SessionEnd
|
Levam seu feedback para o contexto, bloqueiam turnos prematuros de "terminei" enquanto ainda há orçamento e apoiam o encerramento |
| Workbench no navegador | Interface web local | Mostra o plano, permite visualizar e baixar versões, receber novos requisitos e ajustar o orçamento ou parar a tarefa |
As quatro ferramentas MCP são o protocolo que a skill segue:
-
ld_begininicia a tarefa com o objetivo completo, um título e um primeiro marco. Cada marco contém um id, escopo, critérios de aceitação e um tempotarget_aftermedido a partir do início da tarefa. -
ld_publishcongela uma versão: os arquivos, umpreview_entryexplícito (umindex.htmlpara um site, por exemplo), uma nota de alterações e uma lista dechecks. Cada verificação tem umlabel, umresultcom valorpassed,failedounot_run, e umevidenceopcional. -
ld_statuslê o plano, o orçamento restante, o feedback na fila e o estado de parada, ou publica uma mensagem pública de atividade de uma linha no workbench. -
ld_doneencerra a tarefa com um resumo.
A skill instrui o agente a nunca marcar uma verificação com falha ou não executada como aprovada. O host verifica cópias e hashes dos snapshots, mas os resultados de aceitação continuam sendo reportados pelo próprio agente. Fecharemos essa lacuna com um teste de API real mais adiante.
Os hooks são o volante. Para uma tarefa iniciada pelo navegador, o host interrompe o agente e retoma a mesma thread do Codex para que sua mensagem chegue através de UserPromptSubmit. Para uma tarefa iniciada na CLI, o feedback chega na próxima ferramenta suportada ou na fronteira de turno.
Como o Live Delivery executa uma tarefa longa
Este é o loop, em ordem:
- Você digita uma solicitação
$ld:gocom o resultado que deseja. - O agente chama
ld_begincom o objetivo completo e um primeiro marco. Não há etapa separada de aprovação de plano. - Ele constrói o marco e executa as verificações de aceitação desse marco.
- Ele chama
ld_publish, que congela a versão 1 com seus arquivos e entrada de preview. - Você abre o workbench, testa a versão e digita alterações no painel esquerdo.
- O agente replaneja: compara a entrega com o objetivo completo, incorpora seu feedback e chama
ld_begincom o próximo marco. - Os passos 3 a 6 se repetem até que o orçamento se esgote ou você pressione Stop task. Então ele publica qualquer melhoria pronta e chama
ld_done.
Duas regras se destacam. Não há contagem fixa de versões, então o agente decide o escopo de cada rodada com base no valor. E concluir os marcos planejados não encerra a tarefa enquanto ainda houver tempo autorizado: o agente continua buscando a próxima melhoria útil.
Como instalar o Qwen Live Delivery Plugin
Verifique primeiro os requisitos:
- Codex CLI (o único harness no lançamento; testado com Codex 0.166.0 e 0.167.1)
- Linux ou macOS
- Node.js 22 ou mais recente
O plugin não inclui modelo nem chave de API. Ele usa o modelo, a autenticação e as configurações de aprovação que você já tem no Codex. Consulte a documentação do Codex CLI da OpenAI se ainda não tiver configurado o Codex.
Clone o repositório e execute o instalador apontando para o seu projeto:
git clone https://github.com/QwenLM/Qwen-Live-Delivery-Plugin.git
cd Qwen-Live-Delivery-Plugin
./live-delivery/install.sh --workspace /path/to/project
Pressione Enter e ele instala o plugin, configura os hooks e abre o Codex. O release não precisa de npm install. Se o Codex já estava aberto, inicie uma nova sessão.
Flags úteis do instalador:
-
--install-onlyinstala sem abrir o Codex -
--doctorverifica uma instalação existente
Você também pode pedir ao Codex para ler o README e seguir sua skill de instalação; após a instalação, o $ld:install cuida da configuração e do diagnóstico. Para desinstalar, execute codex plugin remove ld@live-delivery-local --json e codex plugin marketplace remove live-delivery-local --json. Seus workspaces e registros de entrega permanecem intactos.
Início rápido: sua primeira tarefa dirigível
Inicie o Codex no seu projeto com um orçamento de tempo:
cd /path/to/project
QWEN_LD_TIME_BUDGET=12m codex
Depois, digite a solicitação. O exemplo do 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.
A CLI exibe uma URL do workbench. Abra-a. Esse link concede acesso ao workbench, então trate-o como uma senha e não o cole em tickets ou chats. Após uma reinicialização, use o link mais recente que a CLI exibir.
No workbench:
- Após a primeira entrega, selecione uma versão à direita e abra Files para visualizar ou baixar arquivos individualmente.
- Adicione requisitos à esquerda. Enter envia; Shift+Enter insere uma nova linha.
- Use Time budget no cabeçalho para alterar o tempo total, ou Stop task para finalizar.
Orçamentos de tempo, sandbox e outras configurações
O orçamento de tempo é o tempo total de execução que o agente pode usar. Defina-o com QWEN_LD_TIME_BUDGET antes de iniciar o Codex, ou altere-o depois no cabeçalho do workbench. Os valores importantes:
| Configuração | Valor |
|---|---|
| Orçamento padrão (sem variável definida) | 30 minutos (1.800 segundos na configuração do plugin) |
| Unidades aceitas | minutos, horas ou dias, como 15m, 3h, 2d
|
| Máximo | 7 dias |
| Quem pode ampliá-lo | Apenas você; as ferramentas do modelo não podem aumentar o limite autorizado |
| Comportamento ao parar | Aguarda a chamada de ferramenta atual terminar |
Agora, o alerta. Tarefas iniciadas pelo navegador usam por padrão o sandbox workspace-write do Codex. Definir QWEN_LD_TASK_SANDBOX=danger-full-access desativa o sandbox e a aprovação por comando, permitindo que o agente acesse qualquer coisa fora do workspace com as permissões da sua conta do sistema operacional. O instalador nunca ativa isso por você. Mantenha o padrão, a menos que esteja executando dentro de uma VM ou container descartável.
Use o workbench em uma rede confiável. Para acesso apenas local ou encaminhamento de porta via SSH, defina QWEN_LD_BIND_HOST=127.0.0.1 antes de iniciar o Codex.
Limitações que você deve conhecer antes de confiar nele
Este é um release 0.1.0, e o README é transparente quanto ao seu escopo:
- Apenas Codex CLI. O suporte a outros harnesses de agente está na lista de tarefas, sem data prevista.
- Apenas Linux e macOS. Não há suporte listado para Windows.
- Seu modelo, sua cota. O plugin usa o modelo configurado no Codex. Um orçamento de sete dias em um modelo de ponta gasta dinheiro de verdade, então consulte o preço do Qwen4-Max ou o Qwen4-Max Token Plan se esse for o modelo por trás do seu harness, ou Qwen4-Max gratuitamente para as rotas de cota gratuita.
- As verificações são autorreportadas. O host verifica os snapshots de arquivos, não se seus critérios de aceitação realmente passam.
- Tarefas da CLI recebem feedback depois. Tarefas iniciadas na CLI só veem o feedback do navegador nas fronteiras de ferramenta ou de turno.
Faça cada versão entregue provar seu valor com o Apidog CLI
O Live Delivery exige verificações verídicas em cada versão, mas uma verificação que diz "a API funciona" só vale tanto quanto o teste que a sustenta. Se o seu agente está construindo uma API, ou um aplicativo que consome uma, como a API do Qwen4-Max, faça-o executar um teste real com o Apidog CLI antes de cada ld_publish e incluir o resultado como evidência.
Configure uma única vez:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # escolha Codex quando solicitado
Depois, adicione um prompt à solicitação $ld:go, ou envie-o pelo workbench no meio da tarefa:
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.
O agente lê o schema de cada payload antes de escrever e, então, executa o caso de teste em cada versão:
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
O reporter cli exibe aprovação ou falha no log; o json grava um relatório em ld-reports que o agente cita no evidence de cada verificação. Se a API em construção for a sua, troque o endpoint pelo seu e adicione as novas rotas da versão ao caso de teste a cada rodada. Adicione --upload-report para visualizar as execuções no app do Apidog. Para mais prompts do Codex, veja Apidog CLI no Codex, e leve o mesmo apidog run ... -r junit para o CI com o guia de CI/CD do Apidog CLI. O plano gratuito do Apidog cobre até 4 usuários.
Perguntas frequentes
O Qwen Live Delivery Plugin funciona com Claude Code ou Cursor? Ainda não. No lançamento, ele suporta apenas o Codex CLI. Outros harnesses estão na lista de tarefas do projeto, sem data prevista.
Preciso de uma chave de API do Qwen para usá-lo? Não. O plugin não inclui modelo nem chave. Ele roda com o modelo e a autenticação que sua instalação do Codex já usa.
Qual é o orçamento de tempo padrão? 30 minutos se você não definir QWEN_LD_TIME_BUDGET. É possível definir minutos, horas ou dias, até 7 dias, e alterá-lo no cabeçalho do workbench.
O que acontece quando eu pressiono Stop task? O agente termina a chamada de ferramenta atual, não inicia nenhum novo escopo, publica qualquer melhoria pronta cujas verificações passem e chama ld_done. Cada versão entregue permanece disponível.
É seguro executar com acesso total? Apenas em um ambiente descartável. O danger-full-access remove o sandbox e a aprovação por comando. O instalador nunca o ativa, e o sandbox padrão workspace-write é a escolha sensata para a maioria dos trabalhos.



Top comments (0)