Муҳити тағйирёбанда
AIHUMMER_PUBLIC_TLS_CERT_FILE + AIHUMMER_PUBLIC_TLS_KEY_FILE: HTTPS-ро худи шлюз бо ҷуфти сертификат/калиди хусусӣ ё проксии баръакс таъмин карда метавонад. Ҷуфти нодуруст бо HTTP-и одӣ иваз намешавад. Пеш аз тасдиқи сертификати хусусӣ дар барнома, изи SHA-256-ро бо терминали боэътимоди насб муқоиса кунед.
Танзимоти AiHummer ба қисмҳо тақсим мешавад ду гурӯҳи пурра мухталиф:
- Bootstrap (
gateway.env) — чизе ки дарвозаро бояд бидонад пеш метавонад донед пойгоҳи додаҳоро: DSN пойгоҳи додаҳо, суроғаҳои гӯш кардани, каталогҳои статикӣ, калиди асосӣ. Танҳо ин килиҳо аз муҳит хонда мешаванд. - Феҳристи танзимот (банақшагирӣ) — ҳар як тугмаи дигар. Инҳоро дар дохили
қайдгирӣ ва танзим дар интерфейси идоракунии веб (Идоракунӣ → Танзимот) ё бо
aihummer settings set <KEY> <VALUE>Барои ин калидҳо аgateway.envарзиш аст бо қабули огоҳона нодида гирифт — ҳатто агар танзим шуда бошад, он дорад бе таъсир.
Намунаи конфигуратсия
gateway.env меўбошад фаъолкунӣ-танҳоФармони қарори:
- Мефтаҳи танзимоти феҳрист:
database value → built-in default(муҳит нодида гирифта мешавад) - калиди оғозёбӣ:
environment variable only.
Бинобар ин, манбаи ягонаи ҳақиқати барои тугмаҳои танзимшаванда базаи додаҳо мебошад (интерфейси идоракунии веб) aihummer settingsМуҳит танҳо он чизеро мебарад, ки раванд барои оғоз кардани он зарур аст.
Файли конфигуратсияи насби соҳиби мизбон дар ҷойи зерин қарор дорад:
# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes
[!TIP] Дастгоҳҳои феҳристи Танзимотро нагузоред
gateway.env— он таъсир намекунад. Тағир онҳоро дар интерфейси идоракунии веб (Management → Settings, он дорои ҷустуҷӯ мебошад) ё тавассутиaihummer settings setБаъзе тағйиротҳо (масалан, гузаришҳои асбоб ва зер-агент) чуқурӣ) гарм истифода баред; дигарон талаб мекунанд, ки хидмат аз нав оғоз шавад.
Bootstrap (gateway.env)
Ягона калидҳое, ки дарвозаро воқеан аз муҳит мехонанд.
Ҳарф ва пойгоҳи дода
| Тағирёбанда | Мақсад |
|---|---|
AIHUMMER_DATABASE_URL |
Лозим. Postgres DSN. Бе он дарвоза танҳо дар режими саломатӣ кор мекунад. |
AIHUMMER_DB_APP_URL |
DSN бо нақши маҳдуд, ки Амнияти сатҳи қаторро фаъол мекунад (барои насбҳои маҳаллӣ ба таври худкор танзим мешавад). |
AIHUMMER_GATEWAY_ADDR |
Панели веб, барномаҳо ва каналҳо як нишонии умумии серверро истифода мебаранд. Нишонии умумии нишон додаи насбкунандаро кушоед; нишонии маҳаллии пешфарз http://localhost:8780/ аст. Порти ҳангоми насб интихобшуда метавонад фарқ кунад. |
AIHUMMER_WEBUI_ADDR |
AIHUMMER_WEBUI_ADDR шунавандаи ёрирасони оператор танҳо дар loopback барои мутобиқати танзими ибтидоӣ аст; пешфарз 127.0.0.1:8781. Ин нишонии алоҳидаи берунии панел нест; 0 беэътибор аст. AIHUMMER_WEBUI_ENABLED=false панелро дар ҳар ду шунаванда хомӯш мекунад. |
AIHUMMER_DEFAULT_WORKSPACE_ID |
Ҳуҷраи корӣ пешфарзро барои ҳамгироӣҳои воридшудаи конфигуратсияшуда интихоб мекунад. |
AIHUMMER_HOME_ROOT |
Рутро насб кунед (одатан аз роҳи бинарӣ гирифта мешавад); директорияҳои admin-ui/blob/installer ва файлҳои калидиро мустаҳкам мекунад. |
AIHUMMER_BLOB_DIR |
Хизматрасонии воситаҳои ахбор/файлро (директорияи захираи блоб) фаъол мекунад. Он инчунин нигоҳ медорад артефактҳои плагини хусусӣ (пардохти паҳншуда) зери blob: манбаъҳое, ки насбкунанда ҳалл мекунад. |
AIHUMMER_ADMIN_UI_DIR |
Панели веб, барномаҳо ва каналҳо як нишонии умумии серверро истифода мебаранд. / |
Рамзҳо ва инфрасохтор
| Тағирёбанда | Мақсад |
|---|---|
AIHUMMER_MASTER_KEY |
base64-кодшуда 32 байт; махфиятҳо дар ҳолати истироҳат, анбор ва BYOK-ро имкон медиҳад. |
AIHUMMER_MEDIA_TOKEN_SECRET |
URLҳои зеркаши дастнависшударо дар тӯли оғозҳои дубора боқӣ мегузорад. |
AIHUMMER_OTEL_ENDPOINT |
Нуқтаи охирини OTLP барои фиристодани изҳо/метрикҳо. |
AIHUMMER_DOWNLOAD_BASE_URL |
URL-и асосӣ барои артефактҳои нашр (манбаи худнавсозӣ). |
[!WARNING] Намояндагӣ Фармони танҳо OTLP. AiHummer ин кор мекунад не пинҳон кардани Прометей
/metricsниҳоӣ ё/debug/pprof. НуқтаAIHUMMER_OTEL_ENDPOINTдар шум ба ҷои он ҷамъкунанда.
Феҳристи танзимот (базаи додаҳо — интерфейси идоракунии веб) aihummer settings)
Ҳар калиди зер дар пойгоҳи додаҳо мавҷуд аст. Онро дар интерфейси идоракунӣ дар веб насб кунед (Идоракунӣ → Танзимот) ё монанди ин:
aihummer settings set AIHUMMER_LLM_PROVIDER openai
А gateway.env нархи чунин калид ин аст нирў накарда шуд.
Амният
| Калид | Мақсад |
|---|---|
AIHUMMER_APPROVAL_TOOLS |
Асбобҳое, ки пеш аз иҷро талаб менамоянд, то шахс тасдиқ кунад. |
AIHUMMER_AIRGAPPED |
1 пайдарҳамии баромади умумиро, ки бо модел назорат мешавад (режими ҷудо аз ҳаво), монеъ мешавад. |
AIHUMMER_AUDIT_RETENTION_DAYS |
Муддати нигоҳдории сабти назорати маъмурӣ. |
AIHUMMER_INBOUND_SECRET |
Маҳфияти муштарак HMAC барои пайвасткунанда → дарвоза /v1/inbound/* занги телефонӣ. |
Санҷиши ҳувият ва ҳамоҳангсозии ягона
| Калид | Мақсад |
|---|---|
AIHUMMER_OIDC_ISSUER |
Ҳифз мекунад /v1/admin/*Бе он (ва беба LDAP/SAML) маъмур ба сарлавҳаҳои dev эътимод мекунад — ҳеҷ гоҳ чунин ҳолатро ошкор накунед. |
LDAP/AD ва SAML ҳамзамон бо OIDC барои воридшавӣ ба ташкилот танзим карда шудаанд; SCIM пешниҳоди корбарро ба таври автоматӣ таъмин мекунад. Нигаред Вебқутбҳо, SCIM ва ҷуфтсозӣ.
LLM ва моделҳо
| Калид | Мақсад |
|---|---|
AIHUMMER_LLM_PROVIDER |
Фурӯшандаи модел барои истифода. |
AIHUMMER_LLM_MODEL |
Номи модел. |
AIHUMMER_LLM_GATEWAY_URL |
URL асосии дарвозаи/нигори LLM, ки бо OpenAI мувофиқ аст AIHUMMER_LLM_* масир; аз маҳаллӣ ҷудо AIHUMMER_OPENAI_BASE_URL). Бубинед BYOK ва таъминкунандагон. |
AIHUMMER_OPENAI_API_KEY |
Калиди API барои провайдери мувофиқи OpenAI. |
AIHUMMER_SUBAGENT_MAX_DEPTH |
Ҳадди зиёди амиқии агенти зерсохташуда. |
[!NOTE] Барои ҷавобҳои корӣ провайдери воқеии моделро пайваст кунед. Калиди пулакии API ҳатмӣ нест: модели маҳаллии бо OpenAI мувофиқ, обунаи дастгиришаванда ё калиди API-и худро истифода бурдан мумкин аст. Агар провайдер танзим нашуда бошад, ин хато пайдо мешавад:
Провайдери модели AI ҳанӯз танзим нашудааст — онро дар бахши «Моделҳо» илова кунед
Асбобҳо
| Калид | Мақсад |
|---|---|
AIHUMMER_FS_ROOT |
Решаи иҷозатшудаи файлҳоро боз ҳам маҳдуд мекунад; қимати холӣ дастрасӣ ба ҳост намедиҳад. |
AIHUMMER_DB_QUERY_DSN |
Имкон медиҳад db_query (танҳо хондан) бар зидди ин DSN. |
AIHUMMER_CODE_EXEC |
code_exec бо нобаёнӣ хомӯш аст |
AIHUMMER_BROWSER_PROFILE_SOCKET |
Роҳ ба сокети хусусии managed-profiles.sock-и хидмати браузер; холӣ — профилҳои доимии computer хомӯшанд. |
AIHUMMER_BROWSER_PROFILE_BINDINGS |
Массиви JSON-и пайвастҳои возеҳи профилҳои доимии браузер (profile_id, tenant_id, user_id, agent_ids, conversation_ids). |
Ҷустуҷӯи веб ва браузер аз ҷониби насбкунанда идора мешаванд: онҳо аз қуттӣ насб мешаванд, бо флагҳои --no-search / --no-browser хомӯш карда мешаванд, ва нусхаи мавҷуда бо флагҳои --external-search=URL / --external-browser=URL пайваст карда мешавад — танзимоти алоҳидаи операторӣ барои онҳо нест.
Бӯсаи пурраро бинед Феҳристи асбобҳо барои он ки ҳар як асбоб чӣ кор мекунад.
Овоз ва сайдқар
| Калид | Мақсад |
|---|---|
AIHUMMER_STT_URL |
URL-и дастгирии нутқ ба матн (аз тарафи насбкунанда пешбинишуда). |
AIHUMMER_TTS_URL |
URL-и паҳлӯи матн ба садо (аз тарафи насбкунанда сохташуда). |
AIHUMMER_VIDEO_URL |
URL-и паҳлӯии фаҳмиши видео. |
AIHUMMER_TTS_AUTO_REPLY |
Кай ҷавоби тайёр садо дода мешавад: off, always, inbound (пешфарз), tagged. |
AIHUMMER_TTS_MAX_CHARS |
Ҳадди матни садододашаванда: 0 — ҷавоби пурра, вагарна 100–10000 аломат. |
AIHUMMER_TTS_SUMMARIZE |
Кӯтоҳ кардани ҷавоби дароз барои садодиҳӣ (аз рӯи пешфарз фаъол). |
Сайдкартҳо хадамоти ҷудогонаи HTTP мебошанд; гузаргоҳ тавассути URL ба онҳо мерасад.
Векторҳо ва ҷойгиркуниҳо
| Калид | Мақсад |
|---|---|
AIHUMMER_QDRANT_URL |
Ҷойгоҳи воқеии векторӣ (Qdrant). Ҳузур надорад → дар хотираи дохилӣ нигоҳ дошта мешавад. |
AIHUMMER_EMBEDDER_URL |
Хизматрасонии воқеии дохилсозӣ. Набудани → дохилсозии хеш. |
Сатҳҳои протокол (ихтиёрӣ)
| Калид | Мақсад |
|---|---|
AIHUMMER_MCP_PUBLISH |
Маҳз 1 сервери берунии MCP-ро дар POST /v1/mcp мекушояд. Худ аз худ ягон абзорро содир намекунад. |
AIHUMMER_MCP_EXPORT_TOOLS |
Номҳои дақиқи абзорҳо бо вергул, ки муштарии MCP мебинад. Холӣ (пешфарз) — СИФР абзор содир мешавад. |
AIHUMMER_A2A_PUBLISH |
1 имконият медиҳад, ки сатҳи A2A/.well-known/agent.json, /a2a/message). |
Танҳо Dev месозад
| Тағирёбанда | Мақсад |
|---|---|
AIHUMMER_PLUGIN_PUBKEY |
Як калиди ҷамъиятии иловагӣ, боэътимод (base64 ed25519) барои тасдиқи имзоҳои плагин. Танҳо барои сохтани Dev — дар сохторҳои нашршуда нодида гирифта шудааст (калиди режистри ба файли биноӣ часпонида шудааст). |
AIHUMMER_PLUGIN_DEV_UNSIGNED |
1 имкон медиҳад насб кардан дисавторӣшуда плагинҳо. Фақат барои сохтани Dev — дар сохтани нашршуда нодида гирифта шудааст. Ҳеҷ гоҳ дар як намунаи берун аз дастрасӣ нест. |
[!WARNING] Дар нашри баровардашуда решаи эътимоди плагин чунин аст дар бинарӣ ҳалқадоршуда ва инро на муҳит ва на танзимот метавонад тағйир диҳад — ин як системаи зидди дасткорӣ аст капалат
Намунаи эътимод (расмӣ → калиди часпондашуда, хусусӣ → анбори эътимод, бимиёндошта → баста) тавсиф шудааст дар Насб ва навсозӣ.
Баъд ба куҷо
- Бубинед ки ҳар калид кадом воситаҳоро мекушояд: Феҳристи асбобҳо.
- Инстансро рӯзмарра идора кунед: Маълумоти CLI.