> For the complete documentation index, see [llms.txt](https://help.novatalks.com.ua/ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.novatalks.com.ua/ua/get-started/settings/macros/macroses-ai.md).

# Макроси AI

В NovaTalks макроси AI можна використовувати:

* як помічник для агента, коли необхідно виправити помилки, перефразувати відповідь, перекласти на іншу мову, змінити тон повідомлення, підсумувати діалог тощо

{% embed url="<https://www.youtube.com/watch?v=DxbyQWmCXdI&t=14s>" %}

* як масові функції, які дозволять оцінити діалоги по вашим критеріям, перевірити на відповідність скрипту, визначити емоції клієнта і все, що тільки придумаєте.

{% embed url="<https://www.youtube.com/watch?v=8Lymo_Yzgog>" %}

В макросах NovaTalks створені стандартні ТОП функцій запитів до AI:&#x20;

* ai\_rephrase\_message - перефразувати відповідь
* ai\_fix\_grammar\_message - виправити помилки
* ai\_shorten\_message - скоротити повідомлення
* ai\_expand\_message - розширити повідомлення
* ai\_friendly\_tone\_message - змінити тон повідомлення на дружній
* ai\_formal\_tone\_message - змінити тон повідомлення на офіційний
* ai\_translate\_en\_message - перевести повідомлення на англійську
* ai\_summarize\_dialog - підсумувати діалог
* ai\_reply\_suggestion - пропозиція відповіді

Дані макроси можна редагувати або створювати свої.

{% hint style="success" %}
Для створення власних макросів АІ рекомендуємо скопіювати існуючий макрос та змінити текст в полі command.

За потреби можна редагувати стандартні макроси AI. Але для коректної відправки запиту рекомендуємо змінювати лише текст команди в полі command, інші параметри залишати без змін
{% endhint %}

{% hint style="info" %}
Для того, щоб агент міг використати макрос AI в процесі спілкування з клієнтом, необхідно додати його у вигляді кнопки на робоче місце агента (детальніше - [Налаштування кнопок](/ua/get-started/settings/account-settings.md#buttons)) та налаштувати інтеграцію з OpenAI (детальніше - [OpenAI](/ua/get-started/settings/integrations/ai.md)).
{% endhint %}

***

## Типові налаштування <a href="#common-settings" id="common-settings"></a>

В кожному макросі є такі типові налаштування:

<figure><img src="/files/VddPHjUILtUcFOuBdv3b" alt=""><figcaption></figcaption></figure>

1. **Надіслати користувацьку подію** - custom.send\_to\_ai з наступними змінними:

* send\_content\_type - тип контену, який необхідно відправити до AI. Можливі значення:

message - введений текст в полі відповіді

dialog - переписка в рамках діалогу

* command - текст команди до AI

{% hint style="success" %}
При створенні AI макросу у текст команди можна прописати умови, за якими необхідно оцінити діалог,  зазначивши назви та значення користувацьких змінних, які мають бути повернуті відповідно до заданих умов. Наприклад:

*Please set the next variables based on the following conditions:*

1. *Cross-Selling:*

*ai.reply.crossel = yes - If the customer orders goods and the agent proposes additional goods to buy.*

*ai.reply.crossel = no - If the customer orders goods but the agent does not propose additional goods.*

*ai.reply.crossel = n/a  - If the customer does not order goods.*

2. *Guarantee Offering:*

*ai.reply.guarantee = yes - If the customer orders goods and the agent proposes to buy a guarantee.*

*ai.reply.guarantee = no - If the customer orders goods but the agent does not propose a guarantee.*

*ai.reply.guarantee = n/a - If the customer does not order goods.*

У відповідь AI поверне перелік змінних та їх значення.&#x20;

Дана функція може бути корисною, наприклад, якщо необхідно оцінити або перевірити діалог на відповідність скрипту.&#x20;
{% endhint %}

* інші додаткові параметри - потрібні, якщо відповідь AI містить користувацькі змінні, які потрібно розпарсити. Додавати такі змінні необхідно у форматі:&#x20;

**Ключ** – назва змінної,&#x20;

**Значення**– json\_param.&#x20;

2. Текст відповіді від AI **додати до:**

* приватна нотатка розмови - приватна нотатка розмови (з відправкою в розмову), в рамках якої було запущено макрос
* вікна Відповісти розмови - вікно Відповіді розмови, в рамках якої було запущено макрос (без відправки в розмову)
* нотатка діалогу - нотатка діалогу (із збереженням в нотатку), в рамках якої було запущено макрос&#x20;
* кастомні атрибути розмови (лише текстові)
* кастомні атрибути контакту (лише текстові)

{% hint style="info" %}
Якщо відповідь від АI містить користувацькі змінні, в **Додати до** їх необхідно прописувати в форматі - {{ai.reply.name}}, де name - назва вашої змінної.&#x20;
{% endhint %}