Após selecionar o tipo de gatilho na página Criar Bot, a página do editor de bots será 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 Bots.
Como construir um bot
O bot sempre iniciará com o gatilho que você selecionou na página de Criação de 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 ou Pesquisa de implantação de patch. É 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:
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.
Limitar dispositivos: Ative a opção Limitar dispositivos para especificar o número máximo de dispositivos de destino. Caso a contagem máxima de destino for excedida, toda a invocação falhará imediatamente e os dispositivos individuais não serão processados. O gatilho é marcado como Falha no histórico de gatilhos. A contagem do dispositivo é avaliada após a aplicação do escopo (com base no que o usuário tem permissão para ver ou definir como destino). Os dispositivos on-line e off-line estão incluídos na contagem. Este limite se aplica apenas a gatilhos agendados.Você também pode definir notificações por e-mail em Configurações → Notificações, para que você possa receber notificações quando o limite for ultrapassado e o fluxo de trabalho falhar. Para obter mais informações sobre notificações, consulte a Página inicial do Bots.
Máximo de destinos: este campo aparece após você alternar entre Limitar dispositivos. Insira o número máximo de dispositivos de destino.
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.
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 o 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.
Na página do editor de Neurons Bots, selecione Definir entradas para abrir o painel Definir entradas.
Selecione Adicionar entrada para exibir os campos para criar uma nova entrada.
Nome: o nome de exibição do campo de entrada.
Tipo: o tipo de entrada necessário para o campo. Selecione entre:
Texto/string: selecione para criar um campo de texto livre.
Número: selecione para criar um campo de valor numérico.
Verdadeiro/falso: selecione para criar um campo de seleção Verdadeiro ou Falso.
Data: selecione para criar um campo de data; use o seletor de data.
Opções de texto: selecione para criar campos de opção. Se selecionado, você precisa definir quais são as escolhas, inserir o Nome da escolha e o Valor da escolha; o nome é o nome de exibição amigável, e o valor é a string passada através do bot. Você pode adicionar várias opções.
Opcional: selecione se o campo será opcional ou não.
Valor padrão: defina o valor padrão para a entrada. As opções que você tem no valor padrão dependem do tipo de entrada selecionado.
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.
Na página do editor de Neurons Bots, selecione Definir variáveis.
Selecione Adicionar variável para exibir os campos de variáveis.
Nome: digite um nome para a variável. Ao usar o estágio Definir variável, esse é o nome listado no menu suspenso Escolher variável.
Tipo: você pode selecionar um conjunto diferente de variáveis para Dispositivos e Pessoas.
Dispositivos: selecione o tipo de variável entre os seguintes:
Texto/string
Número
Verdadeiro/falso
Data
Opções de texto
Pessoas: selecione o tipo de variável entre os seguintes:
Cargo da pessoa
Localização da pessoa
Gerente da pessoa
Departamento da pessoa
E-mail da pessoa
Nome da pessoa
Você pode executar um bot nos grupos de pessoas estáticos disponíveis na lista.
Valor inicial: defina o valor inicial da variável. A entrada dependerá do tipo de variável que você selecionou.
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.