DEV Community

Cover image for Plugin de Entrega ao Vivo do Qwen: Como Executar Tarefas Longas de Agente com Controle Total
Lucas
Lucas

Posted on Originally published at apidog.com

Plugin de Entrega ao Vivo do Qwen: Como Executar Tarefas Longas de Agente com Controle Total

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+.

Experimente o Apidog hoje

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.

Imagem do plugin

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_begin inicia 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 tempo target_after medido a partir do início da tarefa.
  • ld_publish congela uma versão: os arquivos, um preview_entry explícito (um index.html para um site, por exemplo), uma nota de alterações e uma lista de checks. Cada verificação tem um label, um result com valor passed, failed ou not_run, e um evidence opcional.
  • ld_status lê 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_done encerra 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

Diagrama do loop do Live Delivery

Este é o loop, em ordem:

  1. Você digita uma solicitação $ld:go com o resultado que deseja.
  2. O agente chama ld_begin com o objetivo completo e um primeiro marco. Não há etapa separada de aprovação de plano.
  3. Ele constrói o marco e executa as verificações de aceitação desse marco.
  4. Ele chama ld_publish, que congela a versão 1 com seus arquivos e entrada de preview.
  5. Você abre o workbench, testa a versão e digita alterações no painel esquerdo.
  6. O agente replaneja: compara a entrega com o objetivo completo, incorpora seu feedback e chama ld_begin com o próximo marco.
  7. 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
Enter fullscreen mode Exit fullscreen mode

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-only instala sem abrir o Codex
  • --doctor verifica 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
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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:

  1. Após a primeira entrega, selecione uma versão à direita e abra Files para visualizar ou baixar arquivos individualmente.
  2. Adicione requisitos à esquerda. Enter envia; Shift+Enter insere uma nova linha.
  3. 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.

Diagrama do Apidog CLI com ld_publish

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
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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)