> 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/funkcii/standartnye-funkcii.md).

# Стандартные функции

Стандартные функции в Савви — это встроенные инструменты, которые позволяют агенту выполнять заданные действия в зависимости от контекста диалога.

{% hint style="info" %}
**Стандартные функции** автоматически выполняются на основе условий (написанных на естественном языке), без необходимости создавать отдельные действия в разделе [**Действия** ](/ru/deistviya/multiagentnost.md)или использовать вместо прямого вызова файлов [**Базы знаний**](/ru/baza-znanii/chek-list-vybora-formata-bazy-znanii.md) в основной инструкции.
{% endhint %}

### Доступны следующие основные стандартные функции:

1. **Остановка диалога** — функция, которая позволяет прервать диалог.
2. **Игнорирование сообщения** — функция для пропуска определённых сообщений от клиента или сотрудника.
3. **Установка тега к диалогу** — добавление меток к диалогу для его категоризации.
4. **Вызов менеджера (отправка уведомления в Telegram)** — функция для инициализации отправки [уведомления в Telegram](/ru/osnovnye-nastroiki/opovesheniya-ot-savvi.md).
5. **Добавление в чёрный список** — агент вносит номер клиента в чёрный список, когда клиент просит больше ему не звонить.
6. **Перевод звонка на менеджера** — функция для переадресации звонка на менеджера (доступна только в голосовых агентах).

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FQoDWN02OxvLJe3QbbzMc%2Fimage.png?alt=media&amp;token=ff82d27f-9461-4436-a597-15f91c457aa5" alt=""><figcaption></figcaption></figure>

### Настройка стандартных функций

У каждой **стандартной функции** есть переключатель **Включить функцию**. После включения появляется поле **Описание функции**, а у функции «Остановка диалога» — ещё и переключатель **«Не возобновлять диалог автоматически»** (о нём ниже).

В поле **Описание функции** надо написать условие при которых будет вызвана необходимая **стандартная функция**.

**Пример 1:** Остановка диалога после того как клиент написал телефон.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FD3Wwt9m2dFvufOanuV6A%2Fimage.png?alt=media&amp;token=0ad37b63-2522-409e-a6c0-3059d8c47b97" alt=""><figcaption></figcaption></figure>

Что произошло в диалоге:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FHUQU0IgYo5WwEdJSTsg4%2Fimage.png?alt=media&amp;token=0801abdc-bf04-47fc-931b-eaa1f4f83c86" alt=""><figcaption></figcaption></figure>

#### Остановка диалога без автовозобновления

Диалог, который остановила функция «Остановка диалога», может вернуться в работу сам: по таймеру из блока [«Условия возобновления диалога»](/ru/osnovnye-nastroiki/dopolnitelnye-nastroiki.md) в **Доп. настройки → Параметры ответов**.

Чтобы такой диалог **не возвращался по таймеру**, включите у функции переключатель **«Не возобновлять диалог автоматически»**. По умолчанию он выключен. Так же ведёт себя диалог, который выключили вручную с ответом «Нет, не нужно» на вопрос «Возобновить диалог автоматически?»: по таймеру он тоже не вернётся.

Что работает и после такой остановки:

* **фразы для возобновления** — и от клиента, и от сотрудника;
* ручное возобновление диалога;
* кнопка «Очистить контекст».

{% hint style="warning" %}
Переключатель действует только на остановки, которые выполнила эта функция. Если диалог остановили иначе (вмешательство сотрудника, фраза прерывания, функция с флагом «Остановить диалог при вызове»), он возобновится по таймеру как обычно.

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

Рассылки пропускают такие диалоги, пока их не возобновят.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FSnVcyTL86nGL13LDkEn7%2Fimage.png?alt=media&amp;token=54edf70e-e3c7-407f-a3ac-c4278bcabc20" alt=""><figcaption></figcaption></figure>

**Пример 2:** Нам надо, чтобы при сообщениях, которые состоят из одних эмодзи, агент промолчал в ответ, а на просьбу пригласить менеджера отправил уведомление в Telegram.

Пишем соответствующие инструкции:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fj1lo5Pb5uI3w8XzmmIoo%2Fimage.png?alt=media&amp;token=404889ae-f3c9-494f-8503-123510f5bc33" alt=""><figcaption></figcaption></figure>

Мы видим в диалоге, что на сообщение где используются эмодзи с текстом агент ответил, сообщение состоящее из одних эмодзи - игнорировал.

На просьбу о разговоре с менеджером была выполнена функция вызова уведомления в Telegram.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FF21QOjQRt9KYBLJXb0pa%2Fimage.png?alt=media&amp;token=9646e74b-10d2-4ccb-a55e-cdaf91cd49b9" alt=""><figcaption></figcaption></figure>

Для настройки **стандартной функции:** **Установка тега к диалогу** сначала надо задать или выбрать уже настроенный тег. Для этого, в поле Доступные теги нажать на значок настройки. В появившемся окне написать название нового тега и нажать **+Добавить тег**.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FxrpH9efGoqOzn4EOrl9d%2Fimage.png?alt=media&amp;token=bef5625f-443f-4022-852e-475eceb87b58" alt=""><figcaption></figcaption></figure>

Дальше можно выбрать цвет для этого тега. Он будет отображаться, например, в графике раздела [**Аналитика**](/ru/analitika/analitika-v-savvi.md).

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FpMuVlz0kmRaVReDwWQ6r%2Fimage.png?alt=media&amp;token=cf18ee97-76a5-44ea-993a-d1670aa1a4b9" alt=""><figcaption></figcaption></figure>

Выбираем и добавляем нужный тег.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FP5Ka9o9yhA5Pf3oNAQc1%2Fimage.png?alt=media&amp;token=9e3d1449-d435-49a0-9293-a7ae33287eb4" alt=""><figcaption></figcaption></figure>

В поле **Описание функции** надо написать условие вызова функции.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FqNzgMyg4ruWXwMv8kEVm%2Fimage.png?alt=media&amp;token=aa88c01d-2541-487c-984d-a82e7054d80c" alt=""><figcaption></figcaption></figure>

### Добавление в чёрный список

Функция **«Добавление в чёрный список»** вносит номер клиента в [чёрный список номеров для звонков](https://docs.suvvy.ai/ru/types-of-agents/golosovoi-agent/chyornyi-spisok-nomerov-dlya-zvonkov), когда клиент просит больше ему не звонить. По умолчанию она выключена.

Включите её и в поле **Описание функции** опишите, когда агент должен внести номер. Например:

```
Если клиент просит больше ему не звонить или не беспокоить, добавь его номер в чёрный список.
```

Разговор после вызова продолжается: номер попадает в список сразу, но блокирует только следующие звонки. В текстовом чате эта же функция блокирует контакт в чёрном списке канала.

{% hint style="warning" %}
Если вам надо вызвать одновременно две **стандартные функции**, например чтобы при вызове менеджера, произошла отправка [уведомления в Telegram](/ru/osnovnye-nastroiki/opovesheniya-ot-savvi.md) и **Установка тега к диалогу**, надо одну из функций вызвать в основной инструкции или использовать [Действие](/ru/deistviya/multiagentnost.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.