Instrukcja krok po kroku konfiguracji wtyczki "AI: generowanie treści dla produktów".
Instrukcja uzyskania klucza API
ChatGPT
Rejestracja na oficjalnej stronie OpenAI (ChatGPT) i uzyskanie klucza API:
- Wejdź na stronę https://platform.openai.com/signup/.
- Jeśli nie masz jeszcze konta, zarejestruj się, podając e-mail i hasło (zalecane jest użycie opcji "Continue with Google"). Na tym etapie powinieneś poradzić sobie z dalszą rejestracją samodzielnie.
- Po zalogowaniu trafisz na stronę główną OpenAI API.
- Najedź kursorem na swoje imię lub avatar w prawym górnym rogu i wybierz “Manage account” (Zarządzanie kontem).
- W menu wybierz zakładkę “API keys”.
- Na stronie zarządzania kluczami kliknij przycisk “Create new secret key”.
- System wygeneruje nowy klucz API. Skopiuj go, ponieważ po zamknięciu okna nie będzie już widoczny.
- Teraz możesz używać tego klucza do integracji z API ChatGPT.
Jak sprawdzić dostępne modele na Twoim koncie OpenAI:
- Wejdź na stronę platform.openai.com i zaloguj się.
- Przejdź do sekcji "API" w menu.
- Otwórz zakładkę "Models" (Modele), gdzie znajduje się lista dostępnych modeli.
- Sprawdź, które modele są dostępne na Twoim koncie, np. GPT-5.5, GPT-4 itd.
- Jeśli brakuje potrzebnego modelu, przejdź do sekcji "Usage", aby sprawdzić limity i plan taryfowy.
- Jeśli nadal nie możesz znaleźć modelu, skontaktuj się z pomocą OpenAI przez sekcję "Help".
Jak samodzielnie doładować konto OpenAI:
- Przed doładowaniem upewnij się, że wtyczka działa z wcześniej wygenerowanym kluczem API (sprawdź połączenie w ustawieniach wtyczki).
- Wejdź na platform.openai.com i zaloguj się.
- Otwórz sekcję “Billing” (Rozliczenia).
- Kliknij “Add funds” (Dodaj środki).
- Wybierz kwotę oraz metodę płatności.
- Wprowadź dane i potwierdź płatność (upewnij się, że karta obsługuje płatności międzynarodowe).
- Po płatności sprawdź saldo w sekcji “Usage”.
- Środki będą wykorzystywane zgodnie z liczbą zapytań do API.
DeepSeek
Rejestracja na oficjalnej stronie DeepSeek i uzyskanie klucza API:
- Wejdź na stronę https://platform.deepseek.com/sign_in.
- Jeśli nie masz konta, zarejestruj się lub użyj opcji "Log in with Google" (wcześniej utwórz konto Gmail jeśli go nie masz).
- Po zalogowaniu przejdź do sekcji "API Keys" (https://platform.deepseek.com/api_keys) i kliknij "Create new API key".
- Podaj nazwę klucza i kliknij "Create API key", a następnie skopiuj wygenerowany klucz. Gotowe.
Qwen
Rejestracja na stronie Alibaba Group (Qwen) i uzyskanie klucza API:
- Wejdź na stronę https://bailian.console.alibabacloud.com/.
- Jeśli nie masz konta, zarejestruj się lub użyj Google (jeśli nie masz Gmaila, utwórz go wcześniej).
- Zaloguj się na konto.
- W prawym górnym rogu kliknij profil i wybierz API-KEY.
- Następnie przejdź do All API Keys lub My API Key i utwórz klucz API.
Jeśli potrzebujesz więcej informacji, sprawdź dokumentację: https://www.alibabacloud.com/help/en/model-studio/developer-reference/get-api-key.
Gemini
Rejestracja w Gemini i uzyskanie klucza API:
- Otwórz Google AI Studio API Keys i zaloguj się.
- W menu wybierz API Keys i kliknij Create API key.
- Wybierz lub utwórz projekt, a następnie skopiuj wygenerowany klucz API.
Ten klucz należy wkleić w ustawieniach wtyczki w polu "Gemini API key".
Jak używać klucza
Wklej klucz w ustawieniach wtyczki i zapisz. Wtyczka pobierze dostępne modele Gemini.
Ważne!
- Wymagany jest aktywny klucz API Gemini.
- Dostępność modeli zależy od konta i limitów API.
- Plan darmowy ma ograniczenia i może nie wystarczyć do większych projektów.
Instrukcja konfiguracji wtyczki (Ustawienia API)
- Zainstaluj wtyczkę.
- Przejdź do ustawień wtyczki (Sklep → Wtyczki → "AI: generowanie treści dla produktów").
- W zakładce Ustawienia API wybierz usługę, model AI i wprowadź klucz API.
- Sprawdź połączenie Kontynuuj tylko jeśli test zwróci komunikat "Połączenie udane". W przypadku błędu usuń problem lub doładuj konto.
- Wtyczka jest gotowa do pracy.
Instrukcja pracy z wtyczką (Wysyłanie zapytań do AI)
- Przejdź do zakładki Wysyłanie zapytań do AI.
- W ustawieniu Typ generowanej treści wybierz, co chcesz generować.
- W ustawieniu Szablon promptu wprowadź prompt, używając składni Smarty. Przykład:
-
Jesteś profesjonalnym copywriterem. Napisz w języku polskim unikalny opis produktu „{$product.name}” o długości 1000-1200 znaków. Użyj formatowania HTML (wyłącznie następujące tagi: <p>, <ul>, <ol>, <li>). Tekst musi być unikalny - żadna fraza poza nazwą produktu nie może być skopiowana z żadnego źródła. Pisz prostym językiem. Język angielski może być używany wyłącznie w nazwach modeli i marek. Nie witaj się z klientami. Skoncentruj się na produkcie, jego cechach i wyróżniających go właściwościach. Dostępne cechy produktu: {$product.common_features_string}. Nie wymieniaj ich jedynie w formie listy, lecz naturalnie wpleć je w treść.{if $product.description} Jako przykład opisu produktu możesz wykorzystać nasz dotychczasowy opis produktu. Wyłącznie jako przykład. Nie kopiuj z niego fragmentów tekstu. Najważniejsze jest stworzenie w 100% unikalnego tekstu. Oto poprzedni opis: {$product.description}{/if}
-
W szablonie zaleca się używanie tablicy {$product}. Przykłady:
- {$product.name} – nazwa produktu
- {$product.common_features_string} – lista cech produktu
- {$product.sku_features_string} – cechy wariantów produktu
- {$product|wa_dump} – pełny podgląd danych produktu
-
Możesz użyć gotowych szablonów promptów przygotowanych przez nas.
Zalecamy przetestowanie promptu na 10–20 produktach, aby dopracować jego skuteczność.
- W ustawieniu ID cech wykluczonych z $product w promptach wpisz ID cech oddzielone przecinkami.
- W ustawieniu Zestawy produktów do generowania wybierz wcześniej utworzoną listę produktów. Wtyczka nie obsługuje dynamicznych list. Do zarządzania listami użyj standardowych funkcji Shopy-Script lub UI 2.0.
- Kliknij przycisk . Przy dużych listach (>1000 produktów) proces może potrwać kilka sekund. Jeśli pojawi się błąd „Error in action prompts”, sprawdź składnię promptu.
- Jeśli wszystko jest poprawne, zobaczysz listę produktów z wygenerowanymi promptami. Możesz rozpocząć generowanie.
- Nie zamykaj przeglądarki podczas generowania. Proces można wznowić w dowolnym momencie.
- Jeśli wyniki są niezadowalające, przerwij generowanie i popraw prompt.
Instrukcja pracy z wtyczką (Przetwarzanie odpowiedzi AI)
- Przejdź do zakładki Przetwarzanie odpowiedzi AI.
- Wybierz typ wygenerowanej treści.
- Kliknij .
- Sprawdź wygenerowane treści i w razie potrzeby je edytuj. Pamiętaj o użyciu HTML przy opisach produktów. Jeśli dużo treści wymaga poprawek, lepiej poprawić prompt i wygenerować je ponownie.
- Wybierz produkty do publikacji. Możesz użyć zaznaczenia zbiorczego (Shift lub checkbox).
- Wybierz miejsce zapisu i kliknij . Zalecamy zapisywanie treści AI w dodatkowych polach. W ID pól używaj tylko liter, cyfr i podkreślenia.
- Sprawdź zapis w karcie produktu (Sklep → Towary → Edycja → SEO i opis).
- Gotowe.