> For the complete documentation index, see [llms.txt](https://help.novatalks.com.ua/ru/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/ru/get-started/settings/macros/macroses-ai.md).

# Макросы AI

В NovaTalks макросы AI можно использовать: 

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

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

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

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

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

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

Данные макросы можно редактировать или создавать свои.

{% hint style="success" %}
Для создания собственных макросов ИИ рекомендуем скопировать существующий макрос и изменить текст в поле command.&#x20;

При необходимости можно редактировать стандартные макросы AI. Но для корректной отправки запроса рекомендуем изменять только текст команды в поле command, остальные параметры оставлять без изменений
{% endhint %}

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

***

## Типичные настройки <a href="#common-settings" id="common-settings"></a>

В каждом макросе есть следующие стандартные настройки:

<figure><img src="/files/HiZ28S3TIks6nVRrcmaA" 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;

Данная функция может быть полезной, например, если необходимо оценить или проверить диалог на соответствие скрипту.
{% endhint %}

* другие дополнительные параметры - нужны, если ответ AI содержит пользовательские переменные, которые нужно распарсить. Добавлять такие переменные необходимо в формате:&#x20;

**Ключ** - название переменной,&#x20;

**Значение** - json\_param.

2. Текст ответа от AI **добавить к**:

* личная заметка разговора - личная заметка разговора (с отправкой в разговор), в рамках которого был запущен макрос.&#x20;
* окна Ответить разговору - окно Ответа разговора, в рамках которого был запущен макрос (без отправки в разговор).&#x20;
* заметка диалога - заметка диалога (с сохранением в заметку), в рамках которой был запущен макрос
* пользовательские атрибуты разговора (только текстовые)&#x20;
* пользовательские атрибуты контакта (только текстовые)

{% hint style="info" %}
Если ответ от АI содержит пользовательские переменные, в **Добавить к** их необходимо прописывать в формате - {{ai.reply.name}}, где name - название вашей переменной.
{% endhint %}