შესავალი

channel ─▶ router ─▶ orchestrator (tools · sub-agents · memory · RAG) ─▶ outbox ─▶ channel

**AiHummer არის თვით-ჰოსტირებული AI-აგენტის პლატფორმა ბიზნესისთვის.** ის იღებს შეტყობინებებს თანამშრომელთა და მომხმარებელთა არხებიდან, მიმართავს თითოეულს სწორ აგენტთან, ასრულებს ფუნქცია-გამოძახების სვლას ხელსაწყოებითა და გრძელვადიანი მეხსიერებით, და აბრუნებს პასუხს უკან წარმომავალ არხში — ყველაფერი იმართება ვებ ადმინ UI-დან და OpenAI-თავსებადი API-დან. ეს არის **სრული პროდუქტი**, არა ფრეიმვორკი ან SDK. ერთი თვითკმარი სერვისი მოქმედებს როგორც კონტროლის სიბრტყე, ისე სვლის ძრავი, ასე რომ ტიპური განთავსება არის ერთი სერვისი პლუს PostgreSQL. ## რას იღებთ - **მრავალაგენტიანი ორკესტრაცია** ქვე-აგენტებითა და არასავალდებულო მსჯელობის სტრატეგიებით (plan-steps, reflect, debate, best-of-N, self-heal). - **პირველი კლასის აგენტები** პერსონებით, სტრუქტურირებული პრომპტითა და თითო აგენტზე მოდელით. - **გრძელვადიანი მეხსიერება (Einstein)** — ფაქტები ამოღებული როგორც გადასახედი მტკიცებები, შემდეგ დაწინაურებული მეხსიერებაში; გახსენება შემოღობილია მონაცემთა ღობით პრომპტ-ინჯექციის წინააღმდეგ. - **ცოდნა / RAG** ციტატებით, პლუს `deep_research` მრავალსაფეხურიანი ანგარიშებისთვის. - **არხები** — Telegram, MAX (რუსული მესენჯერი, ახალი), Bitrix24 (შიდა თანამშრომელთა IM), SIP ტელეფონია, ჩასაშენებელი ვებ ვიჯეტი და მობილური და დესკტოპის აპლიკაცია. - **დანამატების ბაზარი** ერთი-დაწკაპუნებით, ჰოსტ-მშობლიური ინსტალაციით. - **დაშიფრული რწმუნებების ვალტი**, საწარმოო SSO (SAML / LDAP / SCIM / OIDC) და Postgres Row-Level Security მრავალმოიჯარე იზოლაციისთვის. ## როგორ მიედინება სვლა 1. **არხი** აწვდის შემომავალ შეტყობინებას gateway-ს. 2. **მარშრუტიზატორი** წყვეტს სამიზნე აგენტს მიბმების, `@`-ხსენებების ან სარეზერვოს გავლით. 3. **ორკესტრატორი** აწყობს ფენოვან, ქეშისთვის ხელსაყრელ სისტემურ პრომპტს და მართავს ფუნქცია-გამოძახების ციკლს ჩაშენებულ ხელსაწყოებზე, ქვე-აგენტებსა და დანამატებზე. 4. **მეხსიერება და ცოდნა** აფუძნებენ პასუხს; ორივე ჩნდება როგორც ხელსაწყოს შედეგი, არასოდეს როგორც ჩაშენებული ინსტრუქცია. 5. გარანტირებული-მიწოდების **outbox** აბრუნებს პასუხს წარმომავალ არხში. ```text channel ─▶ router ─▶ orchestrator (tools · sub-agents · memory · RAG) ─▶ outbox ─▶ channel ``` ## ფუნდამენტური პრინციპები ეს არ არის სარეკლამო ხაზები — ამ სახელმძღვანელოს ყოველი გვერდი მათ ფარგლებში რჩება. - **ჰოსტ-მშობლიური, არა Docker.** AiHummer იშლება როგორც გამოშვების tarball, რომელიც systemd-ის ქვეშ მუშაობს `/home/.aihummer`-დან. არ არსებობს კონტეინერები ან ორკესტრატორები. - **სავალდებულო ფასიანი მოდელების გარეშე.** ის მუშაობს უფასო/ლოკალურ მოდელებსა და Codex/ChatGPT-ხელმოწერის ტრანსპორტზე. თითო-მოიჯარის BYOK გასაღებები არასავალდებულოა. - **უსაფრთხოება როგორც ძირითადი თვისება.** კონვერტით-დაშიფრული ვალტი, ადამიანი-ციკლში დამოწმების ფილტრები, იდემპოტენტური გვერდითი ეფექტები, პრომპტ-ინჯექციის მონაცემთა ღობე, IP allowlist და აუდიტი. - **სტაბილურობა.** SemVer წინ-უსაფრთხო, ავტომატურად-გამოყენებული მონაცემთა ბაზის მიგრაციებით. > [!NOTE] > AiHummer გვთავაზობს OpenAI-თავსებად `POST /v1/chat/completions` endpoint-ს (SSE > სტრიმინგით). ის **არ** გვთავაზობს `/v1/models`-სა ან `/v1/embeddings`-ს, და > დაკვირვებადობა არის OTLP-push — არ არსებობს Prometheus `/metrics` endpoint. ## ვისთვისაა ის - **კომპანიები, რომელთაც სურთ შიდა AI თანამშრომელი**, რომელიც პასუხობს პერსონალს Telegram-ით ან Bitrix24-ით, მეხსიერებით, ცოდნითა და დამოწმების ფილტრებით. - **მომხმარებლისკენ მიმართული გუნდები**, რომლებიც აყენებენ აგენტს ვებსაიტზე, სატელეფონო ხაზზე ან მობილურ აპლიკაციაში. - **უსაფრთხოების-, შესაბამისობის- და სუვერენიტეტის-მცოდნე განთავსებები**, რომელთაც ესაჭიროებათ თვით-ჰოსტირება, Docker-ის გარეშე, სავალდებულო გარე ფასიანი მოდელის გარეშე, დაშიფრული საიდუმლოები, RLS იზოლაცია და SSO. - **პლატფორმისა და IT გუნდები**, რომელთაც სურთ სრული პროდუქტი — ადმინ UI, მრავალმოიჯარეობა, ბაზარი — ნაცვლად ფრეიმვორკის აწყობისა. ## სად შემდეგ - ახალი ხართ აქ? გააგრძელეთ [მოთხოვნებზე](/ka/v1.0/getting-started/requirements) და [ინსტალაციაზე](/ka/v1.0/getting-started/installation). - გსურთ ჯერ მენტალური მოდელი? წაიკითხეთ [Gateway და სვლის ძრავი](/ka/v1.0/architecture/gateway-turn-engine). - აშენებთ API-ის წინააღმდეგ? გადადით [chat/completions-ზე](/ka/v1.0/api/chat-completions).