Технічне Завдання (ТЗ) на розробку скрипта для автоматичної генерації описів товарів з використанням 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.
