SmartyPress AI Engine Статья документации

Настройки SmartyPress AI Engine: провайдеры, модели и логи

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

На экране «Настройки» задаётся то, что плагин потом подставляет во все инструменты: ключи провайдеров, модель и язык по умолчанию, типы записей с кнопками плагина и логирование ошибок. Разберём экран сверху вниз.

Откройте «SmartyPress AI» → «Настройки». Вверху две вкладки: «Общие настройки» (General Settings) — всё, о чём речь ниже, и «Доступные переменные» (Available Variables) — значения для промптов.

Экран «Настройки» SmartyPress AI: вкладки «Общие настройки» и «Доступные переменные», карточки провайдеров
Вверху — две вкладки. Под ними карточки провайдеров: зелёные уже подключены.

Провайдеры ИИ

Блок «Провайдеры ИИ» (AI Providers) — шесть карточек: OpenAI, DeepSeek, Claude, OpenRouter, Yandex и GigaChat. Зелёная карточка с галочкой означает, что ключ сохранён и прошёл проверку, серая с подписью «Не подключено» — ключа нет или он не подошёл.

Щелчок по карточке открывает форму провайдера: поле «API-ключ» (API Key), у некоторых — дополнительные поля вроде каталога Yandex Cloud или области доступа GigaChat. Ключ проверяется пробным запросом в момент сохранения. Подключать можно сразу несколько провайдеров и выбирать нужного в каждом инструменте. Как получить ключ и что вписать в поля, рассказано на странице каждого провайдера:

  • OpenAI — ключ и прокси для доступа из России;
  • DeepSeek — ключ и модели;
  • Claude — ключ Anthropic;
  • OpenRouter — ключ и ограничение списков моделей;
  • YandexGPT и YandexART — сервисный аккаунт, роли и ID каталога;
  • GigaChat — ключ авторизации, область доступа и адрес API.

Провайдер, модель и язык по умолчанию

Эти три поля решают, какую нейросеть плагин возьмёт, если вы ничего не выбрали в окне генерации. В «Расширенных настройках» каждого окна их можно заменить для одного запроса.

  • Провайдер по умолчанию (Default Provider) — в списке только подключённые провайдеры.
  • Модель по умолчанию (Default Model) — модели выбранного провайдера. Список длинный у OpenRouter, поэтому в поле можно печатать: оно ищет по названию. Значок 💰 — модель дорогая, 🧠 — модель рассуждений: прежде чем ответить, она «думает», это дольше и съедает больше токенов.
  • Язык по умолчанию (Default Language) — на каком языке писать тексты и править их «Волшебной палочкой». «Использовать язык сайта» (Use site language) берёт язык из настроек WordPress; можно выбрать один из 18 языков явно.
Раскрытый список «Модель по умолчанию» с пометками 💰 и 🧠 у моделей DeepSeek
Список моделей подключённого провайдера. 💰 — дорогая модель, 🧠 — модель рассуждений.

Не забудьте нажать «Сохранить изменения» (Save Changes) внизу экрана — без этого выбор не запомнится.

Типы записей с кнопками плагина

«Включенные типы постов» (Enabled Post Types) — где появятся кнопки «SmartyPress AI Генератор» и «Волшебная палочка», в блочном и классическом редакторе. По умолчанию это записи и страницы, а если на сайте стоит WooCommerce — ещё и товары. Снимите отметку с типа, где нейросеть не нужна, и в его редакторе кнопок плагина не будет.

Логирование ошибок

«Включить логирование отладки» (Enable Debug Logging) записывает ошибки запросов к нейросетям, чтобы потом было видно, что именно ответил провайдер. Есть и вторая галочка — «Также логировать успешные запросы» (Also log successful requests): она пишет в журнал вообще всё. Включайте её на время, когда ищете причину странного результата, а потом выключайте, иначе журнал быстро разрастётся.

Настройки «Включенные типы постов» и «Включить логирование отладки» в SmartyPress AI
Типы записей, где доступны инструменты плагина, и логирование ошибок для отладки.

Где смотреть логи

Записи лежат в разделе «SmartyPress AI» → «Логи». В таблице — время, провайдер, код ответа и текст ошибки. Кнопки над таблицей: «Обновить» (Refresh), «Очистить все логи» (Clear All Logs) и галочка «Автообновление каждые 30 сек» (Auto-refresh every 30s) — удобно, если держите журнал открытым в соседней вкладке.

Страница «Логи API» SmartyPress AI с ошибкой 401 от DeepSeek и кнопкой «Детали»
В логах — время, провайдер, код ответа и текст ошибки. Здесь DeepSeek не принял ключ (401).

В примере DeepSeek вернул код 401: ключ недействителен. Коды и что с ними делать собраны в статье «Решение проблем».

«Детали» (Details) раскрывают сам запрос: адрес API, модель, параметры и текст промпта, а справа — полный ответ провайдера. Сам ключ плагин в журнал не пишет: последние символы в примере — из текста ошибки, которую прислал DeepSeek.

Раскрытые «Детали запроса» в логах SmartyPress AI: адрес API, модель и параметры запроса
«Детали» раскрывают сам запрос: адрес API, модель, параметры и промпт. Пригодится, если пишете в поддержку.
Что лежит в журнале. В деталях виден промпт вместе с текстом вашей записи. Если отправляете фрагмент журнала в поддержку или на форум, уберите из него то, чего не хотите показывать.

Доступные переменные

На второй вкладке — значения, которые плагин подставляет в промпты вместо переменных в фигурных скобках: тон и стиль текста, число разделов и абзацев. Здесь же можно завести свои переменные — например, {BRAND_NAME} с названием вашей компании. Подробно — в статье «Промпт для написания статьи: переменные и настройка».

Вкладка «Доступные переменные»: тон, стиль, количество разделов и абзацев, кнопка «Добавить переменную»
Вкладка «Доступные переменные»: значения, которые плагин подставляет в промпты.

Компоненты

Модули плагина включаются и выключаются не в настройках, а на отдельном экране «Компоненты». Как это сделать и что меняется в админке — в статье «Установка и активация».

Что дальше