Техническое Задание (ТЗ) на разработку скрипта для автоматической генерации описаний товаров с использованием Gemini API
1. Название проекта: Разработка системы автоматической генерации SEO-оптимизированных описаний товаров для интернет-магазина "https://www.pulsar.ua/" с использованием Google Gemini API.
2. Заказчик:Интернет-магазин "Pulsar" (специализация: аниме-товары, манга, фигурки, артбуки).
3. Цель проекта:Автоматизировать процесс создания уникальных, высококачественных, SEO-оптимизированных и E-E-A-T-соответствующих описаний товаров на русском и украинском языках. Описания должны генерироваться с помощью Google Gemini API и строго соответствовать предоставленному Заказчиком подробному Руководству по стилю и Промт-структуре (далее – «Руководство»). Система должна быть пригодна для обработки как существующих, так и новых партий товаров.
4. Объем работ:* 4.1. Анализ и адаптация Руководства:* Детальное изучение предоставленного Заказчиком Руководства по стилю и Промт-структуре для генерации описаний. * Разработка на основе Руководства эффективного "мастер-промпт-шаблона" для Google Gemini API. Шаблон должен включать плейсхолдеры для динамической подстановки данных конкретного товара. *
4.2. Разработка скрипта (предпочтительный язык – Python):* Скрипт должен считывать исходные данные о товарах из предоставленного файла (например, CSV, Excel, Google Sheets). * Для каждого товара скрипт должен: * Формировать индивидуальный промпт путем заполнения "мастер-промпт-шаблона" данными текущего товара. * Отправлять сформированный промпт в Google Gemini API (использование API-ключа Заказчика или Исполнителя с последующей компенсацией расходов – по согласованию). * Обрабатывать ответ от API, извлекая сгенерированные описания на русском и украинском языках в указанном HTML-формате, а также HTML-комментарии с рекомендациями (мета-теги, Schema.org и т.д., согласно Руководству). * Обеспечить корректную обработку ошибок API, управление лимитами запросов (rate limits) и, при необходимости, реализацию механизма повторных запросов. * Скрипт должен сохранять сгенерированные HTML-описания и рекомендации в структурированном виде (например, добавлять в новые столбцы исходного файла или создавать новый выходной файл) для удобства проверки и последующего импорта на сайт. *
4.3. Тестирование и отладка:* Проведение тестирования скрипта и "мастер-промпт-шаблона" на пилотной партии товаров (10-20 единиц), предоставленной Заказчиком. * Итерационная доработка "мастер-промпт-шаблона" и скрипта на основе результатов тестирования и обратной связи от Заказчика для достижения максимального соответствия Руководству и требуемого качества описаний.
* 4.4. Документирование и передача:* Подготовка краткой документации по скрипту: описание его работы, инструкции по установке зависимостей, запуску и настройке (например, указание пути к файлу с данными, ввод API-ключа). * Передача Заказчику исходного кода скрипта и финальной версии "мастер-промпт-шаблона".
* 4.5. (Опционально) Обучение:* Проведение краткой демонстрации работы скрипта для Заказчика.
5. Входные материалы (предоставляются Заказчиком):* Подробное Руководство по стилю и Промт-структуре для генерации описаний товаров (документ, предоставленный ранее). * Файл с данными о товарах для пилотного запуска (и в дальнейшем для полной обработки) в формате CSV или Excel. Обязательные поля для каждого товара будут включать (но не ограничиваться): Название товара, Категория, Текущее описание (если есть), Ключевые характеристики (материал, размеры, комплектация и т.д.), Бренд, Серия, Дата релиза, Целевая аудитория, Уникальные торговые предложения (УТП), Контекстная информация (мир аниме, художник и т.п.), список релевантных ключевых слов (если есть). * API-ключ для Google Gemini (или договоренность об использовании ключа Исполнителя и порядке расчетов). * Примеры уже существующих описаний, которые Заказчик считает удачными или неудачными (помимо Руководства). * Доступ к контактному лицу со стороны Заказчика для оперативного решения вопросов.
6. Ожидаемые результаты ( deliverables):* Полностью функционирующий скрипт (исходный код на Python или ином согласованном языке), реализующий описанный в п.4 функционал. * Финальная версия "мастер-промпт-шаблона" для Gemini API. * Сгенерированные описания (в требуемом HTML-формате с комментариями) для пилотной партии товаров, сохраненные в согласованном структурированном формате (например, CSV/Excel). * Краткая инструкция по использованию скрипта (README файл).
7. Технические требования и квалификация Исполнителя:* Обязательно:* Подтвержденный опыт работы с API больших языковых моделей (Google Gemini, GPT или аналогичных). * Глубокое понимание принципов промпт-инжиниринга. * Уверенное владение Python (предпочтительно) или другим языком программирования, подходящим для данной задачи (например, Node.js). * Опыт работы с обработкой данных в форматах CSV, Excel, JSON. * Навыки программной генерации и парсинга HTML. * Внимание к деталям, способность точно следовать сложным инструкциям и техническим требованиям. * Умение писать чистый, хорошо документированный и поддерживаемый код. * Желательно:* Опыт автоматизации задач в сфере e-commerce или контент-менеджмента. * Понимание основ SEO в контексте контента.
8. Процесс взаимодействия и этапы работ (предлагаемые):* Этап 1: Подготовительный * Исполнитель изучает ТЗ, Руководство и предоставленные материалы. * Установочный звонок/встреча для обсуждения деталей, стратегии формирования "мастер-промпта", согласования формата данных. * Этап 2: Разработка и внутреннее тестирование (Y дней)* Разработка Исполнителем "мастер-промпт-шаблона" и первой версии скрипта. * Этап 3: Пилотный запуск и итерации (Z дней, включая время на проверку Заказчиком)* Запуск скрипта на пилотной партии товаров. * Заказчик предоставляет обратную связь по качеству сгенерированных описаний. * Исполнитель вносит корректировки в "мастер-промпт-шаблон" и/или скрипт. Возможно несколько циклов правок. * Этап 4: Финализация и сдача проекта (W дней)* Завершение всех доработок, подготовка финальной документации. * Передача всех результатов Заказчику. * Этап 5: (Опционально) Гарантийная поддержка (например, 1-2 недели)* Исправление возможных ошибок, выявленных после сдачи проекта, консультации по работе скрипта.
9. Критерии приемки работ:* Скрипт корректно обрабатывает предоставленные данные о товарах и генерирует описания через Gemini API без сбоев на пилотной партии. * Сгенерированные для пилотной партии описания строго соответствуют всем требованиям Руководства Заказчика (формат HTML, структура, объем, тон, использование ключевых слов, E-E-A-T элементы, требования к естественности текста, наличие двух языковых версий, корректность комментариев с рекомендациями). * Качество описаний для пилотной партии оценено Заказчиком как высокое и соответствующее ожиданиям. * Скрипт документирован и может быть использован Заказчиком для обработки новых партий товаров (самостоятельно или с минимальной поддержкой). * Продемонстрирована корректная обработка стандартных ошибок API.
10. Сроки выполнения проекта:Определяются по согласованию с Исполнителем после оценки объема работ. Просьба предоставить вашу оценку сроков по этапам.
11. Бюджет и порядок оплаты:Просьба предоставить вашу коммерческое предложение (стоимость работ). Возможна поэтапная оплата (например, 30% предоплата, 40% после успешного пилотного запуска, 30% после полной сдачи проекта) или иная схема по договоренности. Уточнить, включены ли расходы на использование Gemini API в стоимость работ, или они оплачиваются Заказчиком отдельно.
12. Конфиденциальность:Исполнитель обязуется не разглашать коммерческую информацию и данные Заказчика, полученные в ходе выполнения проекта. Возможно подписание отдельного NDA.