Конфигурация — AiHummer Документация

AiHummer аркылуу конфигурацияланган жооптор каталог, айлана-чөйрө өзгөрмөлөрүнүн чогулушу эмес. gateway.env болот тоголоктон түзөк гана: маалымат базасынын DSN, уга турган даректер/порттор, мастер ачкыч жана ошондой. Калган бардык ачкычтар маалымат базасында сакталат жана веб-админ UI аркылуу иштөө учурунда же менен өзгөртүлөт aihummer settings CLI. Негизги жол көрсөтмө жөнөкөй: веб интерфейсинде баардык параметрлер жөнгө салынуусу мүмкүн — болгону чөйрөгө гана тиешелүү эмес, жана катуу коддолгон эмес.

Чечим чыгаруунун тартиби

Ар бир каталог настройкасы бирдей жол менен чечилет, биринчи дал келген жеңет:

Маалымат базасы — админ интерфейси аркылуу белгиленген баа же aihummer settings set.
Баштапкы — чыгарылыш менен кошулган орнотулган стандарттуу.

Чөйрө бул чынжырдын бөлүгү болбоого атайын: каталог ачкычтары үчүн AIHUMMER_* өзгөрмө ичинде gateway.env болот назарына албаган, болбосо да белгиленген. Бул ар бир орнотууга так бир чындык булагын берет — маалымат базасы — андыктан UI мааниси эч качан унутулган env файлынын саптары менен жашырылып калбайт.

[!NOTE] Өнүмдүүлүктөгү жүрүм-турумду өзгөртүү үчүн конфигурация файлдарын өзгөртпөйсүз — сиз өзгөртөсүз админ UIдагы жөндөөлөр (Башкаруу → Багыттоолор, издөөгө боло турган баракча) же иштетүү aihummer settings set <KEY> <VALUE> (get / list окуу үчүн), жана бул талап кылат бул жумушчу мейкиндигине таасир тийгизет. Орнотуучу өзү баштапкы каталог баалуулуктарын таратат маалыматтар базасына аркылуу aihummer settings set.

Ысык vs кайра жүктөөнү талап кылат

Өзгөртүлгөн параметрдин күчүнө кириши процесс ачкычка жараша болот:

Мүнөз	Мисалдар	Качан ал колдонулат
Ысык	куралды колдонууга берүү, суб-агенттин максималдуу тереңдиги	Жүктөө учурунда кайра окуу, кайра баштоо жок
Кайра жүктөө талап кылынат	даректи угуу, айрым кызматтарды туташтыруу	Кийинки шлюз кайра жүктөлгөндө колдонулат

Ысык баскычтар түз эле кайра окуулат, андыктан куралды күйгүзүү же жөндөө subagent-depth кийинки айлануундан баштап күчүнө кирет. Айрым структуралык ачкычтар кайра жүктөөдөн кийин гана күчүнө кирет; администрациялык колдонуучу интерфейси кайсысы экенин белгилейт.

Bootstrap өзгөрмөлөрү менен чектелет

Айрым айнымалылар орчиндо болушу керек, анткени алар орнотуулар каталогунан (жана ал окур база маалыматынан) мурун керек болот. Булар бутстрэп айнымалылар болчо чөйрөгө гана тиешелүү болуп, башкаруу интерфейсинде көрүнбөйт:

Өзгөрмө	Эмне үчүн бул bootstrap
`AIHUMMER_DATABASE_URL`	Эч кандай DB-негизделген орнотууну окуп баштоодон мурун DB бар болушу керек.
`AIHUMMER_DB_APP_URL`	RLSти иштетүүчү чектелген роль DSG.
`AIHUMMER_MASTER_KEY`	base64-32 байт; сакталган сырларды ачууга мүмкүнчүлүк берет / кампада / BYOK.
`AIHUMMER_GATEWAY_ADDR`	Жарандарга угузуучу дарек (демейки) `:8780`) — API, жууп туташтыруусу, WS/SSE, кирүүчү жана тиркеме/кулакча прокси.
`AIHUMMER_WEBUI_ADDR`	Жеке админ Веб UI угуу дареги (демейки) `:8781`), тамырда берилген `/`; орнотуу `0` өчүрүү үчүн.
`AIHUMMER_BLOB_DIR`	Blob/медиа каталогунун файл системасынын жолу — процесс башталганда керек.
`AIHUMMER_OIDC_ISSUER`	Коргойт `/v1/admin/*` пайдалануу интерфейси ишенимдүү деп эсептелүүдөн мурун.

Телеметрия OTLP учтуу сыяктуу Ops кабелдөө ошол эле bootstrap категориясына кирет. Бул кыска тизмеде жок болгон бардык нерсе каталог ачкычы: ал маалымат базасында жашайт, жана env ага карата эске алынбайт.

[!WARNING] Сактоо AIHUMMER_MASTER_KEY коопсуз жана сакталган айрым-айрым сенин маалымат базаңдан кўлда нуска. Бул агуулук капчыгын декрипттейт; аны жоготкула жана шифрленген сырлар кайра алынбайт.

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

Хост-мамлекеттик орнотуулар үчүн bootstrap чөйрөсү systemd бирдиги жүктөгөн бир гана файлда жашайт:

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

Бул bootstrap ачкычтарынан тышкары бардык нерселер — агенттер, куралдар, эс тутум режими, себеп-натыйжа стратегиялары, бюджеттер, коргоо чектер жана өзгөлөр — админ UIнын жөндөөлөрүнөн башкарылат (же аркылуу 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 менен.

Билдирүүлөр

Админ UIнын Билдирүүлөр Баракча («Башкаруу» астында) бул мисалынын окуялар жәшиги (администратор кирүүсү, жаңыртуу жеткиликтүү/колдонулган, сайдкар жабылып же восстановление болуп жаткан жана башка) категория, оорлугу жана окулган/окулбаган боюнча фильтрлер менен. Андан шыга жанында турат категория × жеткирүү-канал матрицасы: сиз ишенимдүүлүк кылган ар бир окуя категориясы үчүн вебинтерфейс, электрондук почта, телеграм жана кылт каналдар. Веб UI билдирүүлөрү жергиликтүү түрдө жеткиликтүү; Telegram «Telegramду туташтыр» баскычы менен байланышкан (терең шилтеме), электрондук почта колдоо дареги текшерилгенден кийин иштей баштайт, жана push мобилдик колдонмого келет. Веб UI каналында критикалык окуяларды үнсүз кылууга мүмкүн эмес.

Келерки кайда

Башкаруучу кирүүнү аныктоо: Биринчи кирүү.
Файлдар кайда сакталарын караңыз: Орнотуу.
Алдын ала талаптарды текшериңиз: Талаптар.