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

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

Скопируйте на целевую машину файлы, приведенные в таблице ниже — они находятся в комплекте поставки 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

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

Подсеть используется Logics-сервером, LLM-ядром (компонент “Задачи NLP”) и IDP-сервером (компонент “Умный OCR”).

docker network create -d bridge agent_agent_ai

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

Разверните файлы агента на целевой машине — файл Agent-linux.zip должен находиться в каталоге /srv/samba/shared/install:

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

sudo unzip /srv/samba/shared/install/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

В конфигурационном файле appsettings.ProdLinux.json укажите:

• AgentId — уникальный идентификатор агента в виде значения с типом данных GUID. Идентификатор агента можно задать самостоятельно, а затем передать администратору вместе с IP-адресом, чтобы он добавил его в профиль целевой машины, либо наоборот — сначала создать целевую машину в разделе Настройки ➝ Целевые машины, скопировать автоматически заданный GUID и указать его в этом параметре.
• UserName — логин учетной записи агента.
• Password — пароль от учетной записи агента.
• Адрес Primo.AI.Api и его компонентов.

 "Api": {
	"AgentId": "{91E221E8-8E13-4100-8BCB-84EA318C32DA}", // Уникальный идентификатор агента

	"UserName": "agent",
	"Password": "Xxxxxxxxxxxx",

	"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",

	"LogicsServerBaseUrl": "http://localhost:8001", // Реквизиты logics-сервера (расположен на 1-й машине с агентом)
	"NlpEngineAgentBaseUrl": "https://localhost:5005", // Реквизиты агента LLM-ядра (может быть на отдельной машине)
    "AgentBaseUrl": "http://172.17.0.1:5092", // URL агента, доступный из IDP-сервера

	"TenantId": null // Если агент обслуживает отдельный тенант, укажите его здесь
  },

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

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 5092/tcp

Синхронизация времени

Проверьте время командой date на целевой машине и на машине сервера. Вывод должен быть одинаковым.

• Если временная зона отличается:
  • Установите временную зону компонентов Api в Docker:

  sudo sed -i 's|TIMEZONE=Xxxxxxxxxx|TIMEZONE=Yyyyyyyyyy|g' /app/Primo.AI/Api/.env

  • Установите временную зону машины сервера и целевой машины:

  sudo timedatectl set-timezone Yyyyyyyyyy

  • Перезапустите компоненты Api:

  docker compose -f /app/Primo.AI/Api/docker-compose.yaml down && docker compose -f /app/Primo.AI/Api/docker-compose.yaml up -d && \
  sudo systemctl restart Primo.AI.Api.MachineInfo

  • Перезапустите агента:

  sudo systemctl restart Primo.AI.Agent

  • Настройте регулярную синхронизацию времени между машиной сервера и целевой машиной
    ⚠️

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

Проверка доступности агента

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

curl https://agent-ip:5002/api/version -k

Что дальше

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

• Умного OCR
• NLP