> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/types-of-agents/golosovoi-agent/principy-sostavleniya-promptov-dlya-golosovykh-agentov.md).

# Принципы составления промптов для голосовых агентов

Промпт для голосового агента пишется под живой разговор в реальном времени. В отличие от переписки, где клиент видит текст и может его перечитать, в звонке реплика воспринимается на слух, один раз и последовательно. А ещё агент формирует ответ прямо во время разговора — и это накладывает свои требования уже на этапе написания инструкции.

Ниже — основные правила и советы, как составить голосовой промпт с нуля.

{% hint style="info" %}
При переключении агента в режим **«Голос»** стиль ответов адаптируется автоматически. Прописывать стилевые правила вручную не нужно — сосредоточьтесь на содержании инструкции. Подробнее об общей настройке — в статье [Голосовой агент](/ru/types-of-agents/golosovoi-agent.md). 
{% endhint %}

### Держите промпт компактным — от этого зависит скорость ответа

Это главное правило для голоса. Агент генерирует каждую реплику на лету, во время разговора. Чем объёмнее и сложнее инструкция, тем дольше модель обрабатывает её перед ответом — а в звонке это превращается в заметные паузы и ощущение, что агент «завис».

Поэтому:

* оставляйте только то, что действительно нужно для разговора;
* убирайте повторы, длинные объяснения и правила «на всякий случай»;
* не дробите одну мысль на десяток отдельных пунктов.

Короткий, сфокусированный промпт — это быстрый и живой разговор.

### Не прописывайте стиль ответов вручную

Короткие ответы по одному предложению, отсутствие списков и абзацев, паузы через пунктуацию, разговорные обороты, аккуратное обращение по имени, живые реакции на small talk и жалобы — всё это платформа добавляет сама при переходе в режим «Голос».

Дублировать эти правила в своей инструкции не нужно: это не улучшит поведение, но увеличит объём промпта и замедлит ответы (см. правило выше). В своём тексте описывайте **содержание**: кто агент, какую задачу решает и как ведёт разговор.

### Выносите справочную информацию в базу знаний

Прайсы, каталоги, условия, длинные FAQ и любые справочные данные не должны жить в системном промпте. Их место — в [базе знаний](/ru/baza-znanii/baza-znanii.md): агент подтянет нужный фрагмент в момент, когда клиент об этом спросит.

Это сразу даёт два плюса:

* промпт остаётся компактным, а значит, быстрым;
* данные можно обновлять, не трогая инструкцию.

Простое правило: в промпте — логика разговора, в базе знаний — факты.

### Пишите промпт как сценарий разговора

Голосовой диалог линеен: клиент слышит речь на слух и удерживает по одной мысли за раз. Инструкцию тоже стоит строить как последовательный сценарий, а не как свод разрозненных правил:

* ведите клиента по шагам — одна цель на один этап;
* задавайте по одному вопросу за реплику;
* формулируйте логику как «сначала … потом … затем …».

Так агенту проще держать нить разговора, а клиенту — за ней следовать.

### Закладывайте ошибки распознавания речи

Речь клиента распознаётся не идеально — особенно имена, адреса, номера телефонов и email. Учтите это в промпте:

* при неуверенности агент переспрашивает и уточняет;
* важные данные (номер, дату записи, адрес) агент проговаривает для подтверждения;
* критичные решения не принимаются по одному нечётко распознанному ответу.

### Пунктуация задаёт ритм речи

В голосовом промпте знаки препинания — это инструмент «режиссуры» произношения, а не только грамматика:

* **Точка — это пауза.** Используйте её там, где в живой речи агент сделал бы остановку.
* **Вопрос всегда заканчивается знаком «?».** Иначе интонация вопроса не считывается.
* **Диктовка email или логина — исключение.** Здесь дробление и точки уместны, чтобы клиент успел записать.
* **Если клиент просит «помедленнее» или «с паузами»** — можно ставить точки между словами или буквами, чтобы искусственно замедлить речь.

### Естественность: филлеры и разговорный стиль

Живой человек не говорит «протокольными» фразами. Немного разговорных слов делают агента естественнее:

* Уместные филлеры: «так», «ну», «смотрите», «угу», «ага».
* Реплику можно начать с «Так…», «Окей», «Ну смотрите» — как в обычном разговоре.
* Не злоупотребляйте: филлеры нужны для естественности, а не для заполнения пауз.

### Продумайте числа, даты и специальные форматы

Базовые правила произношения цифр уже заданы служебной инструкцией агента. Но если в вашем сценарии есть специфические термины, аббревиатуры, названия или форматы — артикулы, VIN, промокоды, — добавьте короткую подсказку, как их произносить или диктовать: по буквам, с паузами, с повтором.

### Определите цель звонка и момент завершения

Пропишите, чего агент должен добиться в разговоре (записать, подтвердить, собрать данные) и когда его корректно завершить. Без явного «финала» агент может затягивать звонок и не доводить клиента до результата.

### Проверяйте тестовым звонком

Лучший способ отладки голосового промпта — послушать. Сделайте тестовый звонок от лица агента, оцените темп, длину пауз и естественность речи, и правьте инструкцию по услышанному. Часто именно на слух становится понятно, где промпт слишком длинный или где не хватает шага в сценарии.

### Готовый блок стиля (шаблон) 

Этот блок можно вставить в инструкцию голосового агента и  адаптировать под свою задачу:

{% code overflow="wrap" %}

```
#СТИЛЬ И СТРУКТУРА ОТВЕТОВ /-/ЧТОБЫ АГЕНТ ОТВЕЧАЛ МАКСИМАЛЬНО ЕСТЕСТВЕННО НИЖЕ ПРЕДУСМОТРЕНЫ СПЕЦИАЛЬНЫЕ ПРАВИЛА/-/
- Отвечай от женского лица.
- Имя клиента используй только один раз после знакомства или в редкой уместной эмпатии, не начинай с него ответ и не используй снова, пока не прошло 3 твоих ответа без имени.
- Общайся дружелюбно, естественно и профессионально.
- Обращайся к собеседнику на Вы (только, если клиент не предложит перейти на Ты сам).
- Запрещено выводить маркированные списки.
- Весь текст должен быть сплошным, запрещено разделять его на абзацы.
- Всегда ответы должны состоять ТОЛЬКО из 1 предложения. ЗАПРЕЩЕНО чтобы в ответе было больше 1 предложения — разделяй информацию и смыслы только запятыми и длинными тире, только если не диктуешь email или логин — там можно. Например, не правильно: "Очень приятно, Антон! Вы находитесь на конференции amoConf?", правильно "Очень приятно, Антон, вы находитесь на конференции amoConf?".
- Предложение не должно быть больше 15 слов. Если клиенту нужно больше информации выдавай ее последовательно.
- Каждый вопрос заканчивай знаком вопроса. Используй точку для пауз.
- Когда клиент просит отвечать с паузами используй знак точку между буквами или словами.
- Используй разговорный стиль и филлеры максимально естественно: «так», «ну», «смотрите», «угу», «ага».
- Можно начать реплику с «Так...», «Окей», «Ну смотрите» — как живой человек, но не злоупотребляй — филлеры для естественности, не для заполнения пауз.
- SMALL TALK: Поддержи 1 репликой — верни к делу.
- СТРАННЫЙ ВОПРОС: Живая реакция — верни к делу.
- КЛИЕНТ ЖАЛУЕТСЯ: Коротко посочувствуй — «Давайте хотя бы это решим».
- ДЛИННАЯ ИСТОРИЯ: Слушай, не перебивай; при паузе — мягко верни к делу.
- Если клиент задает вопросы — обращайся к базе знаний.
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.suvvy.ai/ru/types-of-agents/golosovoi-agent/principy-sostavleniya-promptov-dlya-golosovykh-agentov.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.