Введение — AiHummer Документация

AiHummer — платформа ИИ‑сотрудников для бизнеса, доступная в облаке и на вашем сервере. Она принимает сообщения из каналов для сотрудников и клиентов, направляет их нужному агенту, подключает память и инструменты и возвращает ответ в исходный канал. Управление доступно в веб‑интерфейсе и через OpenAI‑совместимый API.

Это готовый продукт, а не фреймворк и не SDK. Единый самодостаточный сервис объединяет административный API и движок обработки запросов, поэтому типовая установка — это один сервис плюс PostgreSQL.

Что вы получаете

Мультиагентная оркестрация с суб-агентами и опциональными стратегиями рассуждения (план-шаги, рефлексия, дебаты, best-of-N, самовосстановление).
Полноценные агенты с профилями, структурированным промптом и своей моделью на каждого агента.
Долговременная память (Einstein) — факты извлекаются как проверяемые утверждения‑кандидаты, затем продвигаются в память; выдача обёрнута в защитную обёртку данных (data-fence), снижающую риск инъекций в промпт.
Знания — поиск по базе знаний с добавлением найденных фрагментов в контекст (RAG), со ссылками на источники и deep_research для многошаговых отчётов.
Каналы — Telegram, VK, Авито, MAX, Bitrix24, SIP-телефония, мобильное и настольное приложение; доступность зависит от установленных коннекторов.
Маркетплейс плагинов с установкой в один клик — напрямую в Linux под systemd, без Docker.
Зашифрованное хранилище секретов (vault), корпоративный SSO (SAML / LDAP / SCIM / OIDC) и Postgres Row-Level Security для изоляции арендаторов (multitenancy).

Как обрабатывается запрос

Канал доставляет входящее сообщение в шлюз.
Маршрутизатор определяет целевого агента по привязкам, @-упоминаниям или резервному агенту.
Оркестратор собирает слоистый, дружелюбный к кэшу системный промпт и ведёт цикл вызова функций по встроенным инструментам, суб-агентам и плагинам.
Память и знания обосновывают ответ; и то, и другое приходит как результаты инструментов, а не как внедрённые инструкции.
Сервис доставки возвращает ответ в канал-источник, повторяет отправку по настроенной политике и сообщает понятную ошибку, если доставить не удалось.

канал ─▶ маршрутизатор ─▶ оркестратор (инструменты · суб-агенты · память · RAG) ─▶ доставка ─▶ канал

Основополагающие принципы

Это не маркетинговые лозунги — все страницы этого руководства остаются внутри них.

Установка напрямую в Linux под systemd, без Docker. AiHummer разворачивается как релизный tarball под управлением systemd из ~/.aihummer (домашнего каталога пользователя, запустившего установщик). Никаких контейнеров и оркестраторов.
Без обязательных платных моделей. Работает на свободных/локальных моделях и транспорте через подписку Codex/ChatGPT. Собственные ключи провайдеров (BYOK) на арендатора — опционально.
Безопасность как базовое свойство. Хранилище секретов с конвертным шифрованием, обязательные одобрения с участием человека, идемпотентные побочные эффекты, защитная обёртка данных, список разрешённых IP-адресов и аудит.
Стабильность. SemVer с обратно совместимыми, автоприменяемыми миграциями БД.

[!NOTE] AiHummer предоставляет OpenAI-совместимый endpoint (адрес API) POST /v1/chat/completions с потоковой передачей ответа по SSE. Endpoints /v1/models и /v1/embeddings не предоставляются. AiHummer предоставляет базовые метрики Prometheus по GET /metrics и при необходимости отправляет расширенную телеметрию через OTLP. /debug/pprof не публикуется.

Для кого это

Компании, которым нужен внутренний ИИ-сотрудник, отвечающий персоналу в Telegram или Bitrix24, с памятью, знаниями и обязательными одобрениями.
Команды, работающие с клиентами, ставящие агента на сайт, телефонную линию или в мобильное приложение.
Развёртывания с упором на безопасность, комплаенс и суверенность, которым нужны размещение на своём сервере, отсутствие Docker, отсутствие обязательной внешней платной модели, шифрование секретов, изоляция RLS и SSO.
Платформенные и ИТ-команды, которым нужен готовый продукт — админ-панель, multitenancy, маркетплейс — а не сборка фреймворка.

Облако или свой сервер: что выбрать

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

	Облако (managed cloud)	Свой сервер (self-hosted)
Кто держит сервер	Мы — вы получаете готовый адрес `<имя>.cloud.aihummer.ru`	Вы — ставите на свой Linux-сервер
Что нужно от вас	Только зарегистрироваться и оплатить	Linux-сервер (root или установка без root)
Как быстро запуск	Несколько минут после оплаты	Одна команда установки + первый вход
Пробный период	10 дней бесплатно на младшем тарифе	Тариф Community бесплатно, без облака
Обновления	Автоматически на нашей стороне	Инстанс обновляется сам по вашей ссылке
Кому подходит	Тем, кто хочет «просто работающего» помощника без своего сервера	Тем, кому важны суверенность данных, свой контур, комплаенс

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

Хочу облако → Регистрация и вход, затем Тарифы и Заказ и оплата.
Хочу свой сервер → Требования и Установка.

Куда дальше

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