AiHummer
Oʻzbekcha▾
Kirish
v1.0.x▾
v1.0.xstable
{ }Swagger
Ishni boshlash/Konfiguratsiya

Konfiguratsiya

v1.0.x · yangilandi 2026-07-07

AiHummer sozlamalar katalogi orqali sozlanadi, muhit oʻzgaruvchilari uyumi orqali emas. Har bir sozlamaning aniqlangan hal qilish tartibi bor, koʻpgina kalitlarni veb-admin UI dan ish vaqtida oʻzgartirish mumkin va faqat kichik bootstrap oʻzgaruvchilari toʻplami muhitda qolishi shart. Asosiy qoida oddiy: sozlash mumkin boʻlgan hamma narsa Web UI da sozlanadigan — faqat-env emas va qotirib qoʻyilmagan.

Hal qilish tartibi

Katalogdagi har bir sozlama bir xil tartibda aniqlanadi, birinchi moslik gʻolib:

  1. Maʼlumotlar bazasi — admin UI orqali oʻrnatilgan qiymat (har bir ish maydoni boʻyicha saqlanadi).
  2. Muhit — tegishli AIHUMMER_* oʻzgaruvchisi.
  3. Standart — relizga birga keladigan oʻrnatilgan standart.

Bu shuni anglatadiki, admin-UI qiymati ish vaqtida muhitni bekor qiladi, muhit esa oʻrnatilgan standartni bekor qiladi. Siz muhitda toʻgʻri bazaviy chiziqni yetkazib berishingiz, soʻngra qayta joylashtirmasdan UI dan jonli ravishda xulqni sozlashingiz mumkin.

[!NOTE] Maʼlumotlar bazasi qatlami muhit ustida turgani uchun siz ishlab chiqarishda koʻpgina xulqni oʻzgartirish uchun konfiguratsiya fayllarini tahrir qilmaysiz — uni admin UI da oʻzgartirasiz va u oʻsha ish maydoni uchun kuchga kiradi.

Qaynoq va qayta-ishga-tushirish-talab-qiladigan

Oʻzgartirilgan sozlama qanday kuchga kirishi kalitga bogʻliq:

Xulq Misollar Qachon qoʻllaniladi
Qaynoq vositani yoqish, sub-agent maksimal chuqurligi Ish vaqtida qayta-oʻqiladi, qayta ishga tushirishsiz
Qayta-ishga-tushirish-talab-qiladigan tinglash manzili, baʼzi xizmatlarning ulanishi Keyingi gateway qayta ishga tushishida qoʻllaniladi

Qaynoq kalitlar jonli qayta-oʻqiladi, shu bois vositani yoqib-oʻchirish yoki subagent-depthni sozlash keyingi nubatda kuchga kiradi. Baʼzi tarkibiy kalitlar faqat qayta ishga tushirishdan keyin kuchga kiradi; admin UI qaysi qaysiligini belgilaydi.

Bootstrap oʻzgaruvchilari faqat-env boʻlib qoladi

Baʼzi oʻzgaruvchilar muhitda boʻlishi shart, chunki ular sozlamalar katalogi (va u oʻqiydigan maʼlumotlar bazasi) mavjud boʻlishidan oldin kerak. Bu bootstrap oʻzgaruvchilari faqat-env va admin UI da koʻrsatilmaydi:

Oʻzgaruvchi Nega u bootstrap
AIHUMMER_DATABASE_URL Har qanday DB-asosli sozlama oʻqilishidan oldin DB mavjud boʻlishi kerak.
AIHUMMER_DB_APP_URL RLS ni faollashtiradigan cheklangan rol DSN.
AIHUMMER_MASTER_KEY base64-32 bayt; secrets-at-rest / vault / BYOK ni ochadi.
AIHUMMER_GATEWAY_ADDR Tinglash manzili (standart :8780).
AIHUMMER_OIDC_ISSUER UI ishonchli boʻlishidan oldin /v1/admin/* ni himoyalaydi.

[!WARNING] AIHUMMER_MASTER_KEY ni xavfsiz saqlang va maʼlumotlar bazasi zaxirasidan alohida zaxiralang. U hisob maʼlumotlari xazinasini deshifrlaydi; uni yoʻqotsangiz, shifrlangan sirlarni qayta tiklab boʻlmaydi.

Konfiguratsiya fayli

Xost-mahalliy oʻrnatishlar uchun bootstrap muhiti systemd birligi yuklaydigan bitta faylda yashaydi:

/home/.aihummer/etc/gateway.env

Bu faylni bootstrap va bazaviy qiymatlar uchun tahrir qiling, soʻngra oʻzgarishlarni qoʻllash uchun gateway xizmatini qayta ishga tushiring:

# /home/.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_OIDC_ISSUER=https://idp.example/realms/main
systemctl restart aihummer-gateway

Bu bootstrap/bazaviy kalitlardan tashqari hamma narsa — agentlar, vositalar, xotira rejimi, fikrlash strategiyalari, byudjetlar, himoya choralari va qolganlari — bu fayldan emas, balki admin UI sozlamalaridan boshqarilishi koʻzda tutilgan.

Ixtiyoriy qobiliyatlarni ulash

Koʻpgina xususiyatlar siz ularni qoʻllab-quvvatlovchi xizmatga yoʻnaltirmaguningizcha oʻchiq. Bular odatda gateway.env da bir marta oʻrnatiladi (yoki tegishli joyda UI da bekor qilinadi):

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

# Enable tools by pointing at their backends
SEARXNG_URL=http://localhost:8888
CLOAKBROWSER_CDP_URL=http://localhost:9222

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

# Real vector store + embedder (else in-memory + hash embedder)
AIHUMMER_QDRANT_URL=http://localhost:6333
AIHUMMER_EMBEDDER_URL=http://localhost:8080

[!TIP] Haqiqiy model hech qachon talab qilinmaydi. AIHUMMER_LLM_* ulanmagan boʻlsa, javoblar determinatsiyalangan mockdan keladi; AiHummer shuningdek bepul/mahalliy OpenAI-mos endpointlarda va Codex/ChatGPT-obuna transportida ishlaydi, ixtiyoriy BYOK bilan.

Bildirishnomalar

Admin UI’ning «Bildirishnomalar» sahifasi («Nazorat» guruhi) — instans hodisalarining kiruvchi lentasi (administrator kirishi, mavjud/qoʻllangan yangilanish, sidecar’larning yiqilishi va tiklanishi va h.k.), kategoriya, muhimlik va oʻqilmaganlar boʻyicha filtrlar bilan. Yonida — kategoriya × yetkazib berish kanali matritsasi: har bir hodisa kategoriyasi uchun webui, email, telegram va push kanallari yoqiladi. webui bildirishnomalari lokal yetkaziladi; Telegram «Telegram’ni bogʻlash» tugmasi (deep-link) bilan bogʻlanadi, email qoʻllab-quvvatlash manzili tasdiqlangandan keyin faollashadi, push mobil ilovaga keladi. Kritik hodisalarni webui kanalida oʻchirib boʻlmaydi.

Keyin qayerga