AiHummer-ը self-hosted AI-գործակալ հարթակ է բիզնեսի համար։ Այն ընդունում է
հաղորդագրություններ աշխատակիցների և հաճախորդների ալիքներից, ուղղորդում յուրաքանչյուրը
ճիշտ գործակալին, գործարկում function-calling ընթացք գործիքներով և երկարաժամկետ
հիշողությամբ, և պատասխանը հետ առաքում սկզբնական ալիք — ամբողջը կառավարվում է վեբ ադմին
UI-ից և OpenAI-համատեղելի API-ից։
Այն ամբողջական արտադրանք է, այլ ոչ թե framework կամ SDK։ Մեկ ինքնակառավարվող
ծառայություն հանդես է գալիս և՛ որպես control-plane, և՛ որպես ընթացքի շարժիչ, ուստի
տիպիկ տեղակայումը մեկ ծառայություն է գումարած PostgreSQL։
Առաջին կարգի գործակալներ անձնավորություններով, կառուցվածքային prompt-ով և
ըստ-գործակալի մոդելով։
Երկարաժամկետ հիշողություն (Einstein) — փաստերը արդյունահանվում են որպես
վերանայելի claim-եր, ապա առաջ տարվում դեպի հիշողություն. վերհիշումը փաթաթված է
data-fence-ով՝ prompt injection-ի դեմ։
Գիտելիք / RAG մեջբերումներով, գումարած deep_research բազմափուլ զեկույցների համար։
Ալիքներ — Telegram, MAX (ռուսական մեսենջեր, նոր), Bitrix24 (ներքին
աշխատակիցների IM), SIP հեռախոսակապ, ներդրվող վեբ վիջեթ և բջջային ու դեսքթոփ հավելված։
Plugin-ների marketplace մեկ կտտոցով, host-native տեղադրմամբ։
Գաղտնագրված հավատարմագրերի vault, ձեռնարկության SSO (SAML / LDAP / SCIM / OIDC)
և Postgres Row-Level Security բազմավարձակալ մեկուսացման համար։
Ինչպես է հոսում ընթացքը
Ալիքը ներգնա հաղորդագրություն է առաքում gateway-ին։
Router-ը լուծում է թիրախ գործակալը bindings-ի, @-հիշատակումների կամ
պահեստավորման միջոցով։
Orchestrator-ը հավաքում է շերտավորված, cache-բարյացակամ system prompt և
կառավարում function-calling ցիկլը ներկառուցված գործիքների, ենթա-գործակալների և
plugin-ների վրա։
Հիշողությունը և գիտելիքը հիմնավորում են պատասխանը. երկուսն էլ ժամանում են որպես
գործիքի արդյունքներ, երբեք որպես ներարկված հրահանգներ։
Երաշխավորված-առաքման outbox-ը պատասխանը վերադարձնում է սկզբնական ալիքին։
Սրանք մարքեթինգային տողեր չեն — այս ուղեցույցի յուրաքանչյուր էջ մնում է դրանց ներսում։
Host-native, ոչ Docker. AiHummer-ը տեղակայվում է որպես systemd-ի տակ
/home/.aihummer-ից աշխատող թողարկման tarball։ Կոնտեյներներ կամ orchestrator-ներ չկան։
Ոչ պարտադիր վճարովի մոդելներ. Այն աշխատում է անվճար/լոկալ մոդելների և
Codex/ChatGPT-բաժանորդագրության փոխադրման վրա։ Ըստ-վարձակալի BYOK բանալիները ընտրովի են։
Անվտանգությունը որպես հիմնական հատկություն. Envelope-գաղտնագրված vault,
human-in-the-loop հաստատման դարպասներ, idempotent կողմնակի էֆեկտներ,
prompt-injection data-fencing, IP allowlist և աուդիտ։
Կայունություն. SemVer առաջ-անվտանգ, ավտոմատ կիրառվող տվյալների բազայի
migration-ներով։
[!NOTE]
AiHummer-ը ներկայացնում է OpenAI-համատեղելի POST /v1/chat/completions վերջնակետ
(SSE streaming-ով)։ Այն չի ներկայացնում /v1/models կամ /v1/embeddings, և
դիտարկելիությունը OTLP-push է — Prometheus /metrics վերջնակետ չկա։
Ում համար է այն
Ընկերություններ, որոնք ուզում են ներքին AI աշխատակից, որը պատասխանում է
անձնակազմին Telegram-ի կամ Bitrix24-ի միջոցով, հիշողությամբ, գիտելիքով և հաստատման
դարպասներով։
Հաճախորդ-ուղղված թիմեր, որոնք գործակալ են դնում կայքի, հեռախոսային գծի կամ
բջջային հավելվածի վրա։
Անվտանգության, համապատասխանության և ինքնիշխանության գիտակից տեղակայումներ, որոնք
կարիք ունեն self-hosting-ի, առանց Docker-ի, առանց պարտադիր արտաքին վճարովի մոդելի,
գաղտնագրված գաղտնիքների, RLS մեկուսացման և SSO-ի։
Հարթակային և IT թիմեր, որոնք ուզում են ամբողջական արտադրանք — ադմին UI,
բազմավարձակալություն, marketplace — framework հավաքելու փոխարեն։
**AiHummer-ը self-hosted AI-գործակալ հարթակ է բիզնեսի համար։** Այն ընդունում է
հաղորդագրություններ աշխատակիցների և հաճախորդների ալիքներից, ուղղորդում յուրաքանչյուրը
ճիշտ գործակալին, գործարկում function-calling ընթացք գործիքներով և երկարաժամկետ
հիշողությամբ, և պատասխանը հետ առաքում սկզբնական ալիք — ամբողջը կառավարվում է վեբ ադմին
UI-ից և OpenAI-համատեղելի API-ից։
Այն **ամբողջական արտադրանք** է, այլ ոչ թե framework կամ SDK։ Մեկ ինքնակառավարվող
ծառայություն հանդես է գալիս և՛ որպես control-plane, և՛ որպես ընթացքի շարժիչ, ուստի
տիպիկ տեղակայումը մեկ ծառայություն է գումարած PostgreSQL։
## Ինչ եք ստանում
- **Բազմա-գործակալ նվագախմբավորում** ենթա-գործակալներով և ընտրովի դատողության
ռազմավարություններով (plan-steps, reflect, debate, best-of-N, self-heal)։
- **Առաջին կարգի գործակալներ** անձնավորություններով, կառուցվածքային prompt-ով և
ըստ-գործակալի մոդելով։
- **Երկարաժամկետ հիշողություն (Einstein)** — փաստերը արդյունահանվում են որպես
վերանայելի claim-եր, ապա առաջ տարվում դեպի հիշողություն. վերհիշումը փաթաթված է
data-fence-ով՝ prompt injection-ի դեմ։
- **Գիտելիք / RAG** մեջբերումներով, գումարած `deep_research` բազմափուլ զեկույցների համար։
- **Ալիքներ** — Telegram, MAX (ռուսական մեսենջեր, նոր), Bitrix24 (ներքին
աշխատակիցների IM), SIP հեռախոսակապ, ներդրվող վեբ վիջեթ և բջջային ու դեսքթոփ հավելված։
- **Plugin-ների marketplace** մեկ կտտոցով, host-native տեղադրմամբ։
- **Գաղտնագրված հավատարմագրերի vault**, ձեռնարկության SSO (SAML / LDAP / SCIM / OIDC)
և Postgres Row-Level Security բազմավարձակալ մեկուսացման համար։
## Ինչպես է հոսում ընթացքը
1. **Ալիքը** ներգնա հաղորդագրություն է առաքում gateway-ին։
2. **Router-ը** լուծում է թիրախ գործակալը bindings-ի, `@`-հիշատակումների կամ
պահեստավորման միջոցով։
3. **Orchestrator-ը** հավաքում է շերտավորված, cache-բարյացակամ system prompt և
կառավարում function-calling ցիկլը ներկառուցված գործիքների, ենթա-գործակալների և
plugin-ների վրա։
4. **Հիշողությունը և գիտելիքը** հիմնավորում են պատասխանը. երկուսն էլ ժամանում են որպես
գործիքի արդյունքներ, երբեք որպես ներարկված հրահանգներ։
5. Երաշխավորված-առաքման **outbox**-ը պատասխանը վերադարձնում է սկզբնական ալիքին։
```text
channel ─▶ router ─▶ orchestrator (tools · sub-agents · memory · RAG) ─▶ outbox ─▶ channel
```
## Հիմնարար սկզբունքներ
Սրանք մարքեթինգային տողեր չեն — այս ուղեցույցի յուրաքանչյուր էջ մնում է դրանց ներսում։
- **Host-native, ոչ Docker.** AiHummer-ը տեղակայվում է որպես systemd-ի տակ
`/home/.aihummer`-ից աշխատող թողարկման tarball։ Կոնտեյներներ կամ orchestrator-ներ չկան։
- **Ոչ պարտադիր վճարովի մոդելներ.** Այն աշխատում է անվճար/լոկալ մոդելների և
Codex/ChatGPT-բաժանորդագրության փոխադրման վրա։ Ըստ-վարձակալի BYOK բանալիները ընտրովի են։
- **Անվտանգությունը որպես հիմնական հատկություն.** Envelope-գաղտնագրված vault,
human-in-the-loop հաստատման դարպասներ, idempotent կողմնակի էֆեկտներ,
prompt-injection data-fencing, IP allowlist և աուդիտ։
- **Կայունություն.** SemVer առաջ-անվտանգ, ավտոմատ կիրառվող տվյալների բազայի
migration-ներով։
> [!NOTE]
> AiHummer-ը ներկայացնում է OpenAI-համատեղելի `POST /v1/chat/completions` վերջնակետ
> (SSE streaming-ով)։ Այն **չի** ներկայացնում `/v1/models` կամ `/v1/embeddings`, և
> դիտարկելիությունը OTLP-push է — Prometheus `/metrics` վերջնակետ չկա։
## Ում համար է այն
- **Ընկերություններ, որոնք ուզում են ներքին AI աշխատակից**, որը պատասխանում է
անձնակազմին Telegram-ի կամ Bitrix24-ի միջոցով, հիշողությամբ, գիտելիքով և հաստատման
դարպասներով։
- **Հաճախորդ-ուղղված թիմեր**, որոնք գործակալ են դնում կայքի, հեռախոսային գծի կամ
բջջային հավելվածի վրա։
- **Անվտանգության, համապատասխանության և ինքնիշխանության գիտակից տեղակայումներ**, որոնք
կարիք ունեն self-hosting-ի, առանց Docker-ի, առանց պարտադիր արտաքին վճարովի մոդելի,
գաղտնագրված գաղտնիքների, RLS մեկուսացման և SSO-ի։
- **Հարթակային և IT թիմեր**, որոնք ուզում են ամբողջական արտադրանք — ադմին UI,
բազմավարձակալություն, marketplace — framework հավաքելու փոխարեն։
## Ուր հետո
- Նո՞ր եք այստեղ։ Շարունակեք դեպի [Պահանջներ](/hy/v1.0/getting-started/requirements)
և [Տեղադրում](/hy/v1.0/getting-started/installation)։
- Ուզու՞մ եք նախ մտավոր մոդելը։ Կարդացեք
[Gateway և ընթացքի շարժիչ](/hy/v1.0/architecture/gateway-turn-engine)։
- Կառուցու՞մ եք API-ի դեմ։ Անցեք
[chat/completions](/hy/v1.0/api/chat-completions)։