Канфігурацыя
AiHummer наладжваецца праз каталог налад, а не праз нагрувашчванне зменных асяроддзя. Кожная налада мае вызначаны парадак вырашэння, большасць ключоў можна змяніць з вэб-адмінскага UI ў рантайме, і толькі невялікі набор bootstrap-зменных павінен заставацца ў асяроддзі. Кіруючае правіла простае: усё, што наладжваецца, можна сканфігураваць у Web UI — не толькі ў env і не зашыта жорстка ў код.
Парадак вырашэння
Кожная налада ў каталогу вырашаецца ў адным і тым жа парадку, перамагае першае супадзенне:
- База даных — значэнне, зададзенае праз адмінскі UI (захоўваецца для кожнага workspace).
- Асяроддзе — адпаведная зменная
AIHUMMER_*. - Значэнне па змаўчанні — убудаванае значэнне, што пастаўляецца з рэлізам.
Гэта значыць, што значэнне з адмінскага UI перавызначае асяроддзе ў рантайме, а асяроддзе перавызначае ўбудаванае значэнне па змаўчанні. Вы можаце задаць разумны базавы ўзровень у асяроддзі, а потым наладжваць паводзіны на хаду з UI без паўторнага разгортвання.
[!NOTE] Паколькі слой базы даных стаіць над асяроддзем, вам не трэба рэдагаваць канфігурацыйныя файлы, каб змяніць большасць паводзін у прадакшэне — вы мяняеце іх у адмінскім UI, і яны ўступаюць у сілу для гэтага workspace.
Гарачыя налады супраць тых, што патрабуюць перазапуску
Тое, як ужываецца змененая налада, залежыць ад ключа:
| Паводзіны | Прыклады | Калі ўжываецца |
|---|---|---|
| Гарачыя | уключэнне інструментаў, максімальная глыбіня суб-агентаў | Перачытваюцца ў рантайме, без перазапуску |
| Патрабуюць перазапуску | адрас праслухоўвання, звязка пэўных сэрвісаў | Ужываюцца пры наступным перазапуску gateway |
Гарачыя ключы перачытваюцца на хаду, таму пераключэнне інструмента ці карэкціроўка
subagent-depth уступае ў сілу на наступным ходзе. Некаторыя структурныя ключы
ўступаюць у сілу толькі пасля перазапуску; адмінскі UI пазначае, якія менавіта.
Bootstrap-зменныя застаюцца толькі ў env
Некалькі зменных павінны прысутнічаць у асяроддзі, бо яны патрэбны да таго, як з’явіцца каталог налад (і база даных, з якой ён чытае). Гэтыя bootstrap-зменныя існуюць толькі ў env і не паказваюцца ў адмінскім UI:
| Зменная | Чаму гэта bootstrap |
|---|---|
AIHUMMER_DATABASE_URL |
БД павінна існаваць да таго, як можна прачытаць любую наладу, што захоўваецца ў БД. |
AIHUMMER_DB_APP_URL |
DSN з абмежаванай роляй, які актывуе RLS. |
AIHUMMER_MASTER_KEY |
base64-32 байты; разблакоўвае secrets-at-rest / vault / BYOK. |
AIHUMMER_GATEWAY_ADDR |
Адрас праслухоўвання (па змаўчанні :8780). |
AIHUMMER_OIDC_ISSUER |
Абараняе /v1/admin/*, пакуль UI не стане давераным. |
[!WARNING] Захоўвайце
AIHUMMER_MASTER_KEYу бяспецы і рабіце рэзервовую копію асобна ад рэзервовай копіі вашай базы даных. Ён расшыфроўвае сховішча ўліковых даных; страціце яго — і зашыфраваныя сакрэты немагчыма будзе аднавіць.
Канфігурацыйны файл
Для host-native усталёвак bootstrap-асяроддзе знаходзіцца ў адзіным файле, які загружае юніт systemd:
/home/.aihummer/etc/gateway.envАдрэдагуйце гэты файл для bootstrap- і базавых значэнняў, потым перазапусціце сэрвіс gateway, каб ужыць змены:
# /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/mainsystemctl restart aihummer-gatewayУсё, што выходзіць за межы гэтых bootstrap-/базавых ключоў — агенты, інструменты, рэжым памяці, стратэгіі разважання, бюджэты, абмежавальныя бар’еры і астатняе — прызначана для кіравання з налад адмінскага UI, а не з гэтага файла.
Звязка апцыянальных магчымасцей
Многія функцыі выключаны, пакуль вы не накіруеце іх на абслугоўваючы сэрвіс. Іх
звычайна задаюць адзін раз у gateway.env (або перавызначаюць у UI, дзе гэта
дастасавальна):
# 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_*адказы прыходзяць ад дэтэрмінаванага mock; AiHummer таксама працуе на бясплатных/лакальных OpenAI-сумяшчальных канчатковых пунктах і транспарце Codex/ChatGPT-падпіскі, з апцыянальным BYOK.
Апавяшчэнні
Старонка «Апавяшчэнні» адмінкі (група «Кантроль») — гэта ўваходная стужка падзей інстанса (уваход адміністратара, даступнае/ужытае абнаўленне, падзенне і аднаўленне сайдкараў і г.д.) з фільтрамі па катэгорыі, важнасці і непрачытаных. Побач — матрыца катэгорыя × канал дастаўкі: для кожнай катэгорыі падзей уключаюцца каналы webui, email, telegram і push. Апавяшчэнні webui дастаўляюцца лакальна; Telegram прывязваецца кнопкай «Прывязаць Telegram» (deep-link), email актывуецца пасля пацверджання адраса падтрымкі, push прыходзіць у мабільную праграму. Крытычныя падзеі нельга адключыць у канале webui.
Куды далей
- Абараніце адмінскі ўваход: Першы ўваход.
- Паглядзіце, дзе знаходзяцца файлы: Усталёўка.
- Праверце патрабаванні: Патрабаванні.