Neiron · Документация

2. Агенты и иерархия

Что такое агент?

Агент — это AI-сотрудник с:

  • Ролью — кем он является (аналитик, закупщик, маркетолог)
  • Памятью — он помнит историю, решения, контекст вашего бизнеса
  • Навыками — умениями выполнять конкретные задачи
  • Доступами — к каким системам он подключён
  • Расписанием — что он делает автоматически

Каждый агент — это отдельный Telegram-бот, с которым вы общаетесь напрямую.

Все агенты создаются и настраиваются через админ панель.

Роли агентов

У каждого агента есть роль, которая определяет его возможности:

Директор

  • Может создавать новые подключения (коннекторы), инструкции и навыки
  • Может ставить задачи подчиненным агентам (если они есть)
  • Основная точка входа для собственника
  • Знает всю структуру компании
  • Собирает сводки и отчёты

Пример: главный агент компании — Директор. Он принимает ваши запросы и координирует всю работу.

Сотрудник (работник)

  • Работает по уже созданным навыкам
  • Выполняет конкретные задачи в своей области
  • Не может создавать новые навыки или подключения — только использовать

Примеры: агент-аналитик, агент-закупщик, агент-маркетолог, персональный агент сотрудника.

Публичный агент

  • Может общаться с внешними пользователями (клиентами, лидами)
  • Имеет доступ только к своим данным
  • Не имеет доступа к общим файлам компании и общим навыкам — работает в изолированной среде
  • Отвечает на заявки, вопросы, обрабатывает входящие обращения
  • Может отправлять сообщения в корпоративный чат. Например, отправлять заявки (выставляется в админ панели)

Иерархия агентов: Руководитель и Подчинённый

Кроме роли, агенты различаются по положению в иерархии:

Руководитель

Агент, у которого есть подчинённые агенты. Руководитель:

  • Может ставить задачи своим подчинённым
  • Видит логи и сообщения подчинённых агентов
  • Может писать через подчинённых сотрудникам или в чаты Telegram
  • Имеет доступ к файлам подчинённых агентов

Подчиненный

Агент, у которого есть руководитель. Подчинённый:

  • Выполняет задачи, которые ставит руководитель
  • Если у него самого нет подчинённых — не может ставить задачи другим агентам и читать их логи
Главный агент (Директор + Руководитель)
 ├── Агент-закупщик (Сотрудник + Подчинённый)
 ├── Агент-маркетолог (Сотрудник + Руководитель)
          └── Специалист по рекламе (Сотрудник + Подчинённый)
 ├── Агент-ассистент (Сотрудник + Подчинённый)
 └── Публичный агент (Публичный + Подчинённый)

Примеры специализаций агентов-сотрудников

АгентЧто делает
АналитикОтчёты, динамика, аномалии, сравнения
ЗакупщикОстатки, заявки, поставщики, подсорт
МаркетологРеклама, акции, СПП, A/B тесты
КонтентщикВидео, карточки, SEO, инфографика
Менеджер по клиентамОтзывы, вопросы, претензии
HR-агентСводки по команде, расшифровки, KPI
Персональный ассистентПомощник конкретного сотрудника

Как агент «знает» ваш бизнес?

При запуске агент получает:

  1. Системный промпт — его роль, правила, характер
  2. Базу знаний компании — продукты, KPI, правила
  3. Личную память — накопленная история взаимодействий
  4. Навыки — инструкции, как выполнять конкретные задачи

Чем дольше агент работает, тем лучше он знает ваш бизнес. Знания накапливаются в MD-файлах и не теряются.

Модели ИИ: можно настраивать

Каждый агент использует языковую модель (LLM). Модель выбирается отдельно для каждого агента и при необходимости переключается в админ-панели без потери текущего диалога.

Принцип экономии: не все задачи требуют дорогой модели.

  • Простые задачи (форматирование, стандартные отчёты) → дешёвая модель
  • Сложные задачи (анализ, стратегия, нестандартные ситуации) → мощная модель

Сильные модели подходят для разработки, сложного анализа и архитектуры; экономичные — для регулярных операций. Альтернативные и открытые модели тестируются и не должны считаться готовой функцией до отдельного подтверждения. Из новых провайдеров стала доступна модель DeepSeek — её можно подключить к агенту по API как ещё один вариант модели.

Как добавить нового агента

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

Шаг 1: Создать Telegram-бот

  1. Откройте Telegram, найдите @BotFather
  2. Отправьте /newbot и следуйте инструкциям
  3. Получите токен бота (строка вида 123456789:AAF...)

Шаг 2: Добавить агента в админ панель

  1. Перейдите на app.neiron.org
  2. Создайте нового агента
  3. Вставьте токен Telegram-бота
  4. Выберите языковую модель
  5. Привяжите к нужным сотрудникам
  6. Пропишите промпт (роль, правила, характер агента)

После этого агент готов к работе — он появится в Telegram и начнёт отвечать.

Как добавить агента в групповой чат

Шаг 1: Настроить через BotFather В @BotFather выполните команду /setprivacy для вашего бота → выберите disabled. Это позволит боту читать сообщения в группе и отвечать в ней.

Шаг 2: Добавить бота в чат Добавьте бота в Telegram-группу как обычного участника. Система автоматически обнаружит новый чат.

Если бот не добавился автоматически:

  1. Откройте app.neiron.org
  2. Зайдите в настройки агента → раздел «Связи»
  3. Добавьте новый чат вручную

Обновлено 25.09.2026 · версия 1