Установка агента

Файлы из комплекта поставки

Скопируйте на целевую машину файлы, приведенные в таблице ниже — они находятся в комплекте поставки Primo RPA AI Server. Остальное ПО должно быть предустановлено в ОС.

Установка агента

Настройка учетной записи

Для работы агента создайте группу primo-ai и учетную запись agent.

sudo groupadd primo-ai

sudo useradd -g primo-ai -m -s /bin/bash agent

sudo usermod -aG docker agent

Создание подсети для запуска контейнеров

Подсеть используется NLP-сервером, IDP-сервером, FT-сервером и LLM-ядром.

docker network create \
  --driver bridge \
  --subnet=172.19.0.0/24 \
  --gateway=172.19.0.1 \
  agent_agent_ai

Установка и настройка агента

Разверните файлы агента на целевой машине.

sudo mkdir -p /app/Primo.AI /app/Primo.AI/Agent /app/Primo.AI/AgentData

sudo unzip distr/Agent-linux.zip -d /app/Primo.AI/Agent

sudo chmod -R 771 /app/Primo.AI/Agent /app/Primo.AI/AgentData

sudo chown -R agent:primo-ai /app/Primo.AI/Agent /app/Primo.AI/AgentData

Установите агент как службу и настройте автозапуск:

sudo cp /app/Primo.AI/Agent/Primo.AI.Agent.service /etc/systemd/system/

sudo systemctl daemon-reload

sudo systemctl enable /etc/systemd/system/Primo.AI.Agent.service

Настройте сервис, скорректировав конфигурационный файл /app/Primo.AI/Agent/appsettings.ProdLinux.json. Обычно требуется отредактировать следующий блок:

 "Api": {
	"AgentId": "{91E221E8-8E13-4100-8BCB-84EA318C32DA}", // Уникальный идентификатор агента
  ...
	"AuthBaseUrl": "https://primo-rpa-ai-server:44392",
	"ApiBaseUrl": "https://primo-rpa-ai-server:44392",
	"InferenceBaseUrl": "https://primo-rpa-ai-server:44392",
	"LogsBaseUrl": "https://primo-rpa-ai-server:44392",
  ...
  "AgentBaseUrl": "http://172.19.0.1:5092", // URL агента, доступный из IDP-сервера
  },

• AgentId — уникальный идентификатор агента в виде значения с типом данных GUID.

Установите корректный идентификатор агента, заменив на него заглушку XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXXX:

sudo sed -i 's|"AgentId": "{91E221E8-8E13-4100-8BCB-84EA318C32DA}"|"AgentId": "{XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXXX}"|g' /app/Primo.AI/Agent/appsettings.ProdLinux.json

• Если использована нестандартная подсеть Docker, укажите адрес хоста: AgentBaseUrl, заменив http://XXX.XXX.XX.1:5092 на эндпоинт агента, доступный из Docker-контейнера:

sudo sed -i 's|http://172.17.0.1:5092|http://XXX.XXX.XX.1:5092|g' /app/Primo.AI/Agent/appsettings.ProdLinux.json

• Обязательно установите адрес Primo.AI.Api и его компонентов – XxxxxxxBaseUrl, заменив https://XXXXXXXXXXXXXXXXX:44392 на доступный из Целевой машины эндпоинт AI Server:

sudo sed -i 's|https://primo-rpa-ai-server:44392|https://XXXXXXXXXXXXXXXXX:44392|g' /app/Primo.AI/Agent/appsettings.ProdLinux.json

Запустите службы:

sudo systemctl start Primo.AI.Agent

Проверьте статус службы:

sudo systemctl status Primo.AI.Agent

Просмотрите журнал службы:

sudo journalctl -u Primo.AI.Agent

Настройка правила брандмауэра ufw

Для разрешения доступа к API агента выполните команды:

sudo ufw allow 5002/tcp

Или для создания белого списка:

sudo ufw allow from x.x.x.x to any port 5002 proto tcp

Где x.x.x.x - IP-адрес машины, на которой установлена серверная часть AI Server.

Также создайте правило для доступности агента по http:5092 только из других компонентов целевой машины внутри подсети agent_agent_ai (IDP-, NLP- и FT-сервер):

sudo ufw allow from 172.19.0.0/24 to 172.19.0.1 port 5092 proto tcp

Настройка SELinux

Проверьте, включен ли SELinux в системе командой sestatus. Если включен, измените контекст исполняемого файла агента:

sudo chcon -t bin_t /app/Primo.AI/Agent/Primo.AI.Agent

Что дальше

Выполните установку конкретных целевых машин.

• Умного OCR
• NLP