Automações

Nas seções a seguir, você encontrará informações sobre como criar e gerenciar automações.

Anatomia de uma automação¶

Uma automação é um dos elementos mais importantes do BotCity Maestro logo atrás das tarefas.

Elas são responsáveis por vincular agentes, que são os bots ou software a serem executados, com os Runners, que são as instâncias do BotCity Runner nas quais os agentes serão executados ao processar as tarefas.

As tarefas são instâncias de uma automação criada pelo usuário por meio da interface do usuário do Maestro, CLI (Interface de linha de comando) da BotCity, Maestro SDK ou da API do Maestro.

Uma automação é definida pelos seguintes elementos:

• Label: O identificador único da automação.
• Nome: O nome amigável da automação.
• Descrição: Uma breve descrição da automação.
• Tempo humano da atividade: O tempo estimado (em minutos) que um humano levaria para concluir uma tarefa dessa automação.
• Tecnologia: Tecnologia ou linguagem de programação utilizada na automação
• Robô vinculado: O agente/bot associado a esta automação.
• Runners vinculados: Lista de Runners associados a esta automação. Se mais de um Runner estiver anexado, a tarefa será distribuída ao primeiro BotCity Runner livre que está online e disponível.
• Notificar os usuários: A lista de usuários a serem notificados quando o alerta de notificações de um determinado tipo acontecer.
• Tipo de notificação: Os tipos de notificação de alerta para notificar os usuários.
• Ícone: Um pequeno ícone que representa a automação que será exibida na interface do usuário do Maestro.
• Prioridade: A prioridade de execução desse processo.
• Parâmetros: Uma lista de parâmetros que serão usados pelo Robô vinculado.

Agendamento CRON¶

Esse tópico foi movido para a seção Agendamentos.

Parâmetros¶

As automações podem ser parametrizadas para maior flexibilidade e código mais dinâmico.

Os parâmetros são definidos na seção Parâmetros da automação ao criar ou editá-la.

Os parâmetros são definidos por um Label e um Tipo. O Label é o identificador exclusivo do parâmetro e o Tipo é o tipo de dados do parâmetro.

Atualmente, os seguintes tipos de parâmetros são suportados:

• Text
• Integer
• Double
• Date

Você também pode definir se esse parâmetro terá um valor padrão e também se é um parâmetro obrigatório.

O Tipo também determinará como o parâmetro será exibido na interface novas tarefas no Maestro.

Criando uma automação¶

Crie uma nova automação clicando no botão + Nova Automação no canto superior direito.

Preencha o formulário com as informações necessárias e clique em Criar.

Aqui está um exemplo de como criar uma automação: