AiHummer
Română▾
AutentificareCont personal
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Primii pași/Ghid rapid

Ghid rapid

v1.1.x · actualizat 2026-07-20

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: o adresă de e-mail, un număr de telefon și un card bancar (pentru perioada de încercare banca încasează 1 ₽ și îl returnează imediat).

  1. Î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.
  2. 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.
  3. În expert alege Nor cale, apoi un plan (lunar/anual). planul de intrare vine cu un Perioadă de încercare gratuită de 10 zile. Detalii: Planuri.
  4. Completează-ți detalii de facturare (individual sau companie/proprietar unic) — ei sunt necesare pentru factură și act.
  5. Alege un nume de subdomeniu (adresa dvs. va fi <name>.cloud.aihummer.ru) și plăti. Vei vedea starea „Pregătirea asistentului tău” cu progres. Detalii: Comandă și plată.
  6. 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

Odată ce serviciul este pornit, deschideți interfața Web de administrare pe server (port privat) :8781 implicit):

http://localhost:8781/

Pe o bază de date goală, un login admin este creat și parola inițială este scrisă în ~/.aihummer/etc/initial-admin-password.txt. Citește-l, autentifică-te, apoi schimbă parola și șterge fișierul imediat — pas cu pas în Primul autentificare.

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": true pentru streaming SSE.

Amintește-ți modelul simulacru

Până conectezi un model real, răspunsurile vin de la un simulare deterministă — util pentru testarea canalelor, rutării și agenților fără cost de model. Cum să te conectezi la un furnizor real (OpenAI, Anthropic, YandexGPT, GigaChat, Codex printr-un abonament ChatGPT și altele) este pe Modele pagină.

[!NOTE] Un model real nu este niciodată obligatoriu: AiHummer rulează pe gratuit/local Endpoint-uri compatibile cu OpenAI și un transport de abonament Codex/ChatGPT.

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.
  • Interfața de administrare nu se va deschide — interfața Web UI ascultă pe portul privat :8781, nu publicul :8780. Verificați serviciul: systemctl status aihummer-gateway.
  • Nu pot găsi parola inițială — este în ~/.aihummer/etc/initial-admin-password.txt, 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?