Às vezes, uma tarefa continua no Orquestrador com um status que não corresponde à realidade, normalmente Executando, mesmo sem nenhuma execução em andamento no Runner. Veja abaixo por que isso acontece e como corrigir o status pelo BotCLI.

1. Por que a tarefa fica com o status incorreto?

O Runner tem um tratamento interno que finaliza a tarefa em estado de erro quando a falha não é reportada pelo código ou quando há um cancelamento forçado. Esse tratamento não é acionado quando o Runner é encerrado de forma abrupta. É nesse cenário que o status fica desatualizado.

Por exemplo, se a máquina reinicia por uma atualização do Windows enquanto uma tarefa está rodando, sem fechar o Runner antes, a tarefa continua como Executando no Orquestrador.

2. O status incorreto afeta as próximas execuções?

Não. O impacto é apenas visual e administrativo, e as execuções seguintes acontecem normalmente.

3. Como corrigir o status da tarefa pelo BotCLI?

Finalize a tarefa pelo BotCLI, que acompanha o BotCity Studio SDK:

1. Abra um terminal na pasta onde o SDK foi instalado.
2. Copie o ID da tarefa no Orquestrador, disponível em Informações da tarefa.
3. Execute o comando abaixo, trocando 123 pelo ID copiado e ajustando o número de itens processados:

./BotCLI task finish -taskId "123" -totalItems 1 -processedItems 1 -failedItems 0

O comando finaliza a tarefa e atualiza os indicadores de itens totais, processados com sucesso e com falha, de forma que ela deixe de aparecer como Executando na fila.

4. Quais outros argumentos o comando task finish aceita?

O task finish também aceita uma mensagem de finalização e o tipo de conclusão (SUCCESS, FAILED ou PARTIALLY_COMPLETED). Veja todos os argumentos na seção task finish e a sintaxe geral da ferramenta em Primeiros Passos.

Ainda precisa de ajuda?

Se isso não resolver o seu caso ou sua pergunta não está listada aqui, abra um chamado com o time de suporte.