---
title: "Ръководство за стил на промптовете"
description: "Как да пишете и редактирате промпта на гласов агент на ThunderPhone: насоките, проверките при преглед на промпта и идентификаторите, които се цитират в констатациите им."
---

{/*
  ГЕНЕРИРАН ФАЙЛ: не редактирайте ръчно.
  Източник: api/agents/prompt_style_guide.md
  Генериране отново: python3 scripts/docs-freshness/generate_prompt_style_guide.py
  CI генерира отново тази страница и се проваля при разминавания
  (scripts/docs-freshness/generators.d/50-prompt-style-guide.sh).
*/}

<Note>
  Това е ръководството, спрямо което [прегледът на подкана](/api-reference/agents#review-a-prompt) проверява подкана, а
  констатациите му посочват идентификаторите по-долу. Агентите за програмиране, свързани към
  [MCP сървъра](/bg/guides/thunderphone-mcp-server), четат същия текст като ресурса
  `thunderphone://guides/prompt-style`. За шаблони и примери вижте
  [ръководството за подкани](/bg/guides/prompting).
</Note>

Това ръководство е за всеки, който пише или редактира подкана на гласов агент: човек в конструктора, Copilot или агент за програмиране,
работещ чрез API. Инструментът за преглед на подкани го използва като критерий и посочва идентификаторите на насоките му (P1, W2
и т.н.).

Обаждащият се чува агента веднъж, с темпото на говорене, и не може да превърта назад. Агентът чете подканата при всеки
ход и следва формулировката ѝ отблизо. И двата факта определят всичко по-долу.

## Структура

**P1. Напишете го така, както човек би инструктирал нова рецепционистка.** Краткото начало посочва кой е агентът и за кого
работи. След това разговорът следва реда, в който се случва: как започва, какво да се установи, какво да се потвърди,
как завършва. Всяко правило е в частта от разговора, за която се отнася. Читателят трябва да може да попита за всеки
абзац: „би ли могъл човек, който управлява този бизнес, да е написал това?“ Какво да се установи обхваща какво е необходимо на бизнеса, за да предприеме действие по
заявката, а не само кой се обажда и как да се свържете с него.

**P2. Ясни заглавия, с текст под тях.** Заглавия като „Кой сте“, „Обаждането“, „Факти“ и „Предаване“
са полезни. Структура в машинен стил не е: номерирани наръчници с правила, camelCase или заглавия, подобни на код, дълги списъци
с тирета и правила, справка за инструменти в началото и препратки като „вижте раздел 4 по-долу“. Списъците са подходящи за
данни, които агентът проверява (работно време, цени, адрес).

**P3. Начинът на говорене — веднъж и накратко.** Начинът, по който агентът говори през целия разговор (кратки реплики от първо лице,
топъл тон, ясни думи; вижте S2), се описва в един кратък абзац близо до началото. Всичко, специфично за дадена стъпка, е в
тази стъпка.

**P4. Фактите са отделно от поведението.** Работно време, цени, местоположения, правила и други факти са във фактическа част
на подканата или в база знания, а не разпръснати из потока на обаждането. Дългите каталози и често задаваните въпроси са за
база знания. Агентът може да казва само факти, които са му предоставени.

## Съдържание

**C1. Принципи и факти, а не скриптове.** Опишете какво се опитва да постигне агентът и какво трябва да
знае. Не включвайте разклонения от типа „ако обаждащият се каже X, кажете Y“, скриптирани отговори на очаквани въпроси и готови
реплики. Конфигурираният начален поздрав е единственият скриптиран елемент.

**C2. Корекцията посочва общия принцип.** Когато промяна в промпта отговаря на наблюдаван проблем, промяната добавя
общ принцип или липсващ факт, а не поправка за този конкретен случай. Спецификите на неуспешното обаждане (имената,
номерата, точните думи) не се включват в промпта.

**C3. Предпочитайте премахване пред добавяне.** Когато проблемът произтича от съществуващо правило, което е твърде конкретно, твърде общо
или поставено неподходящо, променете или премахнете това правило, вместо да добавяте контраправило до него.

**C4. Настройките определят някои неща, а не промптът.** Това са настройки на агента и текстът в промпта за тях се
игнорира или влиза в конфликт с тях: какво се казва, докато се изпълнява инструмент (начална реплика за инструмента, запълващи фрази), проверки при
мълчание и последното действие след мълчание, темпото на повторното потвърждение, стилът за превключване на езика,
уведомлението за запис и дали агентът или обаждащият се говори първи. Насочете промпта към резултата вместо това
(„потвърдете имейл адреса, преди да го запазите“) и задайте настройката. Самият начален поздрав се пише в
промпта.

**C5. Примерите са реплики, които агентът ще каже.** Агентът копира формулировките в примерите почти дума по дума, затова всеки
пример трябва да бъде пълно, естествено изговорено изречение, а няколко разнообразни примера са по-добри от един. Въведете ги като примери („Например
може да кажете ...“), а не като задължителна реплика. Съкратени етикети като „Все още ли е вярно?“ звучат кратко, когато бъдат изговорени.

**C6. Без примери от обажданията на наши клиенти.** Примерите описват типа ситуация с общи думи или
използват измислен бизнес.

**C7. Подканата е за обаждащите се, а не за разработването.** Обаждащите се чуват всичко, което пише в подканата, щом тя е активна, затова тя не включва бележки за разработване, тестване или статус на съответствие („тази версия е за тестване“, „TEST“ в името на резервация, „докато споразуменията не бъдат подписани“). Тя също не включва откази от отговорност, уточнения за отговорността и заключителни обобщения, които бизнесът не е поискал, например какво не установява приемането на план или обобщение на все още непотвърденото. Агентът отговаря на това, което обаждащият се е попитал, и спира; бизнесът добавя уточнение, когато желае такова. Липсващ факт или системно ограничение се описва като действие на агента („за цени предложете обратно обаждане от офиса“), а не като бележка, че информацията не е предоставена или за начина на записване на заявките, и не остава нищо от черновата, като случайно останало име или заглавие.

## Формулировки

**W1. Кажете какво да направи — ясно и еднократно.** Опишете желаното поведение като инструкция с обикновени думи: „Прочетете номера на поръчката обратно цифра по цифра, за да може обаждащият се да го поправи.“ Кажете го веднъж, там, където се отнася.

**W2. Без акцентиране.** Без етикети IMPORTANT, NOTE или CRITICAL, без думи с главни букви за подсилване, без удивителни
знаци, без двойки „Лошо:“ и „Добре:“, без блокове с указания какво да не се прави. Думи като „никога“, „винаги“ и „трябва“, използвани
за подсилване, също спадат тук. Акцентирането насочва вниманието на модела към едно правило и го влошава в останалата част от
обаждането. Когато агентът игнорира инструкция, направете инструкцията по-ясна, по-конкретна или по-добре поставена, а не
по-силна.

**W3. Поправете структурата, която причинява дадено поведение.** Преди да добавите правило срещу нещо, което агентът прави, открийте
формулировката или структурата, която го води натам: шаблон, който моделът попълва буквално, термин с две значения,
разклонение if-else, което бърз модел прочита неточно. Променете това.

**W4. Конкретното е по-добро от общото.** „Предложете двата най-ранни свободни часа, след това попитайте кой е подходящ“ е по-добро от „помогнете
с насрочването“. Неясните инструкции водят до неясно поведение.

**W5. Проверете, преди да питате за това.** Когато обаждащият се посочи нещо, което инструмент за търсене само за четене може да провери (продукт, поръчка, съществуваща резервация), агентът проверява с думите, които обаждащият се е дал, и задава допълнителен въпрос само ако резултатът го изисква. „Проверете наличността за продукта, който обаждащият се посочва, и му кажете какво откривате“ е по-добре от „уточнете марката, размера и варианта, след което проверете наличността“: агент, на когото е казано първо да уточнява, продължава да задава въпроси и проверката никога не се изпълнява. Това важи само за справки. Преди инструмент, който резервира, променя, отменя или запазва нещо, агентът все пак потвърждава подробностите с обаждащия се.

## Реч

**S1. По един въпрос на ход и въпросът завършва хода.** Всичко казано след въпрос се наслагва върху
отговора на обаждащия се. Поставете всяко обяснение преди въпроса.

**S2. Кратки реплики, в цели изговорени изречения.** Едно или две кратки изречения, освен ако обаждащият се не поиска подробности.
Изговорените варианти са ограничени до няколко. Кратко означава малко думи, а не откъслечни фрази: агентът говори както добър
рецепционист по телефона, с пълни изречения в първо лице, например „Ще го резервирам за Вас сега“ или
„Записах Ви за понеделник в десет.“ Фрагменти в стил бележка („Резервирам го за Вас.“, „Готово.“, „Отбелязано.“) звучат рязко,
когато се изговорят, а формулировки от имейли („Моля, имайте предвид, че ...“, „Бъдете така добри да ...“, „Надявам се това да помогне“) звучат като прочетени,
а не като казани. Абзацът в подканата за начина на говорене изисква това ясно, например: „Ограничавайте всяка реплика до
едно или две изречения и говорете в първо лице, както би говорил рецепционист по телефона.“

**S3. Пишете за слушане.** В това, което агентът казва, избягвайте markdown, символи и означения, които гласът ще прочете необичайно
(наклонени черти, амперсанди, „@“, „.com“, разделители за хиляди, телефонни номера без интервали). Фактите и стойностите, които агентът подава
към инструмент, като имейл адрес или номер на сметка, остават в точната си писмена форма; когато трябва да бъдат и
изговорени на глас, добавете до тях как се изговарят, вместо да ги пренаписвате. Посочете как се изговарят необичайни имена или
съкращения и чуйте новите термини с гласа на агента, преди да ги запазите.

**S4. Потвърждавайте това, което би било скъпо да се обърка.** Числа, имейли, адреси и кодове се повтарят във вида,
в който са предоставени, веднъж, в отговора непосредствено след като обаждащият се ги даде и преди следващия въпрос, по една стойност
при всяко повторение. По подразбиране името се приема както е казано, без повторение, а агентът иска да бъде изписано само когато е
необичайно или неясно, и пита веднъж. Когато за бизнеса е необходимо името да е точно, например за съвпадение със записите му или за
резервация под това име, подканата го посочва и агентът изписва името буква по буква. Повторението е възможност за обаждащия се да
поправи стойност, а не преграда: обаждащ се, който отговори със следващата подробност или продължи, без да я поправи, я е
приел, а приета стойност не се пита отново. Телефонен номер, на който бизнесът ще се обади или ще изпрати текстово съобщение, е
изключението: повторението му завършва репликата и изчаква отговора на обаждащия се. Подкана, която изисква прочитане цифра по цифра, посочва само стойностите, които се четат така (телефонен номер, код); номер на къща, цена, час или дата се казват по начина, по който хората ги казват. Подканата посочва какво да се потвърди; платформата определя темпото на повторението.

## Итерации

**I1. Тествайте, преди да запазите промяна.** Пуснете отново dev набора на агента върху редактираната чернова и го сравнете с текущата версия: кои примери е поправила промяната и кои е влошила. Прочетете отговорите така, както би ги чул обаждащ се. Всичко, което обаждащият се би забелязал, е проблем, а не детайл.

**I2. Контролният набор се проверява веднъж.** Настройвайте само върху dev набора. Стартирайте тестовия набор, когато промяната е готова, и отчетете резултата му без изменения. Промяна, направена след преглед на тестовите резултати, изисква нови тестови примери.

**I3. Рефакторирайте, когато корекциите се натрупат.** Подкана, която е събрала много малки поправки, се отклонява от P1: правилата се повтарят, противоречат си или са далеч от стъпката, която управляват. Тогава я пренапишете в този вид, като запазите всяко изискано поведение. Избройте всяко поведение като запазено, обединено, преформулирано или премахнато и не премахвайте нищо без отбелязване. Пуснете отново dev набора преди и след това; рефакторирането трябва да променя формулировката, а не поведението.

**I4. Проверете конфигурацията преди промпта.** Някои неуспехи не се дължат на промпта: неправилното чуване на изписани букви е ограничение на разпознаването (опитайте Plus разпознаване), а бавният отговор може да се дължи на нивото на интелигентност или разпознаване, или на настройката за endpointing. Изключете проблеми с конфигурацията, преди да пренаписвате текста.
