5 pravidel, jak psát technické texty, které inženýři dočtou

Text v prvních dvou řádcích rozhoduje o zbyt

Technický čtenář nečte texty jako běžný návštěvník webu. Nemá trpělivost na omáčky, nevěří superlativům a většinou přesně ví, co hledá. Pokud mu předložíte odstavec plný marketingových frází, zavře stránku dřív, než se dostanete k pointě. Rozdíl mezi textem, který technika zaujme, a textem, který ho odradí, není v délce ani v barvách. Je v tom, jak rychle a přesně mu dáte informaci, kterou potřebuje k rozhodnutí.

Nakonec text otestujte na jednom člověku z oboru. Dejte mu ho přečíst a zeptejte se, co si zapamatoval a co by potřeboval dohledat. Pokud nedokáže po přečtení říct, k čemu text je a co z něj plyne, není problém v něm, ale v textu. Technické publikum není nepřátelské, jen netoleruje mlžení. Když mu dáte fakta, strukturu a přiznaná omezení, přečte i delší text a vrátí se k němu, až bude potřebovat detail.

Než začnete cokoli nastavovat, sepněte si seznam úkolů, které chcete přenést na AI. Typicky jde o psaní konceptů kampaní, generování variant předmětů, personalizaci obsahu podle chování nebo automatické odpovědi na časté dotazy. U každého úkolu si napište, jak poznáte, že je hotový dobře. Tím získáte měřítko, podle kterého budete nástroj hodnotit.

První pravidlo zní: nahraďte přídavná jména čísly a konkrétními parametry. „Vysoký výkon" neznamená nic, „zvládne 40 000 požadavků za sekundu při latenci pod 20 ms" znamená vše. Technik si nepotrpí na oslavné ódy, ale na měřitelné údaje. Kde můžete uvést jednotku, teplotní rozsah, toleranci, verzi protokolu nebo podmínky testování, udělejte to. Pokud údaj nemáte, raději ho vynechejte než nahrazovat prázdným slovem.

Během workshopu se osvědčuje rozdělit práci na dvě fáze. V první jde o generování – nechte vzniknout tři až pět variant, nebojte se je porovnávat. Ve druhé fázi přijde lidská úprava: vyberte nejsilnější myšlenku, přeformulujte ji vlastními slovy, doplňte příklad z praxe a zkontrolujte fakta. Teprve pak text projde jazykovou korekturou. Kdo tuto druhou fázi vynechá, pozná to na čtenosti i na důvěře publika.

Poslední krok je test. Natočte scénář nanečisto, pusťte ho někomu, kdo o tématu nic neví, a sledujte, v jaké sekundě přestane poslouchat. Podle toho upravte úvod nebo vypusťte prostřední část. AI vám ušetří čas při hledání variant, ale rozhodnutí, co funguje, zůstává na vás. Scénář, který nikdo nevylepšil, poznáte podle toho, že zní hladce a nic neřekne.

Kde AI selhává a co musíte doplnit ručně Nejčastější chyba je brát první výstup jako hotový. Model rád opakuje stejné obraty, používá vágní slovesa a zapomíná na vizuální složku. Scénář pro krátké video ale není jen mluvený text. Musí obsahovat popis toho, co je vidět, kde je střih a co se děje v pozadí. Do výstupu proto dopište konkrétní akce: co postava dělá, co se objeví na obrazovce, kdy přijde změna záběru. Bez toho vznikne monolog, u kterého divák usne.

Opakované kontroly místo jednoho dlouhého zadání Lepší výsledek nevznikne jedním dokonalým promptem, ale několika koly úprav. Nechte si nejprve vygenerovat hrubou verzi, přečtěte si ji a teprve pak pište, co konkrétně změnit. Místo „udělej to lepší" použijte „ve druhé větě vypadá slovo opakovaně, nahraď ho jiným a zkrať odstavec na čtyři věty". Čím přesněji popíšete problém, tím méně se výstup vrátí do naučené šablony. U delších textů je výhodné generovat po částech a každou část pak ručně propojit.

Pomáhá i střídání tónu a stavby vět. Pokud všechny odstavce začínají stejně a končí stejně, čtenář to pozná dřív než vy. Zkuste jeden odstavec otevřít otázkou, jiný krátkým tvrzením a další popisem situace. Stejně tak měňte délku vět. Krátká věta za dlouhým souvětím působí živě a přirozeně. Do zadání proto napište, že se má střídat délka i rytmus. Model to sám od sebe nedělá, pokud ho k tomu nevedete.

Nakonec si veďte vlastní knihovnu zadání, která fungují. Ukládejte si nejen prompty, ale i hotové texty a poznámky, co jste v nich opravovali. Po několika zakázkách zjistíte, které formulace vedou k přirozenému výsledku a které naopak vrací text do šablony. Tento vlastní postup je cennější než jakýkoli univerzální návod. Čím víc do něj vložíte vlastní zkušenost, tím méně bude váš text vypadat jako od umělé inteligence.

Když se výstup z nástroje pro psaní s umělou inteligencí začne podobat předchozím textům, nebývá to chyba modelu. Většinou jde o to, že do něj vstupuje příliš obecné zadání. Čím víc se spoléháte na hotové formulace a šablony, tím víc se výsledky sobě podobají. Prvním krokem je přestat kopírovat cizí prompty a začít popisovat vlastní situaci. Místo „napiš článek o AI" zadejte, pro koho text je, co má čtenář po přečtení umět a co v něm naopak být nemá.