Przejdź do głównej zawartości

Edytowanie promptów

Strona szczegółów promptu to miejsce, gdzie edytujesz każdy szablon. Jest podzielona na dwie główne karty — System Prompt i User Prompt — z których każda ma własny edytor, przełącznik podgląd/edycja oraz przycisk AI Assistant.

  1. Przejdź do AI Assistant → Prompt templates.
  2. Użyj sidebaru z filtrami, aby wybrać typ (np. generate_seo.product) i zdecydować, czy chcesz default czy fork.
  3. Kliknij wiersz, aby otworzyć stronę szczegółów.

Domyślnie obie karty pokazują prompt w trybie podglądu — wyrenderowany tekst z podświetlonymi placeholderami. Kliknij Edit, aby przełączyć się na textarea.

Podczas edycji:

  • Przeciągnij prawy dolny róg, aby zmienić rozmiar textarea, jeśli potrzebujesz więcej miejsca.
  • Pasek u góry śledzi niezapisane zmiany. Zapisz, kiedy będziesz zadowolony.
  • Kliknij AI Assistant na dowolnej karcie, aby doprecyzować prompt przez rozmowę z modelem. Zobacz AI assistant.
  • Discard cofa bieżący draft. Wszystko, co wpisałeś w textarea, jest tracone.
  • Save utrwala zmiany w bazie danych. Aktywne workery pobierają nowy szablon przy następnym uruchomieniu — zobacz “Cache” niżej.
  • Wskaźnik blokady na pasku pokazuje, gdy ktoś inny edytuje ten sam szablon. Dwóch adminów nie może zapisać tego samego szablonu jednocześnie.

Rozwiązane szablony są cache’owane per proces workera ze względu na wydajność. Po zapisaniu szablonu musisz albo:

  • Poczekać aż cache wygaśnie naturalnie (następny request po TTL cache), albo
  • Zrestartować workery (bin/console messenger:stop-workers i pozwolić supervisorowi je ponownie uruchomić), albo
  • Wywołać dowolny niecachowany request (świeży test on product czyści cache dla tego szablonu).

Dla jednorazowych zmian czekanie jest krótkie. Dla skoordynowanych rolloutów (np. przepisanie głosu marki we wszystkich kategoriach) zrestartuj workery, aby uniknąć mieszanych wyników.

Jeśli wyedytowałeś szablon i chcesz go cofnąć, strona szczegółów ma akcję Reset to default. Przywraca ona pola systemPrompt i userPrompt z domyślnych wartości dostarczonych przez plugin (PromptDefaults.php) i czyści flagę isModified.

name i description na każdym szablonie są tłumaczalne. Same system i user prompty są przechowywane raz na szablon — nie są tłumaczone. Użyj funkcji tłumaczenia UI, aby przeczytać prompt w swoim języku admina bez zmiany jego zawartości.

Obok kart System i User prompt, strona szczegółów promptu ma zakładkę Template parameters. To są płaskie pokrętła runtime (długość per-field, tryb źródła, własne instrukcje, presety), które modal runtime i panel testu odczytują przy otwarciu. Forki dziedziczą każdy parametr ze swojego szablonu rodzica — nadpisanie pojedynczego parametru jest często tańsze niż forkowanie całego promptu. Zobacz Template parameters, aby zobaczyć pełną referencję.