Tulpar RPA

Документация 0.4 Администрирование

Настройки и HTTPS

Большая часть настроек — в панели: «Администрирование» → «Настройки» (только администратор). Адреса, сертификат и подключение к базе данных, которые нужны до старта, — в файле orchestrator.json папки данных.

«Настройки» → «Общие»: организация, часовой пояс и публичный адрес
«Настройки» → «Общие»: организация, часовой пояс и публичный адрес

Вкладки настроек #

Вкладка Что настраивается
«Общие» «Организация», «Часовой пояс организации» (в нём срабатывают расписания и считаются дни отчётов), «Публичный адрес (PublicUrl)» — только просмотр, задаётся в orchestrator.json
«Безопасность» «Завершать сеанс после бездействия, ч» (1–72; абсолютный срок сеанса — 7 дней), «Разрешить бессрочные токены API»
«Хранение» Сколько дней хранить события роботов, журналы агентов и сервера, скриншоты и файлы заданий, профиль по шагам, задания, аналитику, остаток очередей, оповещения и аудит (не меньше года). Очистка — каждый день в 03:30
«Маскирование» Номера банковских карт, 14-значные ПИН/ИНН и свои регулярные выражения скрываются в сообщениях до записи в журнал (см. Журнал)
«Агенты» «Целевая версия агента» — агенты старше неё обновятся сами (см. Обновление)
«Каналы» E-mail (SMTP), Telegram, вебхук для оповещений и рассылок (см. Оповещения)
«ИИ» ИИ-объяснение ошибок (ниже)
«Отчёты» Подключение BI-систем к базе отчётов: адрес базы, роли рабочих областей, «Показать пароль» и «Сменить пароль» (см. База отчётов)
«Лицензия» Код запроса, загрузка файла лицензии, места роботов и студии (см. Лицензирование)

Если настройки одновременно изменил другой администратор, панель предложит «Загрузить актуальные».

ИИ-объяснение ошибок #

Выключено по умолчанию: пока оно выключено, кнопки «Объяснить ошибку» нет и сервер никуда не обращается.

  1. «Настройки» → «ИИ» → «Адрес сервиса» — OpenAI-совместимый API. Рекомендуется локальная модель в сети организации: Ollama (http://сервер:11434), LM Studio (http://сервер:1234), vLLM (http://сервер:8000) — путь /v1/chat/completions сервер допишет сам.
  2. «Модель» (например, qwen2.5:7b), при необходимости «Ключ API» (хранится зашифрованным).
  3. «Проверить подключение» → «Включить ИИ-объяснение ошибок» → «Сохранить».

Модели отправляются только замаскированные данные ошибки: процесс и версия, код и текст ошибки, упавший шаг. Значения переменных и ресурсов, данные очередей, аргументы заданий и скриншоты не отправляются никогда. Облачный адрес помечается предупреждением „Данные журнала будут отправлены за пределы организации“. Каждое объяснение — в аудите, лимит — «Объяснений в час на пользователя».

orchestrator.json #

Файл в папке данных (C:\ProgramData\Tulpar\Orchestrator\orchestrator.json, в Docker — переменные окружения Tulpar__…). После изменения перезапустите службу.

{
  "Tulpar": {
    "Server": {
      "Urls": "https://0.0.0.0:8443",
      "PublicUrl": "https://orch.company.kg:8443",
      "Certificate": { "Path": "", "Password": "" },
      "AllowInsecureHttp": false,
      "TrustedProxies": []
    },
    "Database": { "ConnectionString": "Host=localhost;Port=5432;Database=tulpar;Username=tulpar;Password=…" },
    "Reports": { "ConnectionString": "" },
    "Logging": { "Level": "Information", "FileRetentionDays": 14 }
  }
}
Ключ Что задаёт
Server.Urls Адреса, которые слушает сервер (через ;)
Server.PublicUrl Адрес, который открывают пользователи и агенты: ссылки в оповещениях, строки подключения, имя в сертификате
Server.Certificate Свой сертификат (ниже); пусто — самоподписанный
Server.AllowInsecureHttp Разрешить HTTP без TLS на сетевом интерфейсе — только для лаборатории
Server.TrustedProxies IP-адреса обратных прокси, чьим заголовкам X-Forwarded-* доверять
Database.ConnectionString Подключение к основной базе
Reports.ConnectionString Отдельная база отчётов; пусто — <основная>_reports на том же сервере
Logging Уровень журнала сервера и сколько дней хранить его файлы

Ограничения частоты запросов (вход — 10 попыток в минуту с адреса, поиск по журналу и выгрузки — 30 в минуту на пользователя, токен API — 600 запросов в минуту) меняются в Tulpar.RateLimits только для нагрузочных тестов.

Сертификат HTTPS #

  • По умолчанию сервер создаёт самоподписанный сертификат на 10 лет для имени из PublicUrl, имени компьютера, localhost и IP-адресов. Агенты и студия доверяют ему по отпечатку из строки подключения.
  • Чтобы браузеры не предупреждали: «Состояние системы» → «Скачать сертификат .cer» и добавьте его в доверенные корневые центры сертификации на компьютерах пользователей (вручную или групповой политикой).
  • Свой сертификат (PFX) — Server.Certificate.Path и Password в orchestrator.json, затем перезапуск службы. Если новый сертификат не доверен Windows на роботах, выдайте роботам новые строки подключения — меняется отпечаток.
  • За 30 дней до окончания срока сертификата «Состояние системы» предупреждает.

Если HTTPS обеспечивает обратный прокси организации, укажите его адрес в TrustedProxies и внешний адрес в PublicUrl.