# Przewodnik po bazie Gemini: promptowanie

> Fundamentalny przewodnik po promptowaniu dla Google Gemini: analiza frameworka RTF (Role-Task-Format), typologia zapytań, gotowe szablony oraz rozwiązywanie błędów.

Skuteczna interakcja z modelami językowymi rodziny Google Gemini opiera się na zrozumieniu, jak sieć neuronowa interpretuje instrukcje wejściowe. Jeśli zapytanie jest sformułowane nieprecyzyjnie, model musi samodzielnie uzupełniać kontekst, co nieuchronnie prowadzi do powierzchownych lub abstrakcyjnych odpowiedzi.

Niniejszy przewodnik omawia podstawowe zasady inżynierii promptów oraz praktyczny framework **RTF (Role – Task – Format)**, który przekształca chaotyczną konwersację w przewidywalne narzędzie pracy służące do rozwiązywania zadań analitycznych, kreatywnych i technicznych.

---

## 1. Podstawy i zasady skutecznego tworzenia promptów

Jakość wyniku modelu Gemini jest bezpośrednio proporcjonalna do strukturalnej precyzji zapytania.

### 1.1. Trzy filary jakościowego zapytania: jasność, kontekst i ograniczenia

Skuteczny prompt opiera się na trzech powiązanych ze sobą elementach:
- **Jasność (Clarity):** jednoznaczne określenie celu bez dwuznaczności czy skomplikowanych konstrukcji składniowych.
- **Kontekst (Context):** dane wejściowe, opis sytuacji, charakterystyka grupy docelowej lub przykłady wyznaczające granice rozumowania modelu.
- **Ograniczenia (Constraints):** parametry zawężające przestrzeń generowania: limit liczby słów, zakazane frazy, ton wypowiedzi oraz zasady formatowania.

> [!NOTE]
> Im więcej konkretnych wskazówek zawiera zapytanie, tym mniej zasobów obliczeniowych Gemini poświęca na zgadywanie ukrytych oczekiwań, a tym samym końcowy wynik jest bardziej precyzyjny.

### 1.2. Iteracyjny cykl współpracy z modelem

Prompting to nie jednorazowy strzał, lecz sterowany proces dialogowy. Standardowy cykl pracy z Gemini składa się z czterech kolejnych kroków:
1. **Pierwotne zapytanie:** sformułowanie zadania zgodnie z przejrzystą strukturą.
2. **Ocena wyjścia:** szybki audyt kompletności, dokładności i tonu otrzymanej odpowiedzi.
3. **Kalibracyjne doprecyzowanie:** punktowa korekta szczegółów („Zmień ton na mniej formalny”, „Przedstaw wnioski w tabeli porównawczej”).
4. **Utrwalenie artefaktu:** zapisanie finalnego materiału.

---

## 2. Typologia promptów: od prostych zapytań po kontekstowe

Ze względu na poziom sterowalności i głębokość kontroli nad wynikiem, prompty dla Gemini dzielimy na trzy główne typy.

### 2.1. Jasne i bezpośrednie zapytania (Clear Prompts)

Podstawowe instrukcje z konkretnie sformułowanym zadaniem, bez dodatkowych warunków:
```text
Sporządź listę 5 głównych czynników wpływających na szybkość ładowania strony internetowej w przeglądarce.
```
Ten typ idealnie nadaje się do szybkich informacji referencyjnych lub izolowanych sprawdzeń faktów, gdzie nie ma potrzeby stosowania unikalnej stylizacji.

### 2.2. Prompty kontekstowe z danymi wejściowymi (Context Prompts)

Zapytania uzupełnione o bazę faktograficzną, opis sytuacji biznesowej lub informacje analityczne:
```text
Uruchamiamy aplikację mobilną do zarządzania finansami osobistymi, skierowaną do studentów w wieku 18–22 lat. Przygotuj 3 warianty propozycji wartości dla głównego ekranu onboardingowego, uwzględniając ograniczony budżet grupy docelowej.
```
Kontekst kieruje rozumowaniem Gemini w ściśle określone granice, zapobiegając banalnym uogólnieniom.

### 2.3. Prompty z rygorystycznymi ograniczeniami (Constraint Prompts)

Instrukcje ustanawiające surowe zasady dotyczące formy, objętości lub struktury wyjścia:
```text
Wyjaśnij zasadę działania obliczeń kwantowych dla 12-letniego dziecka.
Ograniczenia: dokładnie 3 krótkie akapity, użyj analogii z życia codziennego opartej na monetach, bez żadnych wzorów matematycznych ani specjalistycznej terminologii.
```
Ograniczenia zawężają pole generowania i sprawiają, że finalna odpowiedź jest gotowa do natychmiastowego użytku bez konieczności edycji.

---

## 3. Architektura frameworku RTF (Role – Task – Format)

Najbardziej niezawodnym uniwersalnym standardem budowy promptów dla Gemini jest model **RTF**.

### 3.1. Logiczna struktura triady Role – Task – Format

Framework łączy trzy kluczowe pytania, na które model musi odpowiedzieć przed generacją treści:
- **Role (Kim?):** w jakiej roli występuje model, jakie posiada kwalifikacje i poziom ekspercki.
- **Task (Co?):** jaka konkretna czynność lub ciąg działań ma zostać wykonany.
- **Format (Jak?):** w jakiej postaci, objętości i strukturze należy przedstawić finalną odpowiedź.

| Element RTF | Rola elementu | Przykład sformułowania |
| :--- | :--- | :--- |
| **Role (Rola)** | Określa perspektywę, głębokość analizy i słownictwo | „Działaj jako wiodący rekruter techniczny...” |
| **Task (Zadanie)** | Definiuje konkretną akcję poprzez precyzyjny czasownik | „Przeanalizuj CV kandydata i wskaż słabe strony...” |
| **Format (Format)** | Opisuje wygląd zewnętrzny i składnię wyjścia | „W formie tabeli z trzema kolumnami: Umiejętność, Poziom, Ryzyko” |

### 3.2. Dlaczego RTF eliminuje halucynacje i niejasność

Gdy model otrzymuje pełną triadę komponentów, nie musi wybierać stylu „na ślepo”. Rola odrzuca nieistotne rejestry stylistyczne, zadanie skupia uwagę na celowej akcji, a format gwarantuje zwięzłość i łatwość percepcji.

---

## 4. Szczegółowa analiza komponentów RTF: Rola, Zadanie, Format

Aby framework działał z pełną mocą, każdy z trzech komponentów musi być sformułowany zgodnie z jasnymi regułami.

### 4.1. Role (Rola): kalibracja tonu, ekspertyzy i argumentacji

Unikaj ogólników typu „bądź ekspertem”. Wskazuj precyzyjną specjalizację zawodową:
- *Słaba rola:* „Jesteś copywriterem”.
- *Silna rola:* „Występuj jako B2B copywriter z 10-letnim doświadczeniem w dziedzinie chmurowego cyberbezpieczeństwa. Twój ton jest stonowany, merytoryczny i skierowany do CTO dużych korporacji”.

Rola bezpośrednio wpływa na słownik modelu, dobór analogii oraz głębię zanurzenia w temacie.

### 4.2. Task (Zadanie): werbalne fokusowanie i unikanie dwuznaczności

Zadanie zawsze powinno zaczynać się od wyraźnego czasownika trybu rozkazującego: *przeanalizuj*, *porównaj*, *wyodrębnij*, *przepisz*, *zsyntetyzuj*.
- *Niejasne zadanie:* „Pomóż mi z tekstem o inwestycjach”.
- *Konkretne zadanie:* „Porównaj zalety inwestowania w fundusze indeksowe (ETF) versus nieruchomości dla początkującego z kapitałem $5 000. Sformułuj 3 główne ryzyka każdego wariantu”.

### 4.3. Format (Format): zarządzanie strukturą, objętością i składnią

Format definiuje geometrię tekstu. Precyzuj nie tylko strukturę, ale też techniczne wymagania dotyczące prezentacji:
- Tabela Markdown ze stałymi nagłówkami kolumn.
- Numerowana lista z limitem 2 zdań na punkt.
- Poprawny obiekt JSON ze sztywnym schematem kluczy.
- Post na LinkedIn o długości do 150 słów, zawierający tezy i otwarte pytanie na końcu.

---

## 5. Praktyczne szablony promptów do codziennych zadań

Przeanalizujmy praktyczne przykłady kompleksowego zastosowania frameworku RTF w popularnych scenariuszach.

### 5.1. Case Study 1: Copywriting marketingowy i posty do mediów społecznościowych

```text
[Role]: Działaj jako wiodący strateg SMM dla projektu edtech. Twój ton jest przyjazny, energiczny, bez urzędowego żargonu i klisz.
[Task]: Napisz post promocyjny na kanał Telegram dotyczący uruchomienia bezpłatnego warsztatu z analizy danych dla początkujących.
[Format]: 
- Chwytliwy nagłówek do 8 słów;
- 3 kluczowe punkty dotyczące praktycznych umiejętności (każdy punkt do 15 słów);
- Jasne wezwanie do działania (CTA) z linkiem do rejestracji;
- Całkowita objętość do 120 słów.
```

### 5.2. Case Study 2: Analiza danych biznesowych i przygotowanie wniosków

```text
[Role]: Wystąp w roli analityka finansowego startupów na etapie Seed.
[Task]: Oceń podane kwartalne wskaźniki projektu (CAC, LTV, Churn Rate) i zidentyfikuj punkty optymalizacji kosztów: [wstaw dane liczbowe].
[Format]: 
1. Krótka ocena obecnej sytuacji (maksymalnie 3 zdania);
2. Tabela Markdown: Metryka | Wartość bieżąca | Benchmark branżowy | Zalecane działanie;
3. Trzy główne ryzyki z przypisanym priorytetem (High, Medium, Low).
```

### 5.3. Case Study 3: Przegląd kodu technicznego i optymalizacja skryptów

```text
[Rola]: Działaj jako Senior TypeScript Engineer, skupiając się na wydajności i czystej architekturze.
[Zadanie]: Przeprowadź code review poniższej funkcji przetwarzającej tablice: sprawdź złożoność algorytmiczną, zidentyfikuj potencjalne wycieki pamięci oraz zoptymalizuj wykonanie kodu: [wstaw kod].
[Format]:
- Podsumowanie wykrytych problemów w formie listy punktowanej;
- Zoptymalizowana wersja kodu w bloku kodu TypeScript z komentarzami przy kluczowych zmianach;
- Porównanie złożoności czasowej (Big O) oryginalnego i finalnego algorytmu.
```

---

## 6. Analiza porównawcza: słabe prompty vs. zoptymalizowane pod kątem RTF

Aby dostrzec różnicę jakościową, porównajmy typowe intuicyjne zapytania z inżyniersko zweryfikowanymi promptami:

| Scenariusz zadania | Słaby, intuicyjny prompt | Prompt zoptymalizowany pod kątem RTF |
| :--- | :--- | :--- |
| **Analiza marketingowa** | „Opowiedz o konkurencji Notion” | **R:** Strateg produktowy SaaS. <br>**T:** Porównaj Notion, Obsidian i Craft pod kątem pracy offline i współpracy zespołowej. <br>**F:** Tabela z kolumnami: Produkt, Offline, Zespół, Cena, Werdykt. |
| **Nauka złożonych tematów** | „Wyjaśnij, jak działa Docker” | **R:** Wykładowca DevOps dla junior developerów. <br>**T:** Wyjaśnij koncepcję konteneryzacji na analogii z transportem morskim. <br>**F:** 3 kolejne akapity do 50 słów każdy + checklista z 3 głównymi terminami. |
| **Redakcja tekstu** | „Popraw ten tekst: [tekst]” | **R:** Redaktor naczelny wydawnictwa biznesowego. <br>**T:** Skróć tekst o 40%, usuń urzędowy żargon i lanie wody, wzmacniając czasowniki: [tekst]. <br>**F:** Zweryfikowana wersja + lista 3 kluczowych poprawek. |

---

## 7. Architektura iteracyjnego promptingu w Gemini

Poniżej przedstawiono algorytm projektowania i kalibracji zapytań w systemie Gemini:

### 7.1. Diagram budowy i kalibracji promptu w Gemini

```mermaid
flowchart TD
    Start["Формулювання мети"] --> DefineRole["1. Role: визначення експертизи та тону"]
    DefineRole --> DefineTask["2. Task: чітке наказове дієслово та умови"]
    DefineTask --> DefineFormat["3. Format: структура виводу (таблиця, JSON, буліти)"]
    DefineFormat --> Execute["Відправка промпту в Gemini"]
    Execute --> Audit{"Результат відповідає очікуванням?"}
    
    Audit -- "Ні (є неточності)" --> Refine["Уточнення: додати обмеження або змінити тон"]
    Refine --> Execute
    
    Audit -- "Так" --> Final["Готовий практичний артефакт"]
```

---

## 8. Najczęściej zadawane pytania i rekomendacje (FAQ)

### 8.1. Odpowiedzi na typowe pytania dotyczące współpracy z Gemini

> [!NOTE]
> **Czy kolejność Role → Task → Format jest obowiązkowa?**  
> Sekwencja nie jest sztywno narzucona na poziomie sieci neuronowej, jednak logika „Kto wykonuje → Co robi → Jak formuluje” jest najbardziej naturalna dla percepcji modelu i zapobiega utracie kontekstu w dużych zapytaniach.

> [!TIP]
> **Jak zmusić Gemini do pisania krótko i bez lania wody?**  
> Wskaż rygorystyczne ograniczenie liczby słów lub zdań bezpośrednio w komponencie **Format**, np.: *„Dokładnie 3 zdania, łącznie nie więcej niż 60 słów. Zakaz używania fraz wprowadzających typu 'Oczywiście, oto odpowiedź...'”*.

> [!IMPORTANT]
> **Który model Gemini lepiej sprawdzi się przy złożonych promptach?**  
> Do szybkich, rutynowych zadań (copywriting, streszczanie tekstu) doskonale nadaje się **Gemini 2.0 Flash**. Do głębokiej analizy kodu, wieloczynnikowych kalkulacji finansowych lub rozbudowanych łańcuchów logicznych wybieraj **Gemini 1.5 Pro** lub **Gemini 2.0 Pro Experimental**.

> [!WARNING]
> **Dlaczego Gemini czasem ignoruje zadany limit słów?**  
> Model liczy tekst w tokenach, a nie w słowach, więc limit „dokładnie 100 słów” może oscylować w granicach ±10–15%. Jeśli potrzebujesz absolutnej precyzji, definiuj format przez liczbę punktów listy lub zdań.