Prompt debugging - gdy Claude nie rozumie
- Potrafisz zdiagnozować, dlaczego prompt nie działa
- Znasz 10 najczęstszych błędów w promptach
- Wiesz, jak minimalizować halucynacje
- Stosujesz techniki iteracyjnej naprawy promptów
Kiedy zaczynałem pracę z Claude, mój prompt do analizy sentymentu w opiniach klientów brzmiał: "Przeanalizuj te opinie." Wynik? Ogólnikowe podsumowanie bez żadnych liczb. Po 30+ iteracjach doszedłem do prompta, który dawał tabelę z sentymentem, najważniejszymi frazami i priorytetami. Różnica? Kontekst, format i ograniczenia. Poniżej techniki, które pomogły mi (i Tobie pomogą) naprawiać nieskuteczne prompty.
4 typowe problemy i jak je naprawić
Problem 1: Zbyt ogólny prompt
| Źle | Dobrze |
|---|---|
| "Napisz coś o marketingu." | "Napisz 5 taktyk email marketingu dla sklepów e-commerce z odzieżą. Każda taktyka: nazwa, opis (2 zdania), przykład maila. Format: tabela." |
Diagnoza: Claude daje generyczną odpowiedź → Twój prompt jest za ogólny. Naprawa: Dodaj kontekst, specyfikacje i format.
Problem 2: Sprzeczne instrukcje
| Źle | Dobrze |
|---|---|
| "Napisz szczegółowy raport. Max 200 słów." | "Napisz executive summary (max 200 słów) z 3 kluczowymi wnioskami i 1 rekomendacją." |
Diagnoza: Claude próbuje spełnić sprzeczne wymagania i nie spełnia żadnego dobrze. Naprawa: Usuń sprzeczności. Jeśli chcesz krótko i szczegółowo - wybierz jedno.
Problem 3: Brak kontekstu
| Źle | Dobrze |
|---|---|
| "Jaka strategia byłaby najlepsza?" | "Jestem marketing managerem w firmie SaaS B2B (50 osób, $2M ARR, rynek polski). Jaka strategia pozyskiwania klientów byłaby najlepsza na Q2 2026, biorąc pod uwagę budżet $10K/mies.?" |
Diagnoza: Claude nie zna Twojej sytuacji → odpowiada ogólnikowo. Naprawa: Dodaj kontekst: kim jesteś, jaka firma, jaki budżet, jaki cel.
Problem 4: Zbyt wiele instrukcji naraz
| Źle | Dobrze |
|---|---|
| "Napisz artykuł, zoptymalizuj SEO, stwórz meta, zaproponuj grafiki, napisz posty social media i newsletter." | Prompt 1: "Napisz artykuł (800 słów)." → Prompt 2: "Zoptymalizuj SEO tego artykułu." → Prompt 3: "Napisz meta description i 3 posty social media." |
Diagnoza: Claude gubi się w natłoku zadań. Naprawa: Podziel na osobne prompty (prompt chaining).
Halucynacje - co to jest i jak je minimalizować
Halucynacja to sytuacja, gdy Claude wymyśla informacje, które wyglądają wiarygodnie, ale są nieprawdziwe. Może wymyślić: statystyki, cytaty, nazwy firm, daty, linki.
7 technik redukcji halucynacji (z oficjalnej dokumentacji Anthropic)
- "Jeśli nie wiesz - powiedz" - wprost napisz w prompcie, że Claude ma przyznać się do niewiedzy
- Dostarcz źródła - wgraj dokumenty i każ Claude cytować z nich
- Każ cytować fragmenty - "Każdy wniosek poprzyj cytatem z dokumentu"
- Poproś o pewność - "Przy każdej informacji oceń swoją pewność: wysoka/średnia/niska"
- Zweryfikuj - "Po odpowiedzi sprawdź, czy wszystkie informacje są poparte dowodami"
- Ogranicz zakres - "Odpowiadaj TYLKO na podstawie dostarczonych dokumentów"
- Użyj CoT - "Pokaż tok rozumowania krok po kroku" (łatwiej wyłapać błąd logiczny)
Częsty błąd: Pytanie Claude o konkretne statystyki, badania lub cytaty bez dostarczenia źródeł. Claude może je wymyślić. Zawsze weryfikuj konkretne dane.
Techniki naprawy promptów
1. Iteracyjny prompting
Zamiast pisać idealny prompt od zera - iteruj:
Wersja 1: Napisz artykuł o AI w HR.
→ [za ogólny, nudny]
Wersja 2: Napisz artykuł (600 słów) o 3 konkretnych
zastosowaniach AI w rekrutacji. Ton: profesjonalny,
z danymi.
→ [lepiej, ale brakuje przykładów]
Wersja 3: [Wersja 2] + Każde zastosowanie zilustruj
przykładem polskiej firmy. Dodaj sekcję "Wyzwania
i ryzyka".
→ [dobrze!]
2. Self-critique
Poproś Claude o ocenę własnej odpowiedzi:
[Po otrzymaniu odpowiedzi]
"Oceń swoją odpowiedź pod kątem: kompletności,
dokładności, przydatności. Co byś zmienił?"
3. Generate → Critique → Refine
Trzyetapowy proces z Lekcji 3.5:
- Claude generuje draft
- Claude ocenia draft
- Claude poprawia na podstawie oceny
Ćwiczenie praktyczne: Weź 3 "złe" prompty i napraw je:
Prompt 1 (za ogólny): "Pomóż mi z marketingiem." → Napraw, dodając kontekst, cel i format.
Prompt 2 (halucynacje): "Podaj 5 najnowszych badań o AI w edukacji z 2026 roku." → Napraw, żeby Claude nie wymyślał badań.
Prompt 3 (za dużo naraz): "Napisz strategię marketingową, plan contentu na rok, budżet i harmonogram wdrożenia." → Napraw, dzieląc na prompt chain.
Co dalej
W ostatniej lekcji tego modułu dostaniesz gotową bibliotekę promptów - szablony do natychmiastowego użycia w codziennej pracy.