# Персональная студия промптов

> Промпты, которые разбирают ваши разговоры, правила, которые их запускают, и как сделать их своими.

**Персональная студия промптов** — часть AI Softphone, которая разбирает ваши разговоры по-вашему. Для разбора завершённых разговоров в программе есть одиннадцать промптов; они готовы к работе, как только подключены расшифровка и языковая модель, а вы можете менять их обычными словами, копировать и добавлять свои. Они перечислены в блоке **Промпты** в [Настройки → Обработка](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md#prompts).

Ваша модель, ваш ключ, ваш контроль: подключите предпочитаемую модель со своим ключом — через поддерживаемый сервис (в России — [YandexGPT](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md#yandexgpt)) или совместимый API, — либо модель, развёрнутую внутри вашей организации. Если и [расшифровка](https://docs.ai-softphone.com/ru/ai-processing/transcription/index.md#your-own-models) идёт на вашем оборудовании, то и звук, и расшифровки остаются внутри вашей среды.

![Список промптов в Настройки → Обработка](https://docs.ai-softphone.com/screenshots/macos/ru/12b_settings_processing_prompts.png)

## Промпты, которые идут с программой {#the-prompts-that-come-with-the-program}

Код обозначает промпт в стандартном наборе; название и текст можно менять. Форма определяет, как программа хранит и показывает результат.

| Промпт | Код | Форма | Что пишет |
| --- | --- | --- | --- |
| **Содержание** | `summary` | Проза | Главное, решения и следующие шаги в одном коротком абзаце. |
| **Краткое содержание** | `super-summary` | Проза | Одна фраза до 12 слов, без точки в конце и без кавычек. |
| **Задачи** | `action-items` | Пункты | Кто что согласился сделать и когда — словами, которые были сказаны. |
| **Темы** | `topics` | Пункты | Не более шести тем, каждая в двух-трёх словах. |
| **Имена и числа** | `entities` | JSON | Имена людей, названия компаний, суммы, даты и номера, которые прозвучали. |
| **Категория** | `categorise` | Метки | Относит разговор к одной из ваших [категорий](https://docs.ai-softphone.com/ru/ai-processing/dictionaries/index.md). |
| **Метки** | `tags` | Метки | Ставит ваши [метки](https://docs.ai-softphone.com/ru/ai-processing/dictionaries/index.md), чтобы разговор потом нашёлся. |
| **Красные флаги** | `red-flags` | Флаги | Проблемы — с доказательством и временем в разговоре. |
| **Вопрос об этом разговоре** | `qa` | Ответ | Отвечает на ваш вопрос об одном разговоре по его расшифровке. |
| **Качество продажи** | `sales-quality` | Критерии | Проверяет разговор по критериям продаж, которые можно редактировать. |
| **Качество поддержки** | `support-quality` | Критерии | Оценивает, насколько хорошо проблему поняли и решили. |

Формы — это фиксированные виды ответа, благодаря которым программа может его хранить и потом искать: **Метки** — коды из одного из ваших списков, **Флаги** — коды с важностью, **Критерии** — оценка с обоснованием и оценкой по каждому критерию, **Ответ** — ответ со словами, на которых он держится. Указания, которые сообщают модели форму, хранятся в [Справочниках](https://docs.ai-softphone.com/ru/ai-processing/dictionaries/index.md#instructions).

Всего стандартный набор содержит **15 промптов: 11 для завершённых разговоров и четыре помощника суфлёра**. Помощники [суфлёра](https://docs.ai-softphone.com/ru/interface/prompter/index.md) — тоже промпты, только они выполняются на каждую реплику во время звонка, а не на законченный разговор. Они хранятся отдельным списком, в разделе [Помощники](https://docs.ai-softphone.com/ru/ai-processing/prompter/index.md#assistants) в **Настройки → Суфлёр**.

Звонки, сделанные в AI Softphone, встречи, [перехваченные](https://docs.ai-softphone.com/ru/capture/index.md) с компьютера, и импортированные записи проходят через одни и те же промпты, как только у них появляется расшифровка.

Задачи фиксируют договорённости — они не отправляют сообщений, не назначают встреч и не заводят заявок за вас.

## Как сделать своими {#making-it-yours}

- Меняйте то, о чём просит промпт, обычными словами: что искать, в каком виде отвечать и на каком языке.
- Копируйте промпт, чтобы попробовать вариант.
- Выбирайте модель для каждого промпта — на своей машине или в облаке; например, YandexGPT Lite для категорий и меток и YandexGPT Pro для содержания.
- Задавайте порядок, в котором выполняются промпты, включайте и выключайте их и ставьте условия — это делается [правилами](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md#rules): например, оценка продажи запускается только для звонков с категорией **Продажи**.
- Держите собственные категории, метки и красные флаги в [Справочниках](https://docs.ai-softphone.com/ru/ai-processing/dictionaries/index.md).
- Ограничивайте расходы [месячными лимитами](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md#spending).

Исходные промпты и правила восстанавливаются кнопкой **Восстановить по умолчанию** в блоке **По умолчанию** в [Настройки → Обработка](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md#defaults).

## Роль, задание и форма ответа {#role-and-task}

**Роль** (`system`) задаёт поведение модели: например, опираться только на стенограмму и не придумывать факты. **Задание** (`body`) объясняет, что сделать с конкретным разговором. В задание вставляются данные разговора через подстановки. Отдельные [указания из справочника](https://docs.ai-softphone.com/ru/ai-processing/dictionaries/index.md#instructions) сообщают форму ответа и язык.

Стандартные промпты обработки опираются на сказанное. Задачи не должны получать выдуманных исполнителей или сроков, а ответ на вопрос должен прямо сообщать, если нужных сведений в разговоре нет. Это инструкции модели; результат всё равно стоит сверять с расшифровкой.

## Подстановки в промптах {#placeholders}

Пишите подстановку целиком, с двойными фигурными скобками. Перед обращением к модели программа заменяет её данными.

| Подстановка | Что подставляется |
| --- | --- |
| `{{transcript}}` | Стенограмма: по одной реплике в строке, со временем в миллисекундах. |
| `{{duration}}` | Длительность разговора. |
| `{{direction}}` | Направление звонка: входящий или исходящий. |
| `{{party}}` | Собеседник: имя из адресной книги или номер. |
| `{{language}}` | Язык, на котором нужен ответ. |
| `{{question}}` | Вопрос, который задал пользователь. |
| `{{categories}}` | Справочник категорий, из которого нужно выбрать код. |
| `{{tags}}` | Справочник меток. |
| `{{red_flags}}` | Справочник красных флагов. |
| `{{artifact:summary}}` | Содержание, уже полученное по промпту `summary`. |
| `{{conversation}}` | Контекст, накопленный суфлёром по ходу разговора. |
| `{{reply}}` | Последняя реплика собеседника; используется только у суфлёра. |

Краткое содержание использует и `{{artifact:summary}}`, и `{{transcript}}`. Поэтому в стандартных [правилах](https://docs.ai-softphone.com/ru/ai-processing/processing/index.md#rules) сначала получают содержание, затем сжимают его до одной строки. Подстановки для живого разговора показаны в [шаблонах помощников](https://docs.ai-softphone.com/ru/ai-processing/prompter/index.md#assistant-templates).

## Критерии качества {#quality-criteria}

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

| Критерий | Качество продажи | Качество поддержки |
| --- | --- | --- |
| Приветствие | Представился ли оператор и назвал ли компанию? | Представился ли и уточнил ли, с кем говорит? |
| Выяснение / понимание | Выяснил ли, чего клиент на самом деле хотел? | Выяснил ли, что именно не так, прежде чем отвечать? |
| Возражения / решение | Ответил ли на то, что поднял клиент? | Решена ли проблема или назван определённый следующий шаг? |
| Ценность / тон | Объяснил ли, что получает клиент, а не только цену? | Оставался ли спокоен и вежлив, в том числе при недовольстве клиента? |
| Следующий шаг / завершение | Закончился ли разговор определённым следующим шагом? | Убедился ли, что клиент доволен, прежде чем закончить? |

Для продажи успешность сделки сама по себе не заменяет оценку по критериям. Для поддержки решение проблемы важнее приятного впечатления от беседы. Общая оценка — целое число от 1 до 5; по каждому критерию модель возвращает вердикт и короткую заметку. [Формат ответа «Критерии»](https://docs.ai-softphone.com/ru/ai-processing/dictionaries/index.md#shape-rubric) также предусматривает `n/a` — «не применимо».

## Стандартные тексты промптов {#standard-templates}

Ниже приведены роль и задание стандартного русского набора. Их можно использовать при редактировании карточки промпта. Форма ответа задаётся отдельно, как указано в таблице выше; примеры структур приведены в [Справочниках](https://docs.ai-softphone.com/ru/ai-processing/dictionaries/index.md#response-formats).

### Содержание (`summary`) {#summary}

**Роль (`system`)**

```text
Вы читаете стенограммы телефонных разговоров и пишете короткое фактическое
содержание разговора. Вы никогда не додумываете то, чего не было сказано, и
никогда не даёте советов.
```

**Задание (`body`)**

```text
Опишите этот телефонный разговор одним коротким абзацем: о чём он был, что
решили и что будет дальше. Он длился {{duration}} и был {{direction}}, с
{{party}}.

{{transcript}}
```

### Краткое содержание (`super-summary`) {#super-summary}

**Роль (`system`)**

```text
Вы читаете стенограммы телефонных разговоров и сжимаете каждую до одной
фразы. Вы не додумываете и не даёте советов.
```

**Задание (`body`)**

```text
Сожмите этот телефонный разговор до одной фразы не длиннее двенадцати слов —
такой, какая встала бы в таблице рядом с именем звонившего. Без точки в
конце, без кавычек.

{{artifact:summary}}

{{transcript}}
```

### Задачи (`action-items`) {#action-items}

**Роль (`system`)**

```text
Вы читаете стенограммы телефонных разговоров и перечисляете то, что кто-то
взялся сделать. Вы перечисляете только действительно сказанное; вы не
выдумываете ни задачу, ни исполнителя, ни срок.
```

**Задание (`body`)**

```text
Перечислите всё, что кто-либо на этом разговоре взялся сделать. Назовите,
кому это делать, если это прозвучало, и к какому сроку, если это прозвучало.
Если никто ничего не взял на себя, ответьте пустым списком.

{{transcript}}
```

### Темы (`topics`) {#topics}

**Роль (`system`)**

```text
Вы читаете стенограммы телефонных разговоров и перечисляете, о чём в них шла
речь.
```

**Задание (`body`)**

```text
Перечислите темы этого разговора, каждую в двух-трёх словах. Не более шести.

{{transcript}}
```

### Имена и числа (`entities`) {#entities}

**Роль (`system`)**

```text
Вы читаете стенограммы телефонных разговоров и выписываете из них имена,
названия и числа.
```

**Задание (`body`)**

```text
Выпишите имена людей, названия компаний, суммы, даты и номера, которые
прозвучали в этом разговоре. Только то, что было сказано.

{{transcript}}
```

### Категория (`categorise`) {#categorise}

**Роль (`system`)**

```text
Вы относите телефонные разговоры к одной из данных вам категорий. Вы
выбираете из списка и никогда не придумываете свою.
```

**Задание (`body`)**

```text
Отнесите этот разговор к одной из этих категорий:

{{categories}}

{{transcript}}
```

### Метки (`tags`) {#tags}

**Роль (`system`)**

```text
Вы помечаете телефонные разговоры метками из данного вам списка. Вы
выбираете из списка и никогда не придумываете свою метку.
```

**Задание (`body`)**

```text
Проставьте этому разговору те из этих меток, которые ему подходят. Может
подойти ни одной, может несколько.

{{tags}}

{{transcript}}
```

### Красные флаги (`red-flags`) {#red-flags}

**Роль (`system`)**

```text
Вы читаете стенограммы телефонных разговоров и поднимаете только то, что вам
велено искать. Вы приводите слова, на которых основан каждый флаг, и не
поднимаете того, что не можете процитировать.
```

**Задание (`body`)**

```text
Поднимите те из этих флагов, которые видны в разговоре. Для каждого
приведите слова, на которых он держится, и момент в миллисекундах, когда они
прозвучали. Лучше не поднять ничего, чем растянуть определение.

{{red_flags}}
{{transcript}}
```

### Вопрос об этом разговоре (`qa`) {#qa}

**Роль (`system`)**

```text
Вы отвечаете на вопросы об одном телефонном разговоре, по его стенограмме и
ни по чему больше. Если разговор об этом не говорит, вы прямо так и
говорите, а не гадаете.
```

**Задание (`body`)**

```text
{{question}}

{{transcript}}
```

### Качество продажи (`sales-quality`) {#sales-quality}

**Роль (`system`)**

```text
Вы оцениваете, как продавец провёл телефонный разговор. Вы судите только по
тому, что видно в стенограмме, никогда не предполагаете, что было до или
после неё, и одинаково строги к удавшемуся разговору и к неудавшемуся.
```

**Задание (`body`)**

```text
Оцените нашу сторону этого разговора — оператора — по этим критериям и
никаким другим:
- приветствие: представился ли он и назвал ли компанию?
- выяснение: выяснил ли он, чего клиент на самом деле хотел?
- возражения: ответил ли он на то, что клиент поднял, а не проговорил мимо?
- ценность: сказал ли он, что клиент получает, а не только сколько это
стоит?
- следующий шаг: закончился ли разговор чем-то определённым?

{{transcript}}
```

### Качество поддержки (`support-quality`) {#support-quality}

**Роль (`system`)**

```text
Вы оцениваете, как сотрудник поддержки провёл телефонный разговор. Вы судите
только по тому, что видно в стенограмме, и ставите выше то, была ли решена
проблема клиента, а не то, насколько приятным вышел разговор.
```

**Задание (`body`)**

```text
Оцените нашу сторону этого разговора — оператора — по этим критериям и
никаким другим:
- приветствие: представился ли он и уточнил ли, с кем говорит?
- понимание: выяснил ли он, что именно не так, прежде чем отвечать?
- решение: была ли проблема решена или назван определённый следующий шаг?
- тон: оставался ли он спокоен и вежлив, особенно там, где клиент не был?
- завершение: убедился ли он, что клиент доволен, прежде чем закончить?

{{transcript}}
```
