Аусура алагара/Алагалажәа
Алагалажәа
v1.0.x · ирҿыцуп 2026-06-26
AiHummer хатәы-хостуа AI-агенттә платформоуп абизнес азы. Уи иалнагалоит ацҳамҭақәа
аусуҩцәеи аклиентцәеи рканалқәа рҟынтә, инаганахуеит зегьы изыргоу агент ахь, иарҿиоит
функциа-аасфаратә ҩаԥхьара хархәартәқәеи иуааҟәымҭхо ахашҭра рыманы, насгьы инанагоит аҭак
аалаганатә канал ахь — зегьы иманаджироуп веб аадминистраторатә UI насгьы OpenAI-иадгылоу
API аҟынтә.
Ари иҵыхәтәоу продукт, фреимуорк ма SDK акымкуа. Ак хатәы-иҵыхәтәоу аусура иныҟәоит
аконтроль-плоскость насгьы аҩаԥхьара двигатель аиԥш, абри аҟынтә иҟоу дислои ак аусура
PostgreSQL аманы.
Иашәоу
- Рацәа-агент оркестраз сабагентқәа насгьы иалкаау аилкаара астратегиақәа рыла
(plan-steps, reflect, debate, best-of-N, self-heal).
- Актәи-класс агентқәа персонақәа, иаргылоу аҩаԥхьара насгьы агент-аканы модель рыманы.
- Иуааҟәымҭхо ахашҭра (Einstein) — афактқәа иргоуп иныҟәоу клеимқәа аиԥш, нас иргоуп
ахашҭра ахь; аиаргьежьра иуроуп датa-фенс аҿы аҩаԥхьара инъекз аҿагыланы.
- Адырра / RAG цитатақәа рыла, насгьы
deep_research рацәа-арбагала аотчетқәа рзы.
- Аканалқәа — Telegram, MAX (аурыс мессенджер, иаԥҵаз), Bitrix24 (аҩныҵҟатәи аусуҩ IM),
SIP телефониа, иаргылатәу веб виджет насгьы мобильтәи десктоптәи апп.
- Аплагин маркетплеис ак-аасфаратә, хост-нативтә инсталл аманы.
- Зашифрау акредитсиатә vault, энтерпрайз SSO (SAML / LDAP / SCIM / OIDC) насгьы Postgres
Row-Level Security рацәа-тенант аизардаразы.
Аҩаԥхьара шаалга
- Аканал инанагоит инбаунд цҳамҭа гейтуэй ахь.
- Ароутер иалнахуеит изыргоу агент абиндингқәа,
@-апомена ма фолбек ала.
- Аоркестратор иеилнагалоит слойтә, кеш-маатәу аусуратә аҩаԥхьара насгьы инарҿиоит
функциа-аасфаратә ажурнал иаргьежьтә иадгылоу хархәартәқәа, сабагентқәа насгьы аплагинқәа.
- Ахашҭра насгьы адырра иргылоит аҭак; ҩыџьагьы иаауеит хархәартә ҵаҟара аиԥш, мап аҵаны
иинъектироу инструкзқәа аиԥш.
- Иаргылоу-инаганатә outbox инанагоит аҭак аалаганатә канал ахь.
channel ─▶ router ─▶ orchestrator (tools · sub-agents · memory · RAG) ─▶ outbox ─▶ channel
Хадоу аҧҟарақәа
Абарҭ маркетингтә сҭрқәа акымкуа — абри агид адаҟьа зегьы дара рыҩныҵҟа иаанхоит.
- Хост-нативтә, Docker акымкуа. AiHummer дислоиуп арелизтә тарбол аиԥш systemd иаҵаҟа
/home/.aihummer аҟынтә. Аконтейнерқәа ма аоркестраторқәа ыҟам.
- Иҭахуа ахуа модельқәа рымкуа. Уи иныҟәоит хәыда/локалтә модельқәа насгьы
Codex/ChatGPT-абонементтә транспорт ала. Тенант-аканы BYOK аклавишқәа иалкаауп.
- Ашәарҭадара хадоу аҟазшьа аиԥш. Энвелоп-зашифрау vault, ауаҩы-ажурнал-аҿы-иҟоу
аиқәҿиаратә гейтқәа, идемпотент аусеихшьара, аҩаԥхьара-инъекз датa-фенс, IP алоулист
насгьы аудит.
- Аиҵысра. SemVer ала иаԥхьа-шәарҭадоу, иаргылатә-иадгылоу adatabaza амигразқәа аманы.
[!NOTE]
AiHummer иаанарԥшуеит OpenAI-иадгылоу POST /v1/chat/completions эндпоинт (SSE стриминг
аманы). Уи иаанарԥшуам /v1/models ма /v1/embeddings, насгьы аобсервабельтә
OTLP-пуш — Prometheus /metrics эндпоинт ыҟам.
Изызкуа
- Акомпаниақәа иҭаху аҩныҵҟатәи AI аусуҩ аусуҩцәа ирыҭаку Telegram ма Bitrix24 ала,
ахашҭра, адырра насгьы аиқәҿиаратә гейтқәа рыманы.
- Аклиент-ихадоу акоманда агент аиҭагала сайт аҿы, аҭелтә хыр аҿы ма мобильтә апп аҿы.
- Ашәарҭадара-, акомплаиенс- насгьы асувернитет-ихадоу адислоиқәа иҭаху хатәы-хостра,
Docker акымкуа, иҭахуа внешнетә ахуа модель акымкуа, зашифрау секретқәа, RLS аизардара
насгьы SSO.
- Аплатформа насгьы IT акомандақәа иҭаху иҵыхәтәоу продукт — аадминистраторатә UI,
рацәа-тенантра, маркетплеис — фреимуорк аиларгьаагатә акымкуа.
Иахьынтә ашьҭахь
**AiHummer хатәы-хостуа AI-агенттә платформоуп абизнес азы.** Уи иалнагалоит ацҳамҭақәа
аусуҩцәеи аклиентцәеи рканалқәа рҟынтә, инаганахуеит зегьы изыргоу агент ахь, иарҿиоит
функциа-аасфаратә ҩаԥхьара хархәартәқәеи иуааҟәымҭхо ахашҭра рыманы, насгьы инанагоит аҭак
аалаганатә канал ахь — зегьы иманаджироуп веб аадминистраторатә UI насгьы OpenAI-иадгылоу
API аҟынтә.
Ари **иҵыхәтәоу продукт**, фреимуорк ма SDK акымкуа. Ак хатәы-иҵыхәтәоу аусура иныҟәоит
аконтроль-плоскость насгьы аҩаԥхьара двигатель аиԥш, абри аҟынтә иҟоу дислои ак аусура
PostgreSQL аманы.
## Иашәоу
- **Рацәа-агент оркестраз** сабагентқәа насгьы иалкаау аилкаара астратегиақәа рыла
(plan-steps, reflect, debate, best-of-N, self-heal).
- **Актәи-класс агентқәа** персонақәа, иаргылоу аҩаԥхьара насгьы агент-аканы модель рыманы.
- **Иуааҟәымҭхо ахашҭра (Einstein)** — афактқәа иргоуп иныҟәоу клеимқәа аиԥш, нас иргоуп
ахашҭра ахь; аиаргьежьра иуроуп датa-фенс аҿы аҩаԥхьара инъекз аҿагыланы.
- **Адырра / RAG** цитатақәа рыла, насгьы `deep_research` рацәа-арбагала аотчетқәа рзы.
- **Аканалқәа** — Telegram, MAX (аурыс мессенджер, иаԥҵаз), Bitrix24 (аҩныҵҟатәи аусуҩ IM),
SIP телефониа, иаргылатәу веб виджет насгьы мобильтәи десктоптәи апп.
- **Аплагин маркетплеис** ак-аасфаратә, хост-нативтә инсталл аманы.
- **Зашифрау акредитсиатә vault**, энтерпрайз SSO (SAML / LDAP / SCIM / OIDC) насгьы Postgres
Row-Level Security рацәа-тенант аизардаразы.
## Аҩаԥхьара шаалга
1. **Аканал** инанагоит инбаунд цҳамҭа гейтуэй ахь.
2. **Ароутер** иалнахуеит изыргоу агент абиндингқәа, `@`-апомена ма фолбек ала.
3. **Аоркестратор** иеилнагалоит слойтә, кеш-маатәу аусуратә аҩаԥхьара насгьы инарҿиоит
функциа-аасфаратә ажурнал иаргьежьтә иадгылоу хархәартәқәа, сабагентқәа насгьы аплагинқәа.
4. **Ахашҭра насгьы адырра** иргылоит аҭак; ҩыџьагьы иаауеит хархәартә ҵаҟара аиԥш, мап аҵаны
иинъектироу инструкзқәа аиԥш.
5. **Иаргылоу-инаганатә outbox** инанагоит аҭак аалаганатә канал ахь.
```text
channel ─▶ router ─▶ orchestrator (tools · sub-agents · memory · RAG) ─▶ outbox ─▶ channel
```
## Хадоу аҧҟарақәа
Абарҭ маркетингтә сҭрқәа акымкуа — абри агид адаҟьа зегьы дара рыҩныҵҟа иаанхоит.
- **Хост-нативтә, Docker акымкуа.** AiHummer дислоиуп арелизтә тарбол аиԥш systemd иаҵаҟа
`/home/.aihummer` аҟынтә. Аконтейнерқәа ма аоркестраторқәа ыҟам.
- **Иҭахуа ахуа модельқәа рымкуа.** Уи иныҟәоит хәыда/локалтә модельқәа насгьы
Codex/ChatGPT-абонементтә транспорт ала. Тенант-аканы BYOK аклавишқәа иалкаауп.
- **Ашәарҭадара хадоу аҟазшьа аиԥш.** Энвелоп-зашифрау vault, ауаҩы-ажурнал-аҿы-иҟоу
аиқәҿиаратә гейтқәа, идемпотент аусеихшьара, аҩаԥхьара-инъекз датa-фенс, IP алоулист
насгьы аудит.
- **Аиҵысра.** SemVer ала иаԥхьа-шәарҭадоу, иаргылатә-иадгылоу adatabaza амигразқәа аманы.
> [!NOTE]
> AiHummer иаанарԥшуеит OpenAI-иадгылоу `POST /v1/chat/completions` эндпоинт (SSE стриминг
> аманы). Уи **иаанарԥшуам** `/v1/models` ма `/v1/embeddings`, насгьы аобсервабельтә
> OTLP-пуш — Prometheus `/metrics` эндпоинт ыҟам.
## Изызкуа
- **Акомпаниақәа иҭаху аҩныҵҟатәи AI аусуҩ** аусуҩцәа ирыҭаку Telegram ма Bitrix24 ала,
ахашҭра, адырра насгьы аиқәҿиаратә гейтқәа рыманы.
- **Аклиент-ихадоу акоманда** агент аиҭагала сайт аҿы, аҭелтә хыр аҿы ма мобильтә апп аҿы.
- **Ашәарҭадара-, акомплаиенс- насгьы асувернитет-ихадоу адислоиқәа** иҭаху хатәы-хостра,
Docker акымкуа, иҭахуа внешнетә ахуа модель акымкуа, зашифрау секретқәа, RLS аизардара
насгьы SSO.
- **Аплатформа насгьы IT акомандақәа** иҭаху иҵыхәтәоу продукт — аадминистраторатә UI,
рацәа-тенантра, маркетплеис — фреимуорк аиларгьаагатә акымкуа.
## Иахьынтә ашьҭахь
- Аҿыцрауп абраҟа? Иашәынҵа [Аҭахрақәа](/ab/v1.0/getting-started/requirements)
насгьы [Аинсталл](/ab/v1.0/getting-started/installation).
- Иашәҭаху ацәгьара модель раԥхьа? Иашәырԥхьа
[Гейтуэй & аҩаԥхьара двигатель](/ab/v1.0/architecture/gateway-turn-engine).
- API аҿагыланы иашәҩуа? Иашәырԥхьа
[chat/completions](/ab/v1.0/api/chat-completions).