# Макроси 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 %}


---

# Agent Instructions: 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:

```
GET https://help.novatalks.com.ua/ua/get-started/settings/macros/macroses-ai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.