---
title: "Vodič za stil promptova"
description: "Kako napisati i urediti prompt glasovnog agenta ThunderPhonea: smjernice koje provjerava pregled prompta, s ID-ovima na koje se njegovi nalazi pozivaju."
---

{/*
  GENERATED FILE: do not edit by hand.
  Source: api/agents/prompt_style_guide.md
  Regenerate: python3 scripts/docs-freshness/generate_prompt_style_guide.py
  CI regenerates this page and fails on drift
  (scripts/docs-freshness/generators.d/50-prompt-style-guide.sh).
*/}

<Note>
  Ovo je vodič prema kojem [pregled prompta](/api-reference/agents#review-a-prompt) provjerava prompt, a
  njegovi nalazi navode identifikatore u nastavku. Agenti za kodiranje povezani s
  [MCP poslužiteljem](/hr/guides/thunderphone-mcp-server) čitaju isti tekst kao resurs
  `thunderphone://guides/prompt-style`. Za predloške i primjere pogledajte
  [vodič za promptove](/hr/guides/prompting).
</Note>

Ovaj je vodič namijenjen svima koji pišu ili uređuju prompt glasovnog agenta: osobi u alatu za izradu, Copilotu ili agentu za kodiranje
koji radi putem API-ja. Alat za pregled prompta koristi ga kao kriterij i navodi identifikatore smjernica (P1, W2
i tako dalje).

Pozivatelj agenta čuje jednom, brzinom govora, i ne može se vratiti na prethodno. Agent čita prompt pri svakom
koraku i pažljivo slijedi njegovu formulaciju. Obje činjenice oblikuju sve u nastavku.

## Struktura

**P1. Napišite ga onako kako bi osoba uputila novog recepcionara.** Kratak uvod navodi tko je glasovni agent i za koga
radi. Poziv zatim slijedi redoslijedom kojim se odvija: kako započinje, što treba saznati, što treba potvrditi,
kako završava. Svako se pravilo nalazi u dijelu poziva na koji se odnosi. Čitatelj bi za svaki
odlomak trebao moći pitati: „bi li osoba koja vodi ovaj posao mogla ovo upisati?” Što treba saznati obuhvaća ono što je poslovanju potrebno da postupi po
zahtjevu, a ne samo tko zove i kako ih kontaktirati.

**P2. Jednostavni naslovi, prozni tekst ispod njih.** Naslovi poput „Tko ste”, „Poziv”, „Činjenice” i „Prosljeđivanje”
pomažu. Struktura nalik strojnoj ne pomaže: numerirani priručnici s pravilima, naslovi u camelCase formatu ili nalik kodu, dugački popisi
pravila s crticama, referenca za alate na početku i unakrsne reference poput „pogledajte odjeljak 4 u nastavku”. Popisi su prikladni za
podatke koje agent traži (radno vrijeme, cijene, adresa).

**P3. Način govora jednom, ukratko.** Način na koji agent govori tijekom cijelog poziva (kratki iskazi u prvom licu,
topao ton, jednostavne riječi; pogledajte S2) stane u jedan kratak odlomak pri vrhu. Sve što je specifično za jedan korak pripada
tom koraku.

**P4. Odvojite činjenice od ponašanja.** Radno vrijeme, cijene, lokacije, pravila i ostale činjenice idu u dio
prompta s činjenicama ili u bazu znanja, a ne razasuti kroz tijek poziva. Dugi katalozi i česta pitanja pripadaju bazi
znanja. Agent smije iznositi samo činjenice koje su mu dane.

## Sadržaj

**C1. Načela i činjenice, a ne skripte.** Opišite što agent pokušava postići i što treba
znati. Izostavite grane „ako pozivatelj kaže X, recite Y”, unaprijed napisane odgovore na očekivana pitanja i unaprijed
pripremljene fraze. Konfigurirani uvodni pozdrav jedini je unaprijed definiran element.

**C2. Ispravak navodi opće načelo.** Kada izmjena upute odgovara na uočenu pogrešku, izmjena dodaje
opće načelo ili činjenicu koja nedostaje, a ne zakrpu za taj jedan slučaj. Pojedinosti neuspješnog poziva (imena,
brojevi, točne riječi) ne unose se u uputu.

**C3. Radije uklonite nego dodajte.** Kada se pogreška može povezati s postojećim pravilom koje je previše konkretno, preširoko
ili loše postavljeno, promijenite ili uklonite to pravilo umjesto da uz njega dodate proturječno pravilo.

**C4. Postavke odlučuju o nekim stvarima, a ne uputa.** Ovo su postavke agenta, a tekst upute o njima se
zanemaruje ili je u sukobu s njima: što se govori dok se alat izvršava (poruka pri pokretanju alata, popratne fraze),
provjere tijekom tišine i završna radnja nakon tišine, tempo ponavljanja, stil
prebacivanja jezika, obavijest o snimanju te govori li prvi agent ili pozivatelj. Usmjerite uputu na ishod
(„potvrdite adresu e-pošte prije nego što je spremite”) i postavite postavku. Sam uvodni pozdrav piše se u
uputu.

**C5. Primjeri su rečenice koje će agent izgovoriti.** Agent gotovo riječ po riječ preuzima formulaciju primjera, pa je svaki
primjer potpuna, prirodna izgovorena rečenica, a nekoliko raznolikih primjera bolje je od jednog. Uvedite ih kao primjere („Na
primjer, mogli biste reći ...”), a ne kao obaveznu rečenicu. Kratke oznake poput „Je li još uvijek točno?”
zvuče šturo kada se izgovore.

**C6. Bez primjera iz poziva naših korisnika.** Primjeri opisuju vrstu situacije općenitim izrazima ili
koriste izmišljenu tvrtku.

**C7. Prompt je za pozivatelje, a ne o izradi.** Pozivatelji čuju sve što prompt kaže kada je aktivan, stoga
ne uključuje napomene o izradi, testiranju ili statusu usklađenosti („ova je verzija za testiranje”, „TEST” u nazivu
rezervacije, „dok se ugovori ne potpišu”). Također ne uključuje odricanja od odgovornosti, ograničenja odgovornosti ni završne
sažetke koje tvrtka nije zatražila, poput onoga što prihvaćanje plana ne utvrđuje ili sažetka onoga što još nije
potvrđeno. Agent odgovara na ono što je pozivatelj zatražio i staje; tvrtka dodaje ograničenje kada ga želi. Nedostajuća
činjenica ili ograničenje sustava zapisuje se kao ono što agent radi („za cijene ponudite povratni poziv iz ureda”),
a ne kao napomena da podatak nije dostavljen ili o načinu na koji se zahtjevi bilježe, i ne ostaje ništa od sastavljanja,
poput zaostalog imena ili naslova.

## Formulacija

**W1. Jasno i jednom recite što treba učiniti.** Željeno ponašanje navedite kao uputu običnim riječima: „Pročitajte
broj narudžbe znamenku po znamenku kako bi ga pozivatelj mogao ispraviti.” Recite to jednom, ondje gdje se primjenjuje.

**W2. Bez naglašavanja.** Bez oznaka VAŽNO, NAPOMENA ili KRITIČNO, bez riječi velikim slovima radi naglašavanja, bez uskličnika,
bez parova „Loše:” i „Dobro:” te bez blokova o tome što ne treba raditi. Ovdje pripadaju i riječi poput „nikada”, „uvijek”
i „mora” koje se koriste za naglašavanje. Naglašavanje usmjerava pozornost modela na jedno pravilo i pogoršava njegovo snalaženje u ostatku
poziva. Kada agent zanemari uputu, učinite uputu jasnijom, konkretnijom ili bolje postavljenom, a ne naglašenijom.

**W3. Ispravite strukturu koja uzrokuje ponašanje.** Prije dodavanja pravila protiv nečega što agent radi, pronađite
formulaciju ili strukturu koja ga do toga dovodi: predložak koji model doslovno ispunjava, pojam s dva značenja,
uvjetnu granu koju brzi model tumači neprecizno. Promijenite to.

**W4. Konkretno je bolje od općenitog.** „Ponudite dva najranija slobodna termina, a zatim pitajte koji odgovara” bolje je od
„pomozite s rasporedom”. Neodređene upute daju neodređeno ponašanje.

**W5. Provjerite prije nego što pitate o tome.** Kada pozivatelj spomene nešto što alat za pretraživanje samo za čitanje može provjeriti (proizvod, narudžbu, postojeću rezervaciju), glasovni agent provjerava riječima koje je pozivatelj naveo, a zatim postavlja dodatno pitanje samo
ako ga rezultat zahtijeva. „Provjerite zalihu proizvoda koji pozivatelj navede i recite mu što ste pronašli” bolje je od „razjasnite
marku, veličinu i varijantu, a zatim provjerite zalihu”: glasovni agent kojem je rečeno da prvo razjasni nastavlja postavljati pitanja i provjera se nikada
ne pokrene. Ovo se odnosi samo na pretraživanja. Prije alata koji nešto rezervira, mijenja, otkazuje ili sprema, glasovni agent i dalje
potvrđuje pojedinosti s pozivateljem.

## Govor

**S1. Jedno pitanje po potezu, a pitanje završava potez.** Sve što se kaže nakon pitanja govori preko
odgovora pozivatelja. Svako objašnjenje stavite prije pitanja.

**S2. Kratki potezi, u punim izgovorenim rečenicama.** Jedna ili dvije kratke rečenice, osim ako pozivatelj ne zatraži pojedinosti.
Izgovorene su mogućnosti ograničene na nekoliko njih. Kratko znači malo riječi, a ne nedovršene rečenice: agent govori kao dobra
recepcionarka telefonom, u potpunim rečenicama u prvom licu, primjerice: "Sada ću vam to rezervirati" ili
"Upisao sam vas za ponedjeljak u deset." Fragmenti u stilu bilješki ("Rezervacija za vas.", "Gotovo.", "Zabilježeno.") zvuče šturo
kada se izgovore, a izrazi iz e-pošte ("Imajte na umu da ...", "Ljubazno vas molimo ...", "Nadam se da ovo pomaže") zvuče kao da se čitaju,
a ne izgovaraju. Odlomak prompta o načinu govora to izravno navodi, primjerice: "Neka svaki potez bude jedna ili dvije
rečenice i govorite u prvom licu, kao što bi recepcionarka govorila telefonom."

**S3. Pišite za slušanje.** U onome što agent govori izbjegavajte Markdown, simbole i zapise koje će glas neobično pročitati
(kose crte, ampersande, „@”, „.com”, razdjelnike tisućica, telefonske brojeve bez razmaka). Činjenice i vrijednosti koje agent prosljeđuje
alatu, kao što su adresa e-pošte ili broj računa, ostaju u točnom pisanom obliku; kada jednu od njih također treba izgovoriti naglas, uz nju
dodajte način izgovora umjesto da je preoblikujete. Navedite kako se izgovaraju neuobičajena imena ili kratice te preslušajte
nove izraze glasom agenta prije nego što ih zadržite.

**S4. Potvrdite ono što bi bilo skupo pogrešno shvatiti.** Brojevi, e-adrese, adrese i kodovi ponavljaju se u obliku
u kojem su navedeni, jednom, u odgovoru odmah nakon što ih pozivatelj navede i prije sljedećeg pitanja, jedna vrijednost po
ponavljanju. Prema zadanim postavkama ime se prihvaća kako je izgovoreno, bez ponavljanja, a agent traži njegovo slovkanje samo kada je
neobično ili nejasno, i to samo jednom. Kada je tvrtki potrebno točno ime, primjerice radi podudaranja s njezinim evidencijama ili
rezervacije pod tim imenom, prompt to navodi i agent ponavlja ime slovkanjem. Ponavljanje je prilika pozivatelju da
ispravi vrijednost, a ne prepreka: pozivatelj koji odgovori sljedećim podatkom ili nastavi bez ispravljanja prihvatio ju je,
a prihvaćena se vrijednost više ne traži. Telefonski broj na koji će tvrtka uzvratno nazvati ili poslati poruku iznimka je:
njegovo ponavljanje završava potez i čeka odgovor pozivatelja. Prompt koji traži čitanje znamenku po znamenku navodi samo
vrijednosti koje se tako čitaju (telefonski broj, kod); kućni broj, cijena, vrijeme ili datum izgovaraju se onako kako ih ljudi izgovaraju.
Prompt navodi što treba potvrditi; platforma određuje tempo ponavljanja.

## Iteriranje

**I1. Testirajte prije nego što zadržite promjenu.** Ponovno pokrenite razvojni skup agenta na uređenom nacrtu i usporedite ga s
trenutačnom verzijom: koje je primjere promjena ispravila, a koje pokvarila. Čitajte odgovore onako kako bi ih pozivatelj čuo.
Sve što bi pozivatelj primijetio problem je, a ne detalj.

**I2. Izdvojeni skup provjerava se jednom.** Podešavajte samo na razvojnom skupu. Pokrenite testni skup kada je promjena spremna i
prijavite njegov rezultat onakvim kakav jest. Promjena napravljena nakon uvida u rezultate testiranja zahtijeva nove testne primjere.

**I3. Refaktorirajte kada se zakrpe nagomilaju.** Prompt koji je prikupio mnogo malih ispravaka udaljava se od P1: pravila se
ponavljaju, sukobljavaju ili se nalaze daleko od koraka kojim upravljaju. Tada ga preoblikujte u ovaj oblik, zadržavajući svako ponašanje
koje zahtijeva. Svako ponašanje navedite kao zadržano, spojeno, preformulirano ili odbačeno i ništa ne odbacujte bez navođenja. Ponovno pokrenite razvojni
skup prije i nakon toga; refaktoriranje treba promijeniti formulaciju, a ne ponašanje.

**I4. Provjerite konfiguraciju prije upute.** Neki neuspjesi nisu posljedica upute: pogrešno prepoznavanje slovkanih
slova ograničenje je sluha (isprobajte sluh Plus), spor odgovor može biti posljedica razine inteligencije ili
sluha ili postavke otkrivanja kraja govora. Isključite probleme s konfiguracijom prije prepisivanja teksta.
