> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ukrgsm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Як писати промпти: коротко

> Прості правила написання промптів для голосового агента — без технічних термінів, для будь-якого користувача.

Промпт — це інструкція для агента: що він має зробити на цьому кроці розмови. Він пише його не для абонента, а для себе — абонент чує лише готові фрази, які ви написали окремо (репліки переходу й привітання).

Уявіть, що ви пояснюєте нового співробітника, як діяти рівно на цьому одному кроці розмови — не на весь дзвінок, а саме тут.

## 5 правил

**1. Пишіть просто й українською.**
Так, ніби пояснюєте колезі. Без канцеляриту, без зайвих слів.

**2. Один промпт — один крок.**
Не описуйте весь дзвінок у промпті одного вузла. Кожен вузол відповідає лише за свою частину розмови.

**3. Кажіть, що саме перевірити.**
Замість «зрозумій клієнта» напишіть, що саме потрібно розпізнати: погоджується оплатити, просить час, чи заперечує борг.

**4. Якщо агент лише обирає напрямок — скажіть це прямо.**
Багато кроків не вимагають, щоб агент щось казав від себе — весь текст, який почує абонент, уже написаний заздалегідь у переходах. У таких випадках прямо напишіть у промпті: *«Нічого не кажи вголос — лише визнач, куди рухатись далі»*.

**5. Перелічіть варіанти — і перевірте їх кількість.**
Якщо з вузла виходить, наприклад, три стрілки (переходи), у промпті мають бути перелічені рівно три варіанти — не два, не чотири. Якщо агент постійно обирає «не той» варіант — найчастіша причина саме в цьому: варіантів у промпті менше, ніж стрілок з вузла.

## Приклад

<CodeGroup>
  ```text Так не треба theme={null}
  Поговори з клієнтом про оплату.
  ```

  ```text Так треба theme={null}
  Проаналізуй відповідь співрозмовника щодо готовності оплатити
  заборгованість. Нічого не кажи вголос — лише визнач, який варіант
  підходить:
  - готовий сплатити зараз;
  - просить розстрочку;
  - заперечує заборгованість;
  - просить більше часу подумати.
  ```
</CodeGroup>

Другий варіант працює надійно, бо каже, що саме аналізувати, забороняє вільну відповідь і дає точний список — по одному варіанту на кожну стрілку з цього вузла.

## Типові помилки

* **Загальні фрази.** «Допоможи клієнту», «відповідай ввічливо» — це надто розпливчасто, агент не зрозуміє, що саме зробити на цьому кроці.
* **Варіантів у промпті менше або більше, ніж стрілок з вузла.** Перевіряйте це щоразу, коли додаєте чи видаляєте перехід.
* **Спільні правила в кожному вузлі.** Тон спілкування, заборонені теми, назва компанії — це пишеться один раз у [Глобальному вузлі](/voice-agent/global), а не повторюється в промпті кожного кроку.
* **Забутий Publish.** Промпт зберігся, але дзвінки досі йдуть за старою версією — після редагування завжди тисніть **Publish**, а не тільки **Save**.

## Далі

<CardGroup cols={2}>
  <Card title="Вузол агента" href="/voice-agent/agent">
    Детальніше про поля вузла — умови переходів, інструменти, видобування змінних.
  </Card>

  <Card title="Глобальний вузол" href="/voice-agent/global">
    Куди виносити спільні правила, щоб не повторювати їх у кожному промпті.
  </Card>
</CardGroup>