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

Основные настройки модуля «Улей: Коннектор AI» выполняются в административной части портала. Доступ к этим настройкам есть только у администраторов. Для доступа к настройкам перейдите по пути: адрес_портала/bitrix/admin/settings.php?lang=ru&mid=ithive.aiconnector.

На странице доступны следующие настройки:

Подключение AI

  1. Модуль. Выберите модуль-потребитель, для которого настраивается AI. В списке отображаются модули Улья, которые используют AI (например, «Ценности компании»). У каждого модуля свои провайдер, ключи и модели.
  2. Включить AI. Активируйте переключатель «Включить AI».

В модуле предусмотрены три способа подключения:

  1. Прямое подключение. Российские и корпоративные модели: Sber GigaChat, Yandex AI Studio, корпоративная LLM.
  2. Прямое подключение (зарубежные провайдеры). DeepSeek и другие зарубежные API в блоке «Нужны другие модели».
  3. Через AI Gateway. Единый шлюз Cloudflare ко многим провайдерам.

У каждого провайдера есть ссылка «Как подключить» — она открывает на слайдере краткую справку по подготовке учетных данных.

Подключение напрямую

В блоке «Прямое подключение» настраиваются российские и корпоративные модели. Запросы идут напрямую к провайдеру. Заполните поля только тех провайдеров, которые собираетесь использовать.

Sber GigaChat

Для подключения нужны доступ к GigaChat API на developers.sber.ru и Authorization Key.

  1. Authorization Key. Ключ авторизации для доступа к API.
  2. Scope. Вариант доступа к API (например, GIGACHAT_API_PERS).
  3. Не проверять SSL-сертификат. Отключает проверку SSL при обращении к API. Безопаснее указать путь к CA-сертификату ниже и оставить проверку включенной.
  4. Путь к CA-сертификату (необязательно). Путь к корневому сертификату, если этого требует политика безопасности.
  5. Модель. Имя модели: выберите из подсказок или введите свое. Ссылка «Обновить список моделей» подтягивает актуальный каталог — сначала сохраните подключение, затем обновите список.

Yandex AI Studio

Для подключения нужны каталог в Yandex Cloud (Folder ID) и API-ключ сервисного аккаунта с доступом к Foundation Models.

  1. API-ключ. Ключ доступа к API.
  2. Folder ID. Идентификатор каталога в Yandex Cloud.
  3. Модель. Имя модели: выберите из подсказок или введите свое. Ссылка «Обновить список моделей» — после сохранения подключения.

Корпоративная LLM (свой сервер)

Для модели, развернутой на вашем сервере с OpenAI-совместимым API (vLLM, Ollama, TGI, LM Studio и аналоги).

  1. Адрес сервера (Base URL). Корень API без /chat/completions, например https://llm.corp.local/v1.
  2. API-ключ (необязательно). Ключ авторизации, если сервер его требует. Внутри контура сервер часто работает без ключа.
  3. Модель. Имя модели на сервере: выберите из подсказок или введите вручную. Ссылка «Обновить список моделей» — после сохранения подключения.
  4. Не проверять SSL-сертификат. Отключает проверку SSL. Безопаснее указать путь к CA-сертификату ниже.
  5. Путь к CA-сертификату (необязательно). Путь к сертификату внутреннего центра сертификации.

Прямое подключение (зарубежные провайдеры)

Зарубежные провайдеры с прямым подключением находятся в блоке «Нужны другие модели». Разверните его, если нужен прямой доступ к DeepSeek или другим зарубежным API. Учитывайте, что из российских сетей прямой адрес зарубежного провайдера может быть недоступен.

DeepSeek

Для DeepSeek нужен аккаунт на platform.deepseek.com и API-ключ:

  1. API-ключ. Ключ доступа к API провайдера.
  2. Модель. Имя модели: выберите из подсказок или введите свое (например, deepseek-v4-flash или deepseek-v4-pro).

Подключение через AI Gateway

Для выполнения этих настроек нужно предварительно зарегистрироваться на платформе управления AI-сервисами и создать AI-шлюз.

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

  1. Account ID. Идентификатор аккаунта Cloudflare (раздел AI Gateway).
  2. Gateway ID. Имя созданного шлюза.
  3. Токен AI Gateway (необязательно). Токен авторизации шлюза, если для шлюза включена защита.
  4. Подключения (кольцо провайдеров). Выберите провайдера в списке и нажмите «Добавить». Для каждой карточки укажите API-ключ провайдера и модель.

Модель по умолчанию

Блок «Модель по умолчанию» задает провайдера и модель для всех AI-фич выбранного модуля-потребителя.

  1. Выберите способ подключения модели: Через AI Gateway или Напрямую.
  2. Укажите провайдера и модель.

Резервная модель

Блок необязателен для настройки. Если запрос к модели по умолчанию завершился ошибкой, модуль может один раз повторить его через резервную модель. Резерв должен отличаться от основной модели, иначе запрос будет пропущен.

  1. Выберите способ подключения модели: Через AI Gateway или Напрямую.
  2. Укажите провайдера и модель.

AI-фичи модуля

Список AI-фич зависит от выбранного модуля-потребителя. Для каждой фичи можно оставить модель по умолчанию или включить «Переопределить модель» и указать свой способ подключения, провайдера и модель.

Например, для модуля «Ценности компании» доступны:

  • Рекомендация по сотруднику — короткая рекомендация по развитию на основе анонимной оценки коллег.
  • Обзор компании/отдела — сводный AI-обзор по агрегированным метрикам компании или выбранных отделов.

Без переопределения рядом с чекбоксом отображается статус «По умолчанию».

Примечание

Сохраненные ключи и токены при повторном открытии страницы не показываются. Если поле ключа оставить пустым и нажать «Сохранить», ранее сохраненное значение не изменится.

После заполнения полей нажмите «Проверить соединение», затем «Сохранить». ИИ-модель готова к работе.

Предыдущая
О продукте
Следующая
Установка и обновление модуля