AiHummer
Тоҷикӣ▾
Даромадан
v1.0.x▾
v1.0.xstable
{ }Swagger
Оғози кор/Танзимот

Танзимот

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

AiHummer тавассути каталоги танзимот танзим карда мешавад, на тӯдаи тағйирёбандаҳои муҳит. Ҳар як танзим тартиби муайяни ҳалшавӣ дорад, аксари калидҳоро аз интерфейси веб-маъмурӣ ҳангоми кор тағйир додан мумкин аст, ва танҳо маҷмӯи хурди тағйирёбандаҳои bootstrap бояд дар муҳит бимонанд. Қоидаи роҳнамо содда аст: ҳар чизи танзимшаванда дар Web UI танзим карда мешавад — на танҳо env, ва на дар код сабтшуда.

Тартиби ҳалшавӣ

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

  1. Пойгоҳи додаҳо — арзише, ки тавассути интерфейси маъмурӣ танзим шудааст (барои ҳар як workspace нигоҳ дошта мешавад).
  2. Муҳит — тағйирёбандаи мувофиқи AIHUMMER_*.
  3. Пешфарз — пешфарзи дарунсохт, ки бо релиз меояд.

Ин маънои онро дорад, ки арзиши интерфейси маъмурӣ муҳитро ҳангоми кор бартарӣ медиҳад, ва муҳит пешфарзи дарунсохтро бартарӣ медиҳад. Шумо метавонед заминаи оқилонаро дар муҳит интиқол диҳед ва баъд рафторро аз интерфейс зинда танзим кунед, бе аз нав ҷойгиркунӣ.

[!NOTE] Азбаски қабати пойгоҳи додаҳо болои муҳит ҷой дорад, шумо барои тағйир додани аксари рафтор дар истеҳсолот файлҳои танзимотро таҳрир намекунед — шумо онро дар интерфейси маъмурӣ тағйир медиҳед ва он барои он workspace эътибор пайдо мекунад.

Гарм (Hot) дар муқобили талаботи раз аз нав оғоз

Чӣ тавр як танзими тағйирёфта эътибор пайдо мекунад, аз калид вобаста аст:

Рафтор Намунаҳо Кай татбиқ мешавад
Гарм (Hot) фаъолсозии абзор, чуқурии ҳадди ниҳоии зер-агент Ҳангоми кор аз нав хонда мешавад, бе аз нав оғоз
Талаботи раз аз нав оғоз суроғаи гӯшдиҳӣ, васлкунии хидматҳои муайян Ҳангоми аз нав оғози навбатии gateway татбиқ мешавад

Калидҳои гарм зинда аз нав хонда мешаванд, бинобар ин фаъол/хомӯш кардани абзор ё танзими subagent-depth дар навбати оянда эътибор пайдо мекунад. Баъзе калидҳои сохторӣ танҳо пас аз аз нав оғоз эътибор пайдо мекунанд; интерфейси маъмурӣ нишон медиҳад, ки кадомаш кадом аст.

Тағйирёбандаҳои bootstrap танҳо дар env мемонанд

Чанд тағйирёбанда бояд дар муҳит мавҷуд бошанд, зеро онҳо пеш аз он ки каталоги танзимот (ва пойгоҳи додаҳое, ки аз он мехонад) вуҷуд дошта бошад, лозиманд. Ин тағйирёбандаҳои bootstrap танҳо env мебошанд ва дар интерфейси маъмурӣ намоиш дода намешаванд:

Тағйирёбанда Чаро он bootstrap аст
AIHUMMER_DATABASE_URL DB бояд пеш аз он ки ягон танзими бар DB асосёфта хонда шавад, мавҷуд бошад.
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/*-ро пеш аз он ки ба интерфейс эътимод карда шавад, ҳифз мекунад.

[!WARNING] AIHUMMER_MASTER_KEY-ро бехатар нигоҳ доред ва алоҳида аз нусхаи захиравии пойгоҳи додаҳои худ нусхабардорӣ кунед. Он vault-и эътимоднома (credential vault)-ро рамзкушоӣ мекунад; онро гум кунед ва secrets-и рамзшударо барқарор кардан мумкин нест.

Файли танзимот

Барои насбҳои 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/main
systemctl restart aihummer-gateway

Ҳар чизе берун аз ин калидҳои bootstrap/заминавӣ — агентҳо, абзорҳо, ҳолати хотира, стратегияҳои мулоҳизаронӣ, буҷетҳо, guardrail-ҳо ва ғайра — бояд аз танзимоти интерфейси маъмурӣ идора карда шавад, на аз ин файл.

Васлкунии қобилиятҳои ихтиёрӣ

Бисёр хусусиятҳо то он даме, ки шумо онҳоро ба хидмати такягоҳӣ равона накунед, хомӯш мебошанд. Инҳо одатан як бор дар gateway.env танзим карда мешаванд (ё дар интерфейс дар ҷое ки татбиқшаванда аст, бартарӣ дода мешаванд):

# 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-и ихтиёрӣ.

Огоҳиномаҳо

Саҳифаи «Огоҳиномаҳо»-и интерфейси маъмурӣ (гурӯҳи «Контрол») лентаи воридшавандаи рӯйдодҳои нусха аст (воридшавии маъмур, навсозии дастрас/татбиқшуда, афтидан ва барқароршавии sidecar-ҳо ва ғ.) бо филтрҳо аз рӯи категория, муҳимӣ ва хонданашуда. Дар паҳлӯ — матритсаи категория × канали расонидан: барои ҳар категорияи рӯйдодҳо каналҳои webui, email, telegram ва push фаъол карда мешаванд. Огоҳиномаҳои webui ба таври маҳаллӣ расонида мешаванд; Telegram бо тугмаи «Пайваст кардани Telegram» (deep-link) пайваст мешавад, email пас аз тасдиқи суроғаи дастгирӣ фаъол мешавад, push ба барномаи мобилӣ меояд. Рӯйдодҳои критикиро дар канали webui хомӯш кардан намешавад.

Минбаъд ба куҷо