---
title: "Начало работы"
id: "1954"
type: "page"
slug: "getting-started"
published_at: "2026-09-20T14:56:51+00:00"
modified_at: "2026-09-20T18:29:23+00:00"
url: "https://pastukhov.com/agents/chatbot/docs/getting-started"
markdown_url: "https://pastukhov.com/agents/chatbot/docs/getting-started.md"
excerpt: "Чат-бот агент — программа для создания чат-ботов с искусственным интеллектом, которая работает на вашем сервере.…"
---

# Начало работы

[https://pastukhov.com/agents/chatbot/docs/getting-started.md](https://pastukhov.com/agents/chatbot/docs/getting-started.md)

Чат-бот агент — программа для создания чат-ботов с искусственным интеллектом, которая работает на вашем сервере. Диалог собирается мышкой в визуальной студии, проверяется на встроенном эмуляторе, а потом один и тот же бот отвечает в Telegram, на публичной странице чата и виджетом на вашем сайте. ИИ отвечает по вашим документам и честно передаёт разговор человеку, когда сам не справляется.

## Что такое Чат-бот агент

Это не облачный конструктор с ежемесячной подпиской, а приложение, которое вы запускаете на своём сервере и полностью контролируете. Бот — это набор обычных файлов: настройки, сценарий диалога и скрипты. Их видно, их можно скопировать на другой сервер и перенести без экспорта и импорта. Никакой привязки к чужому сервису нет.

Из одного сценария бот сразу умеет работать в трёх каналах: в Telegram, на публичной странице чата на домене платформы и виджетом на вашем сайте. Сценарий пишется один раз, а разговоры со всех каналов сходятся в одном месте — у оператора видно и Telegram, и сайт, и виджет.

## Кому подходит

Владельцам небольшого бизнеса, магазинам и службам поддержки, специалистам — всем, кому нужен бот, но не нужен программист и не хочется платить за облачную подписку. Сценарий собирается из готовых блоков-шагов, а ИИ помогает написать первый черновик по обычному описанию словами. Если возможностей блоков не хватает, можно подключить свой скрипт на Python — например, заглянуть в вашу CRM или посчитать заказ.

## Системные требования

Достаточно любого сервера с Linux и Docker — подойдёт недорогой VPS. Всё остальное встроено в образ: веб-сервер приложения, база данных и эмулятор Telegram. Пошаговая инструкция — на странице [Установка](/agents/chatbot/install)
.

## Первый вход

Откройте адрес приложения в браузере. Пока в базе нет ни одного пользователя, форма регистрации показывается сама — первый зарегистрировавшийся становится администратором. Второй способ — заранее задать логин и пароль переменными окружения при запуске (в переменной хранится не сам пароль, а его «отпечаток» — строчная SHA-256-сумма). Сессия входа живёт 90 дней, так что входить каждую неделю не придётся.

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

## Интерфейс

Все разделы собраны в боковом меню: **Главная**, **Боты**, **Эмулятор**, **Входящие**, **Контакты**, **Аналитика**, **База знаний**, **Модели**, **Скрипты**, **Состояние** и **Вживую** (живые диалоги прямо сейчас). Ниже — файлы проекта и данных. В самом низу, если подключён Pastukhov Agent, появляются активные чаты с ИИ-агентом и очередь заданий.

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

## Первые шаги

1. **Создайте бота** — введите имя и токен от @BotFather. Токен — это секретный ключ доступа бота, его выдаёт Telegram. Настоящего бота пока нет? Не беда: можно завести тестового бота на эмуляторе, он работает без Telegram.
2. **Соберите первый диалог** в студии — перетащите на холст пару блоков-шагов и соедините их стрелкой.
3. **Проверьте на эмуляторе** — напишите боту от лица поддельного человека и посмотрите, что он отвечает.
4. **Нажмите «Запустить»** — бот начнёт принимать сообщения.
5. **Подключите остальное по желанию** — базу знаний, оператора, публичную страницу чата и виджет на ваш сайт.

## Язык, тема и размер шрифта

Язык интерфейса задаётся брендом при установке: у бренда Pastukhov интерфейс русский. Тема (тёмная или светлая), размер шрифта и громкость звуков уведомлений настраиваются в разделе оформления и сохраняются для конкретного пользователя — каждый входит под своими настройками.

## Ярлык на рабочий стол

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

## Все разделы документации

[Боты](/agents/chatbot/docs/bots)
 — создание, запуск и остановка, версии и чек-лист публикации. [Студия сценариев](/agents/chatbot/docs/studio)
 — сборка диалога мышкой. [Узлы сценария](/agents/chatbot/docs/nodes)
 — все 18 типов шагов. [Эмулятор](/agents/chatbot/docs/emulator)
 — проверка без Telegram. [Проверка и отладка](/agents/chatbot/docs/testing)
 — пробные прогоны и трассировка. [Входящие](/agents/chatbot/docs/inbox)
 — работа оператора. [База знаний](/agents/chatbot/docs/knowledge)
 — ответы по вашим документам. [Модели и промпты](/agents/chatbot/docs/models)
 — настройка ИИ. [Скрипты](/agents/chatbot/docs/scripts)
 — свои расчёты на Python. [Контакты, сегменты и рассылки](/agents/chatbot/docs/contacts)
 — работа с базой клиентов. [Аналитика и журналы](/agents/chatbot/docs/analytics)
 — цифры и записи. [Чат-комната на сайте](/agents/chatbot/docs/chatroom)
 — публичная страница чата. [Виджет для сайта](/agents/chatbot/docs/widget)
 — панель чата на вашем сайте. [Чат с ИИ-агентом](/agents/chatbot/docs/agent)
 — правки словами.

[← Оглавление документации](/agents/chatbot/docs)