Канфігурацыя
AiHummer наладжваецца праз каталог налад, а не стос зменных асяроддзя. gateway.env з’яўляецца толькі bootstrap: база дадзеных DSN, адрасы/парты для праслухоўвання, галоўны ключ і падобнае. Усе астатнія ключы знаходзяцца ў базе дадзеных і змяняюцца праз інтэрфейс вэб-адміністратара падчас працы альбо з дапамогай aihummer settings CLI. Асноўнае правіла простае: ўсё, што можна наладзіць, можна канфігураваць у вэб-інтэрфейсе — не толькі праз env і не закодавана.
Заказ на рашэнне
Кожная налада каталога вырашаецца аднолькава, перамагае першае супадзенне:
- База дадзеных — значэнне, усталяванае праз адміністрацыйны інтэрфейс або
aihummer settings set. - Па змоўчанні — убудаваны па змаўчанні, які пастаўляецца з выпуску.
Асяроддзе спецыяльна не ўваходзіць у гэты ланцужок: для ключоў каталога AIHUMMER_* зменная ў gateway.env з’яўляецца ігнараваны, нават калі настроена. Гэта дае кожнай наладзе дакладна адзін крыніца праўды — базу дадзеных — так што значэнне ў інтэрфейсе ніколі не можа быць ціха замоўчана забытым радком у файле асяроддзя.
[!NOTE] Каб змяніць паводзіны ў вытворчасці, вы не рэдагуеце файлы канфігурацыі — вы змяняеце наладжванне ў адміністрацыйным інтэрфейсеКіраванне → Налады, старонка для пошуку) або запусціць
aihummer settings set <KEY> <VALUE>(get/listчытаць), і гэта патрабуе эфект для гэтай працоўнай прасторы. Сам усталёўшчык усталёўвае пачатковыя значэнні каталогаў у базу даных празaihummer settings set.
Гарачы супраць патрабуе перазапуску
Як змена налады ўплывае на працу залежыць ад клавішы:
| Паводзіны | Прыклады | Калі гэта прымяняецца |
|---|---|---|
| Цёплы | уключэнне інструмента, максімальная глыбіня падагента | Перапрачытаць падчас выканання, перазагрузка не патрэбна |
| Патрабуецца перазагрузка | слухаць адрас, праводка пэўных службаў | Пры ўжыванні пры наступным перазапуску шлюза |
Гарэчыя клавішы счытваюцца ў рэжыме рэальнага часу, таму пераключэнне інструмента або рэгуляванне subagent-depth ўступае ў сілу на наступны ход. Некаторыя структурныя ключы ўступаюць у сілу толькі пасля перазагрузкі; адміністрацыйны інтэрфейс паказвае, які з іх які.
Зменныя Bootstrap застаюцца толькі ў асяроддзі
Некаторыя зменныя павінны быць прысутныя ў асяроддзі, бо яны патрэбныя да таго, як з’явяцца каталог наладаў (і база дадзеных, з якой ён чытаецца). запуск зменныя з’яўляюцца толькі для асяроддзя і не адлюстроўваюцца ў адміністрацыйным інтэрфейсе
| Зменная | Чаму гэта bootstrap |
|---|---|
AIHUMMER_DATABASE_URL |
База дадзеных павінна існаваць перад тым, як можна будзе чытаць любыя налады, якія падтрымліваюцца базай дадзеных. |
AIHUMMER_DB_APP_URL |
Абмежаваная роля DSN, якая актывуе RLS. |
AIHUMMER_MASTER_KEY |
base64-32 байты; разблакоўвае сакрэты, якія захоўваюцца / сховішча / BYOK. |
AIHUMMER_GATEWAY_ADDR |
Публічнае выступленне (па змаўчанні) :8780) — API, парыраванне, WS/SSE, уваходныя і праксі для прыкладання/кашалька. |
AIHUMMER_WEBUI_ADDR |
Адрас праслухоўвання прыватнага адміністрацыйнага вэб-інтэрфейсу (па змоўчанні) :8781), пададзена ў корані /; усталявана 0 адключыць |
AIHUMMER_BLOB_DIR |
Шлях да каталога blob/media — неабходны пры загрузцы. |
AIHUMMER_OIDC_ISSUER |
Абароняе /v1/admin/* да таго, як інтэрфейсу давераць. |
Падключэнні Ops, такія як канец OTLP тэлеметрыі, належаць да той жа катэгорыі bootstrap. Усё, што не ў гэтым кароткім спісе, з’яўляецца ключом каталога: яно захоўваецца ў базе даных, і для яго env ігнаруецца.
[!WARNING] Трымаць
AIHUMMER_MASTER_KEYбяспечна і скапіравана асобна з вашай базы даных рэзервовая копія. Яна дэшыфруе сховішча дадзеных; калі страціць яе, зашыфраваныя сакрэты будуць недаступныя няможна аднавіць.
Файл канфігурацыі
Для ўстаноўкі на роднай сістэме асяроддзе bootstrap знаходзіцца ў адным файле, які загружае адзінка systemd:
~/.aihummer/etc/gateway.envРэдагаваць гэты файл толькі для значэнняў bootstrap, затым перазапусціце сэрвіс шлюза, каб ужыць змены:
# ~/.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/mainsystemctl restart aihummer-gatewayУсё, што выходзіць за межы гэтых ключоў bootstrap — агенты, інструменты, рэжым памяці, стратэгіі разваг, бюджэты, ахоўныя механізмы і астатняе — кіруецца праз налады адміністрацыйнага інтэрфейсу (ці праз aihummer settings), а не з гэтага файла: env ігнаруецца для гэтых ключоў.
Падключэнне неабавязковых магчымасцяў
Шматлікія функцыі адключаны, пакуль вы не накіруеце іх на сэрвіс падтрымкі. Усе гэтыя ключы з’яўляюцца наладамі каталога (яны захоўваюцца ў БД): усталюйце іх у адміністрацыйным інтэрфейсе UI (Кіраванне → Налады) або з дапамогай CLI; размяшчаючы іх у gateway.env нічога не робіць — для іх env ігнаруецца. Для сайдкара, устаноўленага з пакета (STT/TTS і інш.), усталёўшчык сам заносіць значэнні ў базу дадзеных.
# 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
Апавяшчэнні
Інтэрфейс адміністратара Апавяшчэнні старонка (у раздзеле “Кіраванне”) з’яўляецца паштовай скрыняй падзей інстанцыі (уваход адміністратара, даступнае/ўжытае абнаўленне, адключэнне або аднаўленне дадатковага сэрвісу і г.д.) з фільтрамі па катэгорыі, цяжкасці і няпрачытаных паведамленнях. Побач з ёй знаходзіцца матрица катэгорыя × канал дастаўкідля кожнай катэгорыі падзей, якую вы ўключаеце вэбінтэрфейс, электронная пошта, тэлеграма і штурхнуць каналы. Паведамленні Web UI дастаўляюцца лакальна; Telegram звязаны з дапамогай кнопкі “Падключыць Telegram” (глыбокая спасылка), электронная пошта актывуецца пасля праверкі падтрымліваючага адрасу, а push-паведамленні прыходзяць у мабільным дадатку. Крытычныя падзеі нельга адключыць на канале webui.
Куды далей
- Заблакіраваць ўваход адміністратара: Першы ўвод.
- Глядзіце, дзе размешчаны файлы: Устаноўка.
- Праверце папярэднія ўмовы: Патрабаванні.