> 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/s-chego-nachat-rabotu-s-nextbot.md).

# С чего начать работу с Nextbot

Точка входа в Nextbot — как устроен ИИ-агент, что он умеет и как шаг за шагом собрать своего без программирования.

[**Nextbot**](https://app.nextbot.ru/) — это платформа, на которой вы сами собираете ИИ-агента для своего бизнеса: он отвечает клиентам, консультирует, записывает на услуги и приносит заявки. Если вы только начинаете, возможностей может показаться слишком много. Но осваивать всё сразу не нужно, и программировать тоже не придётся. Агент собирается шаг за шагом: вы делаете одну настройку, проверяете результат и переходите к следующей.

Эта статья — ваша точка входа. Из неё вы узнаете, как устроен ИИ-агент, что он умеет, как собрать первого агента и где искать ответы, когда захочется большего.

## Как устроен ИИ-агент

Проще всего представить агента как нового сотрудника. Сам сотрудник — это ИИ-модель: она понимает сообщения клиентов и формулирует ответы. Модели в Nextbot уже подключены, вам остаётся выбрать одну из них.

Но даже способному новичку нужно объяснить работу. Вы уже знаете, как ввести человека в курс дела:

1. **Объяснить, что он делает.** «Ты консультант магазина, отвечаешь на вопросы и принимаешь заказы». В Nextbot это [инструкция агента](/functional/setting-up-agent.md).
2. **Дать материалы.** Прайс, список услуг, условия доставки, ответы на частые вопросы. В Nextbot это [источники знаний](/functional/knowledge-base.md).
3. **Выдать инструменты.** Доступ к CRM, календарю записи, таблице с остатками. В Nextbot это [функции](/functional/functions.md) и [интеграции](/functional/integrations.md).
4. **Посадить на рабочее место.** Telegram, ВКонтакте, чат на сайте — туда, где пишут ваши клиенты. В Nextbot это [каналы связи](/functional/integrations.md) в разделе «Интеграции».

Вот и всё устройство: сотрудник и четыре вещи, которые вы ему даёте. Каждая настраивается отдельно, и для каждой в документации есть пошаговая инструкция.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-ceff8675c305528040c873f1c6ff7941da418abf%2Fintensiv-chto-takoe-image-2.png?alt=media" alt="ИИ-модель в центре, вокруг инструкция, знания, функции и канал общения"><figcaption><p>ИИ-модель — это сотрудник. Инструкция, знания, функции и канал общения — то, что вы ему даёте.</p></figcaption></figure>

## Что агент сможет делать

* **Отвечать клиентам** в Telegram, WhatsApp, ВКонтакте, MAX, на Авито и в чате на сайте — днём и ночью.
* **Консультировать** по вашим ценам, услугам и условиям, а не общими словами из интернета.
* **Принимать заявки** — собирать имя, телефон, детали и отправлять в Битрикс24, amoCRM или группу в Telegram.
* **Записывать клиентов** в Google Календарь, YCLIENTS или ALTEGIO.
* **Проверять данные** — наличие товара в таблице, свободное время в календаре.
* **Звать менеджера**, когда вопрос требует человека.

Когда агент заработает, вы сможете смотреть его [диалоги](/functional/dialogi.md), [аналитику](/functional/analitika.md) и запускать [рассылки](/functional/rassylki.md). Примеры готовых агентов смотрите в разделе [Сценарии использования](/getting-started/use-cases.md).

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FVbOLW4hL6mmzuxj3j4bW%2Fimage.png?alt=media&amp;token=234e565f-43c8-4286-89f6-4b54f485298b" alt="Переписка в Telegram: клиент хочет сделать заказ, агент советует товар, уточняет количество, адрес, имя и телефон и подтверждает заказ" width="380"><figcaption><p>Агент магазина мяса в Telegram: подбирает товар, предлагает дополнение к заказу и собирает данные для доставки.</p></figcaption></figure>

## Начните с одной задачи

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

Дальше возможности добавляются по одной: таблица с товарами, функция создания заявок, передача диалога менеджеру. Уже сделанное не пропадёт — к нему добавляется новое.

## «А я точно справлюсь?»

Да. Вот что обычно беспокоит тех, кто только начинает, — и как обстоят дела на самом деле.

**«Я не программист».** Программировать не нужно. Агент настраивается в интерфейсе: текстовые поля, списки, переключатели. Код может понадобиться только для редких нестандартных задач, и даже его можно [написать с помощью ИИ](/functional/functions/sending-result/python-v.2/generaciya-koda-s-ii.md).

**«Я не знаю, что писать в инструкции».** Начните с двух-трёх предложений о том, кто агент и чем он помогает клиентам. Если совсем не идёт, инструкцию можно [сгенерировать](/functional/setting-up-agent/system-prompt/generaciya-i-modifikaciya-prompta.md) и потом подправить.

**«Я что-нибудь сломаю».** Не сломаете. Пока вы не подключили канал, клиенты агента не видят. Все изменения проверяются в [тестовом чате](/functional/chat.md): написали агенту, посмотрели ответ, поправили настройку. Чтобы начать проверку с чистого листа, нажмите «Рестарт диалога» или отправьте команду `/restart`.

**«Тут слишком много настроек».** Для первого агента нужна малая часть из них. Остальные — для тех задач, которые появятся потом. Раздел «Функционал» — это справочник: в него заглядывают, когда нужно, а не читают от начала до конца.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FaTNgyrdYOkHnTbZ2hNjA%2F%7B1E526496-9C3B-4CA6-A98A-4863A2EB1F76%7D.png?alt=media&amp;token=0c7bbb11-682c-46d2-b53b-cf57e54bd800" alt="Поля «Имя агента» и «Инструкция для ИИ-агента» с кнопками Сгенерировать, Модифицировать и Переменные"><figcaption><p>Здесь вы пишете инструкцию. Кнопка «Сгенерировать» поможет, если сложно начать с чистого листа.</p></figcaption></figure>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FEYj113GhYMMNtSYu0dAu%2F%7B83FACD94-33D6-4B4C-BF9F-2EFD4AC27E01%7D.png?alt=media&amp;token=f60995e7-43d8-4d0f-b1ea-133a53fc1ab8" alt="Тестовый чат: агент отвечает на вопросы о наличии говядины; справа вверху кнопка Рестарт диалога"><figcaption><p>А здесь сразу проверяете результат. Кнопка «Рестарт диалога» начинает переписку заново.</p></figcaption></figure>

## Ваш первый агент: шесть шагов

Каждый шаг заканчивается результатом, который вы видите сами. Не торопитесь: сделали шаг, проверили, пошли дальше.

{% stepper %}
{% step %}

## Поймите, как устроен агент

Прочитайте [Из чего состоит ИИ-агент](/getting-started/chto-takoe-ii-agent-i-nextbot.md) и [Что делает ИИ, а что — Nextbot](/getting-started/kak-rabotaet-ii-agent.md).

**Что получится:** вы понимаете, из каких частей собирается агент.
{% endstep %}

{% step %}

## Зарегистрируйтесь

Следуйте инструкции [Регистрация](/getting-started/kak-nachat/registration.md).

**Что получится:** аккаунт и готовый агент, который ждёт настройки.
{% endstep %}

{% step %}

## Опишите агента

Дайте агенту имя и задачу по инструкции [Создание агента](/getting-started/kak-nachat/sozdanie-agenta.md): какую роль он выполняет и как общается с клиентами. Для старта рекомендуем модель GPT-5.4 — как её выбрать, описано в статье [Языковые модели](/functional/setting-up-agent/yazykovye-modeli.md). Напишите агенту в тестовом чате.

**Что получится:** агент вам отвечает. Это уже работающий агент — дальше вы его только улучшаете.
{% endstep %}

{% step %}

## Расскажите агенту о бизнесе

Добавьте график работы, адрес, цены, услуги и условия доставки по инструкции [Наполнение Справочника](/getting-started/kak-nachat/napolnenie-bazy-znanii.md).

**Что получится:** агент отвечает про вашу компанию, а не общими фразами.
{% endstep %}

{% step %}

## Научите агента принимать заявки

Добавьте функцию по инструкции [Добавление функций](/getting-started/kak-nachat/dobavlenie-funkcii.md).

**Что получится:** агент сам собирает контакты и детали заказа.
{% endstep %}

{% step %}

## Подключите канал

Подключите Telegram и группу для заявок по инструкции [Публикация ИИ-агента и получение заявок](/getting-started/kak-nachat/publikaciya-agenta-i-poluchenie-zayavok.md).

**Что получится:** клиенты пишут агенту, а заявки приходят вам.
{% endstep %}
{% endstepper %}

Все шаги разобраны на одном примере в разделе [Как начать?](/getting-started/kak-nachat.md). Повторяйте за ним, подставляя свои данные.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FwvfYcbD1aHKhlEC6XR2u%2Fimage.png?alt=media&amp;token=5b0cf86f-03b2-40bb-9850-bb40330a6997" alt="Сообщение в группе Telegram: Новая заявка — заказ, адрес, имя и телефон клиента" width="380"><figcaption><p>Так выглядит результат шестого шага: заявка из диалога с клиентом пришла в группу Telegram.</p></figcaption></figure>

## Как найти нужное в документации

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

| Вы хотите                                                    | Куда идти                                                                                                                   |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| Изменить стиль общения агента                                | [Системный промпт](/functional/setting-up-agent/system-prompt.md)                                                           |
| Чтобы агент отвечал на вопросы о компании                    | [Источники знаний](/functional/knowledge-base.md)                                                                           |
| Проверять наличие товара                                     | [Таблицы](/functional/knowledge-base/tablicy.md) и [Поиск в таблице](/functional/knowledge-base/tablicy/poisk-v-tablice.md) |
| Отправлять заявки в CRM или записывать клиентов              | [Интеграции](/functional/integrations.md)                                                                                   |
| Автоматически отправлять сообщения при определённых событиях | [Сценарии](/functional/scenarii.md)                                                                                         |
| Понять, сколько это стоит                                    | [Тарифы](/price/tariffs.md)                                                                                                 |
| Расширять стандартные возможности агента                     | [Продвинутые техники](/advices/advanced-techniques.md)                                                                      |
| Разобраться с ошибкой                                        | [Расшифровки ошибок](/questions-answers/errors-description.md) и [частые вопросы](/questions-answers/faq.md)                |
| Узнать, что нового                                           | [Обновления](/updates/2026.md)                                                                                              |

Не нашли свою задачу в таблице — воспользуйтесь строкой **Ask or search** в правом верхнем углу. Напишите задачу своими словами: «передать диалог менеджеру», «проверить наличие товара». Можно задать и вопрос целиком — помощник ответит по материалам документации.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-0cf324b5352dfa33c7f6c24037549c6df5c63ca2%2Fkak-polzovatsya-dokumentaciei-ask-or-search.png?alt=media" alt="Строка Ask or search в правом верхнем углу документации с подсказками поиска и вопросами к помощнику"><figcaption><p>Строка «Ask or search»: можно искать по словам или задать вопрос своими словами.</p></figcaption></figure>

## Если что-то не получилось

Это нормально — настройка агента всегда включает пробы и уточнения. Если агент отвечает не так, как нужно, переделывать его целиком не придётся. Чаще всего достаточно уточнить инструкцию, добавить недостающую информацию или поправить одну настройку.

Чтобы быстрее найти причину:

1. **Меняйте по одному.** Так сразу видно, какая настройка повлияла на результат.
2. **Начинайте с простого примера.** Убедитесь, что инструмент работает в базовой ситуации, и только потом добавляйте условия.
3. **Возвращайтесь к инструкции.** Откройте статью по инструменту, на котором возникла сложность, и сверьте настройки.

Куда ещё обратиться:

* **Агент отвечает не так.** Загляните в [Советы по промптингу](/functional/setting-up-agent/system-prompt/sovety-po-promptingu.md).
* **Появилась ошибка.** Найдите её текст в [Расшифровках ошибок](/questions-answers/errors-description.md).
* **Ответа нет в документации.** Напишите в [бот техподдержки](https://t.me/nextbot_support_bot). Вам помогут.

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

## Ваш следующий шаг

Начните со статьи [Из чего состоит ИИ-агент](/getting-started/chto-takoe-ii-agent-i-nextbot.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/s-chego-nachat-rabotu-s-nextbot.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.