AiHummer
Тоҷикӣ▾
ВоридшавӣКабинети шахсӣ
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Оғози кор/Танзимот

Танзимот

v1.0.x · навсозӣ шуд 2026-07-07

AiHummer тавассути як… танзим карда шудааст каталоги танзимот, на як қатор тағйирёбандаҳои муҳити атроф. gateway.env меўбошад фаъолкунӣ-танҳо: DSN-и пойгоҳи додаҳо, нишони гӯшкунӣ/портҳо, калиди асосӣ ва монанди инҳо. Ҳар калиди дигар дар пойгоҳи додаҳо қарор дорад ва аз интерфейси идоракунии веб дар вақти иҷро ё бо aihummer settings CLI. Қоидаи роҳнамое оддӣ аст: Ҳама чизҳои танзимшаванда дар Web UI конфигуратсияшавандаанд — на танҳо барои муҳити корӣ, ва на сахткодшуда.

Фармони қарори ҳалкунанда

Ҳар як танзими каталог тавассути ҳамон роҳ ҳал карда мешавад, аввалин мутобиқат ғолиб мешавад:

  1. Пойгоҳи додаҳо — арзише, ки тавассути интерфейси идоракунанда муқаррар шудааст ё aihummer settings set.
  2. Пешфарз — режими пешфарз, ки бо нашрият ҳамроҳ шудааст.

Муҳит боқасдона ҷузъи ин занҷир нест: барои калидҳои каталог AIHUMMER_* мутаносиб дар gateway.env меўбошад нирў накарда шуд, ҳатто агар муқаррар шуда бошад. Ин ба ҳар танзим танҳо як манбаи ҳақиқат — пойгоҳи дода — медиҳад, то ки қимати интерфейси корбар ҳеҷ гоҳ аз ҷониби як сатр дар файл 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 база64-32 байт; сиррҳоро ҳифзшуда мекушояд / анбор / BYOK.
AIHUMMER_GATEWAY_ADDR Суханронии оммавӣ гӯш кунед (пешфарз) :8780) — API, ҷуфтсозӣ, WS/SSE, воридшавӣ ва прокси/барномаи Pocket.
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

Ин файлро таҳрир кунед танҳо барои арзишҳои бутстрап, сипас барои татбиқи тағйирот хидмати дарвоза (gateway) - ро аз нав оғоз кунед:

# ~/.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), на аз ин файл: муҳит барои он калидҳо нодида гирифта мешавад.

Имкониятҳои ихтиёрии симкашӣ

Бисёре аз хусусиятҳо ғайрифаъоланд то он даме ки шумо онҳоро ба хидмати пуштибонӣ нишон диҳед. Ҳамаи ин калидҳо танзимоти каталогӣ мебошанд (онҳо дар пойгоҳи додаҳо зиндагӣ мекунанд): онҳоро дар Интерфейси идоракунӣ танзим кунед.Идоракунӣ → Танзимот) ё бо истифода аз 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 бо тугмаи “Link Telegram” (пайвандҳои амудӣ) пайваст мешавад, почта пас аз тасдиқи суроғаи дастгирӣ фаъол мегардад ва огоҳӣ дар барномаи мобилӣ мерасад. Ҳодисаҳои муҳимро нельзя фурӯ нишон диҳем дар канали webui.

Баъд ба куҷо