Specyfikacja Techniczna (ST) dotycząca opracowania skryptu do automatycznego generowania opisów produktów z wykorzystaniem Gemini API
1. Nazwa projektu: Opracowanie systemu automatycznego generowania zoptymalizowanych pod kątem SEO opisów produktów dla sklepu internetowego "https://www.pulsar.ua/" z użyciem Google Gemini API.
2. Zamawiający:Sklep internetowy "Pulsar" (specjalizacja: produkty anime, manga, figurki, artbooki).
3. Cel projektu:Automatyzacja procesu tworzenia unikalnych, wysokiej jakości, zoptymalizowanych pod kątem SEO i zgodnych z E-E-A-T opisów produktów w języku rosyjskim i ukraińskim. Opisy mają być generowane za pomocą Google Gemini API i ściśle zgodne z dostarczonym przez Zamawiającego szczegółowym Przewodnikiem po stylu i strukturze promptów (dalej – „Przewodnik”). System musi obsługiwać zarówno istniejące, jak i nowe partie produktów.
4. Zakres prac:* 4.1. Analiza i dostosowanie Przewodnika:* Szczegółowe zapoznanie się z Przewodnikiem dostarczonym przez Zamawiającego w celu wygenerowania opisów. * Opracowanie na podstawie Przewodnika skutecznego "szablonu głównego promptu" dla Google Gemini API. Szablon musi zawierać miejsca na dynamiczne podstawianie danych konkretnego produktu. *
4.2. Opracowanie skryptu (preferowany język – Python):* Skrypt powinien odczytywać dane o produktach z dostarczonego pliku (np. CSV, Excel, Google Sheets). * Dla każdego produktu skrypt musi: * Tworzyć indywidualny prompt poprzez wypełnienie "szablonu głównego promptu" danymi aktualnego produktu. * Wysyłać utworzony prompt do Google Gemini API (z użyciem klucza API Zamawiającego lub Wykonawcy z późniejszym rozliczeniem kosztów – po uzgodnieniu). * Przetwarzać odpowiedź API, wyodrębniając wygenerowane opisy w języku rosyjskim i ukraińskim w podanym formacie HTML, a także komentarze HTML z zaleceniami (meta-tagi, Schema.org itp., zgodnie z Przewodnikiem). * Zapewnić poprawną obsługę błędów API, zarządzanie limitami zapytań (rate limits) i, w razie potrzeby, implementację mechanizmu ponownego wysyłania zapytań. * Skrypt musi zapisywać wygenerowane opisy HTML i zalecenia w uporządkowanej formie (np. dodając je do nowych kolumn oryginalnego pliku lub tworząc nowy plik wyjściowy) dla łatwej weryfikacji i późniejszego importu na stronę. *
4.3. Testowanie i debugowanie:* Przeprowadzenie testów skryptu i "szablonu głównego promptu" na partii pilotażowej produktów (10-20 jednostek), dostarczonej przez Zamawiającego. * Iteracyjne poprawki "szablonu głównego promptu" i skryptu na podstawie wyników testów i opinii Zamawiającego, aby osiągnąć maksymalną zgodność z Przewodnikiem i wymaganej jakości opisów.
* 4.4. Dokumentacja i przekazanie:* Przygotowanie krótkiej dokumentacji dotyczącej skryptu: opis jego działania, instrukcje instalacji zależności, uruchomienia i konfiguracji (np. wskazanie ścieżki do pliku z danymi, wprowadzenie klucza API). * Przekazanie Zamawiającemu kodu źródłowego skryptu i końcowej wersji "szablonu głównego promptu".
* 4.5. (Opcjonalnie) Szkolenie:* Przeprowadzenie krótkiej prezentacji działania skryptu dla Zamawiającego.
5. Materiały wejściowe (dostarczane przez Zamawiającego):* Szczegółowy Przewodnik po stylu i strukturze promptów do generowania opisów produktów (dokument wcześniej dostarczony). * Plik z danymi o produktach do uruchomienia pilotażowego (i późniejszego pełnego przetwarzania) w formacie CSV lub Excel. Obowiązkowe pola dla każdego produktu obejmują (ale nie ograniczają się do): Nazwa produktu, Kategoria, Obecny opis (jeśli istnieje), Kluczowe cechy (materiał, rozmiary, zestaw, itp.), Marka, Seria, Data premiery, Docelowa grupa odbiorców, Unikalne propozycje handlowe (USP), Informacje kontekstowe (świat anime, artysta itp.), lista odpowiednich słów kluczowych (jeśli istnieją). * Klucz API do Google Gemini (lub ustalenia dotyczące użycia klucza Wykonawcy i rozliczeń). * Przykłady istniejących opisów, które Zamawiający uważa za udane lub nieudane (oprócz Przewodnika). * Dostęp do kontaktu ze strony Zamawiającego w celu szybkiego rozwiązania kwestii.
6. Oczekiwane rezultaty (deliverables):* W pełni funkcjonalny skrypt (kod źródłowy w Python lub innym uzgodnionym języku), realizujący opisane w pkt 4 funkcje. * Końcowa wersja "szablonu głównego promptu" dla Gemini API. * Wygenerowane opisy (w wymaganym formacie HTML z komentarzami) dla partii pilotażowej produktów, zapisane w uzgodnionym uporządkowanym formacie (np. CSV/Excel). * Krótka instrukcja obsługi skryptu (plik README).
7. Wymagania techniczne i kwalifikacje Wykonawcy:* Obowiązkowe:* Potwierdzone doświadczenie w pracy z API dużych modeli językowych (Google Gemini, GPT lub podobne). * Dogłębna znajomość zasad inżynierii promptów. * Biegła znajomość Pythona (preferowana) lub innego języka programowania odpowiedniego do tego zadania (np. Node.js). * Doświadczenie w obsłudze danych w formatach CSV, Excel, JSON. * Umiejętności generowania i parsowania HTML programowo. * Dbałość o szczegóły, zdolność do dokładnego przestrzegania skomplikowanych instrukcji i wymagań technicznych. * Umiejętność pisania czystego, dobrze udokumentowanego i łatwego w utrzymaniu kodu. * Wskazane:* Doświadczenie w automatyzacji zadań w e-commerce lub zarządzaniu treścią. * Podstawowa znajomość SEO w kontekście treści.
8. Proces współpracy i etapy prac (proponowane):* Etap 1: Przygotowawczy* Wykonawca zapoznaje się z ST, Przewodnikiem i materiałami dostarczonymi. * Rozmowa/spotkanie organizacyjne w celu omówienia szczegółów, strategii tworzenia "szablonu głównego promptu", uzgodnienia formatu danych. * Etap 2: Opracowanie i testy wewnętrzne (Y dni)* Opracowanie przez Wykonawcę "szablonu głównego promptu" i pierwszej wersji skryptu. * Etap 3: Pilotaż i iteracje (Z dni, w tym czas na weryfikację przez Zamawiającego)* Uruchomienie skryptu na partii pilotażowej produktów. * Zamawiający przekazuje opinię na temat jakości wygenerowanych opisów. * Wykonawca wprowadza poprawki do "szablonu głównego promptu" i/lub skryptu. Możliwa kilka cykli korekt. * Etap 4: Finalizacja i przekazanie projektu (W dni)* Zakończenie wszystkich poprawek, przygotowanie końcowej dokumentacji. * Przekazanie wszystkich wyników Zamawiającemu. * Etap 5: (Opcjonalnie) wsparcie gwarancyjne (np. 1-2 tygodnie)* Naprawa ewentualnych błędów wykrytych po oddaniu projektu, konsultacje dotyczące działania skryptu.
9. Kryteria akceptacji prac:* Skrypt poprawnie przetwarza dostarczone dane o produktach i generuje opisy przez Gemini API bez awarii na partii pilotażowej. * Wygenerowane opisy dla partii pilotażowej ściśle spełniają wszystkie wymagania Przewodnika Zamawiającego (format HTML, struktura, objętość, ton, użycie słów kluczowych, elementy E-E-A-T, wymogi dotyczące naturalności tekstu, dwie wersje językowe, poprawność komentarzy z zaleceniami). * Jakość opisów dla partii pilotażowej oceniona przez Zamawiającego jako wysoka i zgodna z oczekiwaniami. * Skrypt jest udokumentowany i może być używany przez Zamawiającego do przetwarzania nowych partii produktów (samodzielnie lub z minimalnym wsparciem). * Prawidłowa obsługa standardowych błędów API została wykazana.
10. Terminy realizacji projektu:Ustalane po uzgodnieniu z Wykonawcą po ocenie zakresu prac. Prosimy o przedstawienie własnej oceny terminów dla etapów.
11. Budżet i sposób płatności:Prosimy o przedstawienie oferty handlowej (koszt prac). Możliwa etapowa płatność (np. 30% zaliczki, 40% po udanym pilotażu, 30% po pełnym oddaniu projektu) lub inny układ po uzgodnieniu. Ustalić, czy koszty korzystania z Gemini API są wliczone w cenę prac, czy są rozliczane osobno przez Zamawiającego.
12. Poufność:Wykonawca zobowiązuje się do nieujawniania informacji handlowych i danych Zamawiającego uzyskanych w trakcie realizacji projektu. Może być podpisana odrębna umowa NDA.
