В ClubIS можно подключить любую OpenAI-совместимую языковую модель: локальную (например, Ollama) или облачную (OpenAI, Yandex AI Studio и другие).
Настройки хранятся на площадке и используются службой web-service. Внешние системы обращаются к ClubIS через AI API, а ClubIS уже ходит к выбранной модели.
¶ Где настраивается
Откройте Администратор → Интеграции → AI. Поля языковой модели собраны в блоке OpenAI API.
Рядом блок Речка: расшифровка записей звонков, отдельная инструкция.
Тот же блок OpenAI API включает черновик ответа в переписке с клиентом. Профили, база знаний и журнал подтверждения — в статье AI в переписке.
Вопрос по существующему отчёту — в статье AI в отчётах.
Блок AI Hub: тип события для заметки звонка, отдельная инструкция.
| Поле | Назначение |
|---|---|
| Включено | Разрешает использование подключённой модели |
| Базовый URL | Адрес OpenAI-совместимого API (обычно заканчивается на /v1) |
| API-ключ | Ключ провайдера; для локальной модели без ключа можно оставить пустым |
| Модель | Идентификатор модели у провайдера |
| Проверить соединение | Тестовый запрос к модели с этого компьютера |
Подсказка в программе: адрес указывается с точки зрения сервера ClubIS (web-service), а не рабочей станции. Проверка соединения из Администратора выполняется с компьютера, где открыта программа — если модель доступна только с сервера, кнопка может показать ошибку, а работа через web-service при этом будет успешной.
¶ Разрешение для сотрудника
Вызовы AI API всегда требуют отдельного разрешения AI API у учётной записи (вкладка API в свойствах сотрудника), даже если общая опция ограничения доступа к API ещё не включена.
Как завести служебного пользователя и выдать USER_ID / USER_HASH: Авторизация в API.
¶ Пример: локальная модель (Ollama)
- Установите Ollama на том же сервере, где работает web-service ClubIS (или укажите адрес, доступный с этого сервера).
- Загрузите и запустите модель, например:
ollama pull llama3.2
ollama serve
- В Администратор → Интеграции → AI укажите:
| Поле | Значение |
|---|---|
| Включено | да |
| Базовый URL | http://127.0.0.1:11434/v1 |
| API-ключ | пусто |
| Модель | llama3.2 (или другое имя из ollama list) |
- Нажмите Проверить соединение (на сервере или с машины, с которой этот адрес доступен).
- Сохраните настройки.
Другие локальные OpenAI-совместимые серверы (LM Studio, vLLM и т.п.) подключаются так же: в Базовый URL укажите их /v1, в Модель — имя модели из списка провайдера.
¶ Пример: Yandex Cloud (YandexGPT)
ClubIS использует OpenAI-совместимый интерфейс Yandex AI Studio.
-
Откройте консоль Yandex Cloud. Каталог можно создать или взять уже существующий.
На главной сверху два переключателя: слева облако, справа каталог. Нужен идентификатор каталога, не облака. У правого переключателя (имя каталога) нажмите ⋯ и выберите Копировать ID.
-
Создайте API-ключ сервисного аккаунта с правами на работу с моделями AI Studio.
-
В Администратор → Интеграции → AI укажите:
| Поле | Значение |
|---|---|
| Включено | да |
| Базовый URL | https://ai.api.cloud.yandex.net/v1 |
| API-ключ | API-ключ Yandex Cloud |
| Модель | gpt://<folder_id>/yandexgpt/latest |
Подставьте вместо <folder_id> идентификатор каталога из пункта Копировать ID. Пример:
gpt://b1gxxxxxxxxxxxxxxxx/yandexgpt/latest
Для более быстрой и экономичной модели можно указать yandexgpt-lite:
gpt://<folder_id>/yandexgpt-lite/latest
- Нажмите Проверить соединение и сохраните настройки.
Актуальные имена моделей смотрите в документации Yandex Cloud по генерации текста в AI Studio.
¶ Пример: Yandex Cloud (DeepSeek)
Тот же Базовый URL, API-ключ и идентификатор каталога, что для YandexGPT. Меняется только поле Модель.
| Поле | Значение |
|---|---|
| Базовый URL | https://ai.api.cloud.yandex.net/v1 |
| API-ключ | API-ключ Yandex Cloud |
| Модель | gpt://<folder_id>/deepseek-v4-flash/latest |
Пример:
gpt://b1gxxxxxxxxxxxxxxxx/deepseek-v4-flash/latest
Если в консоли Yandex Cloud для выбранной модели указан другой идентификатор — скопируйте его в формате gpt://<folder_id>/<имя_модели>/latest.
¶ Что дальше
После сохранения настроек внешняя система может вызывать методы AI API площадки (проверка связи и завершение диалога) от имени сотрудника с разрешением AI API. Спецификация методов — в OpenAPI ClubIS (AI API).
В Менеджере та же модель подставляет черновик ответа в переписке с клиентом. Задача сотруднику и сообщение клиенту через оператора чата описаны в статье AI в переписке.
В программе Отчёты та же модель отвечает на вопрос по уже существующему отчёту: AI в отчётах.
¶ Частые вопросы
Где взять идентификатор каталога?
На главной консоли Yandex Cloud сверху два переключателя. Слева — облако, справа — каталог. У правого нажмите ⋯ и Копировать ID. Идентификатор облака в поле Модель не подставляйте.
Почему «Проверить соединение» не проходит, а с сервера всё работает?
Адрес модели должен быть доступен с сервера web-service. Кнопка в Администраторе проверяет доступность с вашего компьютера.
Можно ли оставить ключ пустым?
Да, если провайдер не требует ключ (типично для локальной Ollama). Для Yandex Cloud и OpenAI ключ обязателен.
Это то же самое, что чат поддержки ClubIS?
Нет. Блок OpenAI API — подключение вашей модели для AI API площадки, для черновика в переписке с клиентом и для вопроса на вкладке AI в программе Отчёты. Чат поддержки ClubIS настраивается отдельно и к этим полям не относится.