> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/getting-started/kak-nachat/dobavlenie-funkcii.md).
# Добавление функций
[**Функции**](/functional/functions.md) - это инструменты ИИ-агента, которые позволяют ему взаимодействовать с внешним миром: отсылать уведомления, двигать карточки в crm, узнавать цены и остатки товаров на складе и т.д.
Использование функций позволяет сделать из ИИ-агента не просто "болталку" в чате, а полноценный и полезный инструмент бизнеса.
{% hint style="info" %}
Подробнее про функции можно узнать [в статье](/functional/functions.md)
{% endhint %}
После того, как ИИ-агент настроен и консультирует клиентов, вы можете добавить ему новые обязанности:
* **Уведомления:** сообщает вам о сложных запросах или внештатных ситуациях.
* **Заполнение заказов:** ИИ-агент самостоятельно записывает данные клиента и отсылает уведомление в группу телеграмм.
### Функция уведомления менеджера о внештатной ситуации.
#### Поскольку иногда в общении клиента и ИИ-агента возникают сложности, требующие вмешательства реального человека, добавим ему возможность позвать нас на помощь в сложной ситуации.
1. **Перейдём на страницу** [**функции**](https://app.nextbot.ru/functionsGPT)**:**
2. **Нажмём "Создать функцию с базовыми настройками"**
3. Получим функцию с названием по умолчанию "save\_user\_data"
4. **Нажмем на название функции**, что бы её настроить
5. **Придумаем и заполним имя функции.**\
Имя должно быть заполнено на английском языке **(не латинскими буквами, а именно на английском языке)**.\
Функция вызовется в нужном вам случае, только если нейросеть поймёт её смысл и логику, исходя из имени функции.\
В нашем случае, так как мы создаём функцию вызова менеджера для помощи, выберем имя: **call\_for\_help** (с англ. - запросить помощь)\
Плохим примером было бы назвать эту функцию как "zapros\_menedgera", "function\_pomogite" или "pomogite".
6. **Кратко заполняем инструкцию**: "Запросить помощь" - в инструкции мы объясняем что делает эта функция, в нашем случае хватит очень краткого объяснения, так как поведение этой функции вполне ясно из её названия и контекста использования.
7. **Добавляем всего один параметр**: Имя параметра "query", инструкция для параметра "Причина обращения." В это поле ИИ-агент будет записывать по какой причине он вызывает помощь.
8. К этой функции добавим **сценарий поведения Поставить на паузу**, в случае если функция выполнилась. Чтобы ИИ-агент в этом диалоге больше ничего не отвечал.
9. **Не забудьте всё сохранить**
10. **Далее возвращаемся на страницу редактирования агента, и добавляем в инструкцию сценарий при котором нужно запустить функцию:**\
\&#xNAN;*Если у тебя возникли сложности с ответом, или ты не знаешь ответа, а также клиент просит позвать живого человека вызови функцию: call\_for\_help.*
{% hint style="warning" %}
**Важно помнить, что текст функций и промптов нужно подбирать индивидуально для каждого ИИ-агента.**
{% endhint %}
#### Пробуем что получилось:
Отлично! ИИ-агент вызывал подмогу и диалог перешел в режим Пауза, согласно нашим инструкциям.
### Далее добавим вторую функцию, которая уведомляет нас о новом заказе.
**Имя функции:**\
send\_order\_details (Отправить детали заказа)
**Описание:**\
Функция отправляет менеджеру данные о заказе для оформления и доставки. Включает информацию о заказе, адресе доставки, имени клиента и его контактном номере.
**Аргументы:**
1. **order** Описание: Детали заказа пользователя, включая наименование товара и его количество в формате: название - кг.\
Пример:\
Стейк Рибай - 3кг\
Филе Миньон - 0.8кг\
Говяжий фарш - 5кг
2. **delivery\_address** Описание: Адрес доставки.
3. **client\_name** Описание: Имя клиента.
4. **phone\_number** Описание: Номер телефона для связи с курьером.
Сохраняем функцию!
**Далее пробуем:**\
\
Видно что ИИ-агент сам понял что оформления заказа ему нужно уточнить такие вопросы. Но мне не нравится что вываливает все вопросы кучей. Давайте попросим задавать по одному:
**Доработаем инструкцию:**
*Для того что-бы заполнить карточку заказа необходимо **ШАГ ЗА ШАГОМ** уточнить у клиента:*
* *желаемый товар и его количество, не забывай про дополнительные продажи (предложи кетчуп, специи);*
* *адрес доставки;*
* *имя клиента;*
* *телефон после получения всех данных вызови функцию send\_order\_details, для информирования о новом заказе.*
### **Тестируем что получилось:**
**Квалификатор (ИИ-агент):**\
Здравствуйте, чем могу вам помочь?
**Пользователь:**\
Привет, хочу сделать заказ.
**Квалификатор (ИИ-агент):**\
Здравствуйте! Отлично, что вы решили заказать у нас! Давайте начнем. Какой товар и в каком количестве вас интересует? Мы можем также предложить кетчупы и специи для вашего заказа.
**Пользователь:**\
Что-нибудь для стейка.
**Квалификатор (бот):**\
Отличный выбор! Для приготовления стейка у нас есть несколько вариантов:
* Стейк Рибай (2000 руб./кг): мраморная говядина с потрясающим вкусом.
* Филе Миньон (2500 руб./кг): нежное и мягчайшее мясо, идеальное для гурманов.
* Томагавк (3000 руб./кг): эффектный стейк с реберной костью, который украсит любой ужин.
Какой вариант вам интересен и сколько килограммов хотите? Также могу предложить приправы для стейков или кетчуп.
**Пользователь:**\
Давай Рибай, пару кило.
**Квалификатор (ИИ-агент):**\
Отличный выбор! Записываю 2 кг стейка Рибай.
Хотите добавить специи для стейков (идеальная смесь специй за 300 руб.) или кетчуп (150 руб.) для полного удовольствия? 😊
**Пользователь:**\
Хорошо.
**Квалификатор (ИИ-агентт):**\
Добавляем специи для стейков за 300 руб. к заказу! Также напомню, что на первый заказ у нас действует скидка 10%.
Теперь уточним адрес доставки, чтобы ваш заказ прибыл вовремя. Куда доставить ваш Рибай и специи? 😊
**Пользователь:**\
Аа, ну тогда давай ещё 3 кило фарша.
**Квалификатор (ИИ-агент):**\
Прекрасно! Добавляем ещё 3 кг говяжьего фарша к вашему заказу. Напоминаю, что скидка 10% на первый заказ будет распространяться на весь ваш заказ.
Итак, ваш заказ:
* Стейк Рибай — 2 кг
* Говяжий фарш — 3 кг
* Специи для стейков
Теперь уточним адрес доставки. Куда доставить заказ? 😊
**Пользователь:**\
На Ленина 71-23.
**Квалификатор (ИИ-агентт):**\
Отлично! Доставим ваш заказ по адресу: Ленина, 71, кв. 23.
Осталось только уточнить ваше имя и номер телефона, чтобы курьер смог с вами связаться. 😊
**Пользователь:**\
Дмитрий, 89219702847.
**Квалификатор (ИИ-агент):**\
Дмитрий, ваш заказ оформлен! Мы доставим:
* Стейк Рибай — 2 кг
* Говяжий фарш — 3 кг
* Специи для стейков
Адрес доставки: Ленина, 71, кв. 23.\
Телефон для связи: 89219702847.
Ожидайте наш звонок для подтверждения. Спасибо, что выбрали "Мясной стиль"! 😊
**Результат выполнения функции:**\
**Отлично! ИИ-агент не только болтает в чате но и выполняет полезную работу.**
Далее мы добавим ИИ-агента в телеграмм. Создадим группу для курьеров и менеджеров и будем отправлять заявки туда.
---
# 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:
```
GET https://doc.nextbot.ru/getting-started/kak-nachat/dobavlenie-funkcii.md?ask=
```
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.