Этапы ПО ботов Neurons
Этапы используются для создания бота. На странице редактора ботов Neurons переместите этап в рабочую область. Отобразится панель настроек этапа для определения параметров действия или запроса. Этапы должны быть подключены для создания последовательности действий в боте - см. раздел Настройки подключения. Вы можно выбрать этап из категорий этапов. Также можете создать особые этапы и этапы пользователей для использования с ботом.
Категории этапов
В следующем обзоре не будут перечислены все отдельные этапы. Перечисленные этапы могут быть недоступны в каждом действии конфигурации.
Используется для представления и фильтрации информации с устройств, соответствующих заданным критериям. Выходные данные и информация контекста этого этапа запроса может быть передана через последующие этапы в боте.
Например, можно показать устройства с менее чем 10% свободного места на диске.
Этапы действий используют Центр автоматизации для выполнения действий. Для некоторых действий доступно использование переменных. Для получения дополнительной информации см. раздел Переменные этапа.
- Результаты фильтрации: Вы можете фильтровать результаты запроса с помощью настраиваемых свойств. После подключения встроенного этапа запроса к фильтру в раскрывающемся списке Свойство будут перечислены все доступные свойства. Для отображения информации свойств перейдите на панель запроса Настройки этапа и выберите Информация этапа.
- Вы также можете использовать функциональность Предварительный просмотр запроса для оценки всех целевых устройств и использовать таблицу результатов для просмотра формата и диапазона фильтруемых значений.
- У вас есть возможность последовательно объединить несколько запросов. Если это было сделано, все результаты объединяются и становятся доступными для фильтрации или использования на этапах действий. Вы можете изменить работу подключенного фильтра сравнения, чтобы в нем для определения результатов использовалась логика AND (И) или OR (ИЛИ).
- Присоединить: Используйте этот этап для повторного присоединения бота, который имеет отдельные разделенные ветви. В настройках этапа выберите действие присоединения - любое состояние, все успешно, не менее одного успешного.
- Установка переменной: Используйте этот этап для указания согласованной контрольной точки, которую можно настроить со значениями по умолчанию и обновлять по этапам на основе результатов. Это полезно, когда нужно использовать одну переменную для ссылки на поле, которое может быть обновлено из запросов в разных ветвях. Устанавливаемые переменные указываются в диалоге Определение переменных.
Предварительный доступ к этапам можно получить здесь. Бета-версии этапов предлагаются для тестирования, что позволяет Ivanti собирать отзывы и данные о будущих возможных функциях.
Особые этапы используются для выполнения собственных сценариев. Можно использовать один из следующих шаблонов сценариев:
- osquery: язык на основе SQL с открытым исходным кодом, который можно использовать для запросов и извлечения информации из устройств (поддерживаются устройства Windows и macOS).
- Запрос PowerShell: может использоваться для опроса устройств под управлением Windows и macOS. Он может работать от имени системного или вошедшего в систему пользователя.
- Действие Bash: может использоваться для выполнения действий на устройствах macOS.
- Действие командной строки: выполняет команды в командной строке Windows на целевой конечной системе. Может работать от имени системного или вошедшего в систему пользователя.
- Действие Powershell: может использоваться для выполнения действий на устройствах под управлением Windows.
Для получения дополнительной информации см. раздел Особые этапы
Этапы функции списка используются для выполнения действий с результатами этапа, которые представлены в виде списка. Например, можно фильтровать, сортировать, подсчитывать или суммировать данные списка.
Если результатом этапа функции списка станет список, можно добавить еще одну функцию списка для последующего уточнения результата.
В рабочей области можно идентифицировать этап, который (как ожидается) получит результат в виде списка, по тегу Список.
Для использовании функции списка в последовательности действий:
-
Добавьте этап, имеющий список результатов.
-
Добавьте нужную функцию списка.
-
Используя , подключите этапы действий 2 и 3.
Это действие заполнит значения элемента Выбор списка в этапе функции списка. -
Выберите список, для которого нужно выполнить функцию списка.
-
В зависимости от функции списка закончите оставшуюся конфигурацию этапа.
-
Завершите оставшуюся часть последовательности действий бота и сохраните изменения.
Этапы взаимодействия позволяют боту взаимодействовать с конечными пользователями и собирать их данные с помощью Microsoft Teams. На этапах взаимодействия можно выбрать следующие параметры:
- Взаимодействие через MS Teams: Позволяет боту взаимодействовать с конечными пользователями и собирать их данные с помощью Microsoft Teams. Сообщение содержит заголовок, текст и выбор способа взаимодействия: кнопки или свободный ввод текста.
- Сообщение через MS Teams: Позволяет боту отправлять односторонние сообщения конечным пользователям с помощью Microsoft Teams. Сообщение содержит заголовок и сообщение.
- Рейтинг MS Teams: Позволяют боту взаимодействовать с конечными пользователями и собирать рейтинги с помощью Microsoft Teams. Сообщение содержит заголовок, вопрос и рейтинг.
- Состояние MS Teams: Позволяет боту взаимодействовать с конечными пользователями и собирать их данные с помощью Microsoft Teams. Сообщение содержит заголовок, текст и выбор способа взаимодействия: кнопки или свободный ввод текста.
Для получения дополнительной информации см. раздел Этапы MS Teams.
Этапы пользователей - это этапы со сценариями пользователей. Они сохраняются и становятся доступными в этом разделе пользователя для многократного повторного использования во время создании ботов.
Для получения дополнительной информации см. раздел Этапы пользователей.
Переменные этапа
В настройках этапа могут использоваться переменные для передачи информации между этапами и передачи выходных данных одного действия в виде входных данных другого.
Вставка переменных
Для вставки переменной откройте Настройки этапа. Любое, поддерживающее переменные, поле, будет отображать текст Ctrl + Space. Нажмите Ctrl + пробел для выбора и вставки переменной из списка.
Во время определения переменных в качестве входных данных сценария в среде PowerShell используйте синтаксис $myvar для ссылки на эти переменные.
Имя бота: Имя текущего бота.
Запустивший пользователь: Имя пользователя, запустившего бот Это будет пользователь или служба Neurons.
ИД запустившего пользователя: ИД пользователя запустившего бот. Это будет ИД пользователя или служба Neurons.
Штамп времени (ISO): Текущий штамп времени в формате ISO.
Имя устройства: Отображает имя текущего устройства на текущем этапе. Возвращаемые имена устройств разделяются запятыми.
Все данные устройства: Отображает все данные текущего устройства на текущем этапе. Это будет объект JSON.
Имя: Имя вошедшего в систему конечного пользователя.
Отображаемое имя: Полное имя конечного пользователя.
Адрес эл. почты: Адрес электронной почты конечного пользователя.
Есть готовые шаблоны для использования с переменными. Для более сложных вариантов можно использовать javascript с помощью handlebarsjs.
Настройки этапа
Переместите этап в рабочую область, она будет выделена, и отобразится панель Настройки этапа. Используйте настройки для конфигурации и изменения каждого этапа.
Вы можете настроить параметры с помощью функции сценариев этапов пользователей. Для получения дополнительной информации см. раздел Этапы пользователей.
Каждому этапу назначается уникальный числовой идентификатор. Если бот использует один этап более одного раза, этот ИД можно использовать для определения этапов по отдельности.
Нажмите Просмотр информации об этапе для отображения панели информации об этапе, на которой представлено описание и все связанные с этапом свойства. Их можно использовать в качестве критериев фильтрации результатов запросов.
Включите переключатель Результат влияет на показатель DEX для отображения раздела Опросы на странице устройства.
Если параметры этапа заданы неправильно или отсутствует какая-либо информация, этап будет иметь красную рамку, как и настройка, требующая внимания. После того, как настройка будет исправлена, красная рамка исчезнет.
Устаревшие этапы
Если в боте доступна более новая версия этапа, на желтом баннере будет отображено - Требуется действие: Этот бот содержит устаревший этап x. Рамка устаревшего этапа станет желтой.
Выберите Обновить для обновления этапа на новую версию. После выполнения обновления баннер исчезнет, а рамка этапа более не будет желтой.
Выключенные этапы
Если этап в боте был удален и более недоступен, отображается красный баннер - Требуется действие: Этот бот содержит выключенный этап x. Рамка выключенного этапа станет красной.
Вы должны удалить этап из бота. После выполнения действия баннер исчезнет.
Прикрепленные этапы
Используйте категорию прикрепления для группирования наиболее часто используемых этапов.
Для прикрепления этапа поместите на него указатель мыши и нажмите значок прикрепления .
Для отмены прикрепления этапа нажмите значок прикрепления .
Информация этапа
Используйте значок информации любого этапа для отображения описания данного этапа, информации о конкретной операционной системе и подробных настройках.