Konfiguratsiya — AiHummer Hujjatlar

AiHummer bir orqali sozlanadi sozlamalar katalogi, atrof-muhit o’zgaruvchilari to’plami emas. gateway.env bo‘ladi faqat bootstrap: DSN ma’lumotlar bazasi, tinglash manzillari/portlari, asosiy kalit va shunga o‘xshash narsalar. Har bir boshqa kalit ma’lumotlar bazasida saqlanadi va ish vaqtidagi veb administrator UI orqali yoki bilan o‘zgartiriladi aihummer settings CLI. Qo’llaniladigan asosiy qoida oddiy: veb interfeysida sozlanishi mumkin bo’lgan hamma narsa sozlanadi — faqat env emas, va qattiq kodlangan ham emas.

Qaror buyruği

Har bir katalog sozlamasi shunday hal qilinadi, birinchi mos keluvchi g’olib bo’ladi:

Ma’lumotlar bazasi — admin UI orqali yoki aihummer settings set.
Standart — chiqarilgan versiya bilan birga keladigan o‘rnatilgan sukut bo‘yicha sozlama.

Atrof-muhit maqsadli ravishda bu zanjirning bir qismi emas: katalog kalitlari uchun AIHUMMER_* o’zgaruvchi ichida gateway.env bo‘ladi e’tiborsiz qoldirilgan, hatto o‘rnatilgan bo‘lsa ham. Bu har bir sozlamaga aniq bitta haqiqat manbaini beradi — ma’lumotlar bazasi — shuning uchun UI qiymati hech qachon env faylida unutib qo‘yilgan qatordan suzib o‘tmaydi.

[!NOTE] Ishlab chiqarishda xulq-atvorni o’zgartirish uchun siz konfiguratsiya fayllarini tahrirlab bo’lmaydi — siz o’zgartirasiz admin UI da sozlash (Boshqaruv → Sozlamalar, izlanishi mumkin bo‘lgan sahifa) yoki ishga tushirish aihummer settings set <KEY> <VALUE> (get / list o’qish), va bu oladi ushbu ish maydoni uchun ta’sir. O’rnatuvchi dastur o’zi boshlang’ich katalog qiymatlarini o’rnatadi ma’lumotlar bazasiga orqali aihummer settings set.

Issiq vs qayta ishga tushirish kerak

O’zgartirilgan sozlamaning ta’siri kalitga bog’liq:

Xulq-atvor	Misollar	Qachon qo’llaniladi
Issiq	asbobni yoqish, kichik agentning maksimal chuqurligi	Ish vaqtida qayta o‘qiladi, qayta ishga tushirish shart emas
Qayta ishga tushirish talab qilinadi	tashqi manzilni tinglash, ayrim xizmatlarning simlashtirilishi	Keyingi shlyuzni qayta ishga tushirishda qo‘llanadi

Issiq tugmalar jonli qayta o‘qiladi, shuning uchun vositani almashtirish yoki sozlash subagent-depth keyingi navbatda kuchga kiradi. Ba’zi struktura kalitlari faqat qayta ishga tushirishdan so’ng kuchga kiradi; admin UI qaysi biri qaysi ekanligini belgilaydi.

Bootstrap o’zgaruvchilari faqat env-da qoladi

Muayyan o‘zgaruvchilar muhitda mavjud bo‘lishi kerak, chunki ular sozlamalar katalogi (va undan o‘qiydigan ma’lumotlar bazasi) mavjud bo‘lishidan oldin kerak bo‘ladi. Bu bootstrap o‘zgaruvchilar faqatgina muhit uchun va admin UI’da ko‘rsatilmaydi:

O’zgaruvchi	Nima uchun bu bootstrap
`AIHUMMER_DATABASE_URL`	Har qanday DB bilan qo‘llab-quvvatlanadigan sozlamani o‘qishdan oldin DB mavjud bo‘lishi shart.
`AIHUMMER_DB_APP_URL`	RLSni faollashtiradigan cheklangan rol DSN.
`AIHUMMER_MASTER_KEY`	base64-32 bayt; sirlarni saqlashda ochadi / xazinada / BYOK.
`AIHUMMER_GATEWAY_ADDR`	Jamoatchilik tinglash manzili (standart) `:8780`) — API, juftlash, WS/SSE, kiruvchi va ilova/cho’ntak proksisi.
`AIHUMMER_WEBUI_ADDR`	Shaxsiy admin Veb UI tinglash manzili (standart) `:8781`), ildizda xizmat qilgan `/`; o‘rnatish `0` o‘chirish uchun.
`AIHUMMER_BLOB_DIR`	Blob/media papkasining fayl tizimi yo‘li — ishga tushishda kerak bo‘ladi.
`AIHUMMER_OIDC_ISSUER`	Himoya qiladi `/v1/admin/*` UI ishonchli bo’lishidan oldin.

Operatsion tizim simlari, masalan, telemetriya OTLP endpointi, bir xil boshlang‘ich toifasiga kiradi. Ushbu qisqa ro‘yxatda bo‘lmagan har qanday narsa katalog kaliti hisoblanadi: u ma’lumotlar bazasida yashaydi va env unga e’tibor bermaydi.

[!WARNING] Saqlash AIHUMMER_MASTER_KEY xavfsiz va zahiralangan alohida sizning ma’lumotlar bazangizdan zaxira. U foydalanish huquqi omborini shifrdan chiqaradi; uni yo‘qotib qo‘ysangiz, shifrlangan sirlarni ham yo‘qotasiz qayta tiklanmaydi.

Konfiguratsiya fayli

Mehmon-joylashtirilgan o‘rnatishlar uchun, yuklash muhiti tizimd tomonidan yuklanadigan yagona faylda mavjud:

~/.aihummer/etc/gateway.env

Ushbu faylni tahrir qiling faqat bootstrap qiymatlari uchun, so’ng o’zgarishlarni qo’llash uchun gateway xizmatini qayta ishga tushiring:

# ~/.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 kalitlaridan tashqari hamma narsa — agentlar, vositalar, xotira rejimi, mantiqiy strategiyalar, byudjetlar, himoya choralari va boshqalar — admin UI sozlamalari orqali boshqariladi (yoki orqali aihummer settings), bu fayldan emas: ushbu kalitlar uchun env e’tiborga olinmaydi.

Ixtiyoriy imkoniyatlarni simlash

Ko‘plab funksiyalarni ishga tushirishdan oldin ularni orqa xizmatga yo‘naltirishingiz kerak. Ushbu tugmalarning barchasi katalog sozlamalaridir (ular DB da saqlanadi): ularni admin UI da o‘rnating (Boshqaruv → Sozlamalar) yoki CLI bilan; ularni qo‘yish gateway.env hech narsa qilmaydi — ularga env e’tiborga olinmaydi. Paketdan o’rnatilgan sidecar’lar (STT/TTS va hokazo) uchun o’rnatuvchi qiymatlarni o’zi bazaga kiritadi.

# 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] Haqiqiy model hech qachon talab qilinmaydi. Bilsiz AIHUMMER_LLM_* simli, javoblar keladi deterministik soxta versiyasidan; AiHummer shuningdek bepul/mahalliy OpenAI-ga mos keladigan ustida ishlaydi endpointlar va Codex/ChatGPT-obuna transporti, ixtiyoriy BYOK bilan.

Bildirishnomalar

Admin UIning Bildirishnomalar sahifa (“Boshqaruv” ostida) voqealarning (administrator tizimga kirishi, yangilanish mavjud/qo‘llanilgan, sidecar ishlamay qolishi yoki tiklanishi va hokazo) kirish qutisi bo‘lib, uni kategoriya, jiddiylik va o‘qilmagan bo‘yicha filtrlash mumkin. Uning yonida esa kategoriya × yetkazib berish-kanali matrisi: har bir tadbir toifasi uchun siz yoqashtirgan vebui, elektron pochta, telegram va itarmoq kanallar. Veb UI bildirishnomalari mahalliy ravishda yetkaziladi; Telegram “Link Telegram” tugmasi bilan bog‘lanadi (chuqur havola), elektron pochta qo‘llab-quvvatlash manzili tasdiqlangach faollashadi va push mobil ilovaga keladi. Muhim voqealarni veb UI kanalida jim qilib bo‘lmaydi.

Keyingi qayerga

Admin kirishini qulflang: Birinchi kirish.
Fayllar qayerda joylashganini ko‘ring: O’rnatish.
Oldin shartlarni tekshiring: Talablar.