История страницы

ROBIN Agent  модуль отвечающий за:

• получение команды на запуск конкретного робота м сами зашифрованные пакеты этого программного робота. Получает эту команду от ROBIN Orchestrator 2.0, когда речь идет о запуске из оркестратора, и от Robin Studio 2.0 при запуске в режиме отладки
• передачу в ROBIN Orchestrator 2.0 логов выполнения робота в режиме реального времени, логов ROBIN Studio 2.0 и Robin Player и своих собственных логов после завершения их работы.

ROBIN Agent устанавливается в операционную систему как служба, поэтому отсутствует полноценный графический интерфейс пользователя.

Изменять настройки модуля можно только через его конфигурационный файл Robin.Agent.Service.exe.config:

•        логирование (путь и название файла лога, кодировка, максимальный размер файла лога, количество файлов лога, формат записи (паттерн) строки лога);

•        адрес для обращения к хранилищу роботов через сервер приложений;

•        настройки подключения к RabbitMQ (имя хоста, порт, логин и пароль пользователя, добавленного в RabbitMQ).

Взаимодействие ROBIN Agent 2.0 с другими компонентами и модулями

• ROBIN Player. ROBIN Agent отправляет команды на исполнения программных роботов в ROBIN Player, который установлен на том же хосте. Перед началом рабочей сессии приложения проходят процедуру взаимной аутентификации.
• ROBIN Studio 2.0. Если робот запущен в режиме отладки, агент передает логи исполняющегося процесса в ROBIN Studio 2.0 (формирование этого лога пользователь видит сразу на панели лога в Studio). Agent осуществляет взаимодействие только с той Studio, которая установлена на том же хосте. Перед началом рабочей сессии приложения проходят процедуру взаимной аутентификации.

ROBIN Agent - приложение (в установке «Для себя») или служба (в установке «для всех») обеспечивающее взаимодействие компонентов платформы:

• ROBIN Studio - ROBIN Robot - Executor - в случае использования варианта платформы Standalone
• ROBIN Studio - ROBIN Orchestrator - ROBIN Robot - Executor - в случае использования варианта платформы Enterprise

Как было упомянуто, ROBIN Robot может быть установлен в разных вариантах. При этом меняется каталог установки ROBIN Agent:

...

Вариант установки ROBIN Agent

...

Путь установки приложения

...

Установка «Для себя»

...

C:/Users/<userName>/AppData/Local/Programs/Robin Platform/2.0.0/Agent

...

Установка «Для всех пользователей»

...

C:/Program Files/Robin Platform/2.0.0/Agent

В случае проблем с работой ROBIN Agent, пользователь получит уведомление об ошибке.

В случае с Standalone, при попытке запуска ROBIN RobotPlayer:

...

- приложение, отвечающее за передачу сообщений и команд между ROBIN Studio, ROBIN Orchestrator и ROBIN Robot:

• при запуске робота из любого компонента платформы управление запуском происходит через ROBIN Agent
• при передаче логов выполнения роботов в ROBIN Orchestrator 2.0 в режиме реального времени
• при передаче в ROBIN Orchestrator информации о статусе машины и ее текущей загруженности

Вкладка настроек Robot Player «Агент»

В разделе "Агент" есть возможность настроить логирование ROBIN Agent.

Для поставки Standalone

Image Added

Характеристики настроек вкладки "Агент" представлены в нижеприведенных таблицах: 

Для поставки Standalone

Для сохранения изменений необходимо нажать на кнопку «Сохранить» и перезагрузить ROBIN Agent

Для поставки Enterprise и Cloud

Особые условия

При запуске роботов в Robin Studio Enterprise при восстановлении файлов с длинными именами в папку, которая сама имеет длинное имя можно столкнуться с ограничениями , связанными с длиной пути MAX_PATH, которая определяется Windows API в 260 символов.

При отключенном кэшировании зависимостей робота при восстановлении файлов в Robin Studio Enterprise не хватает длины пути, чтобы скачать одну из зависимостей движка, кроме того после завершения работы робота зависимости будут удалены с машины. Поэтому при каждом повторном запуске робота будет происходить восстановление пакетов действий.

Для этого нужно проверить настройки ROBIN Agent:

1. Если в настройках ROBIN Agent выбран вариант «НЕ кешировать зависимости робота»,

Image Added

то при  запуске робота на .NET действия (например, Сообщение), робот завершается с ошибкой, которая связана с  длиной пути MAX_PATH.

Image Added

Результат: ошибка восстановления пакетов

Начиная с Windows 10 версии 1607, MAX_PATH при отключенном кэшировании зависимостей ограничения были сняты для многих распространенных функций файлов и каталогов Win32. Однако используемое приложение должно согласиться на новое поведение.

Чтобы включить новое поведение длинного пути для каждого приложения при отключенном кэшировании зависимостей робота, должны быть выполнены некоторые условия.

Подробнее можно посмотреть тут: https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=registry#enable-long-paths-in-windows-10-version-1607-and-later

Эта проблема решается настройкой реестра вручную. Для этого в реестр HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystemLongPathsEnabled поставить значение 1.

2. В версиях выше 2.24.0  перечень настроек Robot Player «Агент» ,был усовершенствован и для того, чтобы пакеты восстанавливались корректно, а робот запускался и отрабатывал без ошибки достаточно в настройках ROBIN Agent разрешить кэширование зависимостей.

Image Added

Тогда, при запуске того же действия «Сообщение», пакеты с длинными путями восстанавливаются полностью,  и робот отрабатывает без ошибки.

Image Added

Отображение статуса ROBIN Agent

Статус Агента отображается индикатором статуса подключения в рабочей области в виде круга с буквой "А". 

Актуально для версий: Standalone, Enterprise, Cloud. 

ROBIN Player:

Image Added

При наличии проблем с подключением к ROBIN Agent могут возникнуть трудности с запуском робота. Для диагностики возможных проблем на интерфейсах приложений размещен индикатор статуса подключения Agent. 

Существуют следующие варианты отображения информирования пользователя о статусе Агента:

Вариант поставки Standalone:

• Зеленый - ROBIN Player подключен к Агенту, начиная с версии 2.20.2, Агент подключен к Оркестратору
• Серый - ROBIN Player не подключен к Агенту, необходимо перезапустить Агента

 Вариант поставки Enterprise/Cloud:

• Зеленый - ROBIN Player подключен к Агенту, начиная с версии 2.20.2, Агент подключен к Оркестратору
• Серый - ROBIN Player не подключен к Агенту, необходимо перезапустить Агента
• Красный - ROBIN Player подключен к Агенту, Агент не подключен к Оркестратору
• Желтый - ROBIN Player подключен к Агенту, выполняется переподключение к Оркестратору

ROBIN Studio

Image Added

Вариант поставки Standalone:

• Зеленый - ROBIN Studio подключена к Агенту
• Серый - ROBIN Studio не подключена к Агенту 

Вариант поставки Enterprise/Cloud:

• Зеленый - ROBIN Studio подключена к агенту, Агент подключен к Оркестратору
• Серый - ROBIN Studio не подключена к Агенту
• Красный - ROBIN Studio подключена к Агенту, Агент не подключен к Оркестратору, переподключается сам
• Желтый - ROBIN Studio подключена к Агенту, выполняется переподключение к Оркестратору

При возникновении проблемы с подключением к ROBIN Agent можно попробовать решить ее перезапуском. Для этого:

1. В случае установке «Для себя»

   • остановите работу ROBIN Robot Player - кликните правой кнопкой мыши по иконке программы в дереве, выберите пункт меню "Выйти"
   • откройте

...

В зависимости от типа выполненной на АРМ установки программы последовательности действий немного различаются.

...

1. • каталог, где установлен ROBIN Agent (путь см. выше)

...

1. • найдите в каталоге и запустите

...

1. • приложение Kill.Robin.Agent.exe, дождитесь завершения

...

1. • его работы

   Image Modified

...

1. • найдите в каталоге и запустите

...

1. • приложение Robin.Agent.exe, дождитесь завершения

...

1. • его работы

   Image Modified

• Запустите RobotPlayer, кликнув дважды по иконке программы на Рабочем столе АРМ

2.     В случае, когда была выполнена установка «Для всех пользователей»

1. В случае установки "Для всех пользователей"

• остановите работу ROBIN Robot Player Остановите работу ROBIN RobotPlayer - кликните правой кнопкой мыши на по иконке программы приложения в директории, выберите пункт меню «Выйти»
• Откройте откройте диспетчер задач (комбинация клавиш Ctrl-Alt-Del -> «Диспетчер задач»)
• Перейдите перейдите в раздел «Службы» "Службы"
• В в разделе "Службы" найдите процесс Robin.Agent.Service,
  Image Modified
  

• Остановите остановите процесс, для этого правой кнопкой мыши кликните по имени процесса в Диспетчере задач, выберите пункт меню «Остановить»"Остановить"
  Image Modified

• Дождитесь дождитесь полной остановки процесса Robin.Agent.Service!!!
• Вновь вновь запустите процесс Robin.Agent.Service, правой кнопкой мыши кликните по имени процесса в Диспетчере задач, выберите пункт меню «Запустить»"Запустить"
  Image Modified

• Дождитесь дождитесь запуска процесса Robin.Agent.Service (появился статус «Выполняется» "Выполняется" в строке Службы)
• Запустите RobotPlayerзапустите Robot Player, кликнув дважды по иконке программы на Рабочем столе АРМ

Названия и описания конфигурационных параметров