Konfigurasiýa — AiHummer Resminamalar

AiHummer bir arkaly konfigurasiýa edilýär saýlawlar katalogy, gurşaw üýtgeýänleriň dagy däl. gateway.env -dir diňe bootstrap: maglumatlar bazasynyň DSN-i, gulak asma salgylary/portlary, başlyk açary we ş.m. Her başga açar maglumatlar bazasynda ýaşaýar we wagtynda web administrasiýa interfeýsi arkaly ýa-da bilen üýtgedilýär aihummer settings CLI. Başdaşlyk düzgünine ýönekeýdir: web interfeýsinde sazlap bolýan ähli zat konfigurirlenip bolýar — diňe çevre üsti bilen däl, we çäklendirilip ýazylmadyk.

Kararyň buýruklygy

Her katalog sazlamasy öňinçä laýyk gelýän çözgüt bilen çözülýär:

Maglumatlar bazasy — admin UI arkaly ýa-da kesgitlenen baha aihummer settings set.
Öňünden kesgitleme — çykarylan görnüş bilen ýerleşdirilen gurnama.

Tebigat bu zynjyranyň bir bölegi bolman maksat bilen: katalog açarlary üçin AIHUMMER_* üýtgeýän içinde gateway.env -dir üpjün edilmän, gurulsa-da. Bu her bir sazlamanyň diňe bir hakykat çeşmesiniň — maglumatlar bazasynyň — bolmagyny üpjün edýär, şonuň üçin UI bahasy unudylan bir setir bilen env faýlyndaky gizlin gizlenip bilmez.

[!NOTE] Önümçilikde häsiýeti üýtgetmek üçin konfigurasiýa faýllaryny üýtgetmeýärsiňiz — siz ony üýtgedýärsiňiz dolandyryş UI-de sazlama (Dolandyryş → Sazlamalar, gözleg edilip bilinýän sahypa) ýa-da işletmek aihummer settings set <KEY> <VALUE> (get / list okamak üçin), we bu alýar şol iş meýdançasyna täsir edýär. Gurnamajy özüniň başlangyç katalog bahalaryny goýýar maglumatlar bazasyna arkaly aihummer settings set.

Isleme meşinmi ýa täzeden başlamagy talap edýärmi

Üýtgedilen sazlamanyň täsiri açara görä üýtgeýär:

Görüş	Mysallar	Ondan peýdalanylanda
Yssy	gural aktiwleşdirmek, beýlekçi maksimum çuňluk	Işleýän wagty gaýtadan oka, täzeden başlamagyň zerurlygy ýok
Täzeden başlatmak talap edilýär	diňe üns bermek salgysy, belli hyzmatlaryň simi	Indiki gapy gijikdirileninde ulanyldy

Gyzyl basyş düwmleri göni okalýar, şonuň üçin guraly açmak ýa-da sazlamak subagent-depth indiki öwrümde täsirli bolýar. Käbir gurluşy açarlar diňe gaýtadan başlatmandan soň täsir edýär; administrasiýa interfeýsi haýsynyň haýsydygyny görkezýär.

Bootstrap üýtgeýjiler diňe gurşawda galýar

Haçan-da sazlamalar katalogy (we onuň okaýan maglumatlar bazasy) bolmazdan öň zerur bolandygy üçin, daşky gurşawda birnäçe üýtgeýji bolmalydyr. Bularyň bootstrap üýtgeýjiler diňe daşky gurşaw üçin we admin UI-de görkezilmeýär:

Üýtgeýän	Näme üçin bu bootstrap
`AIHUMMER_DATABASE_URL`	Hala her-hili DB esasly sazlama okalyp bilmezden öň, DB-niň bardygy bolmaly.
`AIHUMMER_DB_APP_URL`	RLS-i işjeňleşdirýän çäklendirilen DSN roly.
`AIHUMMER_MASTER_KEY`	base64-32 bait; dynç ýagdaýyndaky gizlinlikleri açýar / şaýatlyk gutusy / BYOK.
`AIHUMMER_GATEWAY_ADDR`	Ilaty diňlemegiň salgysy (çägelenen) `:8780`) — API, juwanlaşdyrma, WS/SSE, içeri girýän we programma/poçta proksi.
`AIHUMMER_WEBUI_ADDR`	Şahsy administrasiýa Web UI diňleýiş salgysy (başlangyç) `:8781`), kökündäki hyzmat edilýär `/`; bellenildi `0` öçürmek üçin.
`AIHUMMER_BLOB_DIR`	Blob/mediý faýl ulgamy ýolunyň faýl ulgamy — işe gireniňde gerek.
`AIHUMMER_OIDC_ISSUER`	Gorýar `/v1/admin/*` Ulanyjy interfeysi ynam edilmezden öň.

Telemetry OTLP uçuryşy ýaly ops tor baglanyşyklary hem şoňa meňzeş bootstrap kategoriýasyna girýär. Bu gysga sanawda ýok bolan her zat katalog açary bolup durýar: ol maglumatlar bazasynda ýaşap bolýar, we onuň üçin env diňlenilmeýär.

[!WARNING] Sakla AIHUMMER_MASTER_KEY howpsuz we ätiýaçlyk bilen goralan ayry siziň maglumatlar bazanyňyzdan backup. Ol şahsy maglumat skafdyrny deşifreleýär; ony ýitirseniz we şifrlenen gizlinler dikeldip bolmaýar.

Konfigurasiýa faýly

Myhmançylyk-daş-tutma gurallary üçin bootstrap gurşawy, systemd birligi ýükleýän bir faýlda ýaşaýar:

~/.aihummer/etc/gateway.env

Bu faýly üýtget diňe bootstrap gymmatlary üçin, soň üýtgeşmeleri girizmek üçin gapy hyzmatyny täzeden başlatmak:

# ~/.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çarlardan daşyndaky ähli zat — agentler, gurallar, ýatlama režimi, pikirleniş strategiýalary, býujetler, gorag çäklendirmeleri we beýlekiler — admin UI sazlamalaryndan (ýa-da arkaly) dolandyrylýar aihummer settings), bu faýldan däl: şol açarlara degişli enwek göz öňünde tutulmaýar.

Simirleme opsiýa mümkinçilikleri

Köp sanawlar, olary goldaw berýän hyzmaty görkezmeýänçä öçükdir. Bu açarlaryň ählisi katalog sazlamalarydyr (olar DB-de ýaşaýarlar): admin UI-de sazlaň (Dolandyryş → Sazlamalar) ýa-da CLI bilen; olary goýmak gateway.env heç zat etmeýär — olara env göz öňüne alynmaýar. Baglamadan (STT/TTS we ş.m.) gurnalan gapma-garşy ulag üçin guramaçy gymmatlyklary özüniň maglumatlar binasyna goýýar.

# 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] Hakyky model hiç haçan talap edilmeýär. Ýokardan AIHUMMER_LLM_* simli, jogaplar gelýär deterministik meňzeşden; AiHummer şeýle hem mugt/ýerli OpenAI- bilen gabat gelýän sistemada işleýär uchuryş nokatlary we Codex/ChatGPT-abuna transporty, islendik BYOK bilen.

Bildirişler

Admin interfeýsiň Bildirişler sahypa (“Dolandyryş” aşagynda) instansyň wakalarynyň (administrator giriş, elýeterli/ülgedilen täzelenme, sidecar düşýär ýa-da dikelýär we ş.m.) gelen gutusy bolup, kategoriýa, agyrlyk we okaýlan däl ýaly filterler bilen. Onuň ýanynda bir kategoriýa × eltip bermek-kanaly matrisasy: her wakanyň kategoriýasy üçin siz işjeňleşdirýän web interfeýsi, elektron poçta, telegram we itermek kanallar. Web UI habarlary ýerli derejede ýetirilýär; Telegram “Link Telegram” düwmesi bilen baglanyşýar (çuň baglanyşyk), e-poçta goldaw salgysy tassyklanylanda işjeňleşýär we push habary mobil programmada ýetirilýär. Web UI kanalynda möhüm wakalary sessizleşdirmek mümkin däl.

Indi nire?

Admin hasabyna girişi ýapmak: Ilk girmek.
Faýllaryň nirede ýerleşýändigine serediň: Gurnama.
Talap edilýänleri barlaň: Talaplar.