side menu

Настроить интеграцию ELMA365 с ELMA Cortex

После того как вы установили ELMA Cortex, настройте связь с компанией ELMA365. Для этого:

  1. Загрузите в компанию ELMA365 решение для интеграции с ELMA Cortex.
  2. Настройте авторизацию пользователей в ELMA Cortex.
  3. Установите соединение с ELMA Cortex.

Шаг 1. Загрузить решение для интеграции с ELMA Cortex

  1. Запросите у вашего менеджера ELMA365 файл решения Интеграция с ELMA Cortex.
  2. Перейдите в раздел Администрирование > Решения.
  3. Нажмите в правом верхнем углу страницы + Решение и выберите в появившемся окне опцию Загрузить файл.
  4. Укажите файл решения формата .e365.
  5. В открывшемся окне нажмите Далее и дождитесь окончания импорта решения.

В составе решения в компанию загрузится модуль, который используется для интеграции компании ELMA365 с ELMA Cortex.

Шаг 2. Настроить авторизацию пользователей в ELMA Cortex

На стороне ELMA365 нужно настроить авторизацию в ELMA Cortex по протоколу OAuth 2.0, чтобы:

  • проверять права текущего пользователя — когда при работе AI‑агента и AI‑операции нужно совершить действие в системе, проверяется доступ к элементам приложений, кнопкам запуска процессов и т. п.;
  • обеспечить вход администратора в ELMA Cortex — если вы используете авторизацию с помощью ELMA365.

Чтобы настроить авторизацию:

  1. Откройте раздел Администрирование > Модули и выберите модуль Интеграция с ELMA Cortex.
  2. Добавьте клиента OAuth 2.0. Для этого внизу страницы модуля разверните блок Токены и нажмите справа кнопку + Создать клиент OAuth2/OIDC.
  3. В открывшемся окне заполните поля:

cortex-integration-solution-1

  • Название* — задайте имя клиента;
  • Шаблон* — оставьте значение, установленное по умолчанию;
  • URI перенаправления* — введите путь к вашему серверу ELMA Cortex в формате: https://<домен_ELMA_Cortex>/api/pub/v1/security/sessions/callback.
  1. Нажмите Сохранить.
  2. В открывшемся окне скопируйте и сохраните уникальный идентификатор и секрет приложения. Они нужны для настройки входа администратора в ELMA Cortex, если используется авторизация через ELMA365, а также для установки подключения к ELMA365 при создании AI‑агентов и AI‑операций.
  3. Если вы задаёте авторизацию администратора с помощью ELMA365, перейдите к настройке файла переменных окружения и укажите уникальный идентификатор и секрет приложения.

Шаг 3. Установить соединение с ELMA Cortex

После того как сервер ELMA Cortex установлен:

  1. Войдите в ELMA Cortex. Данные для входа зависят от настроенного способа авторизации:
  • с помощью ELMA365 — введите свой логин и пароль из системы;
  • с помощью ELMA Bot — укажите логин и пароль администратора ELMA Bot.
  1. На левой панели нажмите значок cortex-api-keys-icon для перехода к странице API-ключи.
  2. Нажмите рядом с названием страницы значок плюса.
  3. В открывшемся окне задайте название ключа и укажите вид доступа Интеграция, затем нажмите Добавить.
  4. Скопируйте сгенерированный ключ.

cortex-integration-solution-2

  1. Перейдите в ELMA365 и откройте раздел Администрирование > Токены.
  2. Создайте токен, указав в качестве пользователя администратора системы, и скопируйте его.
  3. Откройте раздел Администрирование > Модули и выберите модуль Интеграция с ELMA Cortex.
  4. На вкладке Основное заполните поля:
  • URL* — введите адрес вашего сервера ELMA Cortex;
  • API key* — вставьте API-ключ, скопированный из ELMA Cortex.
  1. Нажмите Переподключить, чтобы установить соединение с сервером ELMA Cortex.
  2. В поле ELMA365 token* вставьте токен, созданный в ELMA365.
  3. Убедитесь, что интеграция работает корректно, нажав кнопку Проверить соединение.

cortex-integration-solution-3

  1. В поле Язык чата по умолчанию выберите язык, на котором AI‑агенты общаются с пользователями: русский или английский.
  2. Внизу страницы нажмите кнопку Сохранить.

Настройка интеграции с ELMA Cortex завершена. Теперь подключите провайдеров больших языковых моделей, чтобы настраивать AI‑агентов, AI‑операции и умный поиск.

 

cortex-troubleshooting.html cortex-llm-providers.html