AiHummer
Қазақша▾
Кіру
v1.0.x▾
v1.0.xstable
{ }Swagger
Жұмысты бастау/Конфигурация

Конфигурация

v1.0.x · жаңартылды 2026-07-07

AiHummer орта айнымалыларының үйіндісі арқылы емес, параметрлер каталогы арқылы бапталады. Әр параметрдің белгіленген шешу реті бар, кілттердің көбін веб әкімші интерфейсінен жұмыс кезінде өзгертуге болады, ал тек шағын bootstrap айнымалылары жиынтығы ғана ортада қалуы керек. Жетекші ереже қарапайым: баптауға болатын нәрсенің бәрі Web UI-де бапталады — тек env-те де емес, қатты кодталған да емес.

Шешу реті

Каталогтағы әр параметр бірдей ретпен шешіледі, бірінші сәйкестік жеңеді:

  1. Дерекқор — әкімші интерфейсі арқылы орнатылған мән (жұмыс кеңістігі бойынша сақталады).
  2. Орта — сәйкес AIHUMMER_* айнымалысы.
  3. Әдепкі — релизбен жеткізілетін ішкі әдепкі.

Бұл әкімші интерфейсінің мәні жұмыс кезінде ортаны жоққа шығаратынын, ал орта ішкі әдепкіні жоққа шығаратынын білдіреді. Сіз ортада орнықты негізді жеткізіп, содан кейін қайта орналастырмай-ақ интерфейстен әрекетті тікелей баптай аласыз.

[!NOTE] Дерекқор қабаты ортаның үстінде тұрғандықтан, өндірісте әрекеттің көбін өзгерту үшін конфигурация файлдарын өңдемейсіз — оны әкімші интерфейсінде өзгертесіз әрі ол сол жұмыс кеңістігі үшін күшіне енеді.

Қызу мен қайта іске қосуды талап ететін

Өзгертілген параметрдің қалай күшіне енуі кілтке байланысты:

Әрекет Мысалдар Қашан қолданылады
Қызу құралды қосу, ішкі агенттің ең үлкен тереңдігі Жұмыс кезінде қайта оқылады, қайта іске қосусыз
Қайта іске қосуды талап ететін тыңдау мекенжайы, кейбір қызметтердің байланысуы Шлюздің келесі қайта іске қосылуында қолданылады

Қызу кілттер жанды түрде қайта оқылады, сондықтан құралды ауыстыру немесе subagent-depth мәнін реттеу келесі кезеңде күшіне енеді. Кейбір құрылымдық кілттер тек қайта іске қосудан кейін күшіне енеді; әкімші интерфейсі қайсысы қайсы екенін белгілейді.

Bootstrap айнымалылары тек env-те қалады

Бірнеше айнымалы ортада болуы керек, өйткені олар параметрлер каталогы (және ол оқитын дерекқор) пайда болмай тұрып қажет. Бұл bootstrap айнымалылары тек env-те болады әрі әкімші интерфейсінде көрсетілмейді:

Айнымалы Неліктен bootstrap
AIHUMMER_DATABASE_URL Кез келген DB-ге негізделген параметр оқылмас бұрын DB болуы керек.
AIHUMMER_DB_APP_URL RLS-ті іске қосатын шектеулі рөл DSN-і.
AIHUMMER_MASTER_KEY base64-32 байт; тыныштықтағы құпияларды / қойманы / BYOK-ты ашады.
AIHUMMER_GATEWAY_ADDR Тыңдау мекенжайы (әдепкі :8780).
AIHUMMER_OIDC_ISSUER Интерфейске сенгенге дейін /v1/admin/* қорғайды.

[!WARNING] AIHUMMER_MASTER_KEY кілтін қауіпсіз ұстаңыз әрі дерекқор сақтық көшірмесінен бөлек сақтаңыз. Ол тіркелгі деректері қоймасын шифрлайды; оны жоғалтсаңыз, шифрланған құпиялар қалпына келтірілмейді.

Конфигурация файлы

Хост-түпнұсқа орнатулар үшін bootstrap ортасы systemd блогы жүктейтін бір файлда тұрады:

/home/.aihummer/etc/gateway.env

Bootstrap және негізгі мәндер үшін осы файлды өңдеңіз, содан кейін өзгерістерді қолдану үшін шлюз қызметін қайта іске қосыңыз:

# /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

Осы bootstrap/негізгі кілттерден тыс нәрсенің бәрі — агенттер, құралдар, жад режимі, ойлау стратегиялары, бюджеттер, қорғаныс шектеулері және қалғаны — осы файлдан емес, әкімші интерфейсінің параметрлерінен басқарылуы керек.

Қосымша мүмкіндіктерді жалғау

Көптеген мүмкіндіктер сіз оларды бэкенд қызметіне бағыттағанша өшулі болады. Бұлар әдетте gateway.env-те бір рет орнатылады (немесе қолданылатын жерде интерфейсте жоққа шығарылады):

# 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] Нақты модель ешқашан міндетті емес. AIHUMMER_LLM_* жалғанбаса, жауаптар детерминды макеттен келеді; AiHummer сондай-ақ тегін/жергілікті OpenAI-үйлесімді нүктелерде және Codex/ChatGPT-жазылым транспортында, қосымша BYOK-пен жұмыс істейді.

Хабарландырулар

Админканың «Хабарландырулар» беті («Бақылау» тобы) — инстанс оқиғаларының кіріс лентасы (әкімші кіруі, қолжетімді/қолданылған жаңарту, sidecar-лардың құлауы мен қалпына келуі т.б.), категория, маңыздылық және оқылмағандар бойынша сүзгілерімен. Қасында — категория × жеткізу арнасы матрицасы: әр оқиға категориясы үшін webui, email, telegram және push арналары қосылады. webui хабарландырулары жергілікті жеткізіледі; Telegram «Telegram-ды байлау» түймесімен (deep-link) байланады, email қолдау мекенжайы расталғаннан кейін іске қосылады, push мобильді қосымшаға келеді. Критикалық оқиғаларды webui арнасында өшіру мүмкін емес.

Келесі қайда