Ghid rapid
Acest ghid rapid te ghidează prin prima ta rulare AiHummer — de la zero până la un prim agent care răspunde într-un canal. Este scris pentru cineva care face acest lucru pentru prima dată: fiecare pas se termină cu ce ar trebui să vezi, și există o secțiune „Dacă nu a funcționat” la final.
Mai întâi, alege-ți drumul
Există două modalități de a obține AiHummer (comparație completă în Introducere):
- Nor — noi rulăm serverul, tu primești o adresă pregătită. Nimic de instalat. → du-te la Traseul A: nor.
- Auto-găzduit (propriul tău server) — instalați AiHummer pe serverul dumneavoastră Linux cu o singură comandă. → mergi la Calea B: propriul tău server.
Ambele căi converg apoi asupra pașilor comuni — primul agent și primul canal.
Traseul A: nor
Ce vei avea nevoie: Adresă de e-mail și număr de telefon. Proba disponibilă nu necesită card sau debitare de verificare; continuarea plătită necesită plata.
- Înscrie-te la my.aihummer.ru: introduceți e-mailul, telefonul și parola, acceptați cele două consimțământuri. Veți vedea confirmarea contului ecran.
- Confirmă contul — prin apel (introdu ultimele cifre ale numărului apelant) sau cu codul din e-mail. Vei vedea că autentificarea s-a realizat automat și vrăjitorul de inițiere s-a deschis. Detalii: Înregistrare și autentificare.
- În expert alege Nor cale, apoi un plan (lunar/anual).
Prima perioadă de probă Personal Helper (
cloud-personal) durează 14 zile, fără card bancar sau debitare de verificare. Este disponibilă o singură dată. Alte planuri oferă probă doar dacă planul Billing ales o include explicit; planurile pentru companii nu o includ. Continuarea necesită plata; proba nu activează debitări automate. Proba este disponibilă doar conturilor fără abonament cloud anterior; folosește o VM partajată, fără VM dedicată sau suplimente plătite. Planuri. - Pentru plata prin factură, introduceți datele firmei sau ale persoanei autorizate în profil. Aprobarea operatorului nu este necesară; plata cu cardul și proba disponibilă nu necesită acest pas.
- Alege un nume de subdomeniu (adresa dvs. va fi
<name>.cloud.aihummer.ru) și începeți proba disponibilă sau plătiți comanda. Vei vedea starea „Pregătirea asistentului tău” cu progres. Detalii: Comandă și plată. - Așteptați pentru aprovizionare (de obicei câteva minute). Când statusul se schimbă Al tău asistentul este în funcțiune, faceți clic Deschideți panoul — interfața de administrare web a instanța se deschide. Detalii: Tablou de bord al instanței.
Configurarea continuă în interfața web de administrare — accesați primul agentParola de administrator pentru o instanță cloud este setată atunci când deschideți panoul pentru prima dată (fișierul de parolă separat utilizat în găzduirea proprie nu este necesar aici).
Calea B: propriul tău server
Ce vei avea nevoie: un server Linux (x86_64 sau arm64), sudo drepturi și PostgreSQL (sau permiteți instalatorului să îl configureze). Lista completă: Cerințe.
Pasul 1. Obțineți linkul personal de instalare
Nu există un script de instalare public — linkul este personal. Înregistrează-te la my.aihummer.ru, deschide Instalează ecran și faceți clic pe „Obține linkul meu de instalare personal”. Veți vedea o comandă gata făcută cu un buton de copiere.
Pasul 2. Instalează cu o singură comandă
Rulează comanda copiată pe server:
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh
Programul de instalare detectează arhitectura, descarcă și verifică pachetul semnat, stabilește directorul rădăcină de instalare la ~/.aihummer și înregistrează serviciul gateway sub systemd. Veți vedea jurnalul pasului de instalare și, la final, un mesaj de serviciu pornit. Detalii complete (canale de lansare, sidecar-uri, instalare fără root): Instalare.
Pasul 3. Indică către PostgreSQL
Singura dependență strictă este PostgreSQL cu pgcrypto extensie. Instalatorul conectează legătura pentru tine; pentru a seta baza de date manual, folosește AIHUMMER_DATABASE_URL opțiune de configurare:
AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable
-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;
Migrațiile bazei de date se aplică automat la pornire.
Pasul 4. Primul autentificare
Panoul web, aplicațiile și canalele folosesc aceeași adresă publică a serverului. Deschideți adresa publică afișată de instalator; adresa locală implicită este http://localhost:8780/. Portul ales la instalare poate fi diferit.
http://localhost:8780/
Autentificați-vă cu numele și parola de administrator alese în asistentul de instalare. Dacă datele inițiale au fost generate automat, folosiți rezumatul final; fișierul privat etc/initial-admin-password.txt se aplică doar acestei inițializări. Nu divulgați datele de acces.
Pas: creează-ți primul agent
Acest pas este împărtășit de cloud și de cel găzduit local. În interfața web de administrare deschideți “Agenți” → + Creează, setează un nume, o persoană (prompt de sistem) și, opțional, un model dedicat. Veți vedea noul agent ca un element în listă. Detaliu complet, cu reglarea caracterului și comportamentului: Agenți.
Pas: conectează primul tău canal
Pentru a permite mesajelor să ajungă la AiHummer, adăugați un canal:
- Telegram — cel mai pregătit pentru producție conector; un ghid complet de la început până la sfârșit “de la BotFather până la primul mesaj” este în Telegram.
- Sesiuni în interfața web — cea mai rapidă metodă de a testa un agent înainte de a conecta un canal extern.
- MAX — un mesager rus, disponibil și el.
Conectorul este instalat pe Module/Marketplace ecran, apoi configurat pe Canale ecran, unde Legături blochează seturile care agent rulează acel canal. Trimite un mesaj canalului și urmărește un flux de turn sfârșind de la un capăt la altul.
Vorbește cu agentul direct din interfața de administrare
Un canal nu este necesar pentru un prim test: pe Sesiuni pagina butonul „+ Sesiune nouă” deschide un chat cu un agent chiar în interfața de administrare. În composer poți atașa fișiere (imagini și documente — modelul primește textul extras), iar două comutatoare deasupra firului dezvăluie cost pe tură și ieșire instrument — util pentru a vedea ce a făcut agentul la fiecare pas.
[!TIP] De asemenea, poți să apelezi direct AiHummer prin API-ul său compatibil cu OpenAI fără niciun canal deloc:
POST /v1/chat/completions Content-Type: application/json {"model": "default", "messages": [{"role": "user", "content": "Hello"}]}Set
"stream": truepentru streaming SSE.
Modele
[!NOTE] Conectați un furnizor real de modele pentru răspunsuri utile. O cheie API plătită nu este obligatorie: puteți folosi un model local compatibil OpenAI, un abonament acceptat sau propria cheie API. Modele · Furnizori BYOK și LLM
Dacă nu a funcționat
- Comanda de instalare a eșuat — verifică că îl rulezi pe Linux x86_64/arm64 și că legătura personală nu este expirată (este valabilă 30 de zile; obține una nouă pe Ecran „Instalare”). Diagnosticare: Instalare.
- Panoul web, aplicațiile și canalele folosesc aceeași adresă publică a serverului. Deschideți adresa publică afișată de instalator; adresa locală implicită este
http://localhost:8780/. Portul ales la instalare poate fi diferit. - Nu pot găsi parola inițială — este în
~/.aihummer/etc/initial-admin-password.txt(doar dacă datele inițiale au fost generate automat), nu în jurnale. Vezi Primul autentificare. - Plata în cloud a eșuat — starea abonamentului pe tabloul de bord arată motiv; reîncearcă, sau (pentru companii) alege plata prin factură, vezi Comandă și plată.
- Agentul nu răspunde într-un canal — asigură-te că canalul este legat de un agent în blocul „Bindings”, și că expeditorul este cunoscut sistemului (prin implicit, agentul răspunde doar utilizatorilor cunoscuți), vezi Canale.
Unde următor?
- Implementare auto-găzduită în producție: Instalare.
- Reglează comportamentul din interfața utilizator Configurare.
- Asigură prima autentificare: Primul autentificare.
- Conectează un model: Modele.