Wersjonowanie promptów: śledź, porównuj i cofaj zmiany
Dobrego promptu rzadko pisze się za pierwszym razem. Poprawiasz sformułowanie, dodajesz ograniczenie, podmieniasz przykład, a po trzech zmianach wynik jest gorszy niż na starcie i nie masz jak wrócić. Wersjonowanie promptów zapisuje migawkę przy każdej istotnej zmianie, więc możesz porównać to, co miałeś, z tym, co masz teraz, przywrócić wersję, która naprawdę działała, i zobaczyć, która edycja coś zmieniła, zamiast zgadywać.
Zmieniłeś prompt, który działał, jakość spadła i musisz cofnąć się do dokładnego brzmienia sprzed tygodnia.
Dwie osoby edytują ten sam współdzielony prompt i potrzebujesz historii, która pokazuje, kto co zmienił, kiedy i dlaczego.
Testujesz dwa sformułowania promptu systemowego i chcesz zachować obie wersje obok siebie, zamiast nadpisać jedną drugą.
Aktualizacja modelu (na przykład z Claude 3.5 na nowszą wersję) zmieniła zachowanie promptu i chcesz rozgałęzić wersję pod konkretny model, nie tracąc oryginału.
Iterujesz szybko i chcesz oznaczyć sprawdzony punkt kontrolny, zanim znów zaczniesz eksperymentować.
Błędy do uniknięcia
Nadpisywanie działającej wersji w miejscu. W chwili, gdy wkleisz nowe brzmienie na stare, sformułowanie, które faktycznie działało, przepada. Zapisuj migawkę przed każdą istotną edycją, a nie dopiero wtedy, gdy jej żałujesz.
Wersjonowanie samego tekstu promptu bez kontekstu wokół niego. Model, temperatura i wypełnione {zmienne} to wszystko część wyniku, więc zapisuj je razem z każdą wersją, bo inaczej migawki nie da się odtworzyć.
Pisanie ogólnikowych notatek w stylu „ulepszony prompt”. Sześć wersji później nie odróżnisz, która zmiana naprawiła wynik w formacie JSON. Notuj, co zmieniłeś i po co, a nie tylko to, że coś się zmieniło.
Traktowanie każdego naciśnięcia klawisza jako nowej wersji. Historia zamienia się w szum. Twórz wersję w realnych punktach kontrolnych (sformułowanie, które przetestowałeś, poprawka, którą wdrożyłeś), a nie przy każdym przesuniętym przecinku.
Prompty do skopiowania
01
Napisz wpis do changeloga wersji
Jesteś prompt engineerem utrzymującym wersjonowaną bibliotekę promptów. Porównaj poprzednią i nową wersję mojego promptu poniżej i napisz jeden wpis do changeloga dla nowej wersji. POPRZEDNIA: {stary_prompt}. NOWA: {nowy_prompt}. Sformatuj wpis jako: etykietę wersji według wersjonowania semantycznego, wiedząc że ostatnią wersją była {ostatnia_wersja}, jednozdaniowe podsumowanie, punktowaną listę tego, co się zmieniło, oraz uwagę, czy zmiana jest łamiąca dla kogokolwiek, kto ponownie używa tego promptu. Zmieść się w 120 słowach i trzymaj się faktów. Nie chwal zmiany.
02
Wyjaśnij, czym różni się zachowanie dwóch wersji
Jesteś recenzentem QA promptów. Oto dwie wersje tego samego promptu. WERSJA A: {wersja_a}. WERSJA B: {wersja_b}. Załóż, że obie działają na tych danych wejściowych: {dane_testowe}. Bez uruchamiania czegokolwiek przewidź, jak różniłby się wynik modelu między A i B, skupiając się na formacie, tonie, poziomie szczegółowości oraz każdym ograniczeniu, które jedna wersja wymusza, a druga pomija. Przedstaw różnice w tabeli z kolumnami Aspekt, Wersja A, Wersja B. Zakończ jednym zdaniem wskazującym, którą wersję bezpieczniej wdrożyć do {przypadek_uzycia} i dlaczego.
03
Zaproponuj podniesienie numeru wersji
Utrzymujesz wersjonowane prompty według wersjonowania semantycznego (GŁÓWNY.POŚREDNI.POPRAWKA). Obecna wersja to {obecna_wersja}. Oto zmiana, którą wprowadziłem: {opis_zmiany}. Zdecyduj, czy to podniesienie numeru GŁÓWNEGO, POŚREDNIEGO czy POPRAWKI, kierując się zasadami: GŁÓWNY oznacza, że kształt lub zachowanie wyniku zmienia się w sposób łamiący dla dotychczasowych użytkowników, POŚREDNI oznacza dodanie nowej funkcji przy zachowaniu zgodności wstecznej, POPRAWKA oznacza zmianę brzmienia lub czytelności bez zmiany zachowania. Odpowiedz wyłącznie nowym numerem wersji, typem podniesienia i jednozdaniowym uzasadnieniem.
04
Sprawdź zmianę promptu przed jej zapisaniem
Jesteś uważnym recenzentem zatwierdzającym zmiany we współdzielonym prompcie. Sprawdź poniższą edycję, zanim zapiszę ją jako nową wersję. OBECNA WERSJA: {obecny_prompt}. PROPONOWANA EDYCJA: {nowy_prompt}. CEL edycji: {cel}. Wychwyć instrukcje, które teraz sobie przeczą, ograniczenia przypadkowo usunięte, {placeholdery}, które już się nie rozwiązują, oraz rozrost zakresu poza podany cel. Zwróć werdykt ZATWIERDŹ albo POPROŚ O ZMIANY, a potem krótką punktowaną listę problemów uszeregowaną według wagi. Jeśli POPROSISZ O ZMIANY, zaproponuj najmniejszą poprawkę rozwiązującą każdy problem.
05
Zbuduj testy regresji dla wersji promptu
Ustawiasz testy regresji, aby przyszłe wersje promptu nie zepsuły się po cichu. Oto prompt: {prompt}. Jego zadaniem jest: {zamierzone_zachowanie}. Przygotuj 6 przypadków testowych, które każda przyszła wersja musi nadal przechodzić. Dla każdego podaj krótką nazwę, dane wejściowe do podania oraz warunek zaliczenia opisujący, co wynik musi zawierać albo czego nigdy nie może zawierać. Uwzględnij przypadek normalny, przypadek brzegowy z brakującymi {zmiennymi} oraz jeden przypadek zaprojektowany tak, by prompt złamał swój format wyniku. Zwróć przypadki jako listę numerowaną.
Jak zapisać je w PromptAtlas
Utwórz folder dla zadania lub kanału.
Dodaj jasne tagi do późniejszego wyszukiwania.
Zamień zmienne szczegóły w pola.
Zapisuj lepsze wersje zamiast nadpisywać przydatne próby.
Eksportuj bibliotekę jako kopię zapasową.
Najczęstsze pytania
Czym jest wersjonowanie promptów?
Wersjonowanie promptów to prowadzenie zapisanej historii promptu w miarę, jak się zmienia, tak by każda istotna edycja stawała się migawką, którą można podejrzeć, porównać i przywrócić. To przeniesienie idei kontroli wersji z kodu na treść twoich promptów.
Czym wersjonowanie promptów różni się od zwykłego zapisywania kopii?
Zapisywanie kopii daje ci luźne pliki, wersjonowanie daje oś czasu. Narzędzie do wersjonowania łączy migawki z jednym promptem, pokazuje różnice między nimi, zapisuje powód każdej zmiany i pozwala cofnąć edycję jednym kliknięciem, zamiast grzebać w „prompt-final-v3-naprawde-final.txt”.
Czy używać wersjonowania semantycznego (v1.2.0) dla promptów?
Możesz i pomaga to, gdy inni polegają na twoim prompcie. Prosta zasada: podnoś numer główny przy zmianie łamiącej zachowanie, numer pośredni przy dodaniu funkcji, a numer poprawki przy drobnych zmianach brzmienia. Przy prywatnych promptach zwykle wystarczą znaczniki czasu i krótkie etykiety.
Co zapisywać oprócz samego tekstu promptu?
Zapisz model i ustawienia, pod które prompt powstał, krótką notatkę o tym, co i po co się zmieniło, a najlepiej też przykładowe dane wejściowe wraz z uzyskanym wynikiem. To właśnie ten kontekst pozwala zrozumieć, dlaczego stara wersja zachowywała się tak, a nie inaczej, gdy wrócisz do niej po miesiącach.
{A}
Zbuduj swoją bibliotekę promptów
Zapisuj prompty, które działają, dodawaj zmienne, zachowuj wersje i znajduj je w kilka sekund.