Introducere — AiHummer Documentație

AiHummer este o platformă de agenți AI pentru afaceri — disponibilă ca cloud administrat sau auto-găzduit. Preia mesaje din canalele angajaților și clienților, le direcționează pe fiecare către agentul potrivit, rulează un ciclu de apelare a funcțiilor cu instrumente și memorie pe termen lung și livrează răspunsul înapoi canalului de origine — totul gestionat dintr-o interfață web de administrare și un API compatibil cu OpenAI.

Este un produs complet, nu un cadru de dezvoltare sau un SDK. Un singur serviciu auto-conținut acționează atât ca plan de control, cât și ca motor de turnuri, astfel încât o implementare tipică este un serviciu plus PostgreSQL.

Ce primești

Orchestrarea mai multor agenți cu sub-agenti și raționament opțional strategii (pași-plan, reflectă, dezbate, cei mai buni din N, auto-vindecare).
Agenți de primă clasă cu persoane, un prompt structurat și un model per-agent.
Memorie pe termen lung (Einstein) — fapte extrase ca afirmații ce pot fi revizuite, apoi promovat în memorie; reamintirea este încapsulată într-o barieră de date împotriva injecției de prompturi.
Cunoștințe / RAG cu citate, plus deep_research pentru rapoarte în mai mulți pași.
Canale — Telegram, VK, Avito, MAX, Bitrix24, telefonie SIP și aplicație mobilă și pentru desktop; disponibilitatea depinde de conectorii instalați.
O piață de pluginuri cu o singură clic, instalare nativă pe gazdă.
Un seif de acreditive criptat, SSO pentru întreprinderi (SAML / LDAP / SCIM / OIDC) și securitatea la nivel de rând din Postgres pentru izolarea multinaționară.

Cum curge o întoarcere

A canal livrează un mesaj de intrare către poarta de acces.
router rezolvă agentul țintă prin legături, @-mențiuni sau o alternativă.
dirijor asamblă un prompt de sistem stratificat, prietenos cu cache-ul și conduce un buclă de apelare a funcțiilor peste instrumente încorporate, sub-agenti și pluginuri.
Memorie și cunoaștere fundamentează răspunsul; ambele ajung ca rezultate ale instrumentului, niciodată ca instrucțiuni injectate.
Serviciul de livrare returnează răspunsul către canalul de origine, încercând din nou conform politicii configurate și raportând un eșec clar dacă aceasta nu se poate finaliza livrarea.

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

Principii fundamentale

Acestea nu sunt sloganuri de marketing — fiecare pagină din acest ghid rămâne în cadrul lor.

Pe gazdă, nu Docker. AiHummer se lansează ca un pachet tarball de versiune care rulează sub systemd de la ~/.aihummer (directorul de acasă al utilizatorului care a rulat installer). Nu există containere sau orchestratori.
Nu există modele plătite obligatorii. Rulează pe modele gratuite/locale și un Transport Codex/ChatGPT-subscription. Cheile BYOK pe fiecare chiriaș sunt opționale.
Securitatea ca proprietate de bază. Seif criptat cu plic, om în buclă porți de aprobare, efecte secundare idempotente, protecția datelor împotriva injecțiilor rapide, IP lista de permisiuni și audit.
Stabilitate. SemVer cu migrări de baze de date sigure și automate, aplicate în avanpremieră.

[!NOTE] AiHummer expune un compatibil cu OpenAI POST /v1/chat/completions punct final (cu streaming SSE). Face nu expune /v1/models sau /v1/embeddings, și observabilitatea este OTLP-push — nu există Prometheus /metrics punct final.

Pentru cine este

Companii care doresc un angajat AI intern personalul care răspunde peste Telegram sau Bitrix24, cu memorie, cunoștințe și puncte de aprobare.
Echipe care se confruntă cu clienții plasarea unui agent pe un site web, o linie telefonică sau un aplicație mobilă
Implementări conștiente de securitate, conformitate și suveranitate care au nevoie auto-găzduire, fără Docker, fără model extern plătit obligatoriu, secrete criptate, Izolarea RLS și SSO.
Echipele de platformă și IT care doresc un produs complet — interfață de administrare, multitenancy, piață — în loc să asamblezi un cadru.

Cloud sau propriul server: pe care să-l alegi

Există două moduri pentru a obține AiHummer. Alegi o dată, în expertul de configurare din contul personal — și acea alegere decide ce vei configura în continuare. Nu trebuie să știi nimic tehnic dinainte; iată o comparație simplă.

	Cloud gestionat	Auto-găzduit (serverul tău)
Cine administrează serverul	Noi o facem — tu primești o adresă gata `<name>.cloud.aihummer.ru`	Tu chiar — instalează-l pe propriul tău server Linux
Ceea ce ai nevoie	Doar înscrie-te și plătește	Un server Linux (root, sau o instalare fără root)
Timpul să lansăm	Câteva minute după plată	O comandă de instalare + prima autentificare
Încercare gratuită	10 zile gratuite pe planul de intrare	Plan comunitar gratuit, fără cloud
Actualizări	Automatic, de partea noastră	Instanța se actualizează singură prin linkul tău
Cel mai potrivit pentru	Oricine vrea un asistent „care funcționează pur și simplu”, fără propriul server	Oricine are nevoie de suveranitate asupra datelor, de propriul lor perimetru, conformitate

Pe scurt: dacă nu ai propriul server sau preferi să nu rulezi unul, alege nor. Dacă datele dumneavoastră trebuie să rămână în interiorul propriului perimetru și aveți un server Linux, alegeți autogăzduit. Poți să îți schimbi părerea: în timp ce instanța nu este încă conectată, butonul „schimbă cale” al vrăjitorului de inițiere îți permite să faci schimbarea cu ușurință.

Vreau nor → Înregistrare și autentificare, atunci Planuri și Comandă și plată.
Vreau propriul meu server → Cerințe și Instalare.

Unde următor?

Vrei o primă rulare completă pas cu pas? Începe cu Ghid rapid — se desparte într-un nor și un pistă auto-găzduită.
Nou în administrarea propriului server? Continuați la Cerințe și Instalare.
Vrei mai întâi modelul mental? Citește Poartă și motor de virare.
Construind împotriva API-ului? Sari la chat/completări.