Strukturované rámce pro promptování

Dlouhý strukturovaný rámec

Dlouhý strukturovaný rámec rozšiřuje krátký rámec o tři sekce: Role, Kontext a Poznámky. Je určený pro komplexní úlohy, kde model potřebuje vědět nejen co má udělat, ale i kým má být, proč to dělá a na co nesmí zapomenout. Typické použití: tvorba článků, systémové prompty chatbotů, analytické úlohy, generování obsahu s přesnými požadavky na tón a formát.

1. Role (Persona)

Co to je: Definice experta, kterého má model simulovat. Role kalibruje úroveň odbornosti, slovník a perspektivu výstupu. Model, který „je“ SEO specialistou, píše jinak než model bez přidělené role — používá oborovou terminologii, zná kontext a automaticky zohledňuje relevantní faktory.

## Role
Jsi zkušený SEO copywriter s 10letou praxí v českém e-commerce.
Specializuješ se na produktové popisky a kategorie pro e-shopy
na platformách Shoptet a WooCommerce.

Tip: Čím konkrétnější role, tím lepší výstup. Porovnejte „Jsi copywriter“ vs. „Jsi SEO copywriter specializující se na české e-shopy“ — druhá varianta modelu říká, jaký slovník použít, na co se zaměřit a jaké konvence dodržovat.

2. Cíl (Objective)

Co to je: Stručný popis úkolu v jedné až dvou větách. I u složitých úloh by měl být cíl jasný a přímý — detaily patří do instrukcí, ne do cíle. Cíl odpovídá na otázku „co má na konci existovat?“.

## Cíl
Napiš produktový popisek pro kategorii „Červená vína" v e-shopu
s vínem. Popisek bude sloužit jako hlavní text kategorie viditelný
pro zákazníky i vyhledávače.

Tip: Uveďte v cíli i účel výstupu (pro koho a kde bude použit). Model, který ví, že text bude na webu pro zákazníky i Google, automaticky vyvažuje čitelnost a SEO.

3. Kontext (Context)

Co to je: Pozadí úlohy — proč je důležitá, jaká je aktuální situace a jak výstup zapadá do širšího celku. Kontext je sekce, která dělá největší rozdíl mezi krátkým a dlouhým rámcem. Bez kontextu model generuje generický výstup; s kontextem generuje výstup přizpůsobený konkrétní situaci.

## Kontext
E-shop winehouse.cz prodává moravská a česká vína. Aktuálně má
120 produktů, ale žádné popisky kategorií — stránky kategorií
jsou prázdné, což negativně ovlivňuje SEO. Hlavní konkurenti
(vinoeshop.cz, vinarstviklima.cz) mají popisky v rozsahu 150–250 slov.
Cílová skupina jsou muži i ženy 30–55 let, kteří vína nakupují
online a oceňují odborný, ale přístupný styl.

Tip: Zahrňte do kontextu konkurenční benchmark (co dělají ostatní), cílovou skupinu a aktuální stav. Tyto tři informace mají největší dopad na relevanci výstupu. Nezahlcujte kontext historií firmy nebo informacemi, které s úkolem přímo nesouvisí.

4. Instrukce (Instructions/Rules)

Co to je: Specifická pravidla pro výstup — formát, tón, délka, omezení a fallback scénáře. V dlouhém rámci jsou instrukce podrobnější než v krátkém, protože složitější úlohy mají více požadavků, které se mohou dostat do konfliktu. Jasné instrukce eliminují nejednoznačnost.

## Instrukce
- Rozsah: **150–200 slov**
- Zahrň **primární klíčové slovo** „červená vína" v prvním odstavci
- Sekundární klíčová slova: „moravská červená vína", „Frankovka", „Svatovavřinecké"
- Tón: odborný, ale přístupný — žádný sommelierský žargon
- **Nepoužívej** superlativy („nejlepší", „jedinečný") ani prázdné fráze
- Struktura: úvodní odstavec → popis odrůd → doporučení k jídlu → CTA
- Poslední věta musí být výzva k akci směřující k prohlížení produktů
- Pokud si nejsi jistý konkrétním faktem, vynech ho místo vymýšlení

Tip: Instrukce zapisujte jako odrážkový seznam — model je zpracovává spolehlivěji než souvislý text. Kritické požadavky zvýrazněte tučně. Nezapomeňte na negativní instrukce (co model nesmí) — jsou často důležitější než pozitivní, protože předcházejí nejčastějším chybám.

5. Proměnné (Variables)

Co to je: Vstupní data, která model zpracovává. V dlouhém rámci bývají proměnné rozsáhlejší — mohou zahrnovat tabulky, seznamy produktů, texty konkurence nebo jiná strukturovaná data. Klíčové je jasně oddělit proměnné od instrukcí, ideálně blokem kódu nebo Markdown nadpisem.

## Proměnné

### Produkty v kategorii
| Odrůda | Ročník | Cena | Hodnocení |
| --- | --- | --- | --- |
| Frankovka | 2021 | 189 Kč | 88/100 |
| Svatovavřinecké | 2022 | 225 Kč | 91/100 |
| Zweigeltrebe | 2021 | 169 Kč | 85/100 |

### Referenční text konkurence
> „V nabídce najdete červená vína z nejlepších moravských vinařství.
> Naše kolekce zahrnuje odrůdy Frankovka, Svatovavřinecké a Zweigeltrebe."

Tip: Pokud máte více typů vstupních dat, oddělte je podnadpisy (###). Model díky tomu přesně ví, co jsou produktová data a co je referenční text konkurence. Referenční texty vkládejte jako citaci (>), aby model chápal, že se jimi má inspirovat, ne je kopírovat.

6. Příklady (Examples)

Co to je: Ukázky požadovaného výstupu, které modelu nastaví formát, tón i úroveň detailu. V dlouhém rámci jsou příklady důležitější než v krátkém, protože úloha je komplexnější a slovní instrukce nemusí stačit k přesnému pochopení záměru. Ideálně uveďte příklad skutečného výstupu, ne jen jeho formát.

## Příklad požadovaného výstupu
(pro jinou kategorii — Bílá vína)

Bílá vína z Moravy patří k tomu nejlepšímu, co česká vinařská tradice
nabízí. V naší kolekci najdete odrůdy Ryzlink rýnský, Pálava
i Veltlínské zelené — každou s vlastním charakterem a příběhem.

Moravská bílá vína se vyznačují svěží kyselinkou a ovocnými tóny,
které nejlépe vyniknou při teplotě 8–10 °C. Hodí se jako aperitiv
i jako doprovod k rybám, lehkým salátům nebo měkkým sýrům.

**Prozkoumejte naši nabídku bílých vín a najděte svého favorita.**

Tip: Příklad by měl být pro jinou kategorii nebo jinou variantu úlohy, než kterou model zpracovává — jinak hrozí, že model příklad jen mírně upraví místo vytvoření originálního výstupu. Pokud nemáte hotový příklad, vytvořte alespoň „kostru“ ukazující strukturu a tón.

7. Poznámky (Notes)

Co to je: Zopakování klíčových pravidel na konci promptu. Modely věnují zvýšenou pozornost začátku a konci kontextového okna (tzv. primacy a recency efekt) — poznámky na závěr fungují jako pojistka, že model nepřehlédne kritická pravidla, i když zpracovává dlouhý prompt s desítkami instrukcí.

## Poznámky
- Klíčové slovo „červená vína" **musí** být v prvním odstavci.
- Rozsah 150–200 slov — ne méně, ne více.
- Žádné superlativy a prázdné fráze.
- Poslední věta = výzva k akci.

Tip: Do poznámek kopírujte jen ta pravidla, jejichž porušení by znehodnotilo výstup. Pokud zopakujete všechno, poznámky ztratí svůj zdůrazňovací efekt. Tři až pět bodů je optimum.

Kompletní příklad dlouhého rámce

Následující ukázka spojuje všech sedm sekcí do jednoho promptu. Všimněte si, jak každá sekce plní jinou funkci — Role říká kým model je, Cíl co má vzniknout, Kontext proč a pro koho, Instrukce jak přesně, Proměnné z čeho, Příklad v jakém stylu a Poznámky na co nezapomenout:

## Role
Jsi zkušený SEO copywriter s 10letou praxí v českém e-commerce.
Specializuješ se na produktové popisky a kategorie pro e-shopy.

## Cíl
Napiš produktový popisek pro kategorii „Červená vína" v e-shopu s vínem.

## Kontext
E-shop winehouse.cz prodává moravská a česká vína. Aktuálně nemá
popisky kategorií, což negativně ovlivňuje SEO. Cílová skupina:
muži i ženy 30–55 let, kteří nakupují víno online.

## Instrukce
- Rozsah: **150–200 slov**
- Primární klíčové slovo „červená vína" v prvním odstavci
- Tón: odborný, ale přístupný
- **Nepoužívej** superlativy ani prázdné fráze
- Struktura: úvod → odrůdy → doporučení k jídlu → CTA
- Poslední věta = výzva k akci

## Proměnné
| Odrůda | Ročník | Cena |
| --- | --- | --- |
| Frankovka | 2021 | 189 Kč |
| Svatovavřinecké | 2022 | 225 Kč |
| Zweigeltrebe | 2021 | 169 Kč |

## Příklad (pro jinou kategorii)
Bílá vína z Moravy patří k tomu nejlepšímu, co česká vinařská tradice
nabízí. V naší kolekci najdete Ryzlink rýnský, Pálavu i Veltlínské
zelené — každou s vlastním charakterem...
**Prozkoumejte naši nabídku bílých vín a najděte svého favorita.**

## Poznámky
- Klíčové slovo „červená vína" **musí** být v prvním odstavci.
- Rozsah 150–200 slov.
- Žádné superlativy.
- Poslední věta = výzva k akci.

Shrnutí

Dlouhý strukturovaný rámec je plná verze promptovacího schématu se sedmi sekcemi. Použijte ho tam, kde krátký rámec nestačí — když model potřebuje vědět kým má být, proč úkol dělá a na co nesmí zapomenout. Pokud ani dlouhý rámec nestačí — například proto, že model potřebuje rozhodovací logiku a pracuje s více nástroji — rozšiřte ho na agentový rámec přidáním sekcí SOP a Nástroje.