AiHummer
Қазақша▾
Кіру
v1.0.x▾
v1.0.xstable
{ }Swagger
Жұмысты бастау/Кіріспе

Кіріспе

v1.0.x · жаңартылды 2026-06-26

AiHummer — бұл бизнеске арналған өзіндік хостингтегі AI-агент платформасы. Ол қызметкерлер мен клиенттер арналарынан хабарламаларды қабылдайды, әрқайсысын тиісті агентке бағыттайды, құралдар мен ұзақ мерзімді жадымен функция-шақыру (function-calling) кезеңін орындайды және жауапты бастапқы арнаға қайтарады — мұның бәрі веб әкімші интерфейсі мен OpenAI-үйлесімді API арқылы басқарылады.

Бұл толыққанды өнім, фреймворк немесе SDK емес. Жалғыз дербес қызмет басқару деңгейі (control-plane) ретінде де, кезең қозғалтқышы (turn engine) ретінде де әрекет етеді, сондықтан әдеттегі орналастыру — бұл бір қызмет плюс PostgreSQL.

Сіз не аласыз

  • Көп-агентті оркестрация қосалқы агенттермен және қосымша пайымдау стратегияларымен (қадамдарды жоспарлау, ой жүгірту, пікірталас, best-of-N, өзін-өзі емдеу).
  • Бірінші дәрежелі агенттер персоналармен, құрылымдалған промпт және әр агентке арналған модельмен.
  • Ұзақ мерзімді жад (Einstein) — фактілер қаралуға жататын талаптар ретінде шығарылып, кейін жадыға көтеріледі; еске түсіру промпт-инъекцияға қарсы дерек қоршауымен (data-fence) оралған.
  • Білім / RAG дереккөздермен, плюс көп қадамды есептер үшін deep_research.
  • Арналар — Telegram, MAX (орыс мессенджері, жаңа), Bitrix24 (ішкі қызметкерлер IM), SIP телефония, ендірілетін веб-виджет және мобильді әрі үстелдік қолданба.
  • Плагин маркетплейсі бір рет басумен, хост-нативті орнатумен.
  • Шифрланған тіркелгі деректер қоймасы, корпоративтік SSO (SAML / LDAP / SCIM / OIDC) және көп жалгерлі (multitenant) оқшаулау үшін Postgres Row-Level Security.

Кезең қалай ағады

  1. Арна кіріс хабарламаны шлюзге (gateway) жеткізеді.
  2. Маршрутизатор (router) мақсатты агентті байланыстырулар, @-аталымдар немесе резервтік нұсқа арқылы анықтайды.
  3. Оркестратор қабатты, кешке ыңғайлы жүйелік промптты құрастырады және ендірілген құралдар, қосалқы агенттер мен плагиндер бойынша функция-шақыру циклін жүргізеді.
  4. Жад пен білім жауапты негіздейді; екеуі де құрал нәтижелері ретінде келеді, ешқашан инъекцияланған нұсқаулар ретінде емес.
  5. Кепілді жеткізуі бар outbox жауапты бастапқы арнаға қайтарады.
channel ─▶ router ─▶ orchestrator (tools · sub-agents · memory · RAG) ─▶ outbox ─▶ channel

Іргелі қағидаттар

Бұлар маркетингтік сөздер емес — осы нұсқаулықтағы әр бет солардың шегінде қалады.

  • Хост-нативті, Docker емес. AiHummer /home/.aihummer ішінен systemd астында жұмыс істейтін релиз tarball ретінде орналастырылады. Контейнерлер немесе оркестраторлар жоқ.
  • Міндетті ақылы модельдер жоқ. Ол тегін/жергілікті модельдерде және Codex/ChatGPT-жазылым тасымалында жұмыс істейді. Әр жалгерге арналған BYOK кілттері қосымша.
  • Қауіпсіздік негізгі қасиет ретінде. Конверт-шифрланған қойма, циклдегі адамның (human-in-the-loop) растау қақпалары, идемпотентті жанама әсерлер, промпт-инъекция дерек қоршауы, IP рұқсат тізімі және аудит.
  • Тұрақтылық. Алға қарай қауіпсіз, автоматты түрде қолданылатын дерекқор көшірмелерімен SemVer.

[!NOTE] AiHummer OpenAI-үйлесімді POST /v1/chat/completions соңғы нүктесін (SSE ағынымен) ұсынады. Ол /v1/models немесе /v1/embeddings ұсынбайды, және бақылау OTLP-push арқылы — Prometheus /metrics соңғы нүктесі жоқ.

Бұл кімге арналған

  • Ішкі AI қызметкерін қалайтын компаниялар қызметкерлерге Telegram немесе Bitrix24 арқылы жадымен, біліммен және растау қақпаларымен жауап беретін.
  • Клиентке бағытталған командалар агентті веб-сайтқа, телефон желісіне немесе мобильді қолданбаға қоятын.
  • Қауіпсіздікке, сәйкестікке және егемендікке мән беретін орналастырулар өзіндік хостингті, Docker-сіз, міндетті сыртқы ақылы модельсіз, шифрланған құпияларды, RLS оқшаулауды және SSO қажет ететін.
  • Платформа мен IT командалары толыққанды өнім қалайтын — әкімші интерфейсі, көп жалгерлілік, маркетплейс — фреймворк құрастырудың орнына.

Әрі қарай қайда