AiHummer
Română▾
Autentificare
v1.0.x▾
v1.0.xstable
{ }Swagger
Primii pași/Configurare

Configurare

v1.0.x · actualizat 2026-07-07

AiHummer este configurat printr-un catalog de setări, nu printr-o grămadă de variabile de mediu. Fiecare setare are o ordine de rezolvare definită, majoritatea cheilor pot fi schimbate din interfața web de administrare la runtime, iar doar un mic set de variabile de bootstrap trebuie să rămână în mediu. Regula directoare este simplă: tot ce este reglabil este configurabil în interfața web — nu doar în env și nu hardcodat.

Ordinea de rezolvare

Fiecare setare din catalog este rezolvată în aceeași ordine, prima potrivire câștigă:

  1. Bază de date — o valoare setată prin interfața de administrare (stocată per workspace).
  2. Mediu — variabila AIHUMMER_* corespunzătoare.
  3. Default — valoarea implicită integrată livrată cu release-ul.

Aceasta înseamnă că o valoare din interfața de administrare suprascrie mediul la runtime, iar mediul suprascrie valoarea implicită integrată. Poți livra o bază rezonabilă în mediu și apoi regla comportamentul live din interfață fără re-deployment.

[!NOTE] Deoarece stratul de bază de date stă deasupra mediului, nu editezi fișiere de configurare pentru a schimba majoritatea comportamentului în producție — îl schimbi în interfața de administrare și intră în vigoare pentru acel workspace.

La cald vs. necesită restart

Cum intră în vigoare o setare schimbată depinde de cheie:

Behaviour Examples When it applies
La cald activare de instrument, adâncime maximă de sub-agenți Recitită la runtime, fără restart
Necesită restart adresă de ascultare, cablarea anumitor servicii Aplicată la următorul restart al gateway-ului

Cheile la cald sunt recitite live, astfel încât comutarea unui instrument sau ajustarea subagent-depth intră în vigoare la următorul tur. Unele chei structurale intră în vigoare doar după un restart; interfața de administrare semnalează care este care.

Variabilele de bootstrap rămân doar în env

Câteva variabile trebuie să fie prezente în mediu, deoarece sunt necesare înainte ca catalogul de setări (și baza de date din care citește) să existe. Aceste variabile de bootstrap sunt doar în env și nu sunt expuse în interfața de administrare:

Variable Why it is bootstrap
AIHUMMER_DATABASE_URL DB-ul trebuie să existe înainte ca orice setare bazată pe DB să poată fi citită.
AIHUMMER_DB_APP_URL DSN cu rol restricționat care activează RLS.
AIHUMMER_MASTER_KEY base64-32 octeți; deblochează secretele-la-repaus / vault / BYOK.
AIHUMMER_GATEWAY_ADDR Adresă de ascultare (implicit :8780).
AIHUMMER_OIDC_ISSUER Protejează /v1/admin/* înainte ca interfața să fie de încredere.

[!WARNING] Păstrează AIHUMMER_MASTER_KEY în siguranță și salvată separat de backup-ul bazei tale de date. Decriptează vault-ul de credențiale; pierde-o și secretele criptate nu pot fi recuperate.

Fișierul de configurare

Pentru instalări native pe gazdă, mediul de bootstrap trăiește într-un singur fișier pe care unitatea systemd îl încarcă:

/home/.aihummer/etc/gateway.env

Editează acest fișier pentru valorile de bootstrap și de bază, apoi repornește serviciul gateway pentru a aplica modificările:

# /home/.aihummer/etc/gateway.env (excerpt)
AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer
AIHUMMER_MASTER_KEY=base64-32-bytes...
AIHUMMER_GATEWAY_ADDR=:8780
AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main
systemctl restart aihummer-gateway

Tot ce este dincolo de aceste chei de bootstrap/bază — agenți, instrumente, mod de memorie, strategii de raționament, bugete, garduri de protecție și restul — este menit să fie gestionat din setările interfeței de administrare, mai degrabă decât din acest fișier.

Cablarea capabilităților opționale

Multe funcții sunt dezactivate până le îndrepți către un serviciu de suport. Acestea sunt de obicei setate o dată în gateway.env (sau suprascrise în interfață acolo unde se aplică):

# Wire a real model (absent → deterministic mock)
AIHUMMER_LLM_PROVIDER=openai
AIHUMMER_LLM_MODEL=gpt-4o-mini
AIHUMMER_LLM_GATEWAY_URL=https://api.openai.com/v1

# Enable tools by pointing at their backends
SEARXNG_URL=http://localhost:8888
CLOAKBROWSER_CDP_URL=http://localhost:9222

# Voice sidecars (STT/TTS auto-set by the installer)
AIHUMMER_STT_URL=http://localhost:8001
AIHUMMER_TTS_URL=http://localhost:8002

# Real vector store + embedder (else in-memory + hash embedder)
AIHUMMER_QDRANT_URL=http://localhost:6333
AIHUMMER_EMBEDDER_URL=http://localhost:8080

[!TIP] Un model real nu este niciodată necesar. Fără AIHUMMER_LLM_* cablat, răspunsurile vin de la un mock determinist; AiHummer rulează de asemenea pe endpoint-uri gratuite/locale compatibile OpenAI și pe un transport prin abonament Codex/ChatGPT, cu BYOK opțional.

Notificări

Pagina „Notificări” a interfeței de administrare (grupul „Control”) este inbox-ul de evenimente al instanței (login de administrator, actualizare disponibilă/aplicată, căderea și restabilirea sidecars-urilor etc.), cu filtre pe categorie, importanță și necitite. Alături — matricea categorie × canal de livrare: pentru fiecare categorie de evenimente se activează canalele webui, email, telegram și push. Notificările webui sunt livrate local; Telegram se leagă cu butonul „Leagă Telegram” (deep-link), emailul se activează după confirmarea adresei de suport, iar push-ul sosește în aplicația mobilă. Evenimentele critice nu pot fi dezactivate pe canalul webui.

Unde mergi mai departe