Документация к плагину "ChatGPT: генерация описаний товаров"
Инструкция по получению API-ключа
При создании нового аккаунта на платформе OpenAI (ChatGPT) вам предоставляется стартовый бесплатный баланс в размере 5$, который можно использовать для тестирования API в течение 3-х месяцев (информация актуальна на 25.01.2025). Рекомендую попробовать использовать именно ChatGPT.
ChatGPT
Регистрация на официальном сайте OpenAI (ChatGPT) и получение API-ключа:
- Создайте новую электронную почту на Gmail, если у вас её ещё нет. Это важно, так как почта на "Яндексе", "Mail.ru" и других сервисах российских компаний может не подойти для регистрации на платформе OpenAI.
- Если ваш IP-адрес — российский, то сайт компании OpenAI будет блокировать вас. Использование VPN в браузере решает эту проблему.
- Зайдите на сайт https://platform.openai.com/signup/.
- Если у вас ещё нет аккаунта, зарегистрируйтесь, указав свою почту и придумав пароль (рекомендую использовать опцию "Продолжить с Google"). На этом этапе, надеюсь, вы разберетесь сами как создать аккаунт.
- После успешного входа в аккаунт, вы попадёте на главную страницу OpenAI API.
- Наведите курсор на своё имя или аватар в правом верхнем углу экрана и нажмите на пункт “Manage account” (Управление аккаунтом).
- В открывшемся меню выберите вкладку “API keys”.
- На странице управления API-ключами найдите кнопку “Create new secret key” и нажмите на неё.
- Система сгенерирует новый API-ключ. Скопируйте этот ключ, так как после закрытия окна вы больше не сможете его увидеть.
- Теперь вы можете использовать этот ключ для интеграции с ChatGPT API.
Как узнать, какие модели доступны на вашем аккаунте OpenAI:
- Перейдите на сайт platform.openai.com и войдите в свой аккаунт.
- Перейдите в раздел "API" в меню управления.
- Откройте вкладку "Models" (Модели), где будет указан список всех доступных моделей для вашего аккаунта.
- Проверьте, какие модели отображаются в списке. Это будут доступные для вашего аккаунта версии, такие как GPT-3.5, GPT-4 и другие.
- Если нужная модель не отображается, перейдите в раздел "Usage" (Использование) для проверки лимитов и тарифного плана, так как доступ к некоторым моделям может зависеть от выбранного тарифа.
- Если вы не можете найти нужную модель, обратитесь в поддержку OpenAI через раздел "Help" для получения точной информации о доступности моделей для вашего аккаунта.
Как пополнять баланс на аккаунте OpenAI самостоятельно:
- Перед тем как пополнить баланс в личном кабинете OpenAI, убедитесь, что по полученному ранее API-ключу плагин работает. Проверьте соединение, используя функционал плагина (см. вкладку Инструкция по настройке плагина (Настройки API) данной документации).
Компания OpenAI может блокировать российские IP-адреса. Если в процессе проверки соединения вы обнаружили, что это ваш случай, то:
- использование VPN в браузере может решить проблему;
- если вы не хотите или не можете использовать VPN в браузере, то рассмотрите возможность использования других нейронных сетей (например, Qwen или DeepSeek);
- или воспользуйтесь платформой CognitiveAI — она позволяет работать с ChatGPT с оплатой в рублях.
Инструкции по подключению к Qwen, DeepSeek и CognitiveAI доступны в отдельных вкладках.
- Если в настройках плагина соединение успешно проверено, вернитесь в личный кабинет OpenAI на сайте platform.openai.com, авторизуйтесь.
- Откройте вкладку “Billing” (Платежи) в меню аккаунта.
- Нажмите на кнопку “Add funds” (Добавить средства).
- Выберите подходящую сумму для пополнения и удобный способ оплаты (например, банковская карта; учтите, что карты российских банков не подойдут).
- Заполните данные для оплаты и подтвердите платёж, перед этим убедившись, что ваша карта поддерживает международные платежи.
- После успешной оплаты проверьте баланс аккаунта. Пополненная сумма должна быть отображена в разделе “Usage” (Использование).
- Теперь вы можете использовать средства для работы с API OpenAI. Учтите, что средства списываются на основе фактического объёма запросов к API.
Как пополнять баланс на аккаунте OpenAI, если нет карты иностранного банка? Варианты:
- Друзья/знакомые с банковской картой иностранного банка — самый рекомендуемый способ.
- Оплата через посредников — некоторые сервисы предлагают услуги пополнения баланса OpenAI за комиссию (поищите их самостоятельно).
- Оплата через посредников — некоторые сервисы предлагают услуги пополнения баланса OpenAI за комиссию (поищите их самостоятельно).
- Можно не пополнять баланс, а просто переподключиться к VPN, создать новый аккаунт с новой электронной почтой и заново получить 5$ на баланс (информация актуальна на 25.01.2025).
DeepSeek
Регистрация на официальном сайте Alibaba Group («DeepSeek») и получение API-ключа:
- Зайдите на сайт https://platform.deepseek.com/sign_in.
- Если у вас ещё нет аккаунта, зарегистрируйтесь, указав свою почту и придумав пароль или воспользуйтесь функцией"Log in with Google" (Перед этим создайте новую электронную почту на Gmail, если у вас её ещё нет).
- После успешной авторизации перейдите во вкладку "API Keys" (https://platform.deepseek.com/api_keys) и нажмите на кнопку "Create new API key".
- Придумайте любое название API-ключа и нажмите кнопку кнопку "Create API key", после чего скопируйте сгенерированный API-ключ. Готово! ВАЖНО! На момент написания данной инструкции, API-ключ начинает работать только после пополнения баланса. На момент написания данной инструкции (8.02.2025), пополнение баланса для новых пользователей временно отключено. Ждите, пока эту возможность включат. Данная инструкция будет обновлена.
Qwen
Регистрация на официальном сайте Alibaba Group (Qwen) и получение API-ключа:
- Создайте новую электронную почту на Gmail, если у вас её ещё нет
- Зайдите на сайт https://www.alibabacloud.com.
- Если у вас ещё нет аккаунта, зарегистрируйтесь, указав свою почту и придумав пароль. Для этого нажмите кнопку "Log In" в правом верхнем углу страницы.
- Под формой авторизации нажмите на кнопку "Sign Up Now"
- Выберите "Individual Account" и нажмите на кнопку "Sign up with Google". Создайте аккаунт (здесь, надеюсь, разберетесь сами).
- После успешной регистрации войдите в свой аккаунт, используя созданные учетные данные.
- ....... дальнейшая инструкция в разработке
CognitiveAI
Что такое CognitiveAI?
CognitiveAI — это не самостоятельная нейронная сеть, как ChatGPT, YandexGPT или GigaChat, а платформа, которая позволяет интегрироваться с различными нейронными сетями. Рекомендуется использовать данную платформу, если вы хотите работать с ChatGPT, но у вас нет возможности использовать VPN или пополнять баланс напрямую в ChatGPT.
Как создать аккаунт и начать пользоваться:
- Перейдите на сайт https://lk.cognitiveai.ru/ и зарегистрируйтесь, указав свою электронную почту.
- После регистрации в разделе «API» сгенерируйте новый токен и сохраните его в безопасном месте.
- На вашем аккаунте должно быть автоматически начислено 10 руб. (актуально на 25.01.2025). Используйте эти средства, чтобы протестировать соединение в настройках плагина (см. вкладку Инструкция по настройке плагина (Настройки API) данной документации).
- Ознакомьтесь с доступными тарифами CognitiveAI. Если вам требуется небольшой объём текстов, пополните баланс и начните пользоваться платформой. Для больших объёмов работы выгоднее оформить подписку в разделе «Платная подписка» за 600 руб./мес. В рамках подписки вы сможете подключить свой API-ключ от ChatGPT (см. вкладку Инструкция по получению API-ключа → ChatGPT данной документации) и использовать его на платформе CognitiveAI, что значительно снизит стоимость токенов.
GigaChat
Интеграция с GigaChat на данный момент находится в разработке (будет добавлено в обновлении плагина — в обычной версии, не премиум-версии).
Инструкция по настройке плагина (Настройки API)
- Установите плагин.
- Перейдите в настройки плагина (Магазин --> Плагины --> Плагин "ИИ (ChatGPT, DeepSeek, Qwen): генерация описаний товаров").
- Во вкладке Настройки API выберите сервис, с которым планируете работать, модель ИИ, укажите API-ключ и проверьте соедение.
Мы рекомендуем использовать ChatGPT, а если он блокируется из-за российского AP — то CognitiveAI. Текстовый контент, генерируемый ChatGPT, на наш взгляд, больше подходит для генерации описаний товаров, чем контент, генерируемый российскими аналогами YandexGPT и GigaChat.
Продолжайте дальнейшую работу с плагином, только если при проверке соедения получили сообщение вида: "Успешное соедение". Если вы получили сообщение об ошибке — устраняйте ее.
- Сохраните настройки плагина.
- Плагин готов к работе!
Инструкция по работе с плагином (Настройки промптов)
- Перейдите во вкладку Настройки промптов.
- В настройке Шаблон укажите промпт, используя синтаксис Smarty. Пример:
В шаблоне используйте массив {$product}. Примеры использования:
- {$product.name} — название товара
- {$product.common_features_string} — список характеристик товара и их значений
- {$product.sku_features_string} — список характеристик артикулов товара и их значений
- {$product|wa_dump} — дамп массива $product (чтобы посмотреть полный список доступных переменных в массиве)
- Вы можете использовать готовые шаблоны промптов, разработанные и применяемые нами на рабочих проектах.
После копирования рекомендуем протестировать работу промпта на 10–20 товарах. Это поможет выявить возможности для его улучшения и адаптировать под особенности вашей тематики и ассортимента товаров.
Инструкция по работе с плагином (Отправка запросов к ИИ)
- Перейдите во вкладку Отправка запросов к ИИ.
- В настройке ID списка товаров для генерации описаний укажите ID списка товаров, предварительно создав его и добавив в него нужные товары. Плагин Плагин "ИИ (ChatGPT, DeepSeek, Qwen): генерация описаний товаров" не предоставляет функционал для поиска товаров и добавления их в список. Используйте для этого штатный функционал Shop Script, либо плагины других разработчиков (например, используйте функционал нового интерфейса Shop Script — UI 2.0, либо плагин Фильтр и поиск товаров в бекенде и в дополнение к нему — Исключение группы товаров из списков).
- Обязательно сохраните настройки плагина после выбора ID списка товаров.
- Нажмите кнопку Если у вас в списке >1000 товаров и/или в магазине >1000 характеристик — ожидайте несколько секунд. При возникновении ошибки «Ошибка в экшене promts» — проверьте ваш шаблон промптов, скорее всего вы там допустили синтаксическую ошибку. Если не можете ее найти самостоятельно - скиньте ваш код нейросети, и попросите устранить синаксическую ошибку в коде Smarty, с этой задачей нейросеть справляется легко. .
- Если все сделано правильно, откроется окно с товарными позициями и сгенерированными по шаблону промптами. Проверьте их корректность, и когда будете готовы — запускайте генерацию.
- Не закрывайте окно браузера, пока процесс генерации не завершится. Если что-то пойдет не так и генерация прервется — не переживайте, ее можно будет возобновить в любой момент.
- Если в процессе генерации вы увидите что получаемые результаты не соответствуют вашим ожиданиям — прервите генерацию, чтобы зря не расходовать бюджет.
Инструкция по работе с плагином (Обработка ответов от ИИ)
- Перейдите во вкладку Обработка ответов от ИИ.
- Нажмите кнопку .
- Откроется окно с товарными позициями и сгенерированным ИИ-контентом. Обязательно проверьте корректность каждого сгенерированного текста. По необходимости отредактируйте тексты, используя html-разметку. Если результатов, требующих корректировки, слишком много — это повод задуматься о том, что промпт составлен неудачно. В таком случае рекомендуется удалить все тексты, скорректировать промпт и начать процесс заново — это будет быстрее и дешевле, чем редактировать большое количество текстов.
- Когда проверите все тексты, выберите нужные товары. Для выбора всех товаров можно использовать соответствующую кнопку, а также есть возможность выбора нескольких товаров с зажатой клавишей Shift.
- Укажите дополнительный параметр для сохранения результата генерации и нажмите кнопку Мы рекомендуем публиковать все данные, полученные от нейросети, в дополнительные параметры товара. Это позволит избежать путаницы между описаниями, написанными человеком, и сгенерированными ИИ. Помните, что в ID дополнительных параметров можно использовать только латинские символы, цифры и символ нижнего подчеркивания. .
- Проверьте, корректно ли сохранились данные, перейдя в настройки одного из товаров (Магазин → Товары → *ваш товар* → кнопка «Редактировать» → вкладка «Описание и SEO» → поле «Дополнительные параметры» внизу страницы).
- Готово! Вы опубликовали сгенерированные описания товаров в выбранный доп. параметр.
Инструкция по работе с доп. параметрами товаров
Дополнительные параметры товаров (сокращенно: доп. параметры товаров) в Webasyst Shop — это произвольные поля, которые позволяют хранить любую информацию, связанную с товаром. Подробнее можно ознакомиться в этой статье на сайте Webasyst. В рамках работы с данным плагином, эти параметры используются для хранения сгенерированных описаний товаров, вместо стандартного поля «Описание».
.... инструкция в разработке ....
Техническая поддержка
- Техническая поддержка осуществляется только через личный кабинет. Инструкция по созданию заявки здесь. Пожалуйста, не пишите на электронную почту и в мессенджеры.
- Техническая поддержка обычно осуществляется в рабочее время: Пн-Сб 08:00-17:00 (мск).
- Среднее время реакции на обращения: 2-3 часа
- Максимальное время реакции на обращения: 2-3 рабочих дня