ИИ-модели и свой ключ
ИИ в панели работает во многих местах: описания товаров и блюд, ответы гостю, разбор звонков, сборка учебных материалов, помощник по разделам. По умолчанию модель под каждую задачу выбираем мы — и большинству этого достаточно.
Раздел «ИИ-модели (LLM)» нужен тем, кому важно решать самим: какой сервис отвечает за ассистентские функции аккаунта и на какой модели он работает. А если у вас уже есть свой договор с провайдером — можно подключить собственный ключ, и вызовы пойдут через него.
Открыть: карточка «ИИ-модели (LLM)» в магазине расширений (категория «Аккаунт») → admin.cenaly.com/ai-models. Своего пункта в меню у раздела нет — это не ошибка, дверь одна, из магазина. Раздел доступен только владельцу аккаунта.
Зачем этот раздел#
| Сценарий | Что делать |
|---|---|
| «Пусть всё работает само» | ничего: раздел можно не открывать, платформа сама подбирает модель под задачу |
| «Хочу, чтобы отвечала конкретная модель» | подключить готовый сервис и выбрать его предпочтительным |
| «У нас свой договор с провайдером / свой инференс» | добавить кастомное подключение со своим адресом и ключом |
| «Нужно понять, куда уходят ИИ-кредиты» | смотреть карточки баланса на странице подписки |
Что нужно для запуска#
| Что | Зачем |
|---|---|
| Вы — владелец аккаунта | раздел owner-only, и это проверяет сервер, а не только интерфейс |
| Карточка в магазине расширений | это единственная дверь в раздел; отдельной платы за подключение карточки нет |
| Для своего ключа — OpenAI-совместимый эндпоинт | нужны адрес (base URL с версией, только https), API-ключ и id модели |
| ИИ-баланс — для готовых сервисов | они работают через нашу инфраструктуру и оплачиваются ИИ-кредитами по факту использования |
Шаг 1. Подключить готовый ИИ-сервис#
Первый блок страницы — «ИИ-сервисы Cenaly»: ChatGPT (OpenAI), Gemini (Google), Grok (xAI) и DeepSeek. Подключение в один клик:
- Нажмите «Подключить» у нужного сервиса — API-ключи не нужны, запрос идёт через нашу инфраструктуру.
- У подключённого сервиса появится строка «Модель» — выберите конкретную модель из списка сервиса (список у каждого свой и время от времени обновляется).
- Ненужный сервис отключается кнопкой «Отключить».
Оплата — ИИ-кредитами аккаунта, как у любых других ИИ-функций: отдельного счёта за «подключение ChatGPT» не появляется, платите вы за фактические вызовы.
Шаг 2. Подключить свой ключ#
Второй блок — «Кастомные LLM». Он для тех, у кого есть свой доступ к модели: собственный договор с провайдером, корпоративный шлюз или своя развёрнутая модель с OpenAI-совместимым API.
- «Добавить кастомный LLM» и заполните: Название (как вы будете его узнавать), Base URL API — адрес вместе с версией, например
https://api.example.com/v1(толькоhttps), API-ключ, Модель — id модели у этого провайдера. - Нажмите «Проверить связь» — уйдёт тестовый запрос, и вы увидите «Связь есть» с замером задержки либо причину отказа. Проверка работает и до сохранения, и потом на уже сохранённой записи.
- «Добавить» — подключение появится в списке. Его можно временно отключить тумблером или удалить (с подтверждением: вместе с записью удаляется и сохранённый ключ).
Как хранится ключ: он лежит на сервере и обратно в браузер не возвращается — в интерфейсе видна только пометка «API-ключ сохранён» и маска. Подменить ключ можно, прочитать его из панели — нет.
Что с деньгами: за вызовы по вашему ключу ИИ-кредиты не списываются — вы платите своему провайдеру напрямую. Но если ваш эндпоинт не ответил, вызов не падает: он уходит обычной платформенной очередью — и вот этот вызов уже считается по кредитам. Проверяйте доступность своего эндпоинта, если видите расход там, где его не ждали.
Подключений может быть несколько (до десяти) — например, разные модели для разных экспериментов; работают те, у которых включён тумблер.
Шаг 3. Выбрать предпочтительную модель#
Третий блок — «Предпочтительная модель», переключатель на весь аккаунт:
- «По умолчанию (рекомендуется под задачу)» — платформа выбирает модель сама, отдельно под каждую функцию. Это исходное состояние;
- конкретный сервис или кастомное подключение — им ассистентские функции будут пользоваться в первую очередь.
Порядок попыток при выбранном предпочтении: сначала ваш кастомный эндпоинт (если предпочтён он), затем платформенный вызов на выбранной модели, затем обычный запасной путь — чтобы функция не «умирала» из-за одного недоступного провайдера.
⚠️ Выбор действует не во всех ИИ-функциях — подробности в «Ограничениях».
Где видно расход#
Расход ИИ живёт на странице подписки, в двух карточках: «LLM-кредиты» — остаток на балансе ИИ-задач, и «Расходы ИИ» — месячный расход по функциям, прогноз счёта до конца месяца и месячный потолок. По строкам видно, какая именно функция тратит: описания, звонки, переводчик, обучение.
Строк по вызовам вашим собственным ключом там не будет — такие вызовы наш баланс не расходуют.
Ограничения#
- Выбор не действует на
cenaly.ru. В российском контуре ИИ-функции работают на YandexGPT, и настройки этого раздела там не спрашиваются: страница откроется и сохранится, но применить её некому. Это следствие требований к обработке данных, а не забытая настройка. - Выбор не действует на вызовы с инструментами. Часть функций устроена как «модель + инструменты» — ИИ-бот гостевого чата, копайлот панели, суфлёр писем в почте. Они работают на своей модели независимо от того, что выбрано здесь.
- Раздел только для владельца. Сотрудник не увидит его в меню, а по прямой ссылке получит экран ошибки загрузки с кнопкой «Повторить», а не вежливое «нет доступа» — знаем, чиним.
- У кастомного ключа нет ни срока, ни автоматической ротации. Меняете ключ у провайдера — поменяйте его и здесь, иначе вызовы начнут уходить запасным путём (и за кредиты).
- Только OpenAI-совместимый API и только
https. Эндпоинт указывается вместе с версией пути; произвольные протоколы и собственные форматы ответа не поддерживаются. - Списка моделей вашего провайдера мы не знаем — id модели вводите руками, из документации провайдера.
- Готовых сервисов четыре. ChatGPT, Gemini, Grok, DeepSeek; остальное — через кастомное подключение.
Устранение неполадок#
| Симптом | Проверьте |
|---|---|
| «Проверить связь» отвечает ошибкой | адрес должен быть полным, вместе с версией (…/v1) и по https; ключ действующий; у провайдера открыт доступ с внешних адресов |
| Подключение есть, а ответы идут «как раньше» | функция может быть из числа тех, что идут мимо выбора (чат-бот, копайлот, суфлёр почты); либо аккаунт работает в контуре cenaly.ru |
| Кредиты тратятся, хотя подключён свой ключ | ваш эндпоинт не отвечает, и вызовы уходят запасным путём. Проверьте связь кнопкой и посмотрите строки в «Расходах ИИ» |
| Ключ в поле показан звёздочками | так и задумано: ключ хранится на сервере и обратно не отдаётся. Нужен другой — введите новый |
| Сотрудник видит «Не удалось загрузить настройки LLM» | раздел доступен только владельцу аккаунта |
| Страница не находится в меню | её там нет: вход только из карточки «ИИ-модели (LLM)» в магазине расширений |
Общий разбор по симптомам — устранение неполадок; если ничего не помогло, напишите нам — как получить помощь.
Частые вопросы#
Нужно ли вообще заходить в этот раздел?#
Нет. Без него всё работает: платформа сама подбирает модель под каждую задачу. Раздел нужен, если вы хотите выбрать модель сами или подключить свой ключ.
Нужен ли свой ключ OpenAI, чтобы пользоваться ИИ?#
Нет. Готовые сервисы подключаются в один клик и работают через нашу инфраструктуру, оплата — ИИ-кредитами аккаунта. Свой ключ — это альтернатива, а не требование.
Свой ключ — это дешевле?#
Зависит от вашего договора с провайдером. Технически это «мимо нашего счёта»: за такие вызовы ИИ-кредиты не списываются, а платите вы напрямую провайдеру.
Кто видит мой API-ключ?#
Никто из интерфейса: ключ пишется на сервер и обратно в браузер не возвращается — вы увидите только пометку, что он сохранён. Раздел доступен исключительно владельцу аккаунта.
Можно ли выбрать разные модели для разных функций?#
Нет, предпочтение одно на аккаунт. Разные модели под разные задачи — это как раз режим «по умолчанию», в котором выбирает платформа.
Почему на cenaly.ru выбор не работает?#
Российский контур работает на YandexGPT: данные не уходят за пределы контура, поэтому внешние провайдеры и свой эндпоинт там не подключаются.
Что будет, если мой эндпоинт временно недоступен?#
Функция не сломается: вызов уйдёт обычной платформенной очередью — и будет посчитан по ИИ-кредитам. Молчаливой потери запроса не произойдёт.
Сколько стоит сама карточка «ИИ-модели»?#
Отдельной платы за подключение карточки нет — платите вы только за фактическое использование моделей через нашу инфраструктуру.
Связанные разделы#
- Подписка — карточки «LLM-кредиты» и «Расходы ИИ»: остаток, расход по функциям и месячный потолок
- Магазин приложений — единственная дверь в раздел «ИИ-модели»
- База знаний — выбор ИИ-провайдера для сборки базы и согласие на обработку
- Обучение сотрудников — какая модель собирает учебные материалы и задания
- ИИ-переводчик для гостя — одна из функций, расходующих ИИ-баланс
- Чат с гостями — ИИ-бот, который работает на своей модели независимо от этого выбора
- Почта и ИИ-автоответчик — ещё одна функция «модель плюс инструменты», идущая мимо этого выбора
- Как получить помощь — если подключение не проходит проверку