Konfiqurasiya — AiHummer Sənədlər

AiHummer bir vasitə ilə konfiqurasiya olunur ayarlar kataloqu, ətraf mühit dəyişənlərinin yığını deyil. gateway.env dır yalnız bootstrap: məlumat bazası DSN, dinləmə ünvanları/portlar, əsas açar və s. Digər bütün açarlar məlumat bazasında yerləşir və iş vaxtında və ya veb admin UI vasitəsilə dəyişdirilir aihummer settings CLI. Əsas qayda sadədir: Veb İstifadəçi İnterfeysində tənzimlənə bilən hər şey konfiqurasiya edilə bilər — yalnız ətraf mühit üçün deyil və sərt şəkildə kodlaşdırılmayıb.

Qərarın qəbul edilməsi sırası

Hər bir kataloq parametri eyni şəkildə həll olunur, ilk uyğun gələn qalibdir:

Verilənlər bazası — admin UI vasitəsilə təyin olunan dəyər və ya aihummer settings set.
Varsayılan — buraxılışla birlikdə göndərilən daxili standart.

Ətraf mühit qəsdən bu zəncirin bir hissəsi deyil: kataloq açarları üçün AIHUMMER_* dəyişən daxilində gateway.env dır görməzdən gəlindi, hətta təyin edilmiş olsa belə. Bu hər bir təyinat üçün tam olaraq bir həqiqət mənbəyi təmin edir — verilənlər bazası — beləliklə, bir UI dəyəri heç vaxt bir env faylında unudulmuş bir sətir tərəfindən səssizcə kölgələnə bilməz.

[!NOTE] İstehsalatda davranışı dəyişmək üçün konfiqurasiya fayllarını redaktə etmirsiniz — siz dəyişirsiniz admin UI-də ayar (İdarəetmə → Parametrlər, axtarıla bilən bir səhifə) və ya işlət aihummer settings set <KEY> <VALUE> (get / list oxumaq), və bu vaxt aparır o iş sahəsi üçün təsir. Quraşdırıcı özü ilkin kataloq dəyərlərini verir verilənlər bazasına vasitəsilə aihummer settings set.

İsti vs yenidən başlatma tələb olunur

Dəyişdirilmiş bir parametrenin təsir etməsi açardan asılıdır:

Davranış	Nümunələr	Tətbiq olunduqda
İsti	alət aktivləşdirmə, alt-agent maksimum dərinliyi	İcra zamanı yenidən oxu, yenidən başlatmağa ehtiyac yoxdur
Yenidən başlatma tələb olunur	dinləmə ünvanı, bəzi xidmətlərin kabelləşdirilməsi	Növbəti şlüz yenidən başladıqda tətbiq olunacaq

Qısa yollar canlı olaraq yenidən oxunur, buna görə aləti açıb bağlamaq və ya tənzimləmək subagent-depth növbəti turda qüvvəyə minir. Bəzi struktur açarları yalnız yenidən başladıqdan sonra qüvvəyə minir; admin UI hansıların hansısı olduğunu göstərir.

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

Bir neçə dəyişən mühitdə mövcud olmalıdır, çünki onlar parametrlər kataloqu mövcud olmadan (və onun oxuduğu verilənlər bazası) lazım olur. Bunlar başlatmaq dəyişənlər yalnız mühit üçündür və idarəetmə idarəetmə panelində göstərilmir:

Dəyişən	Niyə bu bootstrap-dir
`AIHUMMER_DATABASE_URL`	Hər hansı bir verilənlər bazasına əsaslanan parametri oxumaqdan əvvəl verilənlər bazası mövcud olmalıdır.
`AIHUMMER_DB_APP_URL`	RLS-i işə salan məhdudlaşdırılmış DSN rolu.
`AIHUMMER_MASTER_KEY`	base64-32 bayt; istirahətdəki sirləri açır / zəmanət qutusu / BYOK.
`AIHUMMER_GATEWAY_ADDR`	İctimai dinləmə ünvanı (default `:8780`) — API, qoşma, WS/SSE, daxil olan və tətbiq/cib vasitəçi.
`AIHUMMER_WEBUI_ADDR`	Şəxsi admin Veb İstifadəçi İnterfeysi dinləmə ünvanı (standart) `:8781`), kökdə təqdim edildi `/`; müəyyənləşdirildi `0` çıxarmaq üçün
`AIHUMMER_BLOB_DIR`	Blob/media qovluğunun fayl sistemi yolu — başlanğıcda tələb olunur.
`AIHUMMER_OIDC_ISSUER`	Qoruyur `/v1/admin/*` UI etibarlı hesab olunmazdan əvvəl.

Telemetriya OTLP endpointi kimi Ops kabelləşməsi eyni başlanğıc kateqoriyasına daxildir. Bu qısa siyahıda olmayan hər şey kataloq açarıdır: o verilənlər bazasında yaşayır və onun üçün env nəzərə alınmır.

[!WARNING] Saxla AIHUMMER_MASTER_KEY təhlükəsiz və ehtiyat nüsxəsi var ayrılıqda sizin verilənlər bazanızdan backup. O, etibarnamə anbarını deşifr edir; onu itirsən, şifrələnmiş sirləri itirirsən bərpa edilə bilməz.

Konfiqurasiya faylı

Qonaq-yerli quraşdırmalar üçün, bootstrap mühiti systemd vahidinin yüklədiyi tək faylda yerləşir:

~/.aihummer/etc/gateway.env

Bu faylı redaktə et yalnız bootstrap dəyərləri üçün, sonra dəyişiklikləri tətbiq etmək üçün gateway xidmətini yenidən başladın:

# ~/.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_WEBUI_ADDR=:8781
AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main

systemctl restart aihummer-gateway

Bu bootstrap açarlarının xaricində hər şey — agentlər, alətlər, yaddaş rejimi, səbəb nəticə strategiyaları, büdcələr, qoruyucu çərçivələr və qalanlar — admin UI-nin parametrlərindən idarə olunur (və ya vasitəsilə aihummer settings), bu fayldan deyil: bu açarlar üçün env nəzərə alınmır.

Kablolama üçün opsional imkanlar

Çoxlu xüsusiyyətlər onları dəstək xidmətinə yönəldənə qədər söndürülür. Bütün bu açarlar kataloq parametrləridir (onlar verilənlər bazasında yerləşir): onları admin UI-də təyin edin (İdarəetmə → Parametrlər) və ya CLI ilə; onları yerləşdirmə gateway.env heç nə etmir — onlar üçün env nəzərə alınmır. Bundle-dan quraşdırılmış sidecar-lar üçün (STT/TTS və s.) quraşdırıcı dəyərləri özü verilənlər bazasına yerləşdirir.

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

# Enable tools by pointing at their backends

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

# Real vector store + embedder (example URLs; the embedder is installed with
# --with-embedder, otherwise memory uses the lexical fallback)
aihummer settings set AIHUMMER_QDRANT_URL http://localhost:6333
aihummer settings set AIHUMMER_EMBEDDER_URL http://localhost:8080

[!TIP] Həqiqi model heç vaxt tələb olunmur. Olmadan AIHUMMER_LLM_* qoşulmuş, cavablar gəlir deterministik məxluqdan; AiHummer həmçinin pulsuz/yerli OpenAI-uyğun üzərində işləyir son nöqtələr və bir Codex/ChatGPT-abunə daşıyıcısı, istəyə bağlı BYOK ilə.

Bildirişlər

Admin interfeysinin Bildirişlər səhifə (“Nəzarət” altında) nümunənin hadisələr qutusudur (admin girişləri, mövcud/tətbiq edilmiş yeniləmələr, yan maşının aşağı düşməsi və ya bərpası və s.) kateqoriya, ciddilik və oxunmamışlara görə filtrlərlə. Onun yanında bir kateqoriya × çatdırılma-kanalı matrisi: aktiv etdiyiniz hər hadisə kateqoriyası üçün veb interfeys, e-poçt, telegram və itələmək kanallar. Veb UI bildirişləri yerli olaraq göndərilir; Telegram “Telegramu Bağla” düyməsi ilə əlaqələndirilir (dərin link), e-poçt dəstək ünvanı təsdiqləndikdən sonra aktivləşir və push mobil tətbiqdə gəlir. Kritik hadisələr webui kanalında səssizləşdirilə bilməz.

Növbəti haradır

Admin daxilolmasını bağlayın: İlk giriş.
Faylların harada yerləşdiyini görün: Quraşdırma.
Tələbləri yoxlayın: Tələblər.