AiHummer
Azərbaycanca▾
Daxil ol
v1.0.x▾
v1.0.xstable
{ }Swagger
Başlanğıc/Konfiqurasiya

Konfiqurasiya

v1.0.x · yeniləndi 2026-07-07

AiHummer bir yığın ətraf mühit dəyişəni ilə deyil, parametrlər kataloqu vasitəsilə konfiqurasiya olunur. Hər parametrin müəyyən edilmiş həll sırası var, açarların əksəriyyəti veb admin UI-dan iş zamanı dəyişdirilə bilər və yalnız kiçik bir bootstrap dəyişənlər dəsti ətraf mühitdə qalmalıdır. Aparıcı qayda sadədir: tənzimlənə bilən hər şey Web UI-da konfiqurasiya olunur — yalnız env-də deyil və sərt kodlaşdırılmış deyil.

Həll sırası

Kataloqdakı hər parametr eyni sıra ilə həll edilir, ilk uyğunluq qalib gəlir:

  1. Verilənlər bazası — admin UI vasitəsilə təyin edilmiş dəyər (iş sahəsi üzrə saxlanılır).
  2. Ətraf mühit — müvafiq AIHUMMER_* dəyişəni.
  3. Standart — buraxılışla göndərilən daxili standart dəyər.

Bu o deməkdir ki, admin UI dəyəri iş zamanı ətraf mühiti üstələyir, ətraf mühit isə daxili standart dəyəri üstələyir. Siz ətraf mühitdə ağlabatan əsas dəyər göndərib, sonra yenidən deploy etmədən davranışı UI-dan canlı şəkildə tənzimləyə bilərsiniz.

[!NOTE] Verilənlər bazası qatı ətraf mühitin üstündə dayandığına görə, istehsalatda davranışın çoxunu dəyişmək üçün konfiqurasiya fayllarını redaktə etmirsiniz — admin UI-da dəyişirsiniz və bu, həmin iş sahəsi üçün qüvvəyə minir.

Qaynar (hot) və yenidən başlatma tələb edən

Dəyişdirilmiş parametrin necə qüvvəyə minməsi açardan asılıdır:

Davranış Nümunələr Nə vaxt tətbiq olunur
Qaynar (hot) alət aktivləşdirməsi, sub-agent maksimum dərinliyi İş zamanı yenidən oxunur, yenidən başlatma yoxdur
Yenidən başlatma tələb edən dinləmə ünvanı, müəyyən servislərin qoşulması Növbəti gateway yenidən başlatmasında tətbiq olunur

Qaynar açarlar canlı şəkildə yenidən oxunur, ona görə də aləti açıb-bağlamaq və ya subagent-depth tənzimləmək növbəti gedişdə qüvvəyə minir. Bəzi struktur açarları yalnız yenidən başlatmadan sonra qüvvəyə minir; admin UI hansının hansı olduğunu göstərir.

Bootstrap dəyişənləri yalnız env-də qalır

Bir neçə dəyişən ətraf mühitdə mövcud olmalıdır, çünki onlar parametrlər kataloqu (və onun oxuduğu verilənlər bazası) yaranmamışdan əvvəl lazımdır. Bu bootstrap dəyişənləri yalnız env-də olur və admin UI-da göstərilmir:

Dəyişən Niyə bootstrap-dır
AIHUMMER_DATABASE_URL DB-əsaslı hər hansı parametr oxunmazdan əvvəl DB mövcud olmalıdır.
AIHUMMER_DB_APP_URL RLS-i aktivləşdirən məhdudlaşdırılmış rol DSN-i.
AIHUMMER_MASTER_KEY base64-32 bayt; sirlərin saxlanmasını / vault / BYOK-u açır.
AIHUMMER_GATEWAY_ADDR Dinləmə ünvanı (standart :8780).
AIHUMMER_OIDC_ISSUER UI etibarlı sayılmazdan əvvəl /v1/admin/*-ı qoruyur.

[!WARNING] AIHUMMER_MASTER_KEY-i təhlükəsiz saxlayın və verilənlər bazası ehtiyat nüsxənizdən ayrıca ehtiyat nüsxəsini çıxarın. O, etibarnamə vault-unu deşifrə edir; onu itirsəniz, şifrələnmiş sirləri bərpa etmək mümkün deyil.

Konfiqurasiya faylı

Host-native quraşdırmalar üçün bootstrap ətraf mühiti systemd unit-inin yüklədiyi tək bir faylda yerləşir:

/home/.aihummer/etc/gateway.env

Bu faylı bootstrap və əsas dəyərlər üçün redaktə edin, sonra dəyişiklikləri tətbiq etmək üçün gateway servisini yenidən başladın:

# /home/.aihummer/etc/gateway.env (çıxarış)
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

Bu bootstrap/əsas açarlardan kənar hər şey — agentlər, alətlər, yaddaş rejimi, mülahizə strategiyaları, büdcələr, qoruyucu hasarlar və qalanları — bu fayl yerinə admin UI-nin parametrlərindən idarə olunmalıdır.

Əlavə imkanların qoşulması

Bir çox funksiya siz onları dəstək servisinə yönəltməyincə söndürülmüş qalır. Bunlar adətən gateway.env-də bir dəfə təyin olunur (və ya tətbiq olunan yerlərdə UI-da üstələnir):

# Real model qoş (yoxdursa → determinik mock)
AIHUMMER_LLM_PROVIDER=openai
AIHUMMER_LLM_MODEL=gpt-4o-mini
AIHUMMER_LLM_GATEWAY_URL=https://api.openai.com/v1

# Alətləri backend-lərinə yönəltməklə aktivləşdir
SEARXNG_URL=http://localhost:8888
CLOAKBROWSER_CDP_URL=http://localhost:9222

# Səs sidecar-ları (STT/TTS installer tərəfindən avtomatik təyin olunur)
AIHUMMER_STT_URL=http://localhost:8001
AIHUMMER_TTS_URL=http://localhost:8002

# Real vektor anbarı + embedder (əks halda yaddaşdaxili + hash embedder)
AIHUMMER_QDRANT_URL=http://localhost:6333
AIHUMMER_EMBEDDER_URL=http://localhost:8080

[!TIP] Real model heç vaxt tələb olunmur. AIHUMMER_LLM_* qoşulmadan cavablar determinik mock-dan gəlir; AiHummer həmçinin pulsuz/lokal OpenAI-uyğun endpoint-lərdə və Codex/ChatGPT-abunəlik nəqliyyatında işləyir, isteğe bağlı BYOK ilə.

Bildirişlər

Admin UI-nin «Bildirişlər» səhifəsi («Nəzarət» qrupu) nümunə hadisələrinin daxil olan lentidir (administratorun girişi, mövcud/tətbiq edilmiş yeniləmə, sidecar-ların düşməsi və bərpası və s.) — kateqoriya, vaciblik və oxunmamışlar üzrə filtrlərlə. Yanında — kateqoriya × çatdırılma kanalı matrisi: hər hadisə kateqoriyası üçün webui, email, telegram və push kanalları aktivləşdirilir. Webui bildirişləri lokal çatdırılır; Telegram «Telegram-ı bağla» düyməsi (deep-link) ilə bağlanır, email dəstək ünvanı təsdiqləndikdən sonra aktivləşir, push mobil tətbiqə gəlir. Kritik hadisələri webui kanalında söndürmək olmaz.

Növbəti hara