Тағйирёбандаҳои муҳит
AiHummer тавассути тағйирёбандаҳои муҳити AIHUMMER_* (ба ҳамроҳи якчанд
тағйирёбандаҳои хоси асбоб ба монанди SEARXNG_URL) танзим мешавад. Ин саҳифа
каталог аст, ки аз рӯи соҳа гурӯҳбандӣ шудааст. Аксари тағйирёбандаҳо инчунин аз
веб-админ UI таҳриршаванда мебошанд.
Модели танзим
Ҳар танзим бо тартиби собит ҳал мешавад:
database value → environment variable → built-in defaultИн маънои онро дорад, ки қимати дар админ UI захирашуда (дар пойгоҳи маълумот
нигоҳдошташуда) аз муҳит болотар аст, ки он аз пешфарзи дарунсохт болотар аст.
Тағйирёбандаҳои бутстрап — онҳое, ки gateway пеш аз он ки пойгоҳи маълумотро
хонда тавонад ниёз дорад, ба монанди AIHUMMER_DATABASE_URL ва
AIHUMMER_MASTER_KEY — танҳо дар муҳит боқӣ мемонанд.
Файли танзим барои насби host-native дар ин ҷо ҷойгир аст:
# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes[!TIP] Тугмаҳои танзимшаванда ва ғайри-бутстрап беҳтараш дар веб-админ UI тағйир дода шаванд, то онҳо бидуни таҳрири файлҳо амал кунанд. Баъзе тағйирот (ба монанди хомӯш/фурӯзонкунии асбоб ва умқи зерагент) гарм татбиқ мешаванд; дигарон бозоғозии хидматро талаб мекунанд.
Ядро ва пойгоҳи маълумот
| Тағйирёбанда | Мақсад |
|---|---|
AIHUMMER_DATABASE_URL |
Ҳатмӣ. DSN-и Postgres. Бидуни он gateway дар реҷаи танҳо-саломатӣ кор мекунад. |
AIHUMMER_DB_APP_URL |
DSN-и нақши маҳдуд, ки Row-Level Security-ро фаъол мекунад (барои насбҳои маҳаллӣ худкорона таъин мешавад). |
AIHUMMER_GATEWAY_ADDR |
Суроғаи гӯшкунӣ (пешфарз :8780; насбкунанда порти озодро интихоб мекунад). |
AIHUMMER_DEFAULT_WORKSPACE_ID |
Диспетчери воридшаванда ва воркспейси пешфарзи виҷетро фаъол мекунад. |
AIHUMMER_BLOB_DIR |
Хидмати медиа/файлро фаъол мекунад (директорияи нигоҳдории blob). |
AIHUMMER_ADMIN_UI_DIR |
SPA-и админро дар /admin/ хидмат мекунад. |
AIHUMMER_WIDGET_DIR |
Виҷети вебро дар /widget/ хидмат мекунад. |
Амният ва хазина (vault)
| Тағйирёбанда | Мақсад |
|---|---|
AIHUMMER_MASTER_KEY |
32 байти бо base64 рамзшуда; сирҳо-дар-ҳолати-оромӣ, vault ва BYOK-ро фаъол мекунад. |
AIHUMMER_MEDIA_TOKEN_SECRET |
URL-ҳои зеркашии имзошударо дар тӯли бозоғозӣ боэътибор нигоҳ медорад. |
AIHUMMER_APPROVAL_TOOLS |
Асбобҳое, ки пеш аз иҷро тасдиқи инсонро (human-in-the-loop) талаб мекунанд. |
AIHUMMER_AIRGAPPED |
1 хуруҷи оммавии аз модел контролшавандаро мебандад (реҷаи air-gapped). |
AIHUMMER_AUDIT_RETENTION_DAYS |
Тирезаи нигоҳдорӣ барои логи аудити админ. |
Аутентификатсия ва SSO
| Тағйирёбанда | Мақсад |
|---|---|
AIHUMMER_OIDC_ISSUER |
/v1/admin/*-ро муҳофизат мекунад. Бидуни он (ва бидуни LDAP/SAML) админ ба сарварақҳои dev эътимод мекунад — ҳеҷ гоҳ чунин инстансаро ошкор накунед. |
LDAP/AD ва SAML дар паҳлӯи OIDC барои воридшавии корхонавӣ танзим мешаванд; SCIM таъминоти худкори корбарро фароҳам меорад. Нигаред ба Webhooks, SCIM ва ҷуфткунӣ.
Каналҳо ва воридшаванда
| Тағйирёбанда | Мақсад |
|---|---|
AIHUMMER_INBOUND_SECRET |
Сири муштараки HMAC барои зангҳои коннектор → gateway /v1/inbound/*. |
AIHUMMER_INBOUND_URL |
Тарафи коннектор: URL-и воридшавандаи gateway, ки коннектор ба он мефиристад. |
LLM ва моделҳо
| Тағйирёбанда | Мақсад |
|---|---|
AIHUMMER_LLM_PROVIDER |
Таъминкунандаи модел барои истифода. |
AIHUMMER_LLM_MODEL |
Номи модел. |
AIHUMMER_LLM_GATEWAY_URL |
Нуқтаи ниҳоӣ барои gateway-и LLM-и бо OpenAI мутобиқ. |
AIHUMMER_OPENAI_API_KEY |
Калиди API барои таъминкунандаи бо OpenAI мутобиқ. |
AIHUMMER_SUBAGENT_MAX_DEPTH |
Умқи ҳадди аксари зерагентҳои тавлидшуда. |
[!NOTE] Агар ҳеҷ модел васл нашуда бошад, gateway ба як mock-и детерминистӣ бармегардад, то система ҳамчунон кор кунад. Ҳеҷ API-и модели пулакӣ ҳеҷ гоҳ талаб карда намешавад — моделҳои ройгон/маҳаллӣ ва нақли Codex/ChatGPT-аз-обуна дараҷаи якум мебошанд.
Асбобҳо
| Тағйирёбанда | Мақсад |
|---|---|
SEARXNG_URL |
Асбоби web_search-ро фаъол мекунад (URL-и инстансаи SearXNG). |
CLOAKBROWSER_CDP_URL |
Асбобҳои browser/computer-ро фаъол мекунад (URL-и Chrome DevTools Protocol). |
AIHUMMER_FS_ROOT |
filesystem_read-ро фаъол мекунад, дар зери ин root изолятсияшуда. |
AIHUMMER_DB_QUERY_DSN |
db_query (танҳо-хониш)-ро бар зидди ин DSN фаъол мекунад. |
AIHUMMER_CODE_EXEC |
Асбоби code_exec-ро фурӯзон/хомӯш мекунад (бо нобаёнӣ дар мизбонҳои муштарак хомӯш). |
Барои он ки ҳар асбоб чӣ кор мекунад, нигаред ба Каталоги асбобҳо.
Овоз ва сайдкарҳо
| Тағйирёбанда | Мақсад |
|---|---|
AIHUMMER_STT_URL |
URL-и сайдкари нутқ-ба-матн (аз ҷониби насбкунанда худкор таъин мешавад). |
AIHUMMER_TTS_URL |
URL-и сайдкари матн-ба-нутқ (аз ҷониби насбкунанда худкор таъин мешавад). |
AIHUMMER_DIARIZE_URL |
URL-и сайдкари диаризатсияи гӯянда. |
AIHUMMER_VOICECLONE_URL |
URL-и сайдкари клонкунии овоз. |
AIHUMMER_VIDEO_URL |
URL-и сайдкари фаҳмиши видео. |
Сайдкарҳо хидматҳои HTTP-и алоҳида мебошанд; gateway ба онҳо тавассути URL мерасад.
Векторҳо ва эмбеддингҳо
| Тағйирёбанда | Мақсад |
|---|---|
AIHUMMER_QDRANT_URL |
Захираи воқеии вектор (Qdrant). Набошад → захираи дар-хотира. |
AIHUMMER_EMBEDDER_URL |
Хидмати воқеии эмбеддер. Набошад → эмбеддери hash. |
Шина ва мушоҳидапазирӣ
| Тағйирёбанда | Мақсад |
|---|---|
AIHUMMER_NATS_URL |
Шинаи ихтиёрии NATS барои расонидан. |
AIHUMMER_OTEL_ENDPOINT |
Нуқтаи ниҳоии OTLP барои фиристодани trace/метрикаҳо. |
[!WARNING] Мушоҳидапазирӣ танҳо OTLP push аст. AiHummer нуқтаи ниҳоии Prometheus
/metricsё/debug/pprof-ро ошкор намекунад. Ба ҷои онAIHUMMER_OTEL_ENDPOINT-ро ба коллектори худ нишон диҳед.
Навсозиҳо
| Тағйирёбанда | Мақсад |
|---|---|
AIHUMMER_DOWNLOAD_BASE_URL |
URL-и асосӣ барои артефактҳои релиз (манбаи худнавсозӣ). |
AIHUMMER_UPDATE_CHANNEL |
Канали релиз барои пайгирӣ. |
AIHUMMER_AUTO_UPDATE |
Реҷаи навсозӣ: off, check ё apply. |
Каналҳои насби бо калид маҳдудшуда (alfa/beta/dev) илова бар ин дар вақти насб
AIHUMMER_CHANNEL_KEY / AIHUMMER_RELEASE_TOKEN-ро мехонанд.
Бозор ва плагинҳо
| Тағйирёбанда | Мақсад |
|---|---|
AIHUMMER_BLOB_DIR |
Директорияи захираи blob. Ба ғайр аз медиа/файлҳо, он артефактҳои плагини хусусӣ (side-load-шуда)-ро дар зери реф-ҳои blob: нигоҳ медорад, ки деплойер ҳал мекунад. |
AIHUMMER_PLUGIN_PUBKEY |
Калиди оммавии иловагии боэътимод (base64 ed25519) барои тасдиқи имзоҳои плагин — илова бар калиди registry, ки дар core пин шудааст. |
AIHUMMER_PLUGIN_DEV_UNSIGNED |
1 насби плагинҳои имзонашуда-ро иҷозат медиҳад. Танҳо барои таҳияи маҳаллӣ — ҳеҷ гоҳ дар инстансаи аз берун дастрас. |
Модели эътимод (расмӣ → калиди пиншуда, хусусӣ → захираи эътимод, имзонашуда → басташуда) дар Насб ва навсозиҳо тавсиф шудааст.
Сатҳҳои протокол (opt-in)
| Тағйирёбанда | Мақсад |
|---|---|
AIHUMMER_MCP_PUBLISH |
1 сервери берунии MCP-ро дар POST /v1/mcp фаъол мекунад. |
AIHUMMER_A2A_PUBLISH |
1 сатҳи A2A-ро (/.well-known/agent.json, /a2a/message) фаъол мекунад. |
Минбаъд ба куҷо
- Бинед, ки ҳар тағйирёбанда кадом асбобҳоро мекушояд: Каталоги асбобҳо.
- Инстансаро рӯзмарра идора кунед: Маълумотномаи CLI.