Документация для WooCommerce

GEN Admin — AI-ассистент в админке WordPress

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

Скачать плагин .zip Открыть виджеты

Приватное подключение Подтверждение изменений WordPress + WooCommerce

Знакомство

Что такое GEN Admin

GEN Admin — закрытый AI-виджет для сотрудников магазина. После установки плагина он доступен поверх страниц панели WordPress и понимает, какой товар, заказ или запись сейчас открыты. Ассистент ведёт диалог через платформу Gen-neuro, а чтение и изменение данных WooCommerce выполняет локальный плагин.

Ассистент не меняет магазин незаметно Чтение выполняется сразу, а создание и изменение данных сначала формируют карточку-предпросмотр. Запись в WordPress происходит только после нажатия кнопки подтверждения.

Каталог

Товары, категории, цены, остатки, SEO, описания и изображения.

Заказы

Поиск, сводки, фильтры и подготовка пакетных изменений.

Клиенты

Поиск покупателей и управляемые массовые правки данных.

Блог

Создание и обновление записей, рубрик, тегов, SEO и иллюстраций.

Перед началом

Что понадобится

Аккаунт Gen-neuro и созданное рабочее пространство.
Сайт на WordPress с активным WooCommerce.
Права администратора WordPress или право manage_woocommerce.
Положительный баланс токенов в рабочем пространстве.

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

Шаг 1

Создайте и настройте ассистента

Ассистент определяет стиль общения, правила работы и AI-модели. Один ассистент можно использовать в одном или нескольких приватных виджетах.

1
Откройте рабочее пространство
Перейдите в «Пространство» → «Сущности» → «Ассистенты» и нажмите создание нового ассистента.
2
Заполните основные данные
Укажите понятное название и описание поведения. В описании задайте роль, тон, язык, ограничения и правила: например, не выдумывать характеристики, сохранять HTML-разметку или писать лаконично.
3
Сохраните ассистента
После первого сохранения станут доступны модели, базы знаний, товары и тестовый диалог.

Выбор моделей

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

Тип модели	Для чего нужна	Когда выбирать
Основная модель	Диалог, анализ и подготовка действий	Обязательна всегда
Генерация изображений	Новые изображения товаров и статей, изменение текущих фото	Если планируете работать с изображениями
OCR	Распознавание текста в изображениях и документах	Для сканов, накладных и фото с текстом
TTS	Синтез речи	Для сценариев с озвучкой

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

Базы знаний

База знаний нужна, когда ассистент должен учитывать ваши регламенты, стиль контента, справочную информацию, инструкции или данные, которых нет в WordPress.

1Откройте в ассистенте карточку «База знаний».
2Создайте коллекцию или подключите существующую.
3Загрузите PDF, DOCX или TXT либо добавьте записи вручную.
4Дождитесь статуса «готово» и при необходимости назначьте основную коллекцию.

Не дублируйте каталог магазина в базе знаний Актуальные товары, цены, остатки и заказы ассистент читает инструментами непосредственно из WordPress. База знаний лучше подходит для постоянных инструкций и внутренних правил.

Шаг 2

Создайте приватный виджет

1
Откройте раздел виджетов
Перейдите в «Пространство» → «Сущности» → «Виджеты» и создайте новый виджет.
2
Выберите режим «Приватный»
Этот режим предназначен для CMS и server-to-server интеграций. Публичный контент для него не требуется.
3
Привяжите ассистента
На вкладке «Контент» выберите созданного ассистента приватного runtime.
4
Проверьте лимиты и сохраните
При необходимости задайте дневной бюджет и ограничения, затем сохраните виджет.

Данные для подключения

После сохранения откройте вкладку «Доступ». Для плагина понадобятся три значения:

Widget IDИдентификатор виджетаМожно передавать администратору сайта

API base URLАдрес платформыУказывается без добавления /api/…

Management secretСекрет управленияХраните только в WordPress и не публикуйте

Management secret — конфиденциальное значение Не вставляйте его в публичный JavaScript, переписку или документацию. Если секрет стал известен посторонним, нажмите «Обновить токены» и замените значение в настройках WordPress.

Шаг 3

Установите плагин в WordPress

GEN Widget WooCommerceГотовый ZIP-архив для установки через панель WordPress

Скачать .zip

1
Скачайте архив
Не распаковывайте ZIP перед загрузкой в WordPress.
2
Откройте «Плагины» → «Добавить новый»
Нажмите «Загрузить плагин», выберите архив и запустите установку.
3
Активируйте плагин
После активации в меню WooCommerce появится пункт «GEN Widget AI», а в админке — кнопка GEN Admin.

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

Шаг 4

Настройте подключение в WordPress

Откройте «WooCommerce» → «GEN Widget AI» и заполните данные из вкладки «Доступ» приватного виджета.

API base URL

Базовый адрес Gen-neuro без пути /api/.... Скопируйте значение целиком из виджета.

Widget ID

Числовой идентификатор приватного виджета.

Management secret

Секрет для защищённых server-to-server запросов. Он не передаётся в браузер посетителей магазина.

Доступ ассистента

Матрица прав определяет, к каким данным и операциям получит доступ GEN Admin. Права задаются отдельно для товаров, заказов, категорий, клиентов и записей блога.

Флаг	Что разрешает	Рекомендация
Доступ	Полностью включает раздел	Отключите ненужные разделы
Чтение	Поиск и просмотр данных	Обычно можно оставить включённым
Создание	Новые товары или записи, если инструмент поддерживается	Оставьте только ответственным сотрудникам
Изменение	Редактирование существующих данных	Все применения требуют подтверждения
Удаление	Удаление сущностей	По умолчанию отключено; включайте только при необходимости
Массовые	Операции над выборкой объектов	Ограничьте для повседневных ролей

Разрешение в плагине не отменяет стандартные права пользователя WordPress. Если у сотрудника нет права изменить или опубликовать запись, ассистент не должен обходить это ограничение.

1Нажмите «Сохранить подключение».
2Нажмите «Проверить подключение».
3Убедитесь, что проверка завершилась успешно.
4Обновите страницу WordPress и откройте GEN Admin.

Работа с виджетом

Интерфейс GEN Admin

Чат

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

Инструменты

Сгруппированные быстрые действия с дополнительными параметрами перед запуском.

Сессии

Отдельные истории работы. Новая сессия помогает начать другую задачу без старого контекста.

Контекст

Текущий экран, выбранный товар или заказ и доступные на этой странице возможности.

Одна задача — одна понятная формулировка Указывайте объект, действие и ограничения: «Для товара “Classic Comfort” подготовь краткое описание в 2–3 предложения, только по главному изображению». Если переходите к несвязанной большой задаче, удобно создать новую сессию.

Как проходит изменение

1ЗапросВы описываете задачу

2ЧерновикАссистент готовит результат

3ПроверкаВы изучаете карточку

4ПрименениеWordPress сохраняет изменения

Блок «Требует внимания» хранит ожидающие подтверждения поверх чата. Ненужный процесс можно закрыть без применения, а завершённый — убрать из списка.

Возможности

С чем умеет работать ассистент

Товары и категории

Одиночная и пакетная работа с каталогом

Поиск товара по названию, SKU или ID и чтение открытой карточки.
Название, полное и краткое описание, в том числе строго по изображению.
SEO title, meta description и ключевая фраза.
Новое главное изображение, правка текущего и добавление в галерею.
Создание нескольких товаров и массовые изменения полей, цен, остатков и категорий.

Заказы

Поиск, аналитические вопросы и изменения

Чтение открытого заказа и поиск по номеру.
Сводка по количеству и сумме за 7, 30 или 90 дней.
Запросы по периоду, статусу, товару, оплате, доставке или стране.
Подготовка массового изменения статусов и других поддерживаемых полей.

Клиенты

Поиск и обслуживание клиентской базы

Поиск по имени, email, телефону или ID.
Работа с именем, телефоном, email и странами оплаты или доставки.
Пакетные изменения по проверяемой выборке.

Блог и записи

Контент для WordPress с привязкой к товарам

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

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

Изображения

Общий стиль и референсы

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

Общий промпт

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

Референс

Прикрепите пример фона, подложки или оформления. Активный референс хранится в WordPress и виден в профиле, пока вы его не замените или не очистите.

1Откройте «Инструменты» → «Профиль генерации изображений».
2Введите общие требования и при необходимости приложите референс.
3Сохраните профиль — активная настройка будет визуально отмечена.
4Для сброса нажмите «Очистить профиль»; старые генерации не изменятся.

«Создать с нуля» генерирует новое изображение по данным товара и инструкции. «Изменить текущее» использует главное изображение как основу. Для галереи можно создать отдельное изображение, не заменяя главное.

Контроль расходов

Баланс, лимиты и статистика

В «WooCommerce» → «GEN Widget AI» отображаются баланс рабочего пространства, расход выбранного ассистента, количество списаний и время последнего использования. Кнопка «Обновить баланс» запрашивает свежие данные.

Баланс пространстваДоступный остатокОбщий для участников пространства

Потрачено ассистентомФактический расходПомогает оценить стоимость работы

СписанийКоличество операцийИ дата последнего использования

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

Диагностика

Если что-то не работает

Проверка подключения завершилась ошибкой

Сверьте API base URL, Widget ID и Management secret со вкладкой «Доступ». Убедитесь, что виджет сохранён в приватном режиме и к нему привязан ассистент. После исправления сначала сохраните настройки WordPress, затем повторите проверку.

Кнопка GEN Admin не появилась

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

Ассистент видит не тот товар или заказ

Откройте вкладку «Контекст» и проверьте текущую сущность. Явно укажите название, SKU, номер или ID в запросе. Если задача относится к другому объекту или другой теме, создайте новую сессию.

Инструмент недоступен или отсутствует в списке

Проверьте матрицу «Доступ ассистента» в настройках плагина. Раздел, нужный тип операции и флаг «Массовые» должны быть разрешены. Также учитываются стандартные права пользователя WordPress и контекст открытого экрана.

Генерация изображения не запускается

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

Баланс не загружается

Сначала выполните «Проверить подключение». Затем нажмите «Обновить баланс». Если ошибка остаётся, проверьте доступ WordPress-сервера к API base URL, SSL-сертификат сайта и отсутствие блокировки исходящих HTTPS-запросов.

Процесс остался в блоке «Требует внимания»

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

Рекомендации

Безопасная работа

Не передавайте management secret пользователям без административной необходимости.
Выдавайте сотрудникам минимально необходимые права WordPress и инструменты ассистента.
Проверяйте черновики и выбранные объекты перед применением.
Делайте резервные копии магазина перед крупными пакетными изменениями.
Используйте актуальную версию плагина.
Разделяйте несвязанные задачи по сессиям, чтобы история оставалась понятной.

Можно начинать

Установите GEN Admin в свой магазин

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

Скачать плагин Создать виджет