> 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-rabotaet-ii-agent.md).

# Что делает ИИ, а что — Nextbot

Что в работе агента делает искусственный интеллект, что делает платформа Nextbot и как они работают вместе — на примере одного диалога.

В статье [Из чего состоит ИИ-агент](https://doc.nextbot.ru/getting-started/chto-takoe-ii-agent-i-nextbot.md) мы разобрали пять частей агента. Теперь посмотрим, как они работают в живом диалоге.

В агенте работают двое:

**Искусственный интеллект** понимает клиента и решает, что ответить.

**Платформа Nextbot** делает всё остальное: принимает и отправляет сообщения, передаёт ИИ нужные данные, выполняет действия. Если понимать, кто за что отвечает, становится ясно, где настраивать каждую задачу — и почему иногда агент «не слушается» промпта.

## Один диалог, шаг за шагом

Возьмём агента мебельного магазина и проследим за одной перепиской от первого сообщения до заявки.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-f7a9a5f6b5fb051e7ba2b749c4e03b45adfe5627%2Fkak-rabotaet-ii-agent-dialog-telegram.png?alt=media" alt="Переписка в Telegram с агентом мебельного магазина: приветствие с кнопками, подбор дивана, проверка наличия, доставка, заявка и сообщение менеджера. Шаги отмечены цифрами 1–6." width="380"><figcaption><p>Вся переписка в Telegram. Цифры 1–6 соответствуют шагам ниже.</p></figcaption></figure>

### 1. Клиент впервые пишет

> «Здравствуйте»

**Nextbot** запускает [сценарий](https://doc.nextbot.ru/functional/scenarii.md) по событию «Начало диалога». Тот отправляет готовое приветствие с кнопками «Каталог», «Доставка» и «Менеджер».

**ИИ** в этом не участвует. Приветствие одинаковое для всех, кнопки настоящие — их отправляет [конструктор сообщений](https://doc.nextbot.ru/functional/scenarii/deistviya-v-scenariyakh/konstruktor-soobshenii.md).

### 2. Клиент пишет несколько сообщений подряд

> «Ищу диван» «серый» «в маленькую гостиную»

**Nextbot** не спешит отвечать на первое сообщение: [буфер сообщений](https://doc.nextbot.ru/functional/setting-up-agent/bufer-soobshenii.md) ждёт, пока клиент допишет, и собирает три сообщения в одно. Затем Nextbot передаёт его модели вместе с промптом и историей переписки.

**ИИ** понимает запрос целиком: нужен серый компактный диван. По инструкции из промпта он уточняет размер комнаты и бюджет. **Nextbot** отправляет ответ клиенту.

### 3. Клиент спрашивает о наличии

> «А Милан в сером есть?»

**ИИ** понимает, что ответить по памяти нельзя — нужно проверить наличие. Он вызывает функцию поиска.

**Nextbot** ищет в [таблице](https://doc.nextbot.ru/functional/knowledge-base/tablicy.md) с остатками и возвращает результат модели.

**ИИ** формулирует ответ по найденным данным: «Да, есть, осталось две штуки». **Nextbot** отправляет его.

### 4. Клиент спрашивает о доставке

> «Сможете привезти завтра?»

**ИИ** нужно знать две вещи: условия доставки и какое сегодня число. Условия он берёт из [источников знаний](https://doc.nextbot.ru/functional/knowledge-base.md), а дату ему передаёт **Nextbot** — если в настройках агента включена опция «Передача текущей даты». Без неё модель не знает, какой сегодня день.

**ИИ** формулирует ответ с учётом условий и даты. **Nextbot** отправляет его клиенту.

### 5. Клиент оставляет контакты

> «Давайте оформим. Анна, +7 900 000-00-00»

**ИИ** понимает, что все данные собраны, и вызывает функцию создания заявки.

**Nextbot** создаёт сделку в CRM и отправляет уведомление менеджеру. **ИИ** подтверждает клиенту, что заявка принята.

### 6. К диалогу подключается менеджер

Менеджер пишет клиенту, чтобы уточнить детали доставки.

**ИИ** об этом сам не узнает и продолжит отвечать, если его не остановить. Поэтому останавливает его **Nextbot**: если включена настройка [Контроль вмешательства оператора](https://doc.nextbot.ru/functional/setting-up-agent/upravlenie-aktivnostyu-agenta.md), агент замолкает, как только сотрудник пишет в диалог.

## Что видно из этого диалога

### ИИ — голова, Nextbot — руки

Во всех шести шагах роли распределены между **ИИ** и **NextBot**:

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

**Nextbot** принимает и отправляет сообщения, передаёт ИИ данные и выполняет действия: ищет в таблице, создаёт сделку, запускает сценарии.

Иногда работает только платформа, как в шаге 1. Иногда ИИ решает, а платформа выполняет, как в шагах 3 и 5. Но отправить сообщение, найти данные или записать их ИИ сам не может никогда — это всегда делает Nextbot.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-b0532c04ebb57398dc78992e3db15b71fd5b4c0e%2Fkak-rabotaet-ii-agent-ii-i-nextbot.png?alt=media" alt="Схема: Nextbot получает сообщения, предоставляет информацию, выполняет действия и отправляет ответы; искусственный интеллект понимает смысл, обрабатывает информацию, решает, какое действие нужно, и формулирует ответ."><figcaption><p>За что отвечают Nextbot и искусственный интеллект.</p></figcaption></figure>

### ИИ видит только то, что ему передали

В шаге 3 таблица с остатками была в Nextbot, но модель увидела её данные только через функцию. В шаге 4 модель узнала дату, только потому что Nextbot её передал. В шаге 6 она не узнала о менеджере вовсе.

С каждым сообщением модель всегда получает три вещи: промпт, само сообщение и историю переписки. Сколько сообщений из истории она видит, задаёт настройка [Оптимизация истории диалога](https://doc.nextbot.ru/functional/setting-up-agent/optimizaciya-istorii-dialoga.md). Всё остальное — источники знаний, дату, переменные вроде имени клиента и функции — нужно подключить отдельно.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-996ec809b1f253d6741ae82f8808c837e54f91a8%2Fkak-rabotaet-ii-agent-chto-poluchaet-model.png?alt=media" alt="Слева — что модель получает при обработке сообщения: системный промпт, сообщение клиента, контекст переписки. Справа — что можно передать дополнительно: источники знаний, текущую дату и время, переменные, функции, результаты функций."><figcaption><p>Что модель получает при каждом сообщении и что ей можно передать дополнительно.</p></figcaption></figure>

{% hint style="info" %}
**Если данные есть в Nextbot, это ещё не значит, что их видит ИИ.** Агент знает только то, что вы ему передали.
{% endhint %}

### Не всё решается промптом

Промпт управляет тем, как ИИ думает и отвечает. Но кнопки, ожидание, запись в таблицу и реакция на события — это работа платформы. Если написать такое в промпте, модель попробует справиться словами: перечислит варианты вместо кнопок или пообещает «сохранить заявку», ничего не сохранив.

| Что хочется написать в промпте        | Что настроить в Nextbot                                                                                                 | Шаг в примере |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------- |
| «Покажи кнопки»                       | [Конструктор сообщений](https://doc.nextbot.ru/functional/scenarii/deistviya-v-scenariyakh/konstruktor-soobshenii.md)   | 1             |
| «Жди, пока клиент допишет»            | [Буфер сообщений](https://doc.nextbot.ru/functional/setting-up-agent/bufer-soobshenii.md)                               | 2             |
| «Проверь, есть ли товар»              | Функция [поиска в таблице](https://doc.nextbot.ru/functional/knowledge-base/tablicy/poisk-v-tablice.md)                 | 3             |
| «Учитывай сегодняшнюю дату»           | Опция «Передача текущей даты»                                                                                           | 4             |
| «Сохрани заявку»                      | [Функция](https://doc.nextbot.ru/functional/functions.md)                                                               | 5             |
| «Замолчи, когда подключится менеджер» | [Контроль вмешательства оператора](https://doc.nextbot.ru/functional/setting-up-agent/upravlenie-aktivnostyu-agenta.md) | 6             |

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

## Как применять это на практике

Когда будете настраивать новую задачу, задайте себе два вопроса:

1. **Нужно ли что-то понять или решить?** Это работа ИИ — настраивается промптом и знаниями.
2. **Нужно ли что-то сделать: отправить, найти, записать, отреагировать на событие?** Это работа Nextbot — нужна функция, сценарий или настройка.

Чаще всего нужно и то и другое, как в шагах 3 и 5. Первому агенту хватит модели, промпта, сведений о компании, канала и одной функции — если заявки должны сразу попадать к менеджеру. Сценарии и остальные инструменты пригодятся позже.

## Что дальше

Теперь вы знаете, из чего состоит агент и как он работает. Пора собрать своего: начните с [Регистрации](https://doc.nextbot.ru/getting-started/kak-nachat/registration.md) и двигайтесь по шагам раздела [Как начать?](https://doc.nextbot.ru/getting-started/kak-nachat.md).


---

# 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://doc.nextbot.ru/getting-started/kak-rabotaet-ii-agent.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.
