Como alterar o status de uma task no Runner/Orquestrador da BotCity
O que acontece quando uma task não finaliza corretamente no Runner ?
O Runner possui um tratamento interno para finalizar tasks em estado de erro quando:
-
O erro não é reportado pelo código, ou
-
Há um cancelamento forçado da task.
No entanto, em alguns cenários esse tratamento pode não ser acionado. Por exemplo:
-
Se o Runner for encerrado de forma abrupta (reinício ou desligamento da máquina sem fechar o Runner previamente).
Nesses casos, a task pode permanecer no Orquestrador com status incorreto, como "Running".
Isso impacta as execuções seguintes ?
Não.
Se for apenas o status incorreto no Orquestrador, isso não afetará futuras execuções.
O problema é apenas visual/administrativo, mas você pode corrigir manualmente, logo abaixo veremos como manipular os dados via API e CLI para alterar esses status.
Como corrigir o status de uma task parada no Orquestrador ?
Você pode alterar manualmente o status da task de duas formas:
Como finalizar uma task usando a CLI ?
-
Abra um terminal dentro pasta da BotCity.
-
Execute o comando abaixo (ajustando o taskId):
./BotCLI task finish -taskId "123" -totalItems 1 -processedItems 1 -failedItems 0
⚠️ Importante:
-
Substitua
"123"pelo ID da task que deseja alterar. -
O taskId pode ser obtido diretamente no Orquestrado
O que esse comando faz exatamente ?
"Executando" ou "Falhou") e atualiza seus indicadores:-
totalItems: Total de itens da task -
processedItems: Quantidade processada -
failedItems: Quantidade que falhou
Dessa forma, a task é marcada corretamente como concluída e não aparecerá mais como pendente.
👉 Assim, você garante que o status das tasks no Orquestrador esteja atualizado, mesmo em casos de interrupções abruptas do Runner.
Related Articles
Por que o Runner fica travado em "Executing task..." e como resolver ?
Visão Geral Em algumas situações esporádicas, o BotCity Runner pode parecer travado após buscar uma nova tarefa da fila. Nesses casos, o status fica parado em: Executing task... e a automação não é iniciada, sendo necessário reiniciar manualmente o ...O que fazer quando o Runner parece ficar travado após puxar uma tarefa para execução?
Em situações esporádicas, pode ser que o Runner pareça ficar travado após puxar uma nova tarefa para execução. Nesse tipo de situação, a execução não é iniciada e o status do Runner fica como Executing task... até que o Runner seja reiniciado. No ...Quais são os recursos e limitações de uma conta Community no Orquestrador BotCity?
Uma nova conta que é criada na plataforma BotCity tem durante um período de 30 dias acesso total as funcionalidades da plataforma (trial). Após esse período de 30 dias, o acesso à plataforma continua da mesma maneira, a única diferença são algumas ...Como resolver o problema de instalação travada em 0% no BotCity Studio ?
Visão Geral Se ao tentar instalar o BotCity Studio ou iniciar o BotCity Runner, a instalação permanece travada em 0%, ou ocorrem erros de autenticação e login, é muito provável que o ambiente corporativo esteja bloqueando as conexões necessárias para ...Como resolver erros de SSL ao instalar dependências com o pip em ambientes corporativos ?
Visão Geral Ambientes corporativos costumam ter políticas de segurança rígidas que restringem o acesso a determinados recursos da internet. Por isso, é comum que ocorram falhas ao utilizar ferramentas como o pip (gerenciador de pacotes do Python) em ...