# Довідники

> Ваші власні категорії, мітки й червоні прапорці — слова, за якими впорядковано ваші розмови.

**Налаштування → Довідники** містять слова, до яких можна віднести розмову, якими її можна позначити або через які її можна відзначити як проблемну. Ці списки показують моделям, і саме з них моделі мусять вибирати, тож відповідь завжди буде тим, що ви згодом зможете знайти.

![Налаштування → Довідники](https://docs.ai-softphone.com/screenshots/macos/uk/13_settings_dictionaries.png)

**Показувати видалені** показує записи, які ви видалили.

Кожен запис — це назва, короткий код дрібним шрифтом і опис, який підказує моделі, коли його вибирати. Саме код зберігається і саме його повертає [REST API](https://docs.ai-softphone.com/uk/integration/rest-api/index.md#taxonomy-and-settings), тож він лишається тим самим, коли ви перейменовуєте запис.

## Категорії {#categories}

Про що була розмова; **на розмову вибирають одну**. Програма починає з чотирьох:

| Назва | Код | Для чого |
| --- | --- | --- |
| **Продажі** | `sales` | Продаж, пропозиція, перемовини чи доведення покупки до кінця — зокрема й клієнт, який питає, скільки щось коштує. |
| **Підтримка** | `support` | Допомога комусь із товаром чи послугою, які він уже має: несправність, питання про користування, скарга на те, як воно працює. |
| **Особиста** | `personal` | Зовсім не робоча — приватна розмова, що випадково відбулася на цій лінії. |
| **Інше** | `other` | Робоча, але ані продаж, ані підтримка: постачальник, колега, доставка, помилковий номер. Виберіть це, замість вгадувати між іншими. |

Натисніть **Додати**, щоб додати власну категорію.

## Мітки {#tags}

Позначки, *які всі можуть бути правдиві про ту саму розмову*. Натисніть **Додати**, щоб додати мітку. Список починається з таких записів:

| Назва | Код | Для чого |
| --- | --- | --- |
| **Обіцяно передзвонити** | `callback` | Хтось у цьому виклику пообіцяв передзвонити або попросив передзвонити йому. |
| **Скарга** | `complaint` | Інша сторона висловила невдоволення, незалежно від того, чи це владнали. |
| **Передано вище** | `escalation` | Виклик передали комусь іншому, або інша сторона про це попросила. |
| **Клієнт VIP** | `vip` | З іншою стороною поводилися як з важливим клієнтом, або вона сама так про себе сказала. |

## Червоні прапорці {#red-flags}

Те, що потребує уваги, знайдене в розмові разом із доказом і часом, — наприклад, *Розлючений клієнт* або *Ризик відходу*. Червоні прапорці намальовано червоним у [вікні Записи](https://docs.ai-softphone.com/uk/interface/recordings/index.md), і кожен має рівень серйозності: низький, середній або високий.

| Назва | Код | `severity` | Для чого |
| --- | --- | --- | --- |
| **Розлючений клієнт** | `angry-customer` | `high` | Було чути, що інша сторона розлючена, ображає або погрожує піти. |
| **Ризик відходу** | `churn-risk` | `high` | Ішлося про припинення, непродовження чи перехід до когось іншого, хоч би як спокійно. |
| **Дана обіцянка** | `promise-made` | `medium` | Наша сторона зобов'язалася щодо чогось конкретного — дати, ціни, ремонту, повернення грошей. |
| **Чутливі дані** | `sensitive-data` | `high` | Уголос прочитано номер картки, пароль, номер документа чи будь-що інше, чого в запису бути не повинно. |
| **Конкурент** | `competitor` | `low` | Інша сторона назвала когось іншого, хто пропонує те саме, або порівняла нас із ним. |

## Вказівки {#instructions}

![Налаштування → Довідники: форми відповіді та інструкції щодо мови](https://docs.ai-softphone.com/screenshots/macos/uk/13b_settings_dictionaries_scrolled.png)

*Те, що додається до кожної вказівки про форму відповіді і мову, якою її писати.* Їх зберігають тут, щоб кожна вказівка могла використовувати те саме формулювання, і ви можете змінювати їх, як і будь-який інший запис, — або написати власні, наприклад *відповідай коротко* чи *ніколи не називай ціну*, і позначити їх у **Надсилати також** у будь-якій вказівці.

| Назва | Код | Що каже моделі |
| --- | --- | --- |
| **Проза** | `shape-plain` | Відповідати звичайною прозою, без JSON, списків і заголовків. |
| **Пункти** | `shape-list` | Відповідати списком справ, кожна з тим, хто і коли. |
| **Мітки** | `shape-labels` | Відповідати в JSON списком кодів і тим, наскільки модель упевнена в кожному, використовуючи лише коди з наданого їй списку. |
| **Оцінка** | `shape-score` | Відповідати оцінкою, її обґрунтуванням і словами, на яких вона ґрунтується. |
| **Критерії** | `shape-rubric` | Відповідати загальною оцінкою та оцінкою за кожним критерієм. |
| **Сигнали** | `shape-flags` | Відповідати кодами зі списку, кожен із рівнем серйозності. |
| **Відповідь** | `shape-qa` | Відповідати по суті або прямо казати, що в розмові про це не йдеться, і наводити слова, на які спирається відповідь. |
| **JSON** | `shape-json` | Відповідати лише JSON у формі, запитаній вище. |
| **Як говорили** | `language-as-spoken` | Писати тією мовою, якою велася розмова. |
| **Як говорили, названо** | `language-as-spoken-named` | Те саме, з назвою мови. |
| **Названа мова** | `language-named` | Писати мовою, яку ви назвете. |

**Додати** на початку списку додає запис.

## Типові {#defaults}

**Відновити типові** повертає кожен довідник до того вигляду, у якому він прийшов з програмою, поточною мовою інтерфейсу. Те, до чого вже віднесено ваші розмови, лишається недоторканим.

## Формати відповідей {#response-formats}

Блоки відтворюють вбудовані інструкції. Вони описують формати відповідей; альтернативи є способом запису, а не виконуваними прикладами JSON.

### Проза (`shape-plain`) {#shape-plain}

```text
Відповідайте звичайною прозою. Не вживайте JSON, списків чи заголовків.
```

### Пункти (`shape-list`) {#shape-list}

```text
Відповідайте лише JSON, саме такого вигляду:
{"items": [{"text": "що треба зробити", "owner": "хто, або порожньо", "due": "коли, або порожньо"}]}
Коли переліковувати нічого, використайте порожній масив. Не пишіть нічого поза JSON.
```

### Мітки (`shape-labels`) {#shape-labels}

```text
Відповідайте лише JSON, саме такого вигляду:
{"labels": [{"code": "код зі списку, який вам дали", "confidence": 0.0}]}
Вживайте лише коди зі списку. Коли жоден не підходить, використайте порожній
масив. Не вигадуйте коду і не пишіть нічого поза JSON.
```

### Оцінка (`shape-score`) {#shape-score}

```text
Відповідайте лише JSON, саме такого вигляду:
{"score": 3, "rationale": "чому це число, а не на одиницю більше",
 "evidence": [{"at_ms": 0, "quote": "слова, на яких це стоїть"}]}
Оцінка — ціле число від 1 до 5. Не пишіть нічого поза JSON.
```

### Критерії (`shape-rubric`) {#shape-rubric}

```text
Відповідайте лише JSON, саме такого вигляду:
{"overall": 3, "rationale": "чому це число, а не на одиницю більше",
 "criteria": [{"name": "критерій так, як вам його дали",
               "verdict": "pass" або "weak" або "fail" або "n/a",
               "note": "одне речення"}]}
Оцініть кожен даний критерій і жодного іншого. Загальна оцінка — ціле число
від 1 до 5. Не пишіть нічого поза JSON.
```

### Сигнали (`shape-flags`) {#shape-flags}

```text
Відповідайте лише JSON, саме такого вигляду:
{"flags": [{"code": "код зі списку, який вам дали",
            "severity": "low" або "medium" або "high",
            "evidence": "слова, на яких це стоїть",
            "at_ms": 0}]}
Вживайте лише коди зі списку і піднімайте кожен щонайбільше раз. Коли не
підходить нічого, використайте порожній масив. Не пишіть нічого поза JSON.
```

### Відповідь (`shape-qa`) {#shape-qa}

```text
Відповідайте лише JSON, саме такого вигляду:
{"answer": "ваша відповідь або прямо те, що розмова цього не каже",
 "citations": [{"at_ms": 0, "quote": "слова, на яких стоїть відповідь"}]}
Не відповідайте ні з чого, крім розмови. Не пишіть нічого поза JSON.
```

### JSON (`shape-json`) {#shape-json}

```text
Відповідайте лише JSON, у вигляді, попрошеному вище. Не пишіть нічого поза JSON.
```

### Як говорили (`language-as-spoken`) {#language-as-spoken}

```text
Пишіть відповідь тією самою мовою, якою була розмова.
```

### Як говорили, названо (`language-as-spoken-named`) {#language-as-spoken-named}

```text
Пишіть відповідь тією самою мовою, якою була розмова, а саме: {language}.
```

### Названа мова (`language-named`) {#language-named}

```text
Пишіть відповідь цією мовою: {language}.
```
