Os Itens do Datapool São Contabilizados Automaticamente no Insights?

Os Itens do Datapool São Contabilizados Automaticamente no Insights?

Pergunta

Ao utilizar o BotCity Maestro, os dados do datapool são automaticamente refletidos na área de Insights?

Resposta

Não. Os itens do datapool não são contabilizados automaticamente na ferramenta de Insights do Maestro.
Para que essas informações apareçam corretamente nos relatórios, é necessário informar explicitamente os dados de execução — como o total de itens processados, os que falharam e os que foram concluídos com sucesso — usando o método finish_task() do Maestro SDK.


Já Uso o BotCity e Tenho Robôs em Produção

Se você já tem automações rodando pelo orquestrador do BotCity, basta fazer uma pequena alteração no código para começar a reportar os dados processados.

Atualizando o Código de uma Automação Existente

Inclua os parâmetros total_items, processed_items e, opcionalmente, failed_items na chamada do finish_task():

  1. maestro.finish_task(task_id=execution.task_id,                 status=AutomationTaskFinishStatus.SUCCESS,                 message="Task Finished OK.",
  2.                 total_items=100, # Número total de itens processados
  3.                 processed_items=90) # Número de itens processados com sucesso

Notes

Dica:
Atualize o SDK para garantir compatibilidade:  pip install --upgrade botcity-maestro-sdk

E não se esqueça de atualizar o requirements.txt com a nova versão.



Estou Começando Agora

Se você está iniciando com o BotCity, veja abaixo como instalar o SDK e reportar os dados corretamente no seu código.

Instalação do SDK
  1. pip install botcity-maestro-sdk

Warning
Importante: Inclua o SDK no requirements.txt do seu projeto.


Importando e Inicializando o Maestro SDK
  1. from botcity.maestro import *
  2. # Evita erro se não estiver conectado ao Maestro
  3. BotMaestroSDK.RAISE_NOT_CONNECTED = False
  4. # Inicializa o SDK
  5. maestro = BotMaestroSDK.from_sys_args()
  6. # Obtém os dados da tarefa em execução
  7. execution = maestro.get_execution()

Reportando os Dados ao Final da Execução

Ao concluir sua automação, utilize o finish_task() para reportar os dados:

  1. maestro.finish_task(task_id=execution.task_id, status=AutomationTaskFinishStatus.SUCCESS, message="Task Finished OK.", total_items=100, processed_items=90, failed_items=10)

Exemplo Completo de Código em Python

  1. from botcity.core import DesktopBot from botcity.maestro import * BotMaestroSDK.RAISE_NOT_CONNECTED = False def main(): maestro = BotMaestroSDK.from_sys_args() execution = maestro.get_execution() bot = DesktopBot() itens = [] # Lista de itens do seu processo itens_processados = 0 itens_falhados = 0 for item in itens: try: # Processa o item itens_processados += 1 except Exception: itens_falhados += 1 maestro.finish_task( task_id=execution.task_id, status=AutomationTaskFinishStatus.SUCCESS, message="Task Finished OK.", total_items=len(itens), processed_items=itens_processados, failed_items=itens_falhados ) def not_found(label): print(f"Elemento não encontrado: {label}") if __name__ == '__main__': main()

Observações Finais

  • Não existe estrutura obrigatória para contabilizar itens. Você pode organizar sua lógica conforme sua necessidade.

  • O importante é que ao final da execução, os dados sejam reportados por meio do finish_task().

Para mais detalhes técnicos, consulte:
Documentação Oficial do Maestro SDK