Руководство

Блок AI в Deskgram 2: провайдеры, модели и промпты

Настройка AI, ключей, моделей, пользовательских API и проверка генерации в модулях Deskgram 2.

llm6 мин
Опубликовано: Обновлено:

Ключевые выводы

  • Выберите один тестовый аккаунт и контролируемый диалог, группу или канал по назначению модуля.
  • Проверьте провайдера, ключ, модель, стиль и промпт.
  • Подайте один известный вопрос или новый тестовый пост, а не запускайте большой объём сразу.
  • Сравните ответ с фактами, языком, ссылкой и ожидаемой длиной.

AI-компонент выбирает провайдера, модель и параметры генерации в тех модулях Deskgram 2, где он предусмотрен. Он не является отдельным заданием: источник сообщений, момент обращения к AI и отправку результата определяет рабочий модуль.

Проверено по коду 24 октября 2026 года. Возможности пользовательских подключений — на странице AI-провайдеров.

Включите AI в нужном модуле

Откройте вкладку «АИ» и включите «Использовать АИ для генерации». Затем выберите провайдера и модель. Для нейрокомментинга это генерация комментария к посту; для нейрочаттинга — обработка группового контекста; обычный автоответчик использует настройки для личных ответов.

Модуль Нейрокомментинг
Общий вид компонента АИ в модуле Нейрокомментинг

Не переносите назначение одного модуля на другой. AI decision ветвистого автоответчика выбирает существующую ветку, а не превращает каждую ветку в генератор нового текста. Для него есть инструкция дерева диалога.

Выберите провайдера

В текущем интерфейсе доступны io.net, OpenRouter, Mistral и сохранённые пользовательские подключения с моделью по умолчанию. DG2 free скрыт. Старый пресет может содержать недоступный вариант; после загрузки проверьте фактического провайдера, модель и включение генерации.

Блок АИ
Выбор провайдера и отображение баланса

Провайдер — сервис, который принимает запрос. Модель — конкретный API-идентификатор внутри этого сервиса. Одинаковое название модели на двух площадках не означает общие ключ, баланс или лимиты.

Ссылки на настройку сервисов: Mistral, io.net, OpenRouter. Получите собственный доступ в нужном сервисе, затем сохраните его ключ в программе. Не вводите вместо API-ключа пароль аккаунта или ключ лицензии Deskgram.

Баланс и стоимость

Для OpenRouter компонент предусматривает получение баланса. У io.net и Mistral в этом блоке баланс не отображается; у пользовательского подключения это зависит от отдельной настройки и endpoint сервиса. N/A не означает нулевую цену запроса.

Фильтр «Только бесплатные модели» доступен там, где провайдер поддерживает такой признак. Он отбирает элементы списка, но не обещает доступ без квот и не отменяет правила сервиса. Нулевая цена в ручной модели или локальном списке может быть значением по умолчанию. Тариф и доступную квоту проверяйте в кабинете провайдера. Внешние AI-запросы не включены в подписку Deskgram.

Обновите список и выберите модель

Нажмите обновление моделей, дождитесь результата и выберите нужную. Для ручного ввода включите «Своя модель» и укажите точный API ID, а не маркетинговое имя с сайта. Ввод названия не скачивает, не обучает и не размещает модель на компьютере.

Сохранённый ключ, загруженный список и успешный ответ — три разные проверки. Сервис может отдавать каталог, но не разрешать генерацию конкретной моделью. После изменения провайдера заново проверьте модель; старый ID может относиться к другому API.

Задайте стиль и промпт

Компонент предлагает готовые стили и «Задать свой промпт». Для собственной инструкции выберите этот вариант и заполните поле. Укажите роль, известные факты, язык и ожидаемый формат, а не только «отвечай хорошо».

Стили комментариев
Выбор стиля и ввод собственного промпта

Условный пример для поддержки:

Отвечай по инструкции продукта. Установка выполняется по ссылке, указанной ниже. Не выдумывай цены и функции. Если ответа в предоставленных сведениях нет, предложи написать в поддержку. Дай короткий ответ на языке вопроса.

Добавьте реальные сведения и нужную ссылку. Промпт не загружает автоматически документацию по упоминанию её названия. Если сведения должны попасть в контекст, передайте их в предусмотренном поле рабочего модуля.

Для комментария к посту задайте связь с публикацией и нужную длину; для личного ответа — информацию для ответа пользователю. Контекст переписки и параметр использования сообщения собеседника настраиваются самим модулем и не одинаковы во всех функциях.

Температура

Температура влияет на вариативность, а не достоверность. Начните со значения интерфейса, сравните несколько ответов и меняйте один параметр за раз. Некоторые модели ограничивают диапазон или не поддерживают параметр; отклонение запроса проверяйте по ответу провайдера. Повышение температуры не исправляет отсутствующие факты.

Сохраните API-ключ

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

Настройки API
Раздел глобальных настроек для ввода API-ключей

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

Подключите пользовательский сервис

В API → пользовательские AI-провайдеры добавьте подключение: название, Base URL, API-ключ, хотя бы одну модель с точным ID и модель по умолчанию. Используется OpenAI-совместимый контракт GET /models и POST /chat/completions. Base URL должен быть корнем API, например адресом с нужным префиксом версии, а не полным адресом chat/completions.

Кнопка тестирования сначала запрашивает /models. Непустой корректный список подтверждает чтение каталога, но не генерацию выбранной моделью. Если каталог не получен и есть модель по умолчанию, тест делает короткий chat/completions-запрос. Он может расходовать токены или квоту.

После проверки сохраните подключение, выберите его в рабочем AI-компоненте и проверьте реальный сценарий. Свой API должен возвращать ожидаемый формат, а не просто HTTP 200 с произвольной страницей. Отдельная инструкция пользовательского провайдера описывает эту настройку подробнее.

Проверьте результат на короткой задаче

  1. Выберите один тестовый аккаунт и контролируемый диалог, группу или канал по назначению модуля.
  2. Проверьте провайдера, ключ, модель, стиль и промпт.
  3. Подайте один известный вопрос или новый тестовый пост, а не запускайте большой объём сразу.
  4. Сравните ответ с фактами, языком, ссылкой и ожидаемой длиной.
  5. Задайте вопрос без ответа в материалах и проверьте поведение.
  6. Сопоставьте результат с журналом и расходом в кабинете сервиса.

Успешный AI-ответ и успешная отправка Telegram — разные этапы. Поведение при ошибке зависит от модуля: нельзя обещать общий автоматический переход на шаблон или резервную модель для каждого провайдера, особенно пользовательского.

Если генерация не работает

СимптомЧто проверить
Провайдера нет в спискеПодключение сохранено и имеет модель по умолчанию; DG2 free скрыт
Модель не найденаОбновление списка, точный API ID и выбранный сервис
401/403 от AI APIКлюч и права в сервисе
429Квота и ограничения провайдера; повторные попытки могут расходовать ресурс
Список есть, ответа нетПрава именно на генерацию, формат запроса и журнал
Ответ не по темеСтиль, промпт, переданный контекст и правильный рабочий модуль
Баланс N/A или цена 0Доступность сведений о стоимости; проверить кабинет сервиса
После пресета изменились настройкиНедоступный старый провайдер или модель; проверить текущие значения

Связанные инструкции

Дальше

Полезные ссылки