5: Integração com o Orquestrador BotCity

O Orquestrador BotCity oferece uma solução integrada para o gerenciamento de suas automações. Além de finalizar a tarefa ao final do código que criamos, também podemos adicionar ao processo outras integrações com o Orquestrador BotCity.

No template que baixamos, já existe a instância de conexão com o Orquestrador BotCity, a variável maestro. Você pode utilizar essa variável para chamar os métodos de integração disponíveis.

Para mais informações sobre os métodos, consulte a documentação da BotCity.

# Import do Maestro SDK
from botcity.maestro import *

def main():
    # Faz a autenticação automaticamente com o Orquestrador
    maestro = BotMaestroSDK.from_sys_args()
    # Retorna informações da execução
    execution = maestro.get_execution()

    ...

    # Status de finalização de tarefa
    maestro.finish_task(
        task_id=execution.task_id,
        status=AutomationTaskFinishStatus.SUCCESS,
        message="Tarefa de cadastro concluida.",
        total_items=len(produtos)
    )

Exercício extra

Você pode incluir integrações de Alertas, Erros, Logs ou qualquer outra integração que ache válida para o processo.

Exemplos

• Vincular um alerta informativo no inicio do processo:

# Criando alerta
maestro.alert(
    task_id=execution.task_id,
    title="Alerta de Informação",
    message="Informe que o processo de cadastro foi iniciado.",
    alert_type=AlertType.INFO
)

• Enviar um arquivo de relatório em PDF:

# Enviando um arquivo de relatório
maestro.post_artifact(
    task_id=execution.task_id,
    artifact_name="relatorio.pdf",
    filepath=r"resource\artifact.pdf"
)

• Criar uma entrada de log no Orquestrador:

# Criando uma entrada de log
maestro.new_log_entry(
    activity_label="controle_cadastro",
    values={
        "vaga": vaga["id"],
        "status": "Sucesso"
    }
)