Ir para o conteúdo

Guia de edição

Tarefas e a fila

Acompanhe, espere e cancele exportações e transcrições, e o que os limites significam.

Última atualização:

O que você vai aprender#

  • o que é uma tarefa e quais tipos existem;
  • como acompanhar uma tarefa no editor, na CLI e no MCP;
  • por que uma tarefa pode ficar na fila ou ser recusada.

A ideia#

O trabalho longo roda como uma tarefa, para que nada bloqueie uma requisição. Dois tipos são públicos: export e transcribe. Uma tarefa fica queued, running e depois succeeded, failed ou cancelled, e informa o progresso e um resultado. As tarefas são armazenadas com o projeto, então uma tarefa sobrevive a uma aba do navegador fechada ou a um agente reiniciado. O fluxo de eventos (veja Eventos) anuncia cada mudança.

No editor, a barra superior mostra um indicador de tarefas, como 2 jobs · 40%, enquanto algo roda. O diálogo de exportação continua rodando quando você o fecha. Uma tarefa iniciada por um agente aparece no mesmo indicador.

Os limites protegem a máquina e, no modo de rede, os outros usuários: VUKEM_VIDEO_MAX_EXPORTS (2 ao mesmo tempo por espaço de trabalho), VUKEM_VIDEO_MAX_EXPORTS_PER_KEY (1 em execução por usuário ou chave, mais duas podem esperar), VUKEM_VIDEO_MAX_TRANSCRIBES e VUKEM_VIDEO_MAX_TRANSCRIBES_PER_KEY. Além dos limites, a chamada falha com E_QUEUE_FULL, que pode ser repetida.

Início rápido#

Terminal
vukem-video export --project prj_7k2m9x4q1b --no-wait
vukem-video job:list --project prj_7k2m9x4q1b --state active
vukem-video job:show job_4h8k2m6p9t --wait
vukem-video job:cancel job_4h8k2m6p9t

Por padrão, a CLI espera pela tarefa até --timeout (10 minutos). O código de saída 2 significa que a espera estourou o tempo ou que o erro pode ser repetido; o código de saída 1 significa que a tarefa falhou.

Erros comuns#

  • Iniciar uma segunda exportação do mesmo projeto ao mesmo tempo: ela espera atrás da primeira ou falha com E_QUEUE_FULL. Espere pela primeira.
  • Tratar E_RATE_LIMITED como definitivo. As chamadas pesadas (job_start, media_import, template:import) têm o seu próprio limite por minuto; espere o Retry-After.
  • Cancelar uma tarefa concluída: o arquivo permanece; não há nada a cancelar.

Próximos passos#