AI-агенты для бизнеса: платформа, компоненты, каналы
Введение
AI-агенты — это не просто чат-боты, отвечающие по скрипту. Это интеллектуальные системы, которые понимают контекст, подключаются к вашим базам данных и документам, вызывают API и принимают решения. Для бизнеса это означает: меньше рутины, быстрее ответы, ниже затраты, выше качество.
Мы выделяем четыре типа агентов, закрывающих ключевые потребности любой компании:
| Тип | Что делает |
|---|---|
| Агент поддержки (FAQ) | Отвечает на вопросы по базе знаний, регламентам, документам |
| Агент-консультант (продавец) | Помогает выбрать товар, сравнивает, оформляет заказ, делает кросс-сейл |
| Ассистент сотрудника | Оформляет отпуска, сбрасывает пароли, ищет приказы, ведёт онбординг |
| Аналитик данных | Превращает бизнес-вопрос в SQL, возвращает ответ + график |
Но за каждым из этих агентов стоит общая платформа — и именно она определяет, будет ли агент удобным, безопасным и управляемым. В этом документе мы разбираем бизнес-компоненты платформы и каналы доставки.
Бизнес-компоненты платформы
1. Аналитика диалогов
Без аналитики агент — чёрный ящик. Бизнесу нужно понимать, что происходит внутри.
Что даёт аналитика:
| Возможность | Зачем бизнесу |
|---|---|
| Дашборд обращений | Сколько диалогов, в каких каналах, в какое время. Пики нагрузки для планирования ресурсов |
| Разбивка по агентам | Нагрузка и активность по каждому агенту |
| Воронка эскалаций | Сколько диалогов агент решил сам, сколько ушло на оператора |
| Лексические темы | О чём спрашивают чаще всего — частые слова в вопросах, без ручной разметки (без эмбеддингов) |
| Поиск по диалогам | Полнотекстовый поиск по всей истории — compliance, разбор инцидентов, обучение |
| Слепые зоны | Инструменты, которые часто возвращают пусто или падают: что нужно доработать |
| Оценки пользователей | Лайк/дизлайк по ответам агента — сигнал к улучшению |
Аналитика — opt-in: по умолчанию не учитывается ни один агент, включается глобально или на конкретный шаблон.
Пример, как это может выглядеть (числа условные):
📊 Дашборд за июль 2026
├─ Всего диалогов: 8 230
│ ├─ Решено агентом: 5 760 (70%)
│ ├─ Эскалировано: 1 810 (22%)
│ └─ Не решено (нет в базе): 660 (8%) ⚠️
├─ Топ-5 тем:
│ 1. Статус заказа — 2 140
│ 2. Возврат/брак — 1 520
│ 3. Доставка в регионы — 980
│ 4. Сравнение товаров — 890
│ 5. Гарантия — 720
├─ Среднее время ответа: 1.2 сек
└─ Средняя оценка пользователя: 4.7 / 5
2. Безопасность
AI-агент работает с данными компании — документами, базой клиентов, финансовой информацией. Безопасность не опция, а фундамент.
Уровни защиты:
| Уровень | Что входит |
|---|---|
| Изоляция | Агент не читает контекст другого агента и не тратит его бюджет. Память и state скоупятся на пользователя/сессию. Один инстанс — один контур (мультитенантность по клиентам не заявляется) |
| Контроль доступа | Админ-токены и web-пользователи ограничиваются списком шаблонов (скоупед-оператор). Админ-API fails closed |
| Защита персональных данных | Хук guard находит email, телефоны, карты, IBAN, паспорта, ИНН, СНИЛС, API-ключи, PEM; действия — redact/deny/rework. pseudonymize обратимо заменяет значения токенами и хранит их в локальном зашифрованном vault'е |
| Аудит действий | Access-лог каждого HTTP-запроса и журнал событий (tool-вызовы, бюджеты, ошибки, решения операторов). Значения токенов не логируются |
| Одобрение действий | Чувствительные инструменты гейтятся human-in-the-loop в ядре — агент не может обойти одобрение, в том числе через prompt injection |
| Секреты и шифрование | Секреты только в .env, в YAML — лишь имя переменной; TLS на уровне сервера; OAuth-токены коннекторов шифруются (AES-256-GCM) |
| Изоляция исполнения | Инструменты работают в песочнице (лимиты ФС и сети). Доступ к БД — через sql_tool с настраиваемым readonly (по умолчанию запись разрешена); shell_tool запускает только авторский CLI |
Пример: как работает маскирование ПДн
Пользователь: Мой паспорт 4512 345678, проверьте заказ
Агент (видит): Мой паспорт [PASSPORT_MASKED], проверьте заказ
В логах: [PASSPORT_MASKED] — исходные данные не
сохраняются, только факт обнаружения ПДн
3. База знаний и данные
Агент хорош ровно настолько, насколько актуальны его знания. Источники делятся на два типа: поисковый архив и живые данные через инструменты.
Как агент получает знания:
| Способ | Как работает | Для каких данных |
|---|---|---|
| Поисковый архив | Сайт обходится краулером (agent-os scrape) в полнотекстовый архив (BM25). Хук rag впрыскивает релевантные фрагменты в контекст, archive_tool ищет по архиву |
Регламенты, инструкции, FAQ, контент сайта |
| Документы по запросу | PDF, Word/Excel/PowerPoint читаются инструментами в момент обращения (pdf_tool, office_tool) — без предварительной индексации |
Приказы, положения, договоры |
| Живые данные (API) | site_tool и OAuth-коннекторы ходят в REST-API в реальном времени; sql_tool — запросы к PostgreSQL/MySQL; duckdb_tool — собственная БД агента |
Товары, цены, статусы заказов |
| RSS / JSON | rss_tool и json_tool ищут по лентам и файлам |
Новости, выгрузки |
Актуализация. Архив пересобирается краулером — вручную, скриптом или по cron. Автоматической индексации документов (Confluence, Google Docs, 1С) и версионирования базы знаний нет.
4. Контроль качества
Агент должен не просто отвечать, а отвечать хорошо. Качество держится на управляемых механизмах.
| Механизм | Что делает |
|---|---|
| Заземление ответа | Хук groundedness сверяет утверждения ответа с архивом и результатами инструментов; link_check проверяет ссылки |
| Схема и формат | schema_guard валидирует ответ и аргументы инструментов по JSON Schema; format_guard следит за ссылками |
| Разрыв циклов | loop_guard останавливает зацикливание вызовов инструментов |
| Оценки пользователей | Лайк/дизлайк по ответу (feedback), статистика для администратора |
| Наблюдаемость | Метрики хуков по точкам, тайминги, circuit breaker провайдера, Prometheus /metrics |
| Бенчмарки | Прогоны агентов на наборе сценариев (bench) с историей результатов |
| Анализ слепых зон | Инструменты и вопросы, где агент чаще всего не справляется (аналитика диалогов) |
5. Интеграционный слой
Агент не существует в вакууме — он подключается к ИТ-ландшафту компании.
Встроенные интеграции:
| Система | Что даёт |
|---|---|
Drive, Sheets, Docs, Slides и Calendar (google_tool, calendar_tool) |
|
| Яндекс | Яндекс.Диск и Яндекс.Календарь (yandex_tool) |
| Базы данных | PostgreSQL и MySQL через sql_tool; своя DuckDB у агента |
| Хранилища файлов | S3, WebDAV, FTP (storage_tool) |
| Почта | Приём IMAP и отправка SMTP (email) |
| Мессенджеры | Telegram, VK, Яндекс Мессенджер (каналы и sink'и) |
| Произвольные API | site_tool (REST, OAuth2, HMAC-подпись) и OAuth-коннекторы (oauth_connect/connector_request) |
| MCP-серверы | Любые инструменты по стандарту Model Context Protocol (mcp_tool) |
В планах: 1С/ERP, amoCRM/Bitrix24, Active Directory/LDAP, ClickHouse, Jira/Kaiten/Notion, платёжные шлюзы (ЮKassa и др.), службы доставки (СДЭК, ПЭК, Почта России), WhatsApp Business API. Нативной поддержки у них пока нет — часть достижима только произвольным HTTP через site_tool.
Каналы доставки
Агент должен быть там, где пользователь. Не пользователь идёт к агенту, а агент — к пользователю.
1. Виджет на сайте
Самый очевидный канал для внешних клиентов.
| Характеристика | Описание |
|---|---|
| Где | Сайт компании, интернет-магазин, личный кабинет, портал госуслуг |
| Как выглядит | Плавающая кнопка «Чат с AI» в правом нижнем углу. При клике — окно диалога |
| Кастомизация | Цвета, логотип, приветственное сообщение, аватар агента |
| Эскалация | Если агент не решил → перевод на живого оператора (чат, звонок, заявка) |
| Контекст | Агент видит, на какой странице находится пользователь, и может использовать это в ответе |
| Аналитика | Каждая сессия записывается, источник трафика известен |
Пример размещения:
Сайт университета
├─ Главная — виджет с предложением: «Я отвечу на вопросы
│ о поступлении, расписании и студенческой жизни»
├─ Страница приёмной кампании — виджет автоматически предлагает:
│ «Хотите узнать проходной балл на ваш факультет?»
└─ Личный кабинет студента — виджет в контексте: «Нужна справка
об обучении? Я помогу оформить»
2. Telegram-бот
Самый популярный канал в России для внутренних коммуникаций и поддержки.
| Характеристика | Описание |
|---|---|
| Где | Отдельный бот @CompanyHelperBot или встроенный в корпоративный чат |
| Для кого | Сотрудники (HR, IT, документы), клиенты (поддержка, заказы), партнёры |
| Преимущества | Не требует установки — Telegram есть у всех. Push-уведомления. Привычный интерфейс |
| Документы | Отправка PDF, изображений, таблиц прямо в чат |
| Кнопки | Быстрые действия: «Мой расчётный листок», «Статус заказа», «Оформить отпуск» |
Сценарий для производства (производственная компания):
Сотрудник цеха открывает Telegram на смартфоне → @CompanyHelperBot
→ «Оформить отгул» → одна кнопка → готово.
Не нужно: искать компьютер, заходить в 1С, помнить пароль,
разбираться в интерфейсе.
3. VK, Яндекс Мессенджер, email и API
Кроме виджета и Telegram, агент подключается к другим каналам:
| Канал | Характеристика |
|---|---|
| VK | Бот сообщества через Long Poll: сообщения, вложения, быстрые действия |
| Яндекс Мессенджер | Бот Яндекс 360 через getUpdates — для сотрудников на Яндекс-платформе |
Приём писем по IMAP и ответ по SMTP; email_tool — исходящие |
|
| HTTP API (SSE) | POST /v1/chat/completions — основной программный интерфейс и стриминг ответа |
| Webhook | POST /v1/inbound/:template — внешняя система запускает агента и синхронно получает ответ |
Сравнение каналов
| Канал | Где применяется | Авторизация | Push |
|---|---|---|---|
| Виджет на сайте | Сайт, интернет-магазин, личный кабинет | Сессия сайта | Нет |
| Telegram | Внешние клиенты и сотрудники | Отдельно (телефон/токен) | Да |
| VK / Яндекс Мессенджер | Сообщество, корпоративный контур | Токен бота/сообщества | Зависит от платформы |
| Внешняя переписка, заявки | IMAP-учётка | Нет | |
| HTTP API | Встраивание в свои продукты | Bearer / билет пользователя | Нет |
Дополнительно: результат работы агента-наблюдателя уходит в sink — вебхук, Telegram, VK, Яндекс Мессенджер, email, другой агент или storage (S3/WebDAV/FTP).
Архитектура: как это работает
flowchart TB
subgraph channels["📱 КАНАЛЫ"]
Widget["Виджет на сайте"]
Messengers["Telegram · VK · Яндекс"]
Api["HTTP API (SSE)"]
Email["Email"]
end
subgraph triggers["⏰ ТРИГГЕРЫ — запуск без человека"]
Cron["Cron"]
Webhook["Webhook"]
Monitor["Monitor (RSS и др.)"]
end
Host["🌐 Хост — HTTP-сервер<br/>аутентификация · админ-UI"]
subgraph kernel["🧠 ЯДРО — операционная система для агентов"]
direction TB
Sched["Планировщик<br/>конкурентность и очередь"]
Processes["Таблица процессов<br/>агент = процесс (PID, состояние)"]
Ctx["Контекст (аналог RAM)<br/>вытеснение и сжатие"]
Budg["Бюджеты (аналог cgroups)<br/>token bucket · группы"]
Hooks["Хуки жизненного цикла<br/>guard · rag · memory · cache"]
Ipc["IPC и системные вызовы<br/>spawn · fork · send/recv"]
end
subgraph providers["⚙️ ИНФЕРЕНС (аналог CPU)"]
Router["Маршрутизация моделей<br/>и кэш инференса"]
Llm["LLM<br/>OpenAI-совместимый · DeepSeek · Ollama"]
end
subgraph tools["🔧 ИНСТРУМЕНТЫ (аналог устройств I/O)"]
Web["Сеть · сайты · браузер"]
Know["Архив поиска (BM25) · PDF · документы"]
Db["SQL · DuckDB · файлы"]
Act["Скрипты · субагенты · почта · S3"]
end
subgraph store["💾 ХРАНИЛИЩА"]
Transcripts["Транскрипты диалогов"]
Events["Журнал событий (аудит)"]
State["State store"]
end
subgraph modules["🧩 МОДУЛИ — фичи поверх ядра"]
Wf["Workflow (DAG)"]
Analytics["📊 Аналитика диалогов"]
Approvals["Approvals · эскалация"]
Connectors["Коннекторы (OAuth)"]
end
Widget --> Host
Messengers --> Host
Api --> Host
Email --> Host
Cron --> Host
Webhook --> Host
Monitor --> Host
Host --> Sched
Sched --> Processes
Processes --> Ctx
Processes --> Budg
Processes --> Hooks
Processes --> Ipc
Hooks --> Router
Router --> Llm
Processes --> Web
Processes --> Know
Processes --> Db
Processes --> Act
Processes --> Transcripts
Processes --> Events
Processes --> State
Events -.-> Analytics
Hooks -.-> Approvals
Ipc -.-> Wf
Act -.-> Connectors
Ключевые принципы:
- Агент — это процесс. Каждый агент запускается как самостоятельный процесс со своим PID, контекстом, набором инструментов и бюджетом. Шаблон агента (
agent.yaml) — это рецепт; процесс создаётся лениво, на первый запрос. Воркфлоу и субагенты — тоже процессы, с семантикойspawn/fork. - Ядро — это порядок. Один асинхронный рантайм планирует все процессы, держит лимит конкурентности и распределяет бюджеты (token bucket, группы на пользователя и сессию). Ядро посредничает в каждом вызове инструмента: валидирует аргументы, ограничивает по времени, логирует и считает стоимость.
- Модель — сменный процессор. Ядро не делает инференс само, а планирует его на подключаемом провайдере (OpenAI-совместимый API, DeepSeek, Ollama). Маршрутизация моделей выбирает модель под запрос, кэш инференса убирает повторные вызовы.
- Управляемость через хуки. Хуки перехватывают жизненный цикл в точках «до/после сообщения, вызова инструмента, инференса, стрима токенов, компакции контекста». Отсюда DLP и маскирование ПДн (
guard,pseudonymize), заземление ответа (groundedness), память (memory), RAG (rag), кэши (faq_cache,tool_cache), разрыв циклов (loop_guard). - Модульность. Ядро — только механизм; фичи (workflow, cron, каналы, аналитика, коннекторы, память, маршрутизация моделей, документация) — отдельные модули, подключаемые к ядру через единый шов сервисов. Отключённая подсистема отвечает «не настроено», а не ломает платформу.
- Автономность через триггеры. Агент запускается не только сообщением: cron — по расписанию, webhook — внешним push, monitor — при появлении новых данных (RSS). Результат уходит в sink: вебхук, Telegram, email, другой агент.
- Контроль и изоляция. Агент не читает чужой контекст и не тратит чужой бюджет. Все шаги пишутся в транскрипты и журнал событий (аудит). Рабочая база знаний — поисковый архив BM25; доступ к внешним БД и системам — только через инструменты, с настраиваемым read-only и подтверждением.
Заключение
AI-агенты для бизнеса — это не магия и не хайп. Это инженерное решение, которое сшивает три вещи:
- Модель — большая языковая модель, понимающая естественный язык.
- Данные компании — документы, базы, регламенты, товарный каталог.
- Каналы — сайт, Telegram, VK, Яндекс Мессенджер, email — там, где пользователь.
Результат: сотрудники и клиенты получают ответ за секунды, бизнес экономит миллионы, аналитики наконец занимаются аналитикой, а не выгрузками.
И всё это — с окупаемостью от недели.