> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/osnovnye-nastroiki/dopolnitelnye-nastroiki.md).

# Дополнительные настройки

Описание дополнительных настроек

После того, как прописали основные **Инструкции Агента**, ввели **Название Агента** и настроили **Время ожидания в секундах**, можем переходить к дополнительным настройкам. Для этого перейдите во вкладку **Доп.настройки:**

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

Перед Вами развернётся меню с рядом **дополнительных вкладок настроек**:

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

## Параметры LLM

### Выбор языковой модели

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

При нажатии на поле **"Языковая модель"** откроется список доступных для подключения моделей.

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

Выбор модели оформлен таким образом, чтобы было возможным сравнить имеющиеся варианты по ключевым показателям.\
**Качество** - взвешенная оценка работы модели.\
**Тип** - показывает основные особенности модели, является ли модель думающей, принимает ли изображения для обработки, на каком уровне выполняет математические операции.\
**Стоимость** - средняя стоимость модели в сравнении с другими моделями.

{% hint style="info" %}
Обратите внимание, если у модели активна иконка обработки изображений, это означает, что она принимает изображения напрямую, если иконка неактивна, то модель будет работать с изображениями через внутренний механизм обработки изображения на платформе, который передаст в модель только описание изображения, прямой обработки изображения не будет.
{% endhint %}

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

Флаг **"Указать языковую модель для тестового чата"** позволяет выбрать отдельную модель для тестового чата в кабинете Савви. Таким образом, Вы можете, например, сравнить работу моделей в одном агенте.

### Параметры ответа

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

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

**Максимальное количество токенов в ответе агента** - определяет максимальный ответ, который может быть обработан от модели, при превышении лимита в диалоге отобразиться ошибка. В большинстве случае не требует изменений, но в ряде моделей с размышлениями значение необходимо увеличить, значение подбирается опытным путем.

**Лимит параллельного вызова функций** - если сценарий работы агента подразумевает выполнение большого количества функций, то в некоторых случаях превышение лимита в 10 вызовов приведет к ошибке, если результат выполнения каждой следующей не зависит от результата предыдущей, в этом случае лучше увеличить лимит параллельного вызова, после чего функции будут вызваны параллельно, и не выйдет ошибка последовательного вызова. Дополнительно, это позволит уменьшить стоимость диалога, поскольку вызов всех функций будет осуществлен в рамках одного обращения к модели.

### Структурированный ответ

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

**Использовать структурированный ответ** - позволяет отправлять большой ответ, содержащий изображения, разбивая его на отдельные сообщения. Более подробно можно ознакомиться с функционалом в отдельной инструкции [Структурированные ответы (отправка картинок агентом)](/ru/osnovnye-nastroiki/dopolnitelnye-nastroiki/strukturirovannye-otvety-otpravka-kartinok-botom.md).

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

## Параметры ответов

## Креативность агента

<figure><img src="/files/52zWfR8YUI8XQRGMVy1e" alt=""><figcaption></figcaption></figure>

*Соответствие режима значению температуры:*

* **Стабильность** - *0 (менее креативен, больше отвечает по заранее заготовленному тексту)*
* **Сбалансированность** - *10 (В сбалансированном режиме чат-бот сочетает точность с лёгкой долей креативности. Этот режим подходит для общения, где требуется и ясность, и немного гибкости)*
* **Креативность** - *20 (более разнообразные и креативные ответы)*

### История сообщений (контекст)

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

> **Передавать историю сообщений** - этот параметр отвечает за то, сколько последних сообщений передаётся в модель для обработки. Другими словами - сколько последних сообщений **запоминает агент**.
>
> * **Не передавать историю** - в этом случае агент будет работать в режиме ***Вопрос-Ответ***.
> * **Передавать всю историю** - весь диалог за всё время будет передан в модель. Модель будет лучше понимать контекст разговора, но это увеличит расход токенов, а в некоторых ситуациях, может привести и к ухудшению понимания контекста.\
>   \
>   Например, в бьюти-сфере, когда клиент записывается на услугу раз в месяц и задаёт одни и те же вопросы с определённой периодичностью. В этом случае мы рекомендуем ограничивать контекст истории по времени.
> * **Передавать историю за Х сообщений** - это значит, что в памяти агента будет храниться определённое количество сообщений, которое задаётся пользователем.
> * **Передавать историю за Х минут** - это значит, что в памяти агента будет храниться история сообщений только за определённое время.

### Маскирование персональных данных

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

Подробно о **Маскировании персональных данных** Вы можете прочитать по [<mark style="background-color:blue;">ссылке</mark> ](#maskirovanie-personalnykh-dannykh).

### Условия прерывания диалога

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

> * **Не отвечать при прерывании диалога человеком** - в случае, когда сотрудник вмешивается в диалог в зависимости от канала из которого поступает обращение, агент будет переставать отвечать.
> * **Фразы по которым будет срабатывать принудительное прерывание диалога** - в случае, если в диалоге прозвучит данная фраза (от сотрудника или клиента), агент перестанет отвечать и передаст диалог человеку (администратору). Бывают ситуации, когда сотрудник пишет в конечном канале и СРМ-системы не всегда распознают это сообщение, как сообщение от сотрудника. В этом случае, данная настройка помогает приостановить диалог из конечного канала.
> * **Игнорировать первые сообщения от сотрудника** - используется, если для начала диалога предусмотрена рассылка.
> * **Фразы по которым прерывание срабатывать не будет -** используется, если, например, в середине диалога у Вас происходит рассылка или подтверждение записи, и надо, чтобы агент не останавливался, а продолжал общение. *В этом случае, надо прописать текст рассылки.*

{% hint style="warning" %}
Обратите внимание, что ***Прерывание по контрольной фразе*** работает только тогда, когда отправленная фраза совпадает с прописанной точь-в-точь.
{% endhint %}

### Условия возобновления диалога

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

> * **Возвращение управления агенту после прерывания** - настройка, которая позволяет возобновить общение агента спустя установленное время.
> * **Время возвращения управления агенту в минутах** - время, через которое агент снова возобновит своё общение после прерывания.
> * **Фразы для возобновления -** фразы, после которых агент включится снова в работу.

{% hint style="warning" %}
Обратите внимание, что ***Возобновления*** ***по контрольной фразе*** работает только тогда, когда отправленная фраза совпадает с прописанной точь-в-точь.
{% endhint %}

### Игнорирование сообщений покупателя

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

Данная настройка служит для того, чтобы агент игнорировал фразы клиента.

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

### Распознавание изображений

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

> Этот раздел настроек позволяет управлять процессом распознавания изображений агентом. Вы можете выбрать один из режимов работы с изображениями:
>
> * **Выключено** — модель не будет распознавать изображения.
> * **Передавать в модель напрямую** — продвинутый режим, когда модель распознаёт изображения без возврата текста и сразу понимает смысл изображения.

<figure><img src="/files/8v25EzXqgjetvc9ftldx" alt=""><figcaption></figcaption></figure>

> * **Всегда —** в этом режиме агент всегда будет распознавать изображения и при этом действовать согласно прописанной инструкции под выпадающим списком.

<figure><img src="/files/4HagjLAYja8mdefR2SPW" alt=""><figcaption></figcaption></figure>

> * **Если не найдено в БЗ —** в данном режиме агент будет в первую очередь искать совпадение изображения в БЗ. В случае, если совпадений не будет найдено, агент будет действовать согласно прописанной инструкции под выпадающим списком.

### Нераспознанные сообщения

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

> В некоторых каналах могут приходить служебные сообщения или сообщения, которые агент не сможет обработать. На этот случай предусмотрена данная настройка, которая позволяет прописать текст сообщения, который будет отправляться в случае получения нераспознанного сообщения.

### Разделение ответа от агента

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

> Разбивка ответа агента на несколько сообщений в зависимости от выбора настроек.

*Как настроить?*

> 1. Выбираем тип разделения ответов.
> 2. Устанавливаем размер чанка (количество предложений/параграфов) одной части разделённого ответа.
> 3. Выставляем задержку между отправками сообщения в секундах.

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

{% hint style="warning" %}
Задержка между сообщениями происходит при отправке в подключенный канал. Это значит, что в тестовом чате Савви сообщение появится сразу после генерации ответа LLM моделью. Проверить работу задержки можно при запросе из подключенного канала.
{% endhint %}

### Сообщения до и после

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

> Это текст, который будет отправлен ***До*** и/или ***После*** сообщения от нейросети. Например, можно использовать для подписи, что это агент.

**Например:**\
Агент ответил фразой

<pre><code><strong>Добрый день, чем я могу Вам помочь?
</strong></code></pre>

А в канал *(и соответственно конечному клиенту)* будет **отправлено**:

```
Сообщение от агента:

Добрый день, чем я могу Вам помочь?

Текст написан Савви
```

{% hint style="warning" %}
Сам агент **не будет** видеть этого дополнительного текста.
{% endhint %}

### Условия замены

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

> * **Вызывать фоллоу-апы после ответа сотрудника —** означает, что бот будет отправлять *фоллоу-апы* не только после своих сообщений, но и в случае, если клиент не ответит после сообщения сотрудника.
>
>   Подробнее с настройкой **фоллоу-апов** Вы можете ознакомиться по [*этой ссылке*](/ru/osnovnye-nastroiki/dopolnitelnye-nastroiki/follou-apy.md).
> * **Фразы для замены замены** служат для того, чтобы в ответе агента заменять нежелательные слова или словосочетания на желаемые.
>
>   Например, чтобы агент в ответах вместо слова "**фирма**" использовал слово "**компания**", необходимо прописать "**фирма**" в поле *Значение*, а "**компания**" в поле *Параметр*.
>
>   Включённая настройка **Фраза может быть частью другого слова** позволяет заменять часть слова в ответе.

## Фоллоу-апы

{% hint style="success" %}
Подробнее с настройкой **фоллоу-апов** Вы можете ознакомиться по [*этой ссылке*](/ru/osnovnye-nastroiki/dopolnitelnye-nastroiki/follou-apy.md).
{% endhint %}

## Рабочее время

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

> Данный раздел позволяет указать часовой пояс, в рамках которого работает и отвечает агент. А так же, позволяет настроить недельное и дневное расписание его работы.

**Как настроить расписание работы агента?**

Для начала включаем настройку **Указать рабочее время**:

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

Далее настраиваем **желаемое время работы агента.**

> **Разберём на примере.**
>
> Допустим, нам нужно, чтобы агент отвечал только в нерабочее время. Т.е. с 20:00 до 10:00, тогда настройки времени будут выглядеть следующим образом:

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

> Т.е. мы разбиваем рабочее время агента на два временных отрезка в рамках одного дня.
>
> С **00:00** до **10:00** и с **20:00** до **23:59**.

{% hint style="warning" %}
**Обратите внимание**

Для корректной настройки времени, время в окошке слева должно быть меньше времени окошка справа в рамках одного дня. Т.е. не получится установить время сразу с **20:00** до **10:00**, вместо этого надо разбить время на два временных промежутка: **00:00-10:00** и **20:00-23:59**.
{% endhint %}

## Защита от спама

<figure><img src="/files/91DMzzfwG1HmUPws7K3W" alt=""><figcaption></figcaption></figure>

> * **Максимальное количество сообщений в диалоге** - настройка, позволяющая ограничить длину диалога в количестве сообщений.
> * **Максимальная стоимость диалога** — при достижении заданной стоимости диалога, агент перестаёт отвечать на сообщения пользователя.

{% hint style="warning" %}
Поскольку каждое сообщение имеет стоимость, есть риск "**слить**" бюджет в каких-то преднамеренных или непреднамеренных ситуациях, когда клиент пишет слишком много сообщений. Данная настройка позволяет застраховаться **от напрасной потери баланса**.
{% endhint %}

## Опции базы знаний

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

{% hint style="success" %}
Чтобы добавить ключевое слово, ведите в поле нужное **слово** или **словосочетание** и нажмите **Enter**.
{% endhint %}

> * **Ключевые слова** - поскольку база знаний фундаментально работает на смысловом понимании контекста *(агент сам решает, когда выбрать тот или иной файл для ответа)*, в некоторых случаях могут возникать ситуации, когда не вызывает базу знаний.\
>   Данная настройка позволяет указать слова, при которых агент будет принудительно в обязательном порядке обращаться к базе знаний, даже если из контекста в этом нет необходимости.
> * **Повышенная теплота базы знаний** - настройка, которая позволяет указать степень необходимости обращения к базе знаний. Если переключатель включен, то агент будет чаще обращаться к базе знаний, нежели использовать свои собственные знания.
> * **Сохранять историю вызова функций** - после первого вызова функций, агент будет держать эту функцию в памяти и обращаться к ней в дальнейшем не тратя дополнительные токены на новый вызов.\
>   Эта настройка увеличивает стоимость всего диалога, но позволяет уменьшить стоимость отдельного сообщения.

## Пользовательские переменные

{% hint style="success" %}
Подробнее о **Пользовательских переменных** Вы можете прочитать в статье по [*этой ссылке*](/ru/osnovnye-nastroiki/prompts/prompts-1.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.suvvy.ai/ru/osnovnye-nastroiki/dopolnitelnye-nastroiki.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.