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

AiHummer — это self-hosted платформа ИИ-агентов для бизнеса. Она принимает сообщения из сотрудниковых и клиентских каналов, направляет каждое нужному агенту, выполняет ход (turn) с вызовом инструментов и долговременной памятью и возвращает ответ обратно в канал-источник — всё это управляется из веб-админки и через OpenAI-совместимый API.

Это готовый продукт, а не фреймворк и не SDK. Единый самодостаточный сервис выступает и control-plane, и turn-движком, поэтому типовая установка — это один сервис плюс PostgreSQL.

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

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

Как проходит ход (turn)

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

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

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

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

Host-native, не Docker. AiHummer разворачивается как релизный tarball под управлением systemd из /home/.aihummer. Никаких контейнеров и оркестраторов.
Без обязательных платных моделей. Работает на свободных/локальных моделях и транспорте через подписку Codex/ChatGPT. Ключи BYOK на арендатора — опционально.
Безопасность как базовое свойство. Vault с конвертным шифрованием, гейты одобрения с участием человека, идемпотентные побочные эффекты, data-fence против инъекций, IP-allowlist и аудит.
Стабильность. SemVer с безопасными вперёд, автоприменяемыми миграциями БД.

[!NOTE] AiHummer предоставляет OpenAI-совместимый эндпоинт POST /v1/chat/completions (со стримингом по SSE). Эндпоинтов /v1/models или /v1/embeddings нет, а наблюдаемость работает по push-модели OTLP — эндпоинта Prometheus /metrics тоже нет.

Для кого это

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

Куда дальше

Только начинаете? Перейдите к Требованиям и Установке.
Сначала хотите понять модель? Прочитайте Gateway и turn-движок.
Интегрируетесь с API? Откройте chat/completions.