Глобал АйТи. AI SEO-описания категорий

Глобал АйТи. AI SEO-описания категорий — решение для 1С-Битрикс, которое помогает создавать SEO-описания разделов каталога с учетом ассортимента, региона, старого текста и дополнительных требований к стилю.

Модуль решает несколько задач:

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

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

Как работает решение

Клиент покупает или активирует решение в маркетплейсе.
Сервис получает событие активации купона от 1С-Битрикс.
После проверки события создается подключение клиента.
На email покупателя отправляются Client ID и API-ключ.
Эти данные указываются в настройках модуля на сайте.
Модуль отправляет запросы на генерацию описаний.
Сервис подбирает поисковые данные, вызывает Yandex ML и возвращает результат.

Генерация выполняется асинхронно. Это значит, что модуль сначала создает запрос, а затем проверяет его статус до получения готового результата.

Что получает клиент после покупки

После успешной активации покупки на email клиента отправляется письмо с данными подключения:

Client ID;
API-ключ.

Эти данные нужны модулю для обращения к сервису генерации.

Если письмо не пришло, проверьте:

правильность email при покупке;
папку спам;
статус покупки или активации купона.

Если письмо не найдено, напишите на info@gl-it.ru и укажите номер заказа. Поддержка поможет проверить активацию и получить данные подключения.

Настройка модуля

Откройте административную часть сайта 1С-Битрикс.

Перейдите в настройки модуля:

Настройки → Настройки модулей → Глобал АйТи. AI SEO-описания категорий

Рисунок 1 - Переход в настройки модуля

Укажите обязательные данные подключения:

Адрес API — адрес AI-сервиса, например https://aiwordstat.gl-it.ru;
Client ID — идентификатор клиента из письма с данными подключения;
API-ключ — ключ доступа из письма с данными подключения.

Рисунок 2 - Форма настроек подключения

Сохраните настройки.

Если одно из полей не заполнено, модуль покажет предупреждение и подскажет, какие параметры нужно указать.

Если письмо с Client ID и API-ключом не пришло, напишите на info@gl-it.ru и укажите номер заказа — вам помогут получить данные подключения.

Проверка подключения

После ввода данных подключения модуль проверяет связь с AI-сервисом через запрос баланса.

Возможные состояния:

Подключение настроено — поля заполнены корректно, AI-сервис отвечает, баланс доступен;
Настройки подключения заполнены не полностью — не заполнен Адрес API, Client ID или API-ключ;
Не удалось подтвердить подключение — поля заполнены, но AI-сервис не подтвердил доступ.

Если ключ указан неверно, сервис вернет понятную ошибку авторизации. В этом случае проверьте, что Client ID и API-ключ скопированы полностью, без лишних пробелов и переносов строк.

Рисунок 3 - Проверка подключения

Генерация SEO-описания

Откройте раздел модуля Сервисы → Глобал АйТи. AI SEO-описания категорий → SEO настройки. Выберите инфоблок, перейдите к нужному разделу каталога и откройте редактирование раздела через строку списка или контекстное меню.

Для генерации описания укажите данные категории.

Обычно используются:

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

Дополнительные требования можно использовать как пользовательское задание к генерации. Это поле необязательное: если оставить его пустым, модуль не будет отправлять дополнительный prompt в AI-сервис. Например:

Сделай текст экспертным, спокойным и без агрессивных продаж. Не используй слово "лучший".

Ограничение для дополнительных требований — до 1000 символов. Пробельное значение не считается заданием: перед отправкой модуль убирает пустые строки.

Рисунок 4 - Форма генерации SEO-описания

Что учитывается при генерации

Сервис формирует задание на основе нескольких источников:

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

В результате сервис возвращает HTML-фрагмент описания. Его можно использовать на странице раздела каталога.

Рисунок 5 - Успешная генерация

Рисунок 6 - Готовое описание раздела

Статусы обработки

В интерфейсе модуля используются пользовательские статусы обработки:

Запрос отправлен — модуль создал задачу на генерацию;
AI генерирует описание — сервис обрабатывает запрос;
Описание готово — результат получен и доступен в истории;
Ошибка генерации — запрос завершился неуспешно, детали показываются в сообщении и истории.

Если запрос еще не завершен, модуль повторно проверяет статус через несколько секунд. На странице раздела отображается текущая стадия обработки.

Рисунок 7 - Статус обработки запроса

Баланс токенов

Для каждого клиента ведется баланс токенов.

Баланс изменяется в следующих случаях:

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

В интерфейсе модуля могут отображаться:

текущий баланс;
доступный баланс;
зарезервированные токены;
задолженность, если она возникла;
история операций.

Рисунок 8 - Баланс токенов

История операций

История операций помогает понять, как менялся баланс.

В ней могут быть операции:

пополнение по покупке или купону;
резервирование перед генерацией;
освобождение резерва;
списание фактической стоимости генерации.

Это удобно для контроля расходов и разбора спорных ситуаций.

Рисунок 9 - История операций по токенам

Ограничения

Модуль не заменяет SEO-стратегию и редакторскую проверку.
Результат генерации нужно просматривать перед публикацией.
Качество результата зависит от входных данных.
Дополнительные требования ограничены 1000 символами.
При недоступности внешних сервисов генерация может временно завершиться ошибкой.

Частые вопросы

Можно ли использовать модуль без старого описания?

Да. Старое описание необязательно. Если его не передать, текст будет создан на основе категории, товаров, региона и поисковых данных.

Зачем нужны дополнительные требования?

Они позволяют уточнить стиль и ограничения текста: тональность, запрет отдельных слов, нужные акценты, длину и структуру.

Что делать, если генерация завершилась ошибкой?

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

Проверьте сообщение на странице генерации и повторите запрос позже, если ошибка временная. Если проблема сохраняется, обратитесь в поддержку и передайте идентификатор запроса или номер заказа.

Списываются ли токены при ошибке?

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

Можно ли получить новый API-ключ?

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

Результат внедрения

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