Оғози кор / Муқаддима
Муқаддима v1.2.x · навсозӣ шуд 2026-07-05 ⧉ Нусхабардорӣ ҳамчун Markdown ✓ Нусхабардорӣ шуд
AiHummer як платформаи агентии AI барои тиҷорат аст — дастрас ҳамчун облаки идорашаванда ё худ-меҳмоннамо. Он паёмҳоро аз каналҳои кормандон ва муштариён мегирад, ҳар як паёмро ба агент дуруст равона мекунад, як даври функсияро бо асбобҳо ва хотираи дарозмуддат иҷро мекунад ва ҷавобро ба канали аслии он мерасонад — ҳама аз ҷониби интерфейси веби идоракунӣ ва API, ки бо OpenAI мувофиқ аст, идора карда мешавад.
Ин як аст маҳсулоти пурра не як чорчӯба ё SDK. Як хидмати мустақил ҳам ҳамчун идоракунӣ ва ҳам муҳаррики гардиш амал мекунад, аз ин рӯ насби маъмулӣ як хидмат плюс PostgreSQL мебошад.
Чӣ мегиред
Оркестратсияи чандагентӣ бо зер-агентҳо ва далели ихтиёрӣ
стратегияҳо (барнома-қадамҳо, андеша кардан, баҳс кардан, беҳтарин аз N, худтабобаткунӣ).
Агентҳои дараҷаи аввал бо шахсиятҳо, пешниҳоди сохташуда ва модели ҳар агент.
Хотираи дарозмуддат (Эйнштейн) — далелҳо ба шакли даъвоҳои тавассути баррасӣ пешниҳодшаванда гирифта мешаванд, пас
ба хотир тавассути таблиғ; ба ёдоварӣ дар доираи маълумот бо ҳимоя алайҳи воридшавии фармон печонида шудааст.
Дониш / RAG бо иқтибосҳо, илова deep_research барои ҳисоботҳои чандмарҳила
Каналҳо — Telegram, VK, Avito, MAX, Bitrix24, телефонии SIP ва
Барномаи мобилӣ ва мизи корӣ; дастрасӣ ба насби пайвасткунакҳо вобаста аст.
Бозори плагинҳо бо як клик, насби маҳаллӣ дар мизбон.
Анбори шаҳодатномаи рамзгузоришуда , SSO-и корхона (SAML / LDAP / SCIM / OIDC)
ва Амният сатҳи қатори Postgres барои ҷудоии бисертамлони.
Чӣ тавр гардиш мегузарад
А канал паёмеро, ки ворид мешавад, ба дарвоза мерасонад.
Он руттер агенти мақсадиро тавассути пайвасткуниҳо ҳал мекунад, @-зикр ё як алтернатива.
Он оркестратор як рӯйхати қабатбандшуда, соҳиби кэш ва дӯстдори система сохт ва
дар як давраи функсия-бардошта тавассути абзорҳои дохилӣ, зер-агентҳо ва плагинҳо роҳ меандозад.
Хотира ва дониш Ҷавобро асос кунед; ҳар ду ҳамчун натиҷаҳои асбоб меоянд, ҳеҷ гоҳ
чун тавсияҳои воридшуда.
Хадамоти таҳвил посухро ба канали аслӣ бармегардонад ва кӯшиш мекунад
ба мувофиқи сиёсати муқарраршуда ва гузориш додани нокомии равшан дар сурати он
таппиқ намудани таҳвил ғайриимкон аст.
channel ─▶ router ─▶ orchestrator (tools · sub-agents · memory · RAG) ─▶ delivery ─▶ channel
Принсипҳои асосӣ
Ин хатиҳои маркетингӣ нестанд — ҳар саҳифа дар ин дастур дар доираи онҳо мемонад.
Меҳмон-аз рӯйи ватан, на Docker. AiHummer ҳамчун як бастаи баровариш, ки таҳти иҷро қарор дорад, насб мешавад
systemd аз ~/.aihummer (қатораи хонагӣ барои корбарие, ки идора кард
насбкунанда). Ҳеҷ контейнер ё оркестратор вуҷуд надорад.
Ҳеҷ гуна моделҳои маҷбурии пулакӣ вуҷуд надоранд. Он дар модели озод/махаллӣ кор мекунад ва як
Нақлиёт Codex/ChatGPT-обуна. Калидҳои BYOK барои ҳар як иҷоранишин ихтиёрӣ мебошанд.
Амният ҳамчун хосияти асосӣ. қуттии нигаҳдорӣ бо рамзгузории конверт, инсон дар раванд
дарвозаҳои тасдиқ, таъсироти паҳлӯии идемпотент, муҳофизати маълумот аз воридкунии фаврӣ, IP
феҳристи иҷозатдодашуда ва тафтиш.
Субот SemVer бо муҳофизати пешрафта ва гузаришҳои худкор ба пойгоҳи додаҳо.
[!NOTE]
AiHummer як ҳамоҳанг бо OpenAI-ро ошкор мекунад POST /v1/chat/completions нирӯи ниҳоӣ
(бо ҷараёни SSE). Ин мекунад не ошкор кардан /v1/models ё /v1/embeddings,
ва намоёнпазирӣ OTLP-пуш аст — Prometheus вуҷуд надорад /metrics охирон нуқта
Барои кӣ аст
Ширкатҳое, ки мехоҳанд корманди сунъии дохилӣ дошта бошанд ҷавобгӯи кормандон
Телеграм ё Битрикс24, бо хотира, дониш ва дарвозаҳои тасдиқ.
Гурӯҳҳои рӯ ба муштариён ҷой додани агентие дар вебсайт, хатти телефон ё
барномаи мобилӣ
Ҷобаҷокунӣ бо эҳтиёти амниятӣ, риояи қоида ва худидоракунии миллӣ ки ниёз дорад
хизматрасонии худӣ, Docker нест, модели беруна бо пардохт ҳатмӣ нест, сиррҳои рамзгузорӣшуда,
Ҷудоии RLS ва SSO.
Платформа ва гурӯҳҳои IT ки мехоҳанд маҳсулоти пурра дошта бошанд — интерфейси идоракунӣ,
чанд иҷорагирӣ, бозор — ба ҷои ҷамъ кардани як чаҳорчӯба.
Абр ё сервери худатон: кадомро интихоб кардан
Мавҷуданд ду роҳ Барои ба даст овардани AiHummer. Шумо як маротиба интихоб мекунед, дар равшандозии ҳисоби шахсӣ — ва ин интихоби шумо муайян мекунад, ки баъд чӣ танзим мекунед. Шумо пеш аз ҳама лозим нест чизе техникии донист; ин ҷо як муқоисаи оддӣ аст.
Абри идорашуда
Хизматрасонии худидоракунии (сервери шумо)
Кӣ серверро идора мекунад
Мо мекунем — шумо як суроғаи омодаро мегиред <name>.cloud.aihummer.ru
Шумо мекунед — онро дар сервери Линукси худ насб кунед
Чӣ лозиматон аст
Фақат сабти ном кунед ва пардохт кунед
Сервери Linux (root, ё насби бе root)
Вақт барои оғоз
Чанд дақиқа пас аз пардохт
Як фармони насб + воридшавии аввал
Санҷиши озод
10 рӯз ройгон дар нақшаи воридшавӣ
Нақшаи ҷамъиятӣ ройгон, бе абр
Навсозӣ
Автоматики, аз тарафи мо
Ин намуна тавассути истиноди шумо навсозӣ мешавад
Беҳтарин барои
Ҳар касе, ки мехоҳад як ёвари ‘танҳо кор мекунад’ бе сервери шахсии худ дошта бошад
Ҳар касе, ки ниёз ба ҳукумронии додаҳо, ҳудуди худ ва мутобиқат дорад
Дар кӯтоҳӣ: агар шумо сервери шахсии худро надошта бошед, ё намехоҳед якеи онро идора кунед, интихоб кунед абр Агар маълумоти шумо бояд дар дохили ҳудуди худ бимонад ва шумо сервери Linux дошта бошед, интихоб кунед хостинги шахсӣ Шумо метавонед назарро тағир диҳед: ҳангоме ки ин намуна ҳанӯз пайваст нашудааст, тугмаи «тағйир додани роҳ» дар мудири ҳамроҳӣ ба шумо имкон медиҳад ба осонӣ тағйир диҳед.
Баъд ба куҷо
Мехоҳед як марҳилаи пурраи аввалини қадам ба қадам дошта бошед? Бо
Оғози зуд — он ба як абр ва як қисми дигар тақсим мешавад
пахши худқад
Нав барои идора кардани сервери худ? Давом диҳед ба
Талабот ва
Насб .
Аввал мехоҳед модели маънавиро донед? Хонед
Дарвозаву муҳаррики гардиш .
Сохтмон бар зидди API? Ба
гӯшӣ/комплетҳо .
Баъдӣ →
Стенди намоишӣ
**AiHummer як платформаи агентии AI барои тиҷорат аст — дастрас ҳамчун облаки идорашаванда ё худ-меҳмоннамо.** Он паёмҳоро аз каналҳои кормандон ва муштариён мегирад, ҳар як паёмро ба агент дуруст равона мекунад, як даври функсияро бо асбобҳо ва хотираи дарозмуддат иҷро мекунад ва ҷавобро ба канали аслии он мерасонад — ҳама аз ҷониби интерфейси веби идоракунӣ ва API, ки бо OpenAI мувофиқ аст, идора карда мешавад.
Ин як аст **маҳсулоти пурра**не як чорчӯба ё SDK. Як хидмати мустақил ҳам ҳамчун идоракунӣ ва ҳам муҳаррики гардиш амал мекунад, аз ин рӯ насби маъмулӣ як хидмат плюс PostgreSQL мебошад.
## Чӣ мегиред
- **Оркестратсияи чандагентӣ** бо зер-агентҳо ва далели ихтиёрӣ
стратегияҳо (барнома-қадамҳо, андеша кардан, баҳс кардан, беҳтарин аз N, худтабобаткунӣ).
- **Агентҳои дараҷаи аввал** бо шахсиятҳо, пешниҳоди сохташуда ва модели ҳар агент.
- **Хотираи дарозмуддат (Эйнштейн)** — далелҳо ба шакли даъвоҳои тавассути баррасӣ пешниҳодшаванда гирифта мешаванд, пас
ба хотир тавассути таблиғ; ба ёдоварӣ дар доираи маълумот бо ҳимоя алайҳи воридшавии фармон печонида шудааст.
- **Дониш / RAG** бо иқтибосҳо, илова `deep_research` барои ҳисоботҳои чандмарҳила
- **Каналҳо** — Telegram, VK, Avito, MAX, Bitrix24, телефонии SIP ва
Барномаи мобилӣ ва мизи корӣ; дастрасӣ ба насби пайвасткунакҳо вобаста аст.
- **Бозори плагинҳо** бо як клик, насби маҳаллӣ дар мизбон.
- **Анбори шаҳодатномаи рамзгузоришуда**, SSO-и корхона (SAML / LDAP / SCIM / OIDC)
ва Амният сатҳи қатори Postgres барои ҷудоии бисертамлони.
## Чӣ тавр гардиш мегузарад
1. А **канал** паёмеро, ки ворид мешавад, ба дарвоза мерасонад.
2. Он **руттер** агенти мақсадиро тавассути пайвасткуниҳо ҳал мекунад, `@`-зикр ё як алтернатива.
3. Он **оркестратор** як рӯйхати қабатбандшуда, соҳиби кэш ва дӯстдори система сохт ва
дар як давраи функсия-бардошта тавассути абзорҳои дохилӣ, зер-агентҳо ва плагинҳо роҳ меандозад.
4. **Хотира ва дониш** Ҷавобро асос кунед; ҳар ду ҳамчун натиҷаҳои асбоб меоянд, ҳеҷ гоҳ
чун тавсияҳои воридшуда.
5. Хадамоти таҳвил посухро ба канали аслӣ бармегардонад ва кӯшиш мекунад
ба мувофиқи сиёсати муқарраршуда ва гузориш додани нокомии равшан дар сурати он
таппиқ намудани таҳвил ғайриимкон аст.
```text
channel ─▶ router ─▶ orchestrator (tools · sub-agents · memory · RAG) ─▶ delivery ─▶ channel
```
## Принсипҳои асосӣ
Ин хатиҳои маркетингӣ нестанд — ҳар саҳифа дар ин дастур дар доираи онҳо мемонад.
- **Меҳмон-аз рӯйи ватан, на Docker.** AiHummer ҳамчун як бастаи баровариш, ки таҳти иҷро қарор дорад, насб мешавад
systemd аз `~/.aihummer` (қатораи хонагӣ барои корбарие, ки идора кард
насбкунанда). Ҳеҷ контейнер ё оркестратор вуҷуд надорад.
- **Ҳеҷ гуна моделҳои маҷбурии пулакӣ вуҷуд надоранд.** Он дар модели озод/махаллӣ кор мекунад ва як
Нақлиёт Codex/ChatGPT-обуна. Калидҳои BYOK барои ҳар як иҷоранишин ихтиёрӣ мебошанд.
- **Амният ҳамчун хосияти асосӣ.** қуттии нигаҳдорӣ бо рамзгузории конверт, инсон дар раванд
дарвозаҳои тасдиқ, таъсироти паҳлӯии идемпотент, муҳофизати маълумот аз воридкунии фаврӣ, IP
феҳристи иҷозатдодашуда ва тафтиш.
- **Субот** SemVer бо муҳофизати пешрафта ва гузаришҳои худкор ба пойгоҳи додаҳо.
> [!NOTE]
> AiHummer як ҳамоҳанг бо OpenAI-ро ошкор мекунад `POST /v1/chat/completions` нирӯи ниҳоӣ
> (бо ҷараёни SSE). Ин мекунад **не** ошкор кардан `/v1/models` ё `/v1/embeddings`,
> ва намоёнпазирӣ OTLP-пуш аст — Prometheus вуҷуд надорад `/metrics` охирон нуқта
## Барои кӣ аст
- **Ширкатҳое, ки мехоҳанд корманди сунъии дохилӣ дошта бошанд** ҷавобгӯи кормандон
Телеграм ё Битрикс24, бо хотира, дониш ва дарвозаҳои тасдиқ.
- **Гурӯҳҳои рӯ ба муштариён** ҷой додани агентие дар вебсайт, хатти телефон ё
барномаи мобилӣ
- **Ҷобаҷокунӣ бо эҳтиёти амниятӣ, риояи қоида ва худидоракунии миллӣ** ки ниёз дорад
хизматрасонии худӣ, Docker нест, модели беруна бо пардохт ҳатмӣ нест, сиррҳои рамзгузорӣшуда,
Ҷудоии RLS ва SSO.
- **Платформа ва гурӯҳҳои IT** ки мехоҳанд маҳсулоти пурра дошта бошанд — интерфейси идоракунӣ,
чанд иҷорагирӣ, бозор — ба ҷои ҷамъ кардани як чаҳорчӯба.
## Абр ё сервери худатон: кадомро интихоб кардан
Мавҷуданд **ду роҳ** Барои ба даст овардани AiHummer. Шумо як маротиба интихоб мекунед, дар равшандозии ҳисоби шахсӣ — ва ин интихоби шумо муайян мекунад, ки баъд чӣ танзим мекунед. Шумо пеш аз ҳама лозим нест чизе техникии донист; ин ҷо як муқоисаи оддӣ аст.
| | **Абри идорашуда** | **Хизматрасонии худидоракунии (сервери шумо)** |
|---|---|---|
| Кӣ серверро идора мекунад | Мо мекунем — шумо як суроғаи омодаро мегиред `<name>.cloud.aihummer.ru` | Шумо мекунед — онро дар сервери Линукси худ насб кунед |
| Чӣ лозиматон аст | Фақат сабти ном кунед ва пардохт кунед | Сервери Linux (root, ё насби бе root) |
| Вақт барои оғоз | Чанд дақиқа пас аз пардохт | Як фармони насб + воридшавии аввал |
| Санҷиши озод | 10 рӯз ройгон дар нақшаи воридшавӣ | Нақшаи ҷамъиятӣ ройгон, бе абр |
| Навсозӣ | Автоматики, аз тарафи мо | Ин намуна тавассути истиноди шумо навсозӣ мешавад |
| Беҳтарин барои | Ҳар касе, ки мехоҳад як ёвари 'танҳо кор мекунад' бе сервери шахсии худ дошта бошад | Ҳар касе, ки ниёз ба ҳукумронии додаҳо, ҳудуди худ ва мутобиқат дорад |
**Дар кӯтоҳӣ:** агар шумо сервери шахсии худро надошта бошед, ё намехоҳед якеи онро идора кунед, интихоб кунед **абр**Агар маълумоти шумо бояд дар дохили ҳудуди худ бимонад ва шумо сервери Linux дошта бошед, интихоб кунед **хостинги шахсӣ**Шумо метавонед назарро тағир диҳед: ҳангоме ки ин намуна ҳанӯз пайваст нашудааст, тугмаи «тағйир додани роҳ» дар мудири ҳамроҳӣ ба шумо имкон медиҳад ба осонӣ тағйир диҳед.
- **Ман мехоҳам абр** [Сабти ном ва воридшавӣ](/tg/v1.0/portal/registration), пас
[Нақшаҳо](/tg/v1.0/portal/plans) ва [Фармоиш ва пардохт](/tg/v1.0/portal/order-payment).
- **Ман мехоҳам сервери худро дошта бошам** [Талабот](/tg/v1.0/getting-started/requirements)
ва [Насб](/tg/v1.0/getting-started/installation).
## Баъд ба куҷо
- Мехоҳед як марҳилаи пурраи аввалини қадам ба қадам дошта бошед? Бо
[Оғози зуд](/tg/v1.0/getting-started/quickstart) — он ба як абр ва як қисми дигар тақсим мешавад
пахши худқад
- Нав барои идора кардани сервери худ? Давом диҳед ба
[Талабот](/tg/v1.0/getting-started/requirements) ва
[Насб](/tg/v1.0/getting-started/installation).
- Аввал мехоҳед модели маънавиро донед? Хонед
[Дарвозаву муҳаррики гардиш](/tg/v1.0/architecture/gateway-turn-engine).
- Сохтмон бар зидди API? Ба
[гӯшӣ/комплетҳо](/tg/v1.0/api/chat-completions).