AiHummer
Кыргызча▾
Кирүү
v1.0.x▾
v1.0.xstable
{ }Swagger
Иштеп баштоо/Конфигурация

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

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

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

Чечилүү тартиби

Каталогдогу ар бир жөндөө бирдей тартипте чечилет, биринчи дал келүү утат:

  1. Маалымат базасы — админ UI же aihummer settings set аркылуу коюлган маани.
  2. Демейки — релиз менен жөнөтүлгөн орнотулган демейки маани.

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

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

Ысык vs кайра иштетүүнү талап кылган

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

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

Ысык ачкычтар жандуу кайра окулат, ошондуктан куралды күйгүзүү/өчүрүү же subagent-depth жөндөө кийинки кезекте күчүнө кирет. Кээ бир структуралык ачкычтар кайра иштеткенден кийин гана күчүнө кирет; админ UI кайсынысы кайсы экенин белгилейт.

Bootstrap өзгөрмөлөрү env-де гана калат

Бир нече өзгөрмө чөйрөдө болушу керек, анткени алар жөндөөлөр каталогу (жана ал окуган маалымат базасы) пайда болгонго чейин керек. Бул bootstrap өзгөрмөлөрү env-де гана болот жана админ UI’де көрсөтүлбөйт:

Өзгөрмө Эмне үчүн ал bootstrap
AIHUMMER_DATABASE_URL DB менен иштеген кандайдыр бир жөндөө окулганга чейин DB болушу керек.
AIHUMMER_DB_APP_URL RLS’ти жандырган чектелген ролдун DSN’и.
AIHUMMER_MASTER_KEY base64-32 байт; secrets-at-rest / vault / BYOK ачат.
AIHUMMER_GATEWAY_ADDR Жалпыга ачык угуу дареги (демейки :8780) — API, жупташтыруу, WS/SSE, кирүүчү жана колдонмо/pocket прокси.
AIHUMMER_WEBUI_ADDR Жеке админ Web UI’дин угуу дареги (демейки :8781), тамырда / берилет; өчүрүү үчүн 0 коюңуз.
AIHUMMER_BLOB_DIR Blob/медиа каталогунун файл системасындагы жолу — жүктөлгөндө керек.
AIHUMMER_OIDC_ISSUER UI ишенимдүү болгонго чейин /v1/admin/* коргойт.

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

[!WARNING] AIHUMMER_MASTER_KEY коопсуз сактаңыз жана аны маалымат базаңыздын камдыгынан өзүнчө камдаңыз. Ал каттоо маалыматтарынын сейфин чечмелейт; аны жоготсоңуз, шифрленген сырларды калыбына келтирүүгө болбойт.

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

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

~/.aihummer/etc/gateway.env

Бул файлды bootstrap маанилери үчүн гана түзөтүңүз, андан кийин өзгөрүүлөрдү колдонуу үчүн шлюз кызматын кайра иштетиңиз:

# ~/.aihummer/etc/gateway.env (үзүндү)
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 жокко чыгарылат.

Кошумча мүмкүнчүлүктөрдү байланыштыруу

Көптөгөн функциялар сиз аларды колдоочу кызматка багыттаганга чейин өчүк болот. Бул ачкычтардын баары каталог жөндөөлөрү (алар DB’де жашайт): аларды админ UI’де (Башкаруу → Жөндөөлөр) же CLI менен коюңуз; аларды gateway.env ичине жазуу эч нерсе кылбайт — алар үчүн env жокко чыгарылат. Бандлдан орнотулган sidecar’лар (STT/TTS ж.б.) үчүн орноткуч маанилерди маалымат базасына өзү себет.

# Чыныгы моделди байланыштыруу (коюлбаса → детерминисттик мактан)
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

# Куралдарды алардын бэкенддерине багыттап иштетүү
aihummer settings set SEARXNG_URL http://localhost:8888
aihummer settings set CLOAKBROWSER_CDP_URL http://localhost:9222

# Үн sidecar'лары (STT/TTS орноткуч тарабынан автоматтык конфигурацияланат)
aihummer settings set AIHUMMER_STT_URL http://localhost:8001
aihummer settings set AIHUMMER_TTS_URL http://localhost:8002

# Чыныгы вектордук дүкөн + эмбеддер (мисал URL'дер; эмбеддер --with-embedder
# менен орнотулат, антпесе эс лексикалык 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’дин («Көзөмөл» тобундагы) «Билдирмелер» барагы — инстанциянын окуялар лентасы (админдин кириши, жеткиликтүү/колдонулган жаңыртуу, sidecar’дын өчүшү же калыбына келиши ж.б.) категория, олуттуулук жана окулбаган боюнча чыпкалары менен. Анын жанында «категория × жеткирүү-каналы» матрицасы турат: ар бир окуя категориясы үчүн webui, email, telegram жана push каналдарын иштетесиз. Web UI билдирмелери жергиликтүү түрдө жеткирилет; Telegram «Telegram’ди байлоо» баскычы (терең шилтеме) менен байланат, email колдоо дареги ырасталгандан кийин активдешет, ал эми push мобилдик колдонмого келет. Критикалык окуяларды webui каналында өчүрүүгө болбойт.

Кийинки кадам