Executar Prompts Agendados

Use /loop e as ferramentas de agendamento cron para executar prompts repetidamente, verificar status ou definir lembretes únicos dentro de uma sessão do Qwen Code.

Tarefas agendadas permitem que o Qwen Code execute novamente um prompt automaticamente em um intervalo. Use-as para verificar um deployment, monitorar um PR, acompanhar um build de longa duração ou lembrar a si mesmo de fazer algo mais tarde na sessão.

As tarefas têm escopo de sessão: elas existem no processo atual do Qwen Code e são removidas quando você sai. Nada é gravado no disco.

Nota: Tarefas agendadas são um recurso experimental. Ative-as com experimental.cron: true nas suas configurações ou defina QWEN_CODE_ENABLE_CRON=1 no seu ambiente.

Agendar um prompt recorrente com /loop

A skill integrada /loop é a maneira mais rápida de agendar um prompt recorrente. Passe um intervalo opcional e um prompt, e o Qwen Code configura um job cron que é executado em segundo plano enquanto a sessão permanece aberta.

/loop 5m check if the deployment finished and tell me what happened

O Qwen Code analisa o intervalo, converte-o para uma expressão cron, agenda o job e confirma a cadência e o ID do job. Em seguida, ele executa o prompt imediatamente uma vez — você não precisa esperar pela primeira execução do cron.

Sintaxe de intervalo

Os intervalos são opcionais. Você pode colocá-los no início, no final ou omiti-los completamente.

As unidades suportadas são s para segundos, m para minutos, h para horas e d para dias. Segundos são arredondados para o minuto mais próximo, já que o cron tem granularidade de um minuto. Intervalos que não dividem uniformemente em sua unidade, como 7m ou 90m, são arredondados para o intervalo limpo mais próximo e o Qwen Code informa qual foi escolhido.

Executar loop em outro comando

O prompt agendado pode ser, ele mesmo, um comando ou uma invocação de skill. Isso é útil para executar novamente um workflow que você já empacotou.

/loop 20m /review-pr 1234

Cada vez que o job é executado, o Qwen Code roda /review-pr 1234 como se você tivesse digitado.

Gerenciar loops

O /loop também oferece suporte a dois subcomandos para gerenciar jobs existentes:

/loop list

Lista todos os jobs agendados com seus IDs e expressões cron.

/loop clear

Cancela todos os jobs agendados de uma vez.

Definir um lembrete único

Para lembretes únicos, descreva o que você deseja em linguagem natural em vez de usar /loop. O Qwen Code agenda uma tarefa de execução única que se exclui após ser executada.

remind me at 3pm to push the release branch

in 45 minutes, check whether the integration tests passed

O Qwen Code fixa o horário de execução em um minuto e hora específicos usando uma expressão cron e confirma quando ela será executada.

Gerenciar tarefas agendadas

Peça ao Qwen Code em linguagem natural para listar ou cancelar tarefas, ou referencie as ferramentas subjacentes diretamente.

what scheduled tasks do I have?

cancel the deploy check job

Internamente, o Qwen Code usa estas ferramentas:

Cada tarefa agendada possui um ID de 8 caracteres que você pode passar para CronDelete. Uma sessão pode conter até 50 tarefas agendadas por vez.

Como as tarefas agendadas são executadas

O agendador verifica a cada segundo se há tarefas pendentes e as coloca na fila quando a sessão está ociosa. Um prompt agendado é executado entre as suas interações, não enquanto o Qwen Code está gerando uma resposta. Se o Qwen Code estiver ocupado quando uma tarefa vencer, o prompt aguardará até que a interação atual termine.

Todos os horários são interpretados no seu fuso horário local. Uma expressão cron como 0 9 * * * significa 9h no local onde você está executando o Qwen Code, e não UTC.

Jitter

Para evitar que todas as sessões acessem a API exatamente no mesmo momento, o agendador adiciona um pequeno deslocamento determinístico aos horários de execução:

• Tarefas recorrentes são executadas com um atraso de até 10% do seu período, limitado a 15 minutos. Um job horário pode ser executado em qualquer momento entre :00 e :06.
• Tarefas únicas agendadas para o início ou meio da hora (minuto :00 ou :30) são executadas até 90 segundos antes.

O deslocamento é derivado do ID da tarefa, então a mesma tarefa sempre recebe o mesmo deslocamento. Se o tempo exato for importante, escolha um minuto que não seja :00 ou :30, por exemplo 3 9 * * * em vez de 0 9 * * *, e o jitter de tarefas únicas não será aplicado.

Expiração em três dias

Tarefas recorrentes expiram automaticamente 3 dias após a criação. A tarefa é executada uma última vez e, em seguida, se exclui. Isso limita por quanto tempo um loop esquecido pode permanecer em execução. Se você precisar que uma tarefa recorrente dure mais tempo, cancele-a e recrie-a antes que expire.

Tarefas únicas não expiram por tempo — elas simplesmente se excluem após serem executadas uma vez.

Referência de expressões cron

O CronCreate aceita expressões cron padrão de 5 campos: minute hour day-of-month month day-of-week. Todos os campos suportam curingas (*), valores únicos (5), passos (*/15), intervalos (1-5) e listas separadas por vírgula (1,15,30).

O dia da semana usa 0 ou 7 para domingo até 6 para sábado. Quando tanto o dia do mês quanto o dia da semana estão restritos (nenhum é *), uma data corresponde se qualquer um dos campos corresponder — isso segue a semântica padrão do vixie-cron.

Sintaxe estendida como L, W, ? e aliases de nome como MON ou JAN não são suportados.

Limitações

O agendamento com escopo de sessão possui restrições inerentes:

• As tarefas só são executadas enquanto o Qwen Code está em execução e ocioso. Fechar o terminal ou encerrar a sessão cancela tudo.
• Não há recuperação para execuções perdidas. Se o horário agendado de uma tarefa passar enquanto o Qwen Code está ocupado com uma solicitação de longa duração, ela será executada uma vez quando o Qwen Code ficar ocioso, e não uma vez por intervalo perdido.
• Não há persistência entre reinicializações. Reiniciar o Qwen Code limpa todas as tarefas com escopo de sessão.