Editor de Neurons Bots

Depois de selecionar o tipo de gatilho na página Criar Bot, a página do editor de Neurons Bots é exibida. Use o editor para criar o bot construindo os estágios. Os estágios podem ser uma combinação de consultas, com filtros e ações para os respectivos resultados. Saiba mais sobre Estágios de Neurons Bots.

Como construir um bot

O bot sempre iniciará com o gatilho que você selecionou na página de Criação de Neurons Bots.
Você pode atualizar as Configurações do gatilho quando mudar o bot de Inativo (padrão) para Ativo. Você pode fazer isso agora ou depois de criar o bot. Você também pode alterar o tipo de gatilho em Configurações do gatilho.
Para construir o bot, adicione estágios à área de trabalho. Você pode procurar estágios usando a pesquisa ou expandindo as categorias de estágio para ver o que está disponível. Saiba mais sobre Categorias de estágio.
Clique e arraste o estágio desejado para a área de trabalho. Uma vez que o estágio esteja na área de trabalho, as seguintes funcionalidades são disponibilizadas:

Clique para exibir o painel Informações do Estágio. Este painel fornece uma descrição do estágio e uma lista de todas as propriedades que ele retornará, por exemplo, nome do dispositivo, modelo do dispositivo, ID do evento, data do evento.
Clique para conectar o estágio a outro estágio. É assim que você conecta os estágios para construir o bot. Os estágios podem ter múltiplas conexões com outros estágios, dependendo da complexidade pretendida para o bot. Depois que um conector for desenhado, clique na linha do conector para abrir as Configurações de conexão.
Clique para desconectar o estágio de outro estágio.
Clique para excluir o estágio do bot.

Você pode copiar (CTRL+C) e colar (CTRL+V) qualquer parte do fluxo de trabalho na área de trabalho ou entre as guias do navegador (somente Chrome).

Clique em um Estágio para ver as configurações dele. Preencha as propriedades do estágio para personalizar o bot. Todas as propriedades obrigatórias são indicadas por um asterisco vermelho.
Clique e arraste o ícone do conector para conectar um estágio a outro.
Depois de concluir o bot conectando todos os estágios, filtros e ações necessários, selecione Salvar e publicar.

Você pode salvar o bot como rascunho a qualquer momento, clique em Salvar rascunho. Se você sair do editor sem salvar, um diálogo de confirmação será exibido. Você pode optar por salvar um rascunho ou descartar as alterações feitas.
Quando você salva um rascunho, o nome do bot é exibido com meu rascunho ao lado dele para indicar o status de rascunho.

Configurações do gatilho

Um estágio Gatilho é o tipo do bot, ou seja, Agendamento ou Ação personalizada. É sempre o primeiro estágio no editor de bot.

Para editar as configurações do gatilho, clique no estágio Gatilho na área de trabalho para abrir o painel Configurações do gatilho. Você pode editar as configurações do gatilho somente se o status do gatilho for Ativo.

As configurações disponíveis dependem do tipo de gatilho:

Configurações de gatilho do bot Agendamento

Grupo(s) de destino: selecione os grupos de destino nos quais executar o bot.
Escopo de destino: selecione uma porcentagem, em intervalos de 10 unidades, entre 10% e 100%. O escopo seleciona aleatoriamente um número de dispositivos dentro do grupo de destino; ele não detecta se os dispositivos estão online ou offline.

No mínimo um dispositivo sempre será selecionado, independentemente do limite percentual.

Comportamento de execução do dispositivo: há duas opções para escolher:
- Executar para dispositivos on-line - escolha esta opção para executar o bot agendado apenas em dispositivos que estão on-line no momento.
- Executar para dispositivos on-line e colocar dispositivos offline na fila para executar na próxima vez que estiverem on-line - escolha esta opção para executar o bot agendado em dispositivos on-line. Para dispositivos offline, as tarefas entram na fila e são executadas quando eles ficarem on-line.
  Se você escolher esta opção, especifique Dias a esperar antes do tempo limite. Insira quantos dias esperar até o dispositivo ficar on-line. Se o dispositivo não ficar on-line dentro do período especificado, a solicitação de execução será encerrada. O período máximo de espera é 28 dias.
- Clique em Executar para iniciar a ação.
Alterne o modo de agendamento para selecionar entre agendamento básico e avançado.

As configurações básicas simplificam o agendamento. O agendamento é recorrente e oferece as opções Diariamente ou Semanalmente. O intervalo de repetição pode ser especificado em minutos, horas ou semanas.
Repetir: selecione se o agendamento deve ser repetido; diário ou semanal.
Frequência: selecione a unidade de frequência do agendamento; minutos ou horas.
Intervalo: selecione o intervalo de 30 a 55, em intervalos de 5 unidades.
Início: selecione a data e hora de início da primeira execução agendada.
Fim: selecione a data e hora de término da última execução agendada.

As configurações avançadas fornecem opções adicionais, como a inclusão de dias específicos em um agendamento mensal, para dar mais controle sobre a programação. O agendamento será executado até que o gatilho dele seja definido como inativo. Para iniciar o modo avançado, selecione Configurações de agendamento avançadas, e a seção Configurações de agendamento será exibida.
Repetir: selecione se o agendamento deve ser repetido diariamente, semanalmente ou mensalmente. As opções a seguir dependem da repetição selecionada.

Para Diariamente:
Dias da semana: você pode selecionar todos os dias da semana, segunda a sexta, sábado a domingo ou definido pelo usuário.
Dias: se você selecionar a opção "definido pelo usuário" no campo anterior, deverá selecionar os dias em que o bot será executado.
A cada: selecione os horários em que os bots podem ser executados. Por padrão, está definido como 3 horas.

Para Semanalmente:
A cada: você pode selecionar qualquer número de dias em uma semana.

Para Mensalmente:
Frequência: selecione as opções de frequência do agendamento: dia do mês, semana do mês ou ocorrência mensal. As opções a seguir dependem da frequência selecionada.
- Dia do mês: você pode selecionar qualquer data do mês para executar o bot.
- Semana do mês: você pode selecionar a primeira, segunda, terceira, quarta ou última semana do mês.
- Dia da semana: depois de selecionar a semana do mês, você precisa selecionar o dia da semana para executar o bot.
- Intervalo mensal: você pode selecionar todos os meses, a cada 3 meses ou a cada 6 meses. Ou, se selecionar a opção Definido pelo usuário, poderá selecionar qualquer mês ou vários meses no campo Meses.
- Começando no mês: se você escolher a cada 3 meses ou a cada 6 meses como intervalo mensal, precisará selecionar um mês inicial de janeiro a dezembro.
Em Visão Geral, você tem um panorama de suas configurações, propiciando uma estimativa de como os bots serão executados.
Clique em OK para ativar as configurações de agendamento avançadas.

Nas configurações básicas, o bot será executado automaticamente assim que você salvar e publicar o bot. Já nas configurações avançadas, isso não ocorre.

Entradas do bot: caso tenham sido definidas entradas para o bot, elas aparecerão aqui para você configurá-las.

Configurações de gatilho do bot Ação personalizada

Opções publicadas na exibição de dispositivos

Dispositivo individual: coloque em Ligado para ativar a ação personalizada para um único dispositivo em Dispositivos. Uma vez ativado, o bot pode ser executado em um único dispositivo selecionado em Dispositivos. Essa é a configuração padrão.

Quando o bot está na fila, ele é executado apenas nos dispositivos que foram selecionados.

Para usar a opção de comportamento de execução em um único dispositivo:

Acesse Menu principal > Dispositivos.
A página Dispositivos aparece.
Clique no dispositivo desejado.
A guia Visão geral do dispositivo aparece
No painel Ações, clique em executar na opção Comportamento de execução do dispositivo.
O diálogo Comportamento de execução do dispositivo aparece. Há duas opções disponíveis:
- Executar para dispositivos on-line - escolha esta opção para executar as ações personalizadas apenas em dispositivos que estão on-line no momento.
- Executar para dispositivos on-line e colocar dispositivos offline na fila para executar na próxima vez que estiverem on-line - escolha esta opção para executar as ações personalizadas imediatamente nos dispositivos on-line. Para dispositivos offline, as tarefas entram na fila e são executadas quando eles ficarem on-line.
  Se você escolher esta opção, especifique Dias a esperar antes do tempo limite. Insira quantos dias esperar até o dispositivo ficar on-line. Se o dispositivo não ficar on-line dentro do período especificado, a solicitação de execução será encerrada. O período máximo de espera é 28 dias.
Clique em Executar para iniciar a ação.

Vários dispositivos: coloque em Ligado para ativar a ação personalizada para vários dispositivos em Dispositivos. Uma vez ativados, os bots podem ser executados em vários dispositivos selecionados em Dispositivos.

Para usar a opção de comportamento de execução em vários dispositivos:

Acesse Menu principal > Dispositivos.
A página Dispositivos aparece.
Selecione os dispositivos desejados. Você deve escolher pelo menos dois dispositivos para obter o botão Ação personalizada.
Clique no botão Ações personalizadas.
A janela Ação personalizada aparece.
Clique em executar na opção Comportamento de execução do dispositivo.
O diálogo Comportamento de execução do dispositivo aparece. Há duas opções disponíveis:
- Executar para dispositivos on-line - escolha esta opção para executar as ações personalizadas apenas em dispositivos que estão on-line no momento.
- Executar para dispositivos on-line e colocar dispositivos offline na fila para executar na próxima vez que estiverem on-line - escolha esta opção para executar as ações personalizadas imediatamente nos dispositivos on-line. Para dispositivos offline, as tarefas entram na fila e são executadas quando eles ficarem on-line.
  Se você escolher esta opção, especifique Dias a esperar antes do tempo limite. Insira quantos dias esperar até o dispositivo ficar on-line. Se o dispositivo não ficar on-line dentro do período especificado, a solicitação de execução será encerrada. O período máximo de espera é 28 dias.
Clique em Executar para iniciar a ação.

Os usuários que pretendam iniciar ações personalizadas em Dispositivos devem ter função com a permissão Executar ações personalizadas e/ou Executar ações personalizadas em vários dispositivos. Para obter mais informações sobre funções e permissões, consulte Controle de acesso.

Uma das opções publicadas deve estar habilitada, caso contrário o bot não será publicado como ação personalizada em Dispositivos.

Acesso do usuário à exibição de dispositivos

Selecione o escopo de acesso:

Todos: selecione Todos para permitir que todos os usuários com a permissão Executar ações personalizadas e/ou Executar ações personalizadas em vários dispositivos visualizem e executem o bot em Dispositivos.
Funções: selecione uma ou mais funções que tenham a permissão Executar ações personalizadas e/ou Executar ações personalizadas em vários dispositivos para que visualizem e executem o bot em Dispositivos.
Usuários: selecione Usuários para permitir que apenas a lista de usuários selecionados visualize e execute o bot em dispositivos.
Os usuários selecionados devem ter a permissão Executar ações personalizadas e/ou a permissão Executar ações personalizadas em vários dispositivos.

Para limitar o acesso do usuário:

Nas Configurações do gatilho, mude o botão Status do gatilho para Ativo.
Selecione Limitar acesso do usuário.
A página Acesso do usuário é exibida.
Na página Acesso do usuário, selecione Adicionar usuário.
O painel Adicionar usuários é exibido.
No painel Adicionar usuários, selecione todos os usuários aos quais deseja permitir acesso ao bot como uma ação personalizada em Dispositivos. Isso impede o acesso de todos os outros usuários ao bot.
Selecione OK para confirmar sua seleção e fechar o painel.
Os usuários selecionados são listados na página Acesso do usuário. Selecione Aplicar e fechar para salvar as alterações e retornar às configurações do gatilho.

O estágio Ação personalizada na área de trabalho exibe Visível a, que é o número de usuários que receberam acesso, ou Todos os usuários, se nenhum usuário tiver sido especificado.

Nome e descrição da ação personalizada

Nome de exibição da ação personalizada: insira um nome de exibição para a ação personalizada. Ele é exibido no Ivanti Neurons, em Dispositivos > Ações.
Descrição (opcional): digite um texto descritivo para a ação.

Para executar a ação personalizada em grupos de dispositivos

Vá para Menu principal > Dispositivos > Grupos > Grupos públicos. Selecione o grupo desejado.
Clique no grupo de dispositivos desejado na lista filtrada.
No painel Ações, navegue até Ações personalizadas e clique no botão de execução da ação personalizada desejada.
Um diálogo aparece.
Clique em Executar para iniciar a ação personalizada no dispositivo selecionado.
A seguinte mensagem é exibida:
"O bot agora está em execução. Esta caixa de diálogo pode ser dispensada e você pode continuar trabalhando. Você receberá uma notificação assim que a ação for concluída."
Clique em Fechar ao receber a mensagem de conclusão.

Para exibir os resultados:

Clique no ícone no canto superior esquerdo e clique em Exibir resultados.
A página Histórico de Gatilhos aparece.
Clique no valor em Contagem de destinos para visualizar o status detalhado do dispositivo.

Como alternativa, você pode executar a ação personalizada no dispositivo:

Vá para Menu principal > Dispositivos e selecione os dispositivos para executar a ação personalizada.
Você deve selecionar mais de um dispositivo para obter o botão Ações personalizadas.
Clique no botão Ações personalizadas.
O painel Ações personalizadas aparece.
Clique no botão de execução da ação personalizada que deseja executar.
O painel Ação personalizada lista apenas as ações personalizadas que estão habilitadas para vários dispositivos.

Consulte as etapas 3 a 6 acima para continuar.

Para executar a ação personalizada em pessoas

Acesse Menu principal > Pessoas. A página Pessoas aparece com uma lista.
Clique no nome do usuário desejado. Como alternativa, pesquise o usuário.
A página do usuário aparece.
Clique em Ações para abrir o painel Ações.
No painel Ações, navegue até Ações personalizadas e clique no botão de execução da ação personalizada desejada.
O diálogo Entradas do bot aparece.
Insira a entrada e clique em Executar para iniciar a ação personalizada no usuário selecionado.
A seguinte mensagem é exibida:
"O bot agora está em execução. Esta caixa de diálogo pode ser dispensada e você pode continuar trabalhando. Você receberá uma notificação na bandeja do Ivanti Neurons quando a ação for concluída."
Clique em Fechar ao receber a mensagem de conclusão.

Como alternativa, você pode executar a ação personalizada em vários usuários:

Acesse Menu principal > Pessoas. Selecione os usuários para executar a ação personalizada.
Você deve selecionar mais de um usuário para usar o botão Ações personalizadas.
Clique no botão Ações personalizadas.
O painel Ações personalizadas aparece.
No painel Ações, clique no botão de execução da ação personalizada que deseja executar.
O diálogo Entradas do bot aparece.

O painel Ação personalizada lista apenas as ações que estão habilitadas para vários usuários.

Consulte as etapas 4 a 5 acima para continuar.

Configurações de conexão

Clique na linha de um conector para abrir o painel Conexão.

Condição

Uma condição na linha de conector pode ajudar a filtrar pontos de extremidade à medida que avançam pelos estágios. Para estágios do tipo múltiplo, a condição do conector não remove elementos do resultado, portanto, nenhum dado é modificado.

Link ativado: selecione para permitir que os estágios posteriores sejam executados e, opcionalmente, especificar condições, aparência e rótulos para a conexão. Desabilitar o botão desativa a conexão, independentemente de qualquer condição especificada, e os estágios posteriores não serão executados. A aparência visual da conexão no fluxo de trabalho muda de acordo com esta configuração. Essa funcionalidade de "interruptor" pode ser útil ao projetar ou solucionar problemas de um bot.

Quando um link é desabilitado, todas as condições, rótulos e estilos de linha atuais da conexão são preservados automaticamente. Habilitar o botão em uma conexão a qualquer momento restaura automaticamente todas as configurações dela, mesmo que você tenha salvo, saído e depois reaberto bot.
Tem condição: selecione para usar uma condição para determinar quais pontos de extremidade continuam para o próximo estágio do bot.
- Tem descrição automática: selecione para exibir os parâmetros de condição na linha do conector. Aparece no idioma de acordo com o perfil conectado ao Ivanti Neurons.
- Quantas devem ser verdadeiras?: selecione Todas (e) ou Uma (ou). Aplicável somente se você Adicionar mais de uma condição.
- Escolher valor: selecione o valor da condição.
- Correspondência de resultados: selecione Todos ou Um. Aplicável apenas se conectado a um estágio do tipo múltiplo .
- Selecionar operador: selecione o operador de condição. Depende do valor selecionado.
- Valor personalizado: selecione o valor personalizado para o operador selecionado. Depende do operador selecionado.

Aparência

Você pode personalizar o tipo de linha, o estilo, a espessura da linha, o estilo do link e a cor do conector.

Rótulos

É possível adicionar rótulos às linhas do conector. Selecione Adicionar rótulo para criar um novo rótulo. Você pode personalizar o rótulo por posição, preenchimento, contorno e cor do texto. Selecione Remover rótulo para excluir o rótulo da linha do conector.

Entradas de bot

As entradas de bot são criadas no editor de bot para uso em um bot se você tiver uma opção de ação que possa ser executada. Então você pode ter um bot geral, mas permitir que o analista selecione qual ação tomar no momento da execução.

Por exemplo, em uma ação de limpeza de disco, você pode ter o campo recuperar espaço em disco com opções como: excluir arquivos temporários e concentrar conteúdo do onedrive apenas na nuvem; ou excluir arquivos temporários e executar cleanmgr; ou fazer as duas coisas.

Você pode configurar o nome, tipo e valor padrão do campo de entrada e se ele é opcional ou obrigatório.

As entradas do bot podem ser usadas quando você seleciona executar manualmente a ação personalizada na exibição de dispositivos ou por meio de Executar agora. As entradas também podem ser usadas para um bot de agendamento, nesse caso, quaisquer entradas de bot que tenham sido criadas serão exibidas nas Configurações do gatilho.

Definir variáveis

Defina uma variável no nível do bot. Essa variável é então atualizada ao usar o estágio Definir variável, estágio Comum.

Saiba mais sobre o estágio Definir Variável e Variáveis de Estágio

Executar uma seção de um bot

Você deve selecionar pelo menos dois estágios para entrar no modo de teste. Você pode usar Shift+clicar+arrastar ou segurar Ctrl e clicar duas vezes para selecionar os estágios. Após selecionar os estágios, a seção Executar estágios em um dispositivo aparece no lado direito.

Ela permite que os usuários executem seletivamente uma parte específica do fluxo de trabalho do bot para depurar, testar e analisar problemas de forma eficiente, sem executar o bot inteiro. Por meio dela, os usuários conseguem inspecionar logs, estados de variáveis e saídas intermediárias em tempo real, ajudando a isolar erros e validar correções rapidamente. Com recursos de reprodução, ele garante estabilidade ao mesmo tempo em que otimiza o desenvolvimento e a solução de problemas.

Na seção “Executar estágios em um dispositivo”, você deve selecionar o dispositivo em que deseja executar o teste no campo Escolher dispositivo e preencher as outras entradas necessárias para os estágios.

Depois de preencher todas as entradas, clique em Executar, o que cria um novo fluxo de trabalho. O fluxo de trabalho não selecionado fica esmaecido, e a execução ocorre somente nos estágios selecionados.

Tópicos relacionados

Estágios de Neurons Bots

Resultados de Neurons Bots