Konfigurasiýa — AiHummer Resminamalar

AiHummer bir topar gurşaw üýtgeýjisi arkaly däl-de, sazlamalar katalogy arkaly konfigurirlenýär. gateway.env diňe bootstrap üçin: maglumat bazasy DSN-i, diňleýiş salgylary/portlary, master açar we şuňa meňzeşler. Galan ähli açar maglumat bazasynda ýaşaýar we iş wagtynda web admin UI-den ýa-da aihummer settings CLI-si bilen üýtgedilýär. Esasy düzgün ýönekeý: sazlap bolýan ähli zat Web UI-de konfigurirlenip bolýar — diňe env-de däl, we kodlanan (hardcoded) däl.

Çözüş tertibi

Katalogdaky her sazlama şol bir tertipde çözülýär, ilkinji gabat gelýän ýeňýär:

Maglumat bazasy — admin UI ýa-da aihummer settings set arkaly bellenen baha.
Default — relizler bilen gelýän içki default baha.

Gurşaw bu zynjyryň bilkastlaýyn bölegi däl: katalog açarlary üçin gateway.env-däki AIHUMMER_* üýtgeýjisi äsgerilmeýär, hatda bellenen bolsa-da. Bu her sazlama takyk bir hakykat çeşmesini berýär — maglumat bazasyny — şeýlelikde UI bahasy env faýlyndaky ýatdan çykan setir tarapyndan hiç haçan ümsüm basylyp ýazylyp bilinmez.

[!NOTE] Önümçilikde özüni alyp baryşy üýtgetmek üçin konfigurasiýa faýllaryny redaktirlemeýärsiňiz — sazlamany admin UI-de (Dolandyryş → Sazlamalar, gözlenip bilýän sahypa) üýtgedýärsiňiz ýa-da aihummer settings set <AÇAR> <BAHA> işledýärsiňiz (okamak üçin get / list), we ol şol iş giňişligi üçin güýje girýär. Gurnaýjynyň özi başlangyç katalog bahalaryny aihummer settings set arkaly maglumat bazasyna eçilýär.

Hot vs gaýtadan başlamak talap edilýän

Üýtgedilen sazlamanyň nähili güýje girýändigi açara bagly:

Özüni alyp baryş	Mysallar	Haçan ulanylýar
Hot	gural rugsady, sub-agent maks çuňlugy	Iş wagtynda gaýtadan okalýar, gaýtadan başlamak ýok
Gaýtadan başlamak talap edilýän	diňleýiş salgysy, käbir hyzmatlaryň birikdirilmegi	Indiki gateway gaýtadan başlanda ulanylýar

Hot açarlar janly gaýtadan okalýar, şonuň üçin guraly açyp-ýapmak ýa-da subagent-depth-i sazlamak indiki gezekde güýje girýär. Käbir gurluşly açarlar diňe gaýtadan başlanyňyzdan soň güýje girýär; admin UI haýsysynyň haýsydygyny bellik edýär.

Bootstrap üýtgeýjiler diňe env-de galýar

Birnäçe üýtgeýji gurşawda bolmaly, sebäbi olar sazlamalar katalogy (we onuň okaýan maglumat bazasy) bar bolmazdan ozal gerek bolýar. Bu bootstrap üýtgeýjiler diňe env-de bolup, admin UI-de görkezilmeýär:

Üýtgeýji	Näme üçin bootstrap
`AIHUMMER_DATABASE_URL`	DB-de saklanýan islendik sazlama okalmazdan ozal DB bar bolmaly.
`AIHUMMER_DB_APP_URL`	RLS-i işjeňleşdirýän çäklendirilen rol DSN.
`AIHUMMER_MASTER_KEY`	base64-32 baýt; saklanýan syrlary / seýfi / BYOK-ny açýar.
`AIHUMMER_GATEWAY_ADDR`	Köpçülik diňleýiş salgysy (default `:8780`) — API, jübütleşdirme, WS/SSE, gelýän traffik we app/pocket proksisi.
`AIHUMMER_WEBUI_ADDR`	Hususy admin Web UI diňleýiş salgysy (default `:8781`), kök ýolunda `/` hödürlenýär; öçürmek üçin `0` belläň.
`AIHUMMER_BLOB_DIR`	Blob/media katalogynyň faýl ulgamy ýoly — başlanyşda gerek.
`AIHUMMER_OIDC_ISSUER`	UI ynamly bolmazdan ozal `/v1/admin/*`-i goraýar.

Telemetriýa OTLP endpointi ýaly operasion birikdirmeler hem şol bir bootstrap kategoriýasyna girýär. Bu gysga sanawda ýok islendik zat katalog açarydyr: ol maglumat bazasynda ýaşaýar we ol üçin env äsgerilmeýär.

[!WARNING] AIHUMMER_MASTER_KEY-i ygtybarly saklaň we maglumat bazasynyň ätiýaçlyk nusgasyndan aýratyn ätiýaçlaň. Ol kredensial seýfini deşifrleýär; ony ýitirseňiz şifrlenen syrlary dikeldip bolmaýar.

Konfigurasiýa faýly

Host-natiwe gurnamalar üçin bootstrap gurşawy systemd birligi ýükleýän ýeke-täk faýlda ýaşaýar:

~/.aihummer/etc/gateway.env

Bu faýly diňe bootstrap bahalary üçin redaktirläň, soňra üýtgeşmeleri ulanmak üçin gateway hyzmatyny gaýtadan başladyň:

# ~/.aihummer/etc/gateway.env (bölek)
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 başga ähli zat — agentler, gurallar, ýat režimi, pikirleniş strategiýalary, býujetler, gorag relsleri we galanlary — bu faýldan däl-de, admin UI-niň sazlamalaryndan (ýa-da aihummer settings arkaly) dolandyrylýar: bu açarlar üçin env äsgerilmeýär.

Goşmaça mümkinçilikleri birikdirmek

Köp aýratynlyk siz ony bir baglanyşyk hyzmatyna gönükdirýänçäňiz öçükdir. Bu açarlaryň hemmesi katalog sazlamalary (olar DB-de ýaşaýar): olary admin UI-de (Dolandyryş → Sazlamalar) ýa-da CLI bilen belläň; olary gateway.env-e goýmak hiç zat etmeýär — olar üçin env äsgerilmeýär. Bandldan gurnalan sidecar-lar (STT/TTS we ş.m.) üçin gurnaýjynyň özi bahalary maglumat bazasyna eçilýär.

# Hakyky modeli birikdir (bellenmedik → deterministik 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

# Gurallary olaryň backend-lerine gönükdirip işjeňleşdir
aihummer settings set SEARXNG_URL http://localhost:8888
aihummer settings set CLOAKBROWSER_CDP_URL http://localhost:9222

# Ses sidecar-lary (STT/TTS gurnaýjy tarapyndan awtomatiki sazlanýar)
aihummer settings set AIHUMMER_STT_URL http://localhost:8001
aihummer settings set AIHUMMER_TTS_URL http://localhost:8002

# Hakyky wektor ammary + embedder (mysal salgylar; embedder --with-embedder
# bilen gurnalýar, bolmasa ýat leksiki ätiýaçlyk gözlegi ulanýar)
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. AIHUMMER_LLM_* birikdirilmedik bolsa, jogaplar deterministik mock-dan gelýär; AiHummer şeýle hem mugt/ýerli OpenAI-gabat gelýän nokatlarda we Codex/ChatGPT-abuna transportynda işleýär, isleg boýunça BYOK bilen.

Bildirişler

Admin UI-niň («Dolandyryş» astyndaky) «Bildirişler» sahypasy nusganyň wakalar gutusydyr (admin girişi, elýeterli/ulanylan täzelenme, sidecar-yň düşmegi ýa-da dikelmegi we ş.m.), kategoriýa, kynçylyk derejesi we okalmadyk boýunça süzgüçler bilen. Onuň ýanynda kategoriýa × eltiş-kanal matrisasy ýerleşýär: her waka kategoriýasy üçin webui, email, telegram we push kanallaryny işjeňleşdirýärsiňiz. Web UI bildirişleri ýerli eltilýär; Telegram «Telegram-y baglamak» düwmesi (deep link) bilen baglanýar, email goldaw salgysy tassyklanandan soň işjeňleşýär, push bolsa mobil programma gelýär. Kritik wakalary webui kanalynda öçürip bolmaýar.

Indiki nirä

Admin girişini berkidiň: Ilkinji giriş.
Faýllaryň nirede ýaşaýandygyny görüň: Gurnama.
Öňünden talaplary barlaň: Talaplar.