---
title: "Водич за стил упита"
description: "Како да пишете и уређујете упит гласовног агента ThunderPhone: смернице које провере упита користе, са идентификаторима на које се њихови налази позивају."
---

{/*
  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>
  Ово је водич у односу на који [провера промпта](/api-reference/agents#review-a-prompt) проверава промпт, а
  њени налази наводе идентификаторе у наставку. Агенти за програмирање повезани са
  [MCP сервером](/sr/guides/thunderphone-mcp-server) читају исти текст као ресурс
  `thunderphone://guides/prompt-style`. За шаблоне и примере погледајте
  [водич за писање промптова](/sr/guides/prompting).
</Note>

Овај водич је за свакога ко пише или уређује промпт гласовног агента: особу у алату за израду, Copilot-у или агента
за програмирање који ради путем API-ја. Алат за проверу промпта користи га као критеријум и наводи његове идентификаторе
смерница (P1, W2 и тако даље).

Позивалац агента чује једном, темпом говора, и не може да се врати уназад. Агент чита промпт при сваком
потезу и пажљиво следи његову формулацију. Обе чињенице обликују све у наставку.

## Облик

**P1. Напишите га онако како би особа упутила новог рецепционара.** Кратак увод наводи ко је агент и за кога
ради. Позив затим тече редоследом којим се одвија: како почиње, шта треба сазнати, шта треба потврдити,
како се завршава. Свако правило налази се у делу позива на који се односи. Читалац би за сваки
пасус требало да може да се запита: „да ли би особа која води овај посао могла ово да напише?“ Шта треба сазнати обухвата оно што је предузећу потребно да поступи по
захтеву, а не само ко зове и како их контактирати.

**P2. Јасни наслови, а испод њих проза.** Наслови као што су „Ко сте“, „Позив“, „Чињенице“ и „Прослеђивање“
су корисни. Структура налик машинској није: нумерисани приручници с правилима, наслови у camelCase формату или налик коду, дуге листе
правила са цртицама, референца алата на почетку и унакрсне референце попут „погледајте одељак 4 у наставку“. Листе су у реду за
податке које агент тражи (радно време, цене, адреса).

**P3. Начин говора наведите једном, укратко.** Начин на који агент говори током целог позива (кратке реплике у првом лицу,
топао тон, једноставне речи; видите S2) стаје у један кратак пасус при врху. Све што је специфично за један корак налази се у
том кораку.

**P4. Чињенице одвојите од понашања.** Радно време, цене, локације, правила и друге чињенице иду у део промпта
са чињеницама или у базу знања, а не расуте кроз ток позива. Дуги каталози и честа питања припадају бази
знања. Агент сме да каже само чињенице које су му дате.

## Садржај

**C1. Начела и чињенице, а не скрипте.** Опишите шта агент покушава да постигне и шта треба да
зна. Изоставите гране типа „ако позивалац каже X, реците Y“, скриптиране одговоре на очекивана питања и унапред
припремљене реченице. Конфигурисани уводни поздрав је једини скриптирани елемент.

**C2. Исправка наводи опште начело.** Када измена промпта одговара на уочени неуспех, измена додаје
опште начело или чињеницу која недостаје, а не закрпу за тај један случај. Појединости неуспешног позива (имена,
бројеви, тачне речи) не уносе се у промпт.

**C3. Предност има уклањање, а не додавање.** Када се неуспех може пратити до постојећег правила које је превише конкретно, прешироко
или лоше постављено, измените или уклоните то правило уместо да поред њега додате противправило.

**C4. Подешавања одређују неке ствари, а не промпт.** Ово су подешавања агента, а текст промпта о њима се
игнорише или је у сукобу са њима: шта се изговара док се алат покреће (реченица на почетку алата, попуњавајуће фразе), провере
тишине и завршна радња након тишине, темпо поновног читања, стил преласка са језика на језик, обавештење о
снимању и да ли агент или позивалац први говори. Усмерите промпт на исход
(„потврдите адресу е-поште пре него што је сачувате“) и подесите подешавање. Сам уводни поздрав се пише у
промпту.

**C5. Примери су реченице које ће агент изговорити.** Агент копира формулацију примера готово реч по реч, па је сваки
пример потпуна, природна изговорена реченица, а неколико разноврсних примера је боље од једног. Уведите их као примере („На
пример, можете рећи ...“), а не као обавезну реченицу. Скраћене ознаке попут „И даље је тачно?“ звуче кратко када се
изговоре.

**C6. Без примера из позива наших клијената.** Примери описују врсту ситуације општим речима или
користе измишљено предузеће.

**C7. Упит је за позиваоце, а не о изради.** Позиваоци чују све што упит каже када се активира, па
он изоставља напомене о изради, тестирању или статусу усклађености („ова верзија је за тестирање“, „ТЕСТ“ у
називу резервације, „док се споразуми не потпишу“). Такође изоставља одрицања од одговорности, напомене о
ограничењу одговорности и завршне сажетке које предузеће није тражило, као што су шта прихватање плана не
утврђује или сажетак онога што још није потврђено. Агент одговара на оно што је позивалац питао и стаје;
предузеће додаје напомену када је жели. Недостајућа чињеница или системско ограничење пише се као оно што
агент ради („за цене понудите повратни позив из канцеларије“), а не као напомена да није достављено или о томе
како се захтеви евидентирају, и ништа не остаје од израде нацрта, као што су случајно остављено име или наслов.

## Формулација

**W1. Јасно и једном реците шта треба урадити.** Наведите жељено понашање као упутство обичним речима: „Прочитајте број поруџбине цифру по цифру како би позивалац могао да га исправи.“ Реците то једном, тамо где се примењује.

**W2. Без наглашавања.** Без ознака ВАЖНО, НАПОМЕНА или КРИТИЧНО, без речи великим словима ради наглашавања, без
узвичника, без парова „Лоше:“ и „Добро:“, без блокова о томе шта не треба радити. Овде спадају и речи попут
„никада“, „увек“ и „мора“ које се користе ради наглашавања. Наглашавање усмерава пажњу модела на једно правило и
чини га лошијим у остатку позива. Када агент игнорише упутство, учините упутство јаснијим, конкретнијим или боље
постављеним, а не гласнијим.

**W3. Исправите структуру која изазива понашање.** Пре него што додате правило против нечега што агент ради, пронађите
формулацију или структуру која га доводи до тога: шаблон који модел дословно попуњава, термин који има два значења,
грану ако-иначе коју брз модел чита лабаво. Измените то.

**W4. Конкретно је боље од општег.** „Понудите два најранија слободна термина, а затим питајте који одговара“ је боље од
„помозите око заказивања“. Нејасна упутства доводе до нејасног понашања.

**W5. Проверите пре него што питате о томе.** Када позивалац наведе нешто што алатка за претрагу само за читање може да провери (производ, поруџбину, постојећу резервацију), агент проверава речима које је позивалац навео, а затим поставља додатно питање само ако је потребно на основу резултата. „Проверите залихе за производ који позивалац наведе и реците му шта сте пронашли“ боље је од „разјасните бренд, величину и варијанту, па проверите залихе“: агент коме је речено да прво разјасни наставља да пита и провера се никада не покреће. Ово се односи само на претраге. Пре алатке која нешто резервише, мења, отказује или чува, агент и даље потврђује детаље са позиваоцем.

## Говор

**S1. Једно питање по потезу, а питање завршава потез.** Све што се каже после питања говори преко
одговора позиваоца. Свако објашњење ставите пре питања.

**S2. Кратке реплике, у пуним говорним реченицама.** Једна или две кратке реченице, осим ако позивалац не затражи више детаља.
Изговорене опције ограничите на неколико. Кратко значи неколико речи, а не одсечене реченице: агент говори као добар
рецепционер телефоном, пуним реченицама у првом лицу, на пример: „Одмах ћу Вам то заказати“ или
„Уписао сам Вас за понедељак у десет.“ Фрагменти у стилу белешки („Заказано за Вас.“, „Готово.“, „Забележено.“) звуче одсечно
када се изговоре, а формулације из е-поште („Имајте на уму да...“, „Љубазно...“, „Надам се да ово помаже“) звуче као да се читају,
уместо да су изговорене. Пасус упита о начину говора то тражи јасно, на пример: „Нека свака реплика има једну или две
реченице и говорите у првом лицу, као што би рецепционер говорио телефоном.“

**S3. Пишите за слушање.** У ономе што агент говори избегавајте Markdown, симболе и записе које ће глас необично прочитати
(косе црте, амперсанде, „@“, „.com“, раздвајаче хиљада, бројеве телефона без размака). Чињенице и вредности које агент прослеђује
алату, као што су адреса е-поште или број налога, остају у свом тачном писаном облику; када неку од њих такође треба
изговорити наглас, додајте како се изговара поред ње уместо да је преписујете. Напишите како се изговарају необична имена
или акроними и преслушајте нове термине гласом агента пре него што их задржите.

**S4. Потврдите оно што би било скупо погрешно схватити.** Бројеви, адресе е-поште, адресе и шифре поново се читају у облику
у којем су дати, једном, у одговору одмах након што их позивалац наведе и пре следећег питања, по једна вредност при
сваком поновљеном читању. Име се подразумевано прихвата онако како је изговорено, без поновљеног читања, а агент тражи да се
име сриче само када је необично или нејасно, и то једном. Када је предузећу потребно тачно име, на пример ради подударања
са евиденцијом или за резервацију на то име, упит то наводи и агент поново сриче име. Поновљено читање пружа позиваоцу прилику да
исправи вредност, а није услов: позивалац који одговори следећим детаљем или настави без исправљања прихватио ју је, а прихваћена
вредност се више не тражи. Изузетак је број телефона на који ће предузеће позвати или послати СМС: његово поновљено читање
завршава реплику и чека одговор позиваоца. Упит који захтева читање цифру по цифру наводи само вредности које се тако читају
(број телефона, шифра); кућни број, цена, време или датум изговарају се онако како их људи обично изговарају. Упит наводи шта треба потврдити; платформа одређује темпо поновљеног читања.

## Итерације

**I1. Тестирајте пре него што задржите измену.** Поново покрените развојни скуп агента на измењеном нацрту и упоредите га са
тренутном верзијом: које је примере измена исправила, а које покварила. Читајте одговоре онако како би их позивалац чуо.
Све што би позивалац приметио је проблем, а не детаљ.

**I2. Издвојени скуп се проверава једном.** Подешавајте само на развојном скупу. Покрените тестни скуп када је измена спремна и
пријавите његов резултат онаквим какав јесте. За измену направљену након што сте видели резултате теста потребни су нови примери за тестирање.

**I3. Рефакторишите када се закрпе нагомилају.** Упит који је прикупио много малих исправки удаљава се од P1: правила се
понављају, сукобљавају или су далеко од корака који уређују. Тада га поново напишите у овај облик, задржавајући свако понашање
које захтева. Наведите свако понашање као задржано, спојено, преформулисано или уклоњено и ништа не уклањајте без навођења. Поново покрените развојни
скуп пре и после; рефакторисање треба да промени формулацију, а не понашање.

**I4. Проверите конфигурацију пре упита.** Неки неуспеси нису до упита: погрешно распознавање изговорених
слова је ограничење слушања (испробајте Plus слушање), спор одговор може бити последица нивоа интелигенције или слушања, односно подешавања завршетка говора. Искључите проблеме у конфигурацији пре поновног писања текста.
