---
title: "Průvodce stylem promptů"
description: "Jak psát a upravovat prompt hlasového agenta ThunderPhone: kontroly při revizi promptu podle pokynů a ID, na která odkazují jejich zjištění."
---

{/*
  GENEROVANÝ SOUBOR: neupravujte ručně.
  Zdroj: api/agents/prompt_style_guide.md
  Znovu vygenerujte: python3 scripts/docs-freshness/generate_prompt_style_guide.py
  CI tuto stránku znovu generuje a při odchylce selže
  (scripts/docs-freshness/generators.d/50-prompt-style-guide.sh).
*/}

<Note>
  Toto je příručka, vůči níž [kontrola promptu](/api-reference/agents#review-a-prompt) vyhodnocuje prompt a
  v jejích zjištěních odkazuje na níže uvedená ID. Programovací agenti připojení k
  [serveru MCP](/cs/guides/thunderphone-mcp-server) čtou stejný text jako prostředek
  `thunderphone://guides/prompt-style`. Šablony a příklady najdete v
  [příručce k promptům](/cs/guides/prompting).
</Note>

Tato příručka je určena všem, kdo píší nebo upravují prompt hlasového agenta: člověku v nástroji pro tvorbu, Copilotu nebo programovacímu
agentovi pracujícímu přes API. Nástroj pro kontrolu promptů ji používá jako hodnoticí kritéria a odkazuje na její ID pokynů (P1, W2
a podobně).

Volající slyší agenta jednou, rychlostí běžné řeči, a nemůže se vrátit zpět. Agent čte prompt při každém
tahu a pečlivě přebírá jeho formulace. Obě skutečnosti ovlivňují vše níže.

## Struktura

**P1. Napište jej tak, jak by člověk zaučil nového recepčního.** Krátký úvod uvádí, kdo agent je a pro koho
pracuje. Hovor pak probíhá v pořadí, v jakém se odehrává: jak začíná, co je třeba zjistit, co potvrdit,
jak končí. Každé pravidlo patří do části hovoru, kde se uplatňuje. Čtenář by si měl být schopen u každého
odstavce položit otázku: „mohl by to napsat člověk, který tento podnik provozuje?“ Část o tom, co zjistit, zahrnuje informace, které podnik potřebuje k vyřízení
požadavku, nejen to, kdo volá a jak jej kontaktovat.

**P2. Jednoduché nadpisy, pod nimi souvislý text.** Nadpisy jako „Kdo jste“, „Hovor“, „Fakta“ a „Předání“
pomáhají. Struktura ve stylu stroje nikoli: číslované příručky pravidel, nadpisy v camelCase nebo ve stylu kódu, dlouhé seznamy
pravidel s pomlčkami, přehled nástrojů hned na začátku a křížové odkazy jako „viz oddíl 4 níže“. Seznamy jsou vhodné pro
údaje, které agent vyhledává (otevírací doba, ceny, adresa).

**P3. Způsob mluvy jednou, stručně.** To, jak agent mluví během celého hovoru (krátké odpovědi v první osobě,
vřelý tón, prostá slova; viz S2), patří do jednoho krátkého odstavce poblíž začátku. Vše specifické pro jeden krok patří
do daného kroku.

**P4. Fakta odděleně od chování.** Otevírací doba, ceny, místa, zásady a další údaje patří do části s fakty
v promptu nebo do znalostní báze, nikoli rozptýleně v průběhu hovoru. Dlouhé katalogy a časté dotazy patří do
znalostní báze. Agent smí uvádět pouze údaje, které dostal.

## Obsah

**C1. Zásady a fakta, ne scénáře.** Popište, čeho se agent snaží dosáhnout a co potřebuje
vědět. Vynechte větvení typu „pokud volající řekne X, řekněte Y“, předem napsané odpovědi na očekávané otázky a ustálené
formulace. Nastavený úvodní pozdrav je jediným scénářovým prvkem.

**C2. Oprava uvádí obecnou zásadu.** Pokud změna promptu reaguje na pozorované selhání, změna přidá
obecnou zásadu nebo chybějící informaci, nikoli záplatu pro tento jeden případ. Konkrétní údaje z neúspěšného hovoru (jeho jména,
čísla, přesná slova) do promptu nepatří.

**C3. Upřednostněte odebírání před přidáváním.** Pokud lze selhání vystopovat k existujícímu pravidlu, které je příliš konkrétní, příliš obecné
nebo špatně umístěné, toto pravidlo změňte nebo odstraňte namísto přidání protichůdného pravidla vedle něj.

**C4. Některé věci určují nastavení, ne prompt.** Toto jsou nastavení agenta a text promptu o nich je
ignorován nebo je s nimi v rozporu: co se říká během běhu nástroje (úvodní věta nástroje, vyplňující fráze), kontrolní otázky při
tichu a závěrečná akce po tichu, tempo opakování údajů, styl přepínání jazyků,
upozornění na nahrávání a to, zda mluví první agent nebo volající. Prompt zaměřte na výsledek
(„před uložením potvrďte e-mailovou adresu“) a nastavte příslušné nastavení. Samotný úvodní pozdrav se píše do
promptu.

**C5. Příklady jsou věty, které agent řekne.** Agent kopíruje formulace z příkladů téměř slovo od slova, proto je každý
příklad úplnou, přirozenou mluvenou větou a několik různorodých příkladů je lepších než jeden. Uveďte je jako příklady („Například
můžete říct ...“), nikoli jako povinnou větu. Úsečné formulace jako „Je to stále správně?“ znějí při vyslovení stroze.

**C6. Žádné příklady z hovorů našich vlastních zákazníků.** Příklady popisují daný typ situace obecně nebo
používají smyšlenou firmu.

**C7. Prompt je pro volající, ne o vytváření.** Volající po spuštění slyší vše, co prompt říká, proto neobsahuje poznámky o vytváření, testování ani stavu souladu s předpisy („tato verze je určena k testování“, „TEST“ v názvu rezervace, „dokud nejsou podepsány smlouvy“). Neobsahuje ani prohlášení o vyloučení odpovědnosti, upozornění na odpovědnost a závěrečná shrnutí, o která firma nepožádala, například co nepředstavuje přijetí plánu nebo shrnutí toho, co dosud není potvrzeno. Agent odpoví na to, na co se volající zeptal, a skončí; firma přidá upozornění, když ho chce. Chybějící údaj nebo omezení systému se zapisuje jako to, co agent udělá („u cen nabídněte zpětné volání z kanceláře“), nikoli jako poznámka, že údaj nebyl poskytnut, nebo o tom, jak se požadavky zaznamenávají, a nezůstává nic z přípravy návrhu, například osamocené jméno nebo nadpis.

## Formulace

**W1. Jasně a jednou řekněte, co má udělat.** Požadované chování vyjádřete jako pokyn běžnými slovy: „Přečtěte
číslo objednávky zpět číslici po číslici, aby ho volající mohl opravit.“ Uveďte to jednou tam, kde to platí.

**W2. Bez důrazu.** Žádné štítky DŮLEŽITÉ, POZNÁMKA nebo KRITICKÉ, žádná slova psaná velkými písmeny pro zdůraznění, žádné vykřičníky,
žádné dvojice „Špatně:“ a „Správně:“ ani bloky s tím, co nedělat. Patří sem i slova jako „nikdy“, „vždy“ a „musí“ použitá
pro zdůraznění. Důraz přitahuje pozornost modelu k jednomu pravidlu a zhoršuje jeho schopnost zvládat zbytek
hovoru. Pokud agent pokyn ignoruje, upravte jej tak, aby byl jasnější, konkrétnější nebo lépe umístěný, ne výraznější.

**W3. Opravte strukturu, která chování způsobuje.** Před přidáním pravidla proti něčemu, co agent dělá, najděte
formulaci nebo strukturu, která jej k tomu vede: šablonu, kterou model doslovně vyplňuje, výraz se dvěma významy,
větev if-else, kterou rychlý model čte volně. Změňte ji.

**W4. Konkrétní je lepší než obecné.** „Nabídněte dva nejbližší volné termíny a poté se zeptejte, který vyhovuje“ je lepší než „pomozte
s plánováním“. Vágní pokyny vedou k vágnímu chování.

**W5. Než se na něco zeptáte, vyhledejte to.** Když volající zmíní něco, co může ověřit nástroj pro vyhledávání pouze pro čtení (produkt, objednávku, existující rezervaci), agent to ověří podle slov, která volající uvedl, a doplňující otázku položí pouze
v případě, že ji výsledek vyžaduje. „Zkontrolujte skladovou dostupnost produktu, který volající zmíní, a sdělte mu, co zjistíte“ je lepší než „upřesněte značku, velikost a variantu a pak zkontrolujte skladovou dostupnost“: agent, kterému řeknete, aby nejprve upřesňoval, se bude dál ptát a kontrola se nikdy nespustí. Týká se to pouze vyhledávání. Před použitím nástroje, který něco rezervuje, změní, zruší nebo uloží, agent stále potvrdí podrobnosti s volajícím.

## Řeč

**S1. Jedna otázka na repliku a otázka repliku ukončí.** Cokoli řečené po otázce mluví přes
odpověď volajícího. Veškeré vysvětlení umístěte před otázku.

**S2. Krátké repliky v úplných mluvených větách.** Jedna nebo dvě krátké věty, pokud volající nepožádá o podrobnosti.
Mluvené možnosti omezte na několik. Krátké znamená několik slov, ne útržkovité věty: agent mluví jako dobrý
recepční po telefonu, v úplných větách v první osobě, například „Hned vám to zarezervuji“ nebo
„Mám pro vás rezervaci na pondělí v deset.“ Útržky ve stylu poznámek („Rezervace pro vás.“, „Hotovo.“, „Zaznamenáno.“) znějí po vyslovení stroze
a e-mailové formulace („Vezměte prosím na vědomí, že ...“, „Laskavě ...“, „Doufám, že to pomůže“) znějí spíše jako předčítané
než vyslovené. Odstavec promptu o způsobu mluvení to uvádí přímo, například: „Každou repliku omezte na jednu nebo dvě
věty a mluvte v první osobě, jako by po telefonu mluvil recepční.“

**S3. Pište pro poslech.** V tom, co agent říká, se vyhněte markdownu, symbolům a zápisu, který hlas přečte neobvykle
(lomítka, ampersandy, „@“, „.com“, oddělovače tisíců, telefonní čísla bez mezer). Fakta a hodnoty, které agent předává
nástroji, například e-mailová adresa nebo číslo účtu, zůstávají v přesném psaném tvaru; pokud je zároveň třeba je
vyslovit nahlas, přidejte vedle nich způsob vyslovení, místo abyste je přepisovali. Uveďte, jak se vyslovují neobvyklá jména
nebo zkratky, a před ponecháním nových výrazů si je poslechněte hlasem agenta.

**S4. Potvrzujte to, u čeho by chyba byla nákladná.** Čísla, e-mailové adresy, adresy a kódy se zopakují v podobě,
v jaké je volající uvedl, jednou, v odpovědi hned poté, co je volající sdělí, a před další otázkou, při každém
zopakování pouze jedna hodnota. Jméno se standardně přijímá tak, jak bylo vysloveno, bez zopakování, a agent se na
jeho hláskování zeptá pouze tehdy, je-li neobvyklé nebo nejasné, a zeptá se jen jednou. Když firma potřebuje jméno přesně,
například pro porovnání se svými záznamy nebo pro rezervaci pod tímto jménem, prompt to uvede a agent jméno vyhláskuje zpět. Zopakování dává volajícímu možnost
hodnotu opravit, není to překážka: volající, který odpoví dalším údajem nebo pokračuje bez opravy, ji
přijal a na přijatou hodnotu se již znovu neptáme. Telefonní číslo, na které bude firma volat nebo posílat zprávy, je
výjimkou: jeho zopakování ukončí repliku a čeká na odpověď volajícího. Prompt, který vyžaduje čtení po jednotlivých
číslicích, uvádí pouze hodnoty čtené tímto způsobem (telefonní číslo, kód); číslo domu, cena, čas nebo datum se
vyslovují tak, jak je lidé běžně říkají. Prompt určuje, co potvrdit; platforma určuje tempo zopakování.

## Iterace

**I1. Otestujte změnu, než ji zachováte.** Spusťte vývojovou sadu agenta na upraveném návrhu a porovnejte ji s
aktuální verzí: které příklady změna opravila a které pokazila. Čtěte odpovědi tak, jak by je slyšel volající.
Cokoli, čeho by si volající všiml, je problém, nikoli detail.

**I2. Odložená sada se kontroluje jednou.** Dolaďujte pouze na vývojové sadě. Testovací sadu spusťte, až je změna připravena, a
výsledek uveďte tak, jak je. Změna provedená po zobrazení výsledků testu vyžaduje nové testovací příklady.

**I3. Když se hromadí záplaty, refaktorujte.** Prompt, který nashromáždil mnoho drobných oprav, se odchyluje od P1: pravidla se
opakují, jsou v konfliktu nebo jsou daleko od kroku, který upravují. Poté jej přepište do této podoby a zachovejte každé chování,
které vyžaduje. U každého chování uveďte, zda bylo zachováno, sloučeno, přeformulováno nebo vyřazeno, a nic nevyřazujte potichu. Spusťte vývojovou
sadu před refaktorizací i po ní; refaktorizace má změnit formulaci, ne chování.

**I4. Před promptem zkontrolujte konfiguraci.** Některá selhání nejsou způsobena promptem: chybné rozpoznání hláskovaných písmen je omezením rozpoznávání (vyzkoušejte rozpoznávání Plus), pomalá odpověď může souviset s úrovní inteligence nebo rozpoznávání či s nastavením ukončení promluvy. Než text přepíšete, vylučte vliv konfigurace.
