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

~/.aihummer/etc/gateway.env

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

# 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

AiHummer бір арқылы бапталады **параметрлер каталогы**, қоршаған орта айнымалылар жинағы емес. `gateway.env` болып табылады **тек bootstrap**: деректер қорының DSN, тыңдау мекенжайлары/порттары, негізгі кілт және осындай нәрселер. Басқа барлық кілттер деректер қорында сақталады және оларды веб әкімші UI арқылы орындау кезінде немесе `aihummer settings` CLI. Негізгі қағида қарапайым: **Веб интерфейсінде баптауға болатын барлық нәрсе бапталуы мүмкін** — тек қоршаған ортаға арналған емес, және қатты кодталған да емес. ## Шешімнің тәртібі Әрбір каталог параметрі бірдей шешіледі, бірінші сәйкестік жеңеді: 1. **Дерекқор** — әкімші UI арқылы немесе арқылы орнатылған мән `aihummer settings set`. 2. **Әдепкі** — шығарылыммен бірге жеткізілетін кірістірілген әдепкі баптау. Қоршаған орта **бұл тізбектің бөлігі емес деп саналған**: каталог кілттері үшін `AIHUMMER_*` айнымалыда `gateway.env` болып табылады **ұмытылған**, тіпті орнатылған болса да. Бұл әрбір баптауға бір ғана сенімді дереккөзді — дерекқорды — береді, сондықтан UI мәні ешқашан елеусіз қалдырылған env файлындағы жолмен көлеңкеленбейді. > [!NOTE] > Өндірісте мінез-құлықты өзгерту үшін конфигурациялық файлдарды өңдемейсіз — сіз өзгертесіз > әкімші интерфейсіндегі баптау (**Басқару → Баптаулар**, іздеу мүмкіндігі бар бет) немесе іске қосу > `aihummer settings set <KEY> <VALUE>` (`get` / `list` оқу үшін), және бұл алады > сол жұмыс кеңістігі үшін әсері. Орнатушы өзі бастапқы каталог мәндерін орнатады > дерекқорға арқылы `aihummer settings set`. ## Ыстық vs қайта іске қосуды қажет етеді Параметр өзгерген кезде оның әсері кілтке байланысты болады: | Кәсіптік мінез-құлық | Мысалдар | Қолданылғанда | |---|---|---| | **Ыстық** | құралды іске қосу, қосымша агенттің максималды тереңдігі | Операция кезінде қайта оқу, қайта іске қоспау | | **Қайта іске қосу қажет** | тыңдау мекенжайы, кейбір қызметтердің сымдары | Келесі қақпаны қайта жүктегенде қолданылады | Ыстық пернелер тікелей қайта оқылады, сондықтан құралды қосу немесе баптау `subagent-depth` келесі айналымда күшіне енеді. Кейбір құрылымдық кілттер қайта іске қосқаннан кейін ғана күшіне енеді; әкімші UI қайсысы қандай екенін белгілейді. ## Bootstrap айнымалылары тек қана ортаны сақтайды Кейбір айнымалылар ортада болуы қажет, өйткені олар баптау каталогы (және одан оқитын деректер қоры) пайда болғанға дейін қажет болады. Бұлар **бутстрап** айнымалылар тек қоршаған орта үшін және әкімші интерфейсінде көрсетілмейді: | Айнымалы | Неліктен ол bootstrap | |---|---| | `AIHUMMER_DATABASE_URL` | Кез келген дерекқорға негізделген параметрді оқымастан бұрын дерекқор болуы керек. | | `AIHUMMER_DB_APP_URL` | RLS-ті қосатын шектелген рөлдегі DSN. | | `AIHUMMER_MASTER_KEY` | base64-32 байт; құпияларды тыныштықта ашады / сандық қорап / BYOK. | | `AIHUMMER_GATEWAY_ADDR` | Қоғамдық тыңдау мекенжайы (әдепкі) `:8780`) — API, жұптастыру, WS/SSE, кіріс және қосымша/қалталық прокси. | | `AIHUMMER_WEBUI_ADDR` | Жеке әкімші Web интерфейсінің тыңдау мекенжайы (әдепкі `:8781`), тамырда берілді `/`; орнату `0` өшіру үшін. | | `AIHUMMER_BLOB_DIR` | Blob/медиа каталогының файлдық жүйедегі жолы — жүктеу кезінде қажет. | | `AIHUMMER_OIDC_ISSUER` | Қорғайды `/v1/admin/*` UI сенімді деп танылғанға дейін. | Telemetry OTLP нүктесі сияқты Ops сымдары бірдей бастапқы жүктеу санатына жатады. Осы қысқа тізімде жоқ нәрсенің бәрі каталог кілті болып табылады: ол дерекқорда тұрады, және оған env ескерілмейді. > [!WARNING] > Сақтау `AIHUMMER_MASTER_KEY` қауіпсіз және сақтық көшірмесі жасалған **жеке** сіздің дерекқорыңыздан > бэкап. Ол құпия деректер қорының шифрын ашады; оны жоғалтсаңыз, шифрланған құпияларды > қайтарылмайды. ## Конфигурация файлы Хостқа арналған жергілікті орнатулар үшін bootstrap ортасы systemd бірлігі жүктейтін бір файлда орналасады: ```text ~/.aihummer/etc/gateway.env ``` Бұл файлды өңдеу **тек бутап жолақ мәндері үшін**, содан кейін өзгерістерді қолдану үшін шлюз қызметін қайта іске қосыңыз: ```ini # ~/.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 ``` ```bash systemctl restart aihummer-gateway ``` Бұл бастапқы кілттерден тыс барлық нәрсе — агенттер, құралдар, есте сақтау режимі, ойлау стратегиялары, бюджеттер, қорғаныс құралдары және қалғандары — әкімші интерфейсінің баптауларынан (немесе арқылы) басқарылады `aihummer settings`), бұл файлдан емес: env сол кілттер үшін ескерілмейді. ## Сымдық қосымша мүмкіндіктер Көптеген функциялар оларды қолдау қызметіне бағыттамағанша өшірулі болады. Осы барлық кілттер каталог параметрлері болып табылады (олар дерекқорда сақталады): оларды әкімшішіл интерфейсте орнатыңыз (**Басқару → Баптаулар**) немесе CLI арқылы; оларды қою `gateway.env` ештеңе жасамайды — олар үшін env еленбейді. Бұтіннен орнатылған сайдкарлар (STT/TTS және т.б.) үшін орнатушы мәндерді дерекқорға өзі енгізеді. ```bash # 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] > Шынайы модель ешқашан талап етілмейді. Онсыз `AIHUMMER_LLM_*` байланысқан, жауаптар келеді > детерминистикалық имитациядан; AiHummer сондай-ақ тегін/жергілікті OpenAI-пен үйлесімді режимде жұмыс істейді > аяқ нүктелері және Codex/ChatGPT-жазылым тасымалы, міндетті емес BYOK-пен. ## Хабарландырулар Әкімші интерфейстері **Хабарламалар** бет («Басқару» бөлімінде) – бұл инстанцияның оқиғалар жәшігі (әкімші жүйеге кіруі, жаңарту қолжетімді/қолданылғаны, сайдкар тоқтауы немесе қалпына келуі және т.б.) категория, ауырлық деңгейі және оқылмағанымен сүзгіден өткізу мүмкіндігімен. Оның жанына орналасқан **санат × жеткізу арнасы матрицасы**: әрбір оқиға санатын қосқан сайын **веб интерфейс**, **электрондық пошта**, **телеграм** және **итеру** арналар. Веб UI хабарламалары жергілікті түрде жеткізіледі; Telegram «Link Telegram» батырмамен (терең сілтеме) байланыстырылған, электрондық пошта тек қолдау мекенжайы расталғаннан кейін іске қосылады, ал push хабарламалары мобильді қосымшаға келеді. Веб UI арнасында маңызды оқиғаларды өшіру мүмкін емес. ## Келесі қайда - Әкімші кіруін құлыптау: [Бірінші кіру](/kk/v1.0/getting-started/first-login). - Файлдардың қайда орналасқанын қараңыз: [Орнату](/kk/v1.0/getting-started/installation). - Алдын ала талаптарды тексеріңіз: [Талаптар](/kk/v1.0/getting-started/requirements).