Маълумотнома/Маълумотнома оид ба танзимот
Маълумотнома оид ба танзимот
v1.2.x · навсозӣ шуд 2026-08-06
Дар ин ҷо ҳамаи танзимоте оварда шудаанд, ки оператор дар сервери AiHummer тағйир дода метавонад. Саҳифа аз каталоги худи маҳсулот сохта мешавад, бинобар ин ба сервери шумо мувофиқ аст.
Қимат дар веб-интерфейс ё бо фармони aihummer settings set KEY VALUE дода мешавад (Сатри фармон). Сутуни қимати пешфарз он чизеро нишон медиҳад, ки сервер то додани қимати шумо истифода мебарад.
[!NOTE]
Қиматҳои махфӣ дар ин ҷо чоп намешаванд, калидҳои хизматии таъминкунанда бошанд, тамоман оварда намешаванд — маҳсулот онҳоро аз ҳамаи рӯйхатҳо пинҳон мекунад. Тире қимати холӣ ё шарҳеро мефаҳмонад, ки танҳо дар веб-интерфейс нишон дода мешавад.
API
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_PERSONAL_API_KEYS |
Калидҳои шахсии API барои API-и мутобиқ бо OpenAI |
bool |
1 |
\“off\” аутентификатсияро бо калидҳои шахсӣ дар эндпоинти мувофиқи OpenAI хомӯш мекунад. Ҳар қимати дигар = фаъол. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
Agent
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_APPROVAL_TOOLS |
Абзорҳое, ки тасдиқ талаб мекунанд |
text |
— |
— |
AIHUMMER_SUBAGENT_MAX_DEPTH |
Умқи ниҳоии зер-агентҳо |
int |
2 |
— |
AIHUMMER_SUBAGENT_TIMEOUT_SEC |
Вақти интизории зер-агент (сония) |
int |
180 |
Вақти ҳадди аксари як иҷрои зерагент, бо сония. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_TOOL_SEARCH |
Боркунии танбали абзорҳо (tool_search) |
bool |
false |
Танҳо абзорҳои асосӣ ва мета-абзори ҷустуҷӯро нишон додан, боқимондаро бо дархост ошкор кардан. Ҳангоми зиёд будани абзорҳо навбатҳоро тезтар ва арзонтар мекунад, бо хатари хурди он ки модел абзори камистифодаро нодида монад. |
AIHUMMER_TOOL_SEARCH_CORE |
Боркунии танбал: абзорҳои ҳамеша фаъол |
text |
— |
Номҳои абзорҳо бо вергул, ки ҳатто дар реҷаи танбал дарҳол нишон дода мешаванд. |
AIHUMMER_TOOL_SEARCH_THRESHOLD |
Боркунии танбал: ҳадди ақали абзорҳо барои ба таъхир андохтан |
int |
12 |
Танҳо вақте ба таъхир гузоред, ки пас аз филтри профили агент аз ин шумора зиёдтар абзор монад. |
Agent · Reasoning
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_AGENT_BEST_OF_N |
Намунаҳои best-of-N (0/1=хомӯш, ≥2=фаъол) |
int |
0 |
≥2 N номзад сэмпл мекунад ва довар беҳтаринро интихоб мекунад. Арзиши он N× генератсия аст. |
AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT |
Баҳс: промпти довар (бознависӣ) |
text |
— |
Промпти довари мубоҳисаро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_AGENT_DEBATE_N |
Андозаи панели баҳс (0/1=хомӯш, ≥2=фаъол) |
int |
0 |
≥2 панели мубоҳисаи N номзад + доварро оғоз мекунад. Арзиши он N× генератсия аст. |
AIHUMMER_AGENT_DEBATE_PROMPT |
Баҳс: промпти номзад (бознависӣ) |
text |
— |
Промпти номзади мубоҳисаро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_AGENT_DEBATE_ROUNDS |
Баҳс: даврҳо |
int |
1 |
Шумораи даврҳои мубоҳисаи панели номзадҳо. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_AGENT_JUDGE_PROMPT |
Промпти довари best-of-N (бознависӣ) |
text |
— |
Промпти довари best-of-N-ро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_AGENT_PLAN_PROMPT |
Промпти нақшакаш (бознависӣ) |
text |
— |
Промпти нақшакашро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_AGENT_PLAN_STEPS |
Нақшакаш-иҷрокунанда: ҳадди ниҳоии қадамҳои нақша (0=хомӯш) |
int |
0 |
⟩0 гузариши алоҳидаи нақшакаш→иҷрокунанда→синтезро оғоз мекунад (барои вазифаҳои мураккаби бисёрқадама муфид). 0 = хомӯш. Одатан 4–8. |
AIHUMMER_AGENT_PLAN_STEP_ITERS |
Нақшакаш: такрори абзорҳо дар ҳар қадам (0=пешфарз) |
int |
0 |
Шумораи такрори даъвати абзорҳоро дар ҳар қадами нақша маҳдуд мекунад. 0 = қимати дарунсохти пешфарз (4). |
AIHUMMER_AGENT_REFLECT |
Гузариши худтанқидӣ |
bool |
0 |
Пеш аз ҷавоби ниҳоӣ гузариши таҳлил/худтанқидиро илова мекунад. |
AIHUMMER_AGENT_REFLECT_PROMPT |
Промпти рефлексия (бознависӣ) |
text |
— |
Промпти худтанқидиро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_AGENT_SELF_HEAL |
Худбарқароршавӣ: такрор ҳангоми хатогиҳои абзорҳо (0=хомӯш) |
int |
0 |
⟩0 даъватҳои нобарори абзорҳоро бо ишораи ислоҳкунанда то ҳамин ҳад такрор мекунад. |
Agent · System prompt
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_LOCALE |
Локали пешфарз |
text |
ru-RU |
Забон/локали пешфарзи ҷавоб, мас. ru-RU. Дастурҳои персона/оператор афзалият доранд. |
AIHUMMER_TIMEZONE |
Минтақаи вақт |
text |
UTC |
Минтақаи вақти IANA барои дохил кардани сана, мас. Europe/Moscow. Пешфарз UTC. |
Channels
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_CONFIDENTIAL_PERSONA |
Персонаи махфии веб |
bool |
0 |
Ҳангоми фаъол будан агенти веб-чат маълумоти персона/шахсияти худро ошкор ва нигоҳ намедорад ва танҳо аз рӯи вазифа ҷавоб медиҳад — барои ҷойгиркуниҳои веби беном ё ба махфият ҳассос. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_INBOUND_REQUIRE_BINDING |
Танҳо ба корбарони бақайдгирифташуда ҷавоб додан |
text |
true |
true = бот ҳар фиристандаро дар канал, ки корбари сабтшудаи AiHummer НЕСТ (корбар бо пайванди нақш), нодида мегирад — аъзои тасодуфии чат ва даъватҳои меҳмон ҷавоб намегиранд. false (пешфарз) = ба ҳама ҷавоб додан. |
Integrations
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_A2A_PUBLISH |
Нашри агент тавассути Agent2Agent (A2A) |
bool |
0 |
Агентро ҳамчун сервери A2A нашр кунед (Agent Card + POST /a2a/message). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_MCP_EXPORT_TOOLS |
— |
text |
— |
— |
AIHUMMER_MCP_PUBLISH |
Нашри абзорҳо тавассути MCP |
bool |
0 |
Абзорҳоро ҳамчун сервери MCP дар POST /v1/mcp нашр кунед. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
Knowledge connectors
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_KB_SYNC_INTERVAL |
Фосилаи азнавҳамоҳангсозии банақшагирифташудаи коннекторҳо (0/холӣ = хомӯш) |
text |
— |
Мӯҳлат (мас. 6h, 30m) барои аз нав синхронкунии худкори фонии ҳамаи коннекторҳои дониши танзимшуда дар ҳамаи фазоҳои корӣ. Холӣ/0 = хомӯш. Синхронкунии такрорӣ идемпотентӣ аст (иваз аз рӯи source, бе такрор). slack_export дохил намешавад (zip-и он дастӣ бор карда мешавад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
LLM
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_CASCADE_MIN_CHARS |
Каскад: ҳадди ақали аломатҳо барои эскалатсия |
int |
0 |
Ҳадди дарозии дархост (аломатҳо), ки аз он модели қавитари каскад фаъол мешавад. 0 = пешфарз. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_CASCADE_STRONG_MODEL |
Каскад: модели захиравии қавитар |
text |
— |
Модел, ки барои дархостҳои дароз/мураккаб каскадӣ истифода мешавад (холӣ = хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_CODEX_BASE_URL |
URL-и базавии Codex |
text |
— |
Базаи транспорти Codex (обунаи ChatGPT). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_CODEX_MAX_OUTPUT_TOKENS |
Ҳадди ниҳоии токенҳои баромад (0 = бе маҳдудият) |
int |
0 |
Маҳдудияти max_output_tokens барои як навбати чат. 0 = бе маҳдудият. Дар моделҳои reasoning токенҳои мулоҳиза низ ба ҳамин буҷет ҳисоб мешаванд, бинобар ин қимати хеле хурд ҷавоби холии «incomplete: max_output_tokens» медиҳад. Дарҳол татбиқ мешавад (бе бозоғозӣ). |
AIHUMMER_CODEX_MODEL |
Идентификатори модел (транспорти Codex / gpt-5.5) |
text |
gpt-5.5 |
Идентификатори модели транспорти асосии Codex/ChatGPT (мас. gpt-5.5, gpt-5.5-codex). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_CODEX_REASONING_EFFORT |
Умқи мулоҳизаронӣ |
enum: none \| low \| medium \| high \| xhigh |
low |
Умқи мулоҳизаи модел барои навбатҳои чат, вақте параметрҳои агент онро таъин намекунанд. Қиматҳои дурусти gpt-5.5: none, low, medium, high, xhigh (НЕ minimal — gpt-5.5 онро бо HTTP 400 рад мекунад). Баландтар = сифати беҳтар, вале сусттар/гаронтар. Қимати нодуруст бехатар ба low табдил меёбад. Дарҳол татбиқ мешавад (бе бозоғозӣ). |
AIHUMMER_LLM_CALL_TIMEOUT_S |
Вақти интизории як даъват (сония) |
int |
120 |
Буҷети вақт барои ЯК даъвати модел (зидди дармондагӣ: gpt-5.5 метавонад беохир «фикр» кунад ва навбатро кушода нигоҳ дорад). Пас аз ба охир расидани мӯҳлат даъват бо хатогии ErrCallTimeout бе такрор қатъ мешавад. 0 = бе маҳдудият. Дарҳол татбиқ мешавад (бе бозоғозӣ). |
AIHUMMER_LLM_GATEWAY_URL |
URL-и дарвозаи LLM |
text |
— |
URL-и базавии эндпоинти модели мувофиқи OpenAI, ки агент ба он муроҷиат мекунад (сервери маҳаллии llama.cpp/vLLM/Ollama ё шлюзи ҷойгиршуда). Холӣ монед — эндпоинти пешфарзи провайдер истифода мешавад. |
AIHUMMER_LLM_MODEL |
Модели LLM |
text |
— |
Ном/идентификатори модел, ки дар ҳар навбат ба провайдер фиристода мешавад (модели эндпоинти шумо). Бояд бо моделе, ки эндпоинт воқеан пешниҳод мекунад, мувофиқ бошад. |
AIHUMMER_LLM_PROVIDER |
Провайдери LLM |
text |
— |
Кадом бэкенди модел истифода шавад (эндпоинти мувофиқи OpenAI ё транспорти Codex/обунаи ChatGPT). Муайян мекунад, ки дархостҳо чӣ тавр фиристода ва аутентификатсия мешаванд. |
AIHUMMER_LLM_RETRIES |
Такрори LLM ҳангоми хатогии муваққатӣ |
int |
3 |
Шумораи такрори дархост ба LLM ҳангоми хатогии муваққатӣ. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_LLM_TEMPERATURE |
Ҳарорат |
text |
— |
Ҳарорати сэмплкунӣ (0..2), вақте параметрҳои агент онро таъин намекунанд. Холӣ = нафиристодан. ДИҚҚАТ: моделҳои мулоҳизакори gpt-5.5 (Codex) temperature-ро рад мекунанд — барои онҳо майдонро холӣ монед; онро танҳо ҳангоми истифодаи бэкенди ғайримулоҳизавӣ таъин кунед. Дарҳол татбиқ мешавад (бе бозоғозӣ). |
AIHUMMER_LLM_TOP_P |
Top-p (nucleus-намунагирӣ) |
text |
— |
Ҳадди сэмплкунии nucleus (0..1), вақте параметрҳои агент онро таъин намекунанд. Холӣ = нафиристодан. Мисли temperature, gpt-5.5 reasoning онро рад мекунад — танҳо барои бэкендҳои ғайримулоҳизавӣ таъин кунед. Дарҳол татбиқ мешавад (бе бозоғозӣ). |
AIHUMMER_OPENAI_API |
Услуби API-и OpenAI (chat | responses) |
enum: \| chat \| responses |
— |
chat = /chat/completions, responses = /responses. Холӣ = худкор/пешфарз. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_OPENAI_API_KEY |
Калиди API-и OpenAI-и нативӣ (пешфарз барои насб) |
text |
— |
Калиди аккаунти OpenAI-и шумо барои сикли нативии OpenAI (агар OpenAI-ро ҳамчун провайдери пешфарз истифода баред). Бо BYOK-и фазои корӣ дар саҳифаи «Моделҳо» омехта накунед. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_OPENAI_BASE_URL |
URL-и базавии OpenAI-и нативӣ |
text |
— |
Базаи API-и мувофиқи OpenAI (мас. https://api.openai.com/v1). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_OPENAI_MODEL |
Модели OpenAI-и нативӣ |
text |
— |
Модел барои сикли нативии OpenAI (агар AIHUMMER_OPENAI_API_KEY таъин шуда бошад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_ROUTER_COMPLEX_MODEL |
Роутер: модел барои дархостҳои мураккаб |
text |
— |
Модел барои дархостҳои мураккаб (холӣ = ин гурӯҳ хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_ROUTER_SIMPLE_MODEL |
Роутер: модел барои дархостҳои содда |
text |
— |
Модел барои дархостҳои содда (холӣ = ин гурӯҳ хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_ROUTER_STANDARD_MODEL |
Роутер: модел барои дархостҳои муқаррарӣ |
text |
— |
Модел барои дархостҳои муқаррарӣ (холӣ = ин гурӯҳ хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_DEEPGRAM_API_KEY |
Калиди API-и Deepgram |
text |
— |
API-калиди Deepgram (муҳаррики STT = deepgram). Аз ин ҷо ё аз AIHUMMER_STT_API_KEY гирифта мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_DEEPGRAM_MODEL |
Модели Deepgram |
text |
nova-2 |
Модели Deepgram (мас. nova-2, nova-3, base). Аз дастрасии лоиҳа барои ҳамин калид вобаста аст. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_DEEPGRAM_URL |
URL-и базавии Deepgram |
text |
— |
Базаи Deepgram API. Холӣ = https://api.deepgram.com. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_IMAGE_BASE_URL |
URL-и базавии API-и тасвирҳо (захиравии OpenAI) |
text |
— |
Базаи /images API ҳангоми кор тавассути калиди OpenAI (холӣ = https://api.openai.com/v1). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_IMAGE_MODEL |
Модели тавлиди тасвир |
text |
— |
Модел барои image_generate (пешфарз gpt-image-2). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_MEDIA_MAX_UPLOAD_MB |
Ҳаҷми ниҳоии боркунии медиа (МБ) |
int |
256 |
Ҳаҷми ҳадди аксари як боркунии медиа (PUT /v1/media/{id}/content), бо мегабайт. Навиштанро ба диск тавассути порти ҷамъиятӣ маҳдуд мекунад (ҳифз аз саршавӣ). Пешфарз 256. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_STT_API_KEY |
Калиди API-и STT (ихтиёрӣ) |
text |
— |
Bearer-и ихтиёрӣ, агар сайдкари STT онро талаб кунад (install.sh метавонад онро созад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_STT_CODEX_URL |
URL-и муҳаррики STT барои Codex |
text |
— |
Базаи /v1/audio/transcriptions-и мувофиқи OpenAI барои муҳаррики codex (табдили нутқ ба матн тавассути обунаи ChatGPT). Холӣ = базаи Codex. Bearer аз AIHUMMER_STT_API_KEY ё AIHUMMER_CODEX_ACCESS_TOKEN гирифта мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_STT_ENGINE |
Муҳаррики STT |
enum: faster-whisper \| deepgram \| off |
faster-whisper |
Муҳаррики шинохти нутқ. faster-whisper = сайдкари ройгони маҳаллӣ (пешфарз, аз қуттӣ насб мешавад, URL = AIHUMMER_STT_URL, бе бор ба API-ҳои беруна). deepgram = Deepgram-и абрӣ (тез, калиди AIHUMMER_DEEPGRAM_API_KEY, пулакӣ бо ҳудуди ройгон). off = шинохт хомӯш. (Обунаи Codex/ChatGPT табдили аудиоро ба матн дастгирӣ НАМЕКУНАД.) Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_STT_LANGUAGE |
Забони STT |
text |
— |
Забони шинохт (BCP-47, мас. ru/en). Аз ҷониби муҳаррики deepgram истифода мешавад (модели nova-2). Холӣ = муайянкунии худкор/пешфарзи муҳаррик. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_STT_MODEL |
Модели STT |
text |
Systran/faster-whisper-small |
Модели faster-whisper (мас. small/medium/large-v3 ё Systran/faster-whisper-⟨size⟩). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_STT_URL |
URL-и табдили нутқ ба матн (faster-whisper) |
text |
— |
URL-и сайдкари маҳаллии faster-whisper (мувофиқи OpenAI /v1/audio/transcriptions). Холӣ = пешфарзи худкори http://127.0.0.1:8001, ки install.sh худаш менависад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_TTS_API_KEY |
Калиди API-и TTS (edge-tts) |
text |
— |
Bearer байни шлюз ва сайдкари edge-tts (install.sh онро худкор месозад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_TTS_ENABLED |
Синтези нутқ фаъол аст |
bool |
1 |
Синтези нутқро фаъол мекунад (абзори tts + реҷаи овозӣ). Сайдкари edge-tts аз қуттӣ насб мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_TTS_MODEL |
Модели TTS |
text |
— |
Номи модел барои хидмати edge-tts. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_TTS_URL |
URL-и синтези нутқ (edge-tts) |
text |
— |
URL-и сайдкари маҳаллии edge-tts (мувофиқи OpenAI /v1/audio/speech). Холӣ = пешфарзи худкори http://127.0.0.1:8002, ки install.sh худаш менависад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_TTS_VOICE |
Овози TTS (пешфарз de-DE-FlorianMultilingualNeural) |
text |
de-DE-FlorianMultilingualNeural |
Овози пешфарзи edge-tts (бисёрзабона, аз ҷумла русӣ). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_VIDEO_API_KEY |
Калиди API-и таҳлили видео |
text |
— |
Калиди дастрасӣ ба сайдкари таҳлили видео (агар лозим бошад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_VIDEO_URL |
URL-и таҳлили видео (ffmpeg) |
text |
— |
URL-и сайдкари таҳлили видео. Холӣ = хомӯш. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_VOICE_AEC |
Бартарафсозии акс-садо (AEC) |
bool |
1 |
Талаб кардани echoCancellation ҳангоми сабт (WebRTC). Акси садои TTS-ро дар микрофон бартараф мекунад (Moltis #1129). |
AIHUMMER_VOICE_AGC |
Танзими худкори баландӣ |
bool |
1 |
— |
AIHUMMER_VOICE_BARGEIN_FRAMES |
Кадрҳо барои қатъ кардан (barge-in) |
int |
5 |
Чанд кадри пайдарпайи овоздор (≈20мс) пахши садои ботро қатъ мекунад. |
AIHUMMER_VOICE_DUPLEX |
Овози зиндаи пурраи дуҷониба |
bool |
0 |
Реҷаи зиндаи пурраи дутарафаро фаъол мекунад (стриминг + VAD + barge-in). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_VOICE_NOISE_SUPPRESSION |
Пахши садоҳои изофӣ |
bool |
1 |
— |
AIHUMMER_VOICE_VAD_THRESHOLD |
Ҳадди энергияи VAD (0..1) |
text |
0.02 |
Ҳадди энергияи нутқ барои гейтинги VAD ҳангоми сабт; пасттар = ҳассостар. |
Memory
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_EMBEDDER_DIM |
Андозаи вектори эмбеддер |
int |
768 |
Ченаки вектор — бояд бо модел мувофиқ бошад (multilingual-e5-base=768, bge-m3=1024). |
AIHUMMER_EMBEDDER_KEEPALIVE |
Keep-alive-и эмбеддер |
text |
5m |
keep_alive барои эмбеддери Ollama (танҳо ҳангоми AIHUMMER_MEMORY_RETRIEVAL=embedding). Пешфарз 5m — модели бекор аз хотира бароварда мешавад ва раннери бекормондаи ollama худаш тоза мешавад. -1 (абадӣ нигоҳ доштан) ТАВСИЯ НАМЕШАВАД: аз сабаби хатогии ollama раннери бандшуда метавонад рӯзҳо як ядрои CPU-ро банд кунад. Оғози сард пас аз бекорӣ бо гармкунӣ ҳангоми оғози шлюз ҷуброн мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_EMBEDDER_MODEL |
Модели эмбеддер |
text |
yxchia/multilingual-e5-base |
Модели эмбеддинги Ollama. Пешфарз multilingual-e5-base — бисёрзабона (аз ҷумла русӣ), 768-ченака, сабук ва тез дар CPU (~1-2с ба ҳар эмбеддинг). Префиксҳои query/passage барои e5 худкор татбиқ мешаванд. Барои сифати ҳадди аксар дар GPU bge-m3-ро истифода баред (DIM=1024 таъин кунед). Бояд бо AIHUMMER_EMBEDDER_DIM мувофиқ бошад. |
AIHUMMER_EMBEDDER_PASSAGE_PREFIX |
Префикси ҳуҷҷати эмбеддер |
text |
— |
Префикси ҳуҷҷати нигоҳдошташавандаро бознависӣ кунед (моделҳои e5 худкор \“passage: \”-ро истифода мебаранд). Барои муайянкунии худкор аз рӯи номи модел холӣ монед. |
AIHUMMER_EMBEDDER_QUERY_PREFIX |
Префикси дархости эмбеддер |
text |
— |
Префикси дархости ҷустуҷӯро бознависӣ кунед (моделҳои e5 худкор \“query: \”-ро истифода мебаранд). Барои муайянкунии худкор аз рӯи номи модел холӣ монед. |
AIHUMMER_EMBEDDER_URL |
URL-и эмбеддер (мутобиқ бо Ollama) |
text |
— |
Эмбеддингҳои воқеии семантикӣ. Насбкунанда сайдкари Ollama-ро ҷойгир мекунад ва инро худкор таъин мекунад; ТАЪИН НАШУДА = эмбеддери hash (танҳо лексикӣ, ёдоварии заиф). |
AIHUMMER_MEMORY_CAPTURE |
Реҷаи сабти хотира |
enum: auto \| review \| off |
auto |
auto = худкор дар хотир гирифтан ва ба ёд овардан; review = ҳамчун номзадҳое, ки тасдиқи дастӣ мехоҳанд, нигоҳ доштан; off = бе сабт. |
AIHUMMER_MEMORY_CONTEXT_TIMEOUT |
Вақти интизории боркунии хотира |
text |
3s |
Ҳадди интизорӣ барои боркунии хотира дар оғози ҷавоб (эмбеддинги дархост + ҷустуҷӯ). Агар эмбеддер бор бошад ва ба мӯҳлат нарасад, ҷавоб БЕ блоки хотира давом мекунад ва овезон намемонад. Формати Go duration (мас. 2s, 1500ms). 0 = бе маҳдудият. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_MEMORY_DREAM_INTERVAL |
Фосилаи гузариши «хоб» |
string |
1h |
Чанд вақт як бор гузариши худнигаҳдорандаи dream даъвоҳои санҷидашударо дар ҳамаи доираҳо барои зиддият месанҷад (Go duration, мас. 30m/1h/6h). 0 = хомӯш кардан. |
AIHUMMER_MEMORY_EXTRACT |
Истихроҷи фактҳо тавассути LLM |
bool |
1 |
Ба ҷои нигоҳ доштани порчаҳои хоми ҷумла, далелҳои муназзами субъект/предикат/объектро тавассути LLM ҷудо кардан (пешфарз ФАЪОЛ) — барои кори механизмҳои граф/зиддият/dream зарур аст. Ба ҳар паёми сабтшуда як даъвати LLM илова мекунад; барои сарфаи он хомӯш кунед. |
AIHUMMER_MEMORY_RETRIEVAL |
Реҷаи бозёбии хотира |
enum: fulltext \| embedding |
fulltext |
Хотира чӣ тавр ҷустуҷӯ мешавад. fulltext (пешфарз) = ҷустуҷӯи пурраматнии Postgres аз рӯи матни далелҳо — БЕ модели эмбеддер, бе сайдкар, бе бори CPU (мисли einstein-и кӯҳна дар AiHummer). embedding = ҷустуҷӯи семантикии векторӣ тавассути эмбеддер (AIHUMMER_EMBEDDER_URL/ollama) — аз рӯи маъно дақиқтар, вале CPU-ро бор мекунад ва сайдкар талаб мекунад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_MEMORY_TOKEN |
Токени хидматии хотираи дурдаст |
text |
— |
Токени хидматӣ барои авторизатсия дар Einstein Retrieval API (ҳамчун Authorization: Bearer … фиристода мешавад). Танҳо ҳангоми таъин будани AIHUMMER_MEMORY_URL лозим аст. Холӣ = бе авторизатсия (танҳо барои насбҳои dev бо авторизатсияи retrieval хомӯш). |
AIHUMMER_MEMORY_URL |
URL-и хотираи дурдаст (плагини Einstein) |
text |
— |
URL-и плагини мустақили хотираи Einstein (қарордоди aihummer.memory.v1, мас. http://127.0.0.1:8820). ХОЛӢ (пешфарз) = модули дарунсохти хотираи Go. Ҳангоми таъин будан боркунии контексти навбат тавассути HTTP ба /context + /retrieval-и плагин меравад; ҳангоми хато/дастнорасӣ мулоим ба модули дарунсохт бармегардад (бе фурӯпошӣ). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_QDRANT_API_KEY |
Калиди API-и Qdrant |
text |
— |
— |
AIHUMMER_QDRANT_URL |
URL-и Qdrant (анбори доимии векторӣ) |
text |
— |
ТАЪИН НАШУДА = анбор дар хотира (векторҳо ҳангоми бозоғозӣ ГУМ мешаванд). Барои нигоҳдории боэътимод дар муҳити корӣ таъин кунед. |
AIHUMMER_RERANKER_URL |
URL-и сайдкари азнавтартиббандии RAG |
text |
— |
HTTP-URL-и сайдкари кросс-энкодер барои аз нав рутбабандии ҷустуҷӯи гибридӣ. Холӣ = аз нав рутбабандӣ хомӯш. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
Moderation
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_MODERATION |
Модератсияи воридот |
bool |
1 |
\“off\” ҳифзи дарунсохтро аз jailbreak/prompt-injection хомӯш мекунад. Ҳар қимати дигар = фаъол. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_MODERATION_REFUSAL |
Паёми радкунии модератсия |
text |
— |
Матни рад, ки ҳангоми басташавии дархост аз ҷониби модератор бармегардад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
Public access
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_PUBLIC_URL |
URL-и оммавии дарвоза (Web UI + мизоҷон) |
text |
— |
Ин хостро → ба порти шлюз прокси кунед (AIHUMMER_GATEWAY_ADDR, пешфарз :8780). Аз ҷониби Web UI ва мизоҷони iOS/веб истифода мешавад. |
POCKET_AGENT_GATEWAY_BASE_URL |
URL-и оммавии дарвозаи pocket-agent |
text |
— |
→ ба порти шлюзи pocket-agent прокси кунед (POCKET_AGENT_PORT, пешфарз 8080). Агенти дурдаст тавассути тикети яквақта ба ин ҷо пайваст мешавад. |
TELEGRAM_PUBLIC_URL |
URL-и оммавии вебхуки Telegram |
text |
— |
Танҳо барои реҷаи webhook — → ба порти telegram-connector прокси кунед (AIHUMMER_TELEGRAM_CONNECTOR_PORT, пешфарз 8091). Барои реҷаи polling холӣ монед (URL-и ҷамъиятӣ лозим нест). |
SSO (LDAP/AD)
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_LDAP_BASE_DN |
DN-и базавии ҷустуҷӯи корбарон |
text |
— |
Search root, e.g. OU=Users,DC=corp,DC=example. |
AIHUMMER_LDAP_BIND_DN |
DN-и хидматӣ барои пайвастшавӣ |
text |
— |
Ҳисоб барои bind-и ҷустуҷӯи ибтидоӣ, мас. CN=svc-aihummer,OU=Service,DC=corp,DC=example. Холӣ = ҷустуҷӯи беном. |
AIHUMMER_LDAP_DEFAULT_ROLE |
LDAP: Нақши пешфарз (мутобиқати гурӯҳ нест) |
text |
— |
Нақше, ки ҳангоми ба ягон маппинг мувофиқ наомадани гурӯҳ дода мешавад. Холӣ = бе нақш. |
AIHUMMER_LDAP_ENABLED |
Фаъол кардани вуруд тавассути LDAP/AD |
bool |
0 |
Ҳангоми фаъол будан вуруди администраторон ба каталог рӯй меорад. Пароли bind дар Secrets нигоҳ дошта мешавад (доираи ldap, номи bind_password). |
AIHUMMER_LDAP_GROUP_ATTR |
Атрибути гурӯҳ (пешфарз memberOf) |
text |
— |
Атрибути сабти корбар, ки DN-ҳои гурӯҳҳоро номбар мекунад. Холӣ маппинги гурӯҳ→нақшро хомӯш мекунад. |
AIHUMMER_LDAP_ROLE_MAPPINGS |
LDAP: Мутобиқати гурӯҳ→нақш (JSON) |
text |
— |
Объекти JSON аз DN-и гурӯҳ (ё танҳо CN) → нақш, мас. {\“CN=Admins,OU=Groups,DC=corp,DC=example\”:\“admin\”,\“Operators\”:\“operator\”}. |
AIHUMMER_LDAP_SKIP_TLS_VERIFY |
Гузаштан аз санҷиши TLS (танҳо барои лаборатория, 1/0) |
bool |
0 |
Санҷиши сертификати каталогро хомӯш мекунад. Ҳеҷ гоҳ дар муҳити корӣ фаъол накунед. |
AIHUMMER_LDAP_URL |
URL-и каталог |
text |
— |
e.g. ldaps://ad.corp.example:636 (TLS) or ldap://dc1.corp.example:389. |
AIHUMMER_LDAP_USER_ATTR |
Атрибути вуруд (пешфарз sAMAccountName) |
text |
— |
Атрибути LDAP/Active Directory, ки бо логини воридкардаи корбар муқоиса мешавад (пешфарз sAMAccountName; uid барои OpenLDAP, userPrincipalName барои вуруди навъи UPN). |
AIHUMMER_LDAP_USER_FILTER |
Филтри ҷустуҷӯи корбарон |
text |
— |
Бояд барои логин %s дошта бошад. AD: (sAMAccountName=%s); OpenLDAP: (uid=%s). |
SSO (OIDC)
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_OIDC_AUDIENCE |
Audience-и OIDC |
text |
— |
Claim-и интизории aud — audience-и ҲАМИН ресурсро таъин кунед, то токенҳои барои тарафи дигар барорида радд шаванд. Claim-и aud акнун ба таври пешфарз дар ҳар токен ҲАТМӢ аст (токени бе aud рад мешавад); ҳангоми таъин будани ин, aud бояд онро низ дошта бошад. Дар муҳити корӣ сахт тавсия мешавад. |
AIHUMMER_OIDC_ISSUER |
URL-и нашркунандаи OIDC |
text |
— |
Барорандаи IdP (мас. https://login.example.com). Ҳангоми таъин будан аутентификатсияи OIDC JWT-ро фаъол мекунад. |
AIHUMMER_OIDC_JWKS_URL |
URL-и JWKS-и OIDC |
text |
— |
Эндпоинти JSON Web Key Set барои санҷиши имзои токенҳо. |
AIHUMMER_OIDC_TENANT_CLAIM |
Claim-и фазои корӣ дар OIDC |
text |
— |
Claim-и JWT, ки идентификатори фазои кориро дорад (мас. tenant_id / org). |
SSO (SAML)
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_SAML_DEFAULT_ROLE |
SAML: Нақши пешфарз (мутобиқати гурӯҳ нест) |
text |
— |
Нақше, ки ҳангоми ба ҳеҷ маппинг мувофиқ наомадани қимати тасдиқшуда дода мешавад. Холӣ = бе нақш. |
AIHUMMER_SAML_ENABLED |
Фаъол кардани SSO-и SAML 2.0 |
bool |
0 |
/saml/metadata, /saml/acs, /saml/login-ро мекушояд. Калиди хусусии SP дар Secrets нигоҳ дошта мешавад (доираи saml, номи sp_key). |
AIHUMMER_SAML_ENTITY_ID |
Entity ID-и SP |
text |
— |
Entity ID-и провайдери хидмат (агар холӣ бошад, пешфарз ⟨root⟩/saml/metadata). |
AIHUMMER_SAML_IDP_METADATA |
XML-и метаиттилооти IdP |
text |
— |
Ҳуҷҷати метамаълумоти SAML-и IdP-и худро гузоред (Okta/Azure AD/ADFS). |
AIHUMMER_SAML_ROLE_ATTRIBUTE |
Атрибути нақш/гурӯҳ (пешфарз groups) |
text |
— |
Атрибути assertion, ки қиматҳои гурӯҳ/нақшро дорад. |
AIHUMMER_SAML_ROLE_MAPPINGS |
SAML: Мутобиқати гурӯҳ→нақш (JSON) |
text |
— |
Объекти JSON аз қимати тасдиқшуда → нақш, мас. {\“AdminGroup\”:\“admin\”,\“Ops\”:\“operator\”}. |
AIHUMMER_SAML_ROOT_URL |
URL-и решагии SP |
text |
— |
URL-и базавии аз берун дастраси ин шлюз, мас. https://app.example.com. ACS = ⟨root⟩/saml/acs. |
AIHUMMER_SAML_SP_CERT |
Сертификати SP (PEM) |
text |
— |
Сертификати ҷамъиятии имзои SP (PEM). Калиди хусусии мувофиқ дар Secrets ҷойгир мешавад (доираи saml, номи sp_key). |
Security
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_AIRGAPPED |
Реҷаи ҷудошуда (air-gapped, 1/0) |
bool |
0 |
Баромади бо модел идорашавандаро ба интернети ҷамъиятӣ манъ мекунад (танҳо хостҳои дохилӣ/рӯйхати иҷозатдодашуда). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_AUDIT_RETENTION_DAYS |
Нигоҳдории аудит-лог (рӯз, 0=ҳамеша) |
int |
0 |
Чанд рӯз нигоҳ доштани лоҷи аудит; сабтҳои кӯҳнатар ҳар рӯз нест мешаванд. 0/холӣ = абадӣ нигоҳ доштан. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_CODE_EXEC_ALLOW_HOST |
Иҷозати code_exec дар хост (БЕ песочка) |
bool |
0 |
⚠️ Иҷозат додани иҷрои код бевосита дар хост бе муҳити ҷудокардашуда. Танҳо барои homelab-и боэътимод. Бехатартар аст, ки AIHUMMER_CODE_EXEC_SANDBOX_IMAGE таъин карда шавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_CORS_ORIGINS |
Origin-ҳои иҷозатдодашуда барои CORS (бо вергул) |
text |
— |
Рӯйхати Origin-ҳои иҷозатдодашуда бо вергул. Холӣ = CORS иҷозат дода намешавад (танҳо same-origin). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_CSP |
Сарлавҳаи Content-Security-Policy (бознависӣ) |
text |
— |
Сарлавҳаи CSP-ро бознависӣ мекунад. Холӣ = пешфарзи бехатар. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_INBOUND_SECRET |
Сирри муштараки коннектор → дарвоза |
text |
— |
Сирри умумӣ, ки гузариши коннектор→шлюзро аутентификатсия мекунад (бояд бо қимати тарафи коннектор мувофиқ бошад). Холӣ = эндпоинти вурудӣ БЕ аутентификатсия аст. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_OPENAI_COMPAT_KEY |
Вуруди мутобиқ бо OpenAI: калиди статикии API |
text |
— |
Калиди статикӣ, ки бо он мизоҷони мувофиқи OpenAI дар эндпоинти дарунсохти /v1-и шлюз аутентификатсия мешаванд (P8 home gateway). Холӣ = аутентификатсияи статикӣ хомӯш (калидҳои шахсӣ боқӣ мемонанд). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_OPENAI_COMPAT_WORKSPACE |
Вуруди мутобиқ бо OpenAI: ID-и фазои корӣ |
text |
— |
ID-и фазои корӣ, ки аутентификатсияи статикии мувофиқи OpenAI ба он маппинг мешавад. Холӣ = AIHUMMER_DEFAULT_WORKSPACE_ID. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_REQUIRE_2FA |
Талаб кардани 2FA барои операторон |
bool |
0 |
Барои операторон талаб кардани омили дуюм (TOTP/passkey). Ҳангоми фаъол будан ба операторони бе 2FA ҳангоми вуруд дарҳол пешниҳод мешавад, ки онро танзим кунанд (бе басташавӣ, то соҳиб дар берун намонад). Дарҳол татбиқ мешавад. |
AIHUMMER_REQUIRE_SECURE |
Танҳо пайвастҳои ҳифзшуда (HTTPS/WSS) қабул кардан |
bool |
0 |
Ҳангоми фаъол будан дархостҳои оддии HTTP ба HTTPS равона (барои GET/HEAD) ё рад (403) мешаванд; дастрасӣ аз localhost ҳамеша иҷозат аст, то оператор дар берун намонад. X-Forwarded-Proto-ро аз прокси-и баръакси хотимадиҳандаи TLS ба назар мегирад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_TRUSTED_PROXIES |
CIDR-ҳои боэътимоди прокси-и баръакс (бо вергул) |
text |
— |
Рӯйхати шабакаҳои боэътимоди прокси-и баръакс бо вергул (CIDR, мас. 10.0.0.0/8,192.168.0.0/16, ё IP-ҳои алоҳида). Танҳо барои дархостҳое, ки АЗ ин суроғаҳо меоянд, сарлавҳаи X-Forwarded-For барои муайян кардани IP-и мизоҷ истифода мешавад (аудит, рӯйхати иҷозати IP, ҳифз аз интихоби зӯроваронаи парол). Холӣ = танҳо ба суроғаи воқеии peer бовар кардан (XFF нодида гирифта мешавад, ҷаълкунии IP имконнопазир). Дарҳол татбиқ мешавад. |
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_CODE_EXEC |
Фаъол кардани code_exec |
bool |
0 |
— |
AIHUMMER_CODE_EXEC_INTERPRETERS |
Интерпретаторҳои code-exec (JSON) |
text |
— |
Объекти JSON {language: path_to_binary}, мас. {\“python\”:\“/usr/bin/python3\”}. Холӣ = муайянкунии худкор. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_CODE_EXEC_SANDBOX_IMAGE |
Тасвири песочкаи code-exec |
text |
— |
Образи контейнер барои ҷудокунии code_exec (бе шабака, rootfs танҳо барои хондан, маҳдудиятҳо). Холӣ = иҷро дар худи хост (муҳити боэътимод). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
AIHUMMER_DB_QUERY_DSN |
DSN барои db_query (нақши бо ҳуқуқи ҳадди ақал, на соҳиб — дархостҳо бо маҳдудияти RLS аз рӯи фазои кории фаъол иҷро мешаванд) |
text |
— |
— |
AIHUMMER_FS_ROOT |
Решаи абзори системаи файлӣ |
text |
— |
— |
AIHUMMER_HTTP_ALLOWLIST |
Рӯйхати суроғаҳои иҷозатдодашудаи http_request |
text |
— |
— |
AIHUMMER_HTTP_AUTH_JSON |
Авторизатсияи http_request (JSON) |
text |
— |
— |
AIHUMMER_MCP_SERVERS |
Серверҳои MCP (JSON) |
text |
— |
— |
AIHUMMER_WEBFETCH_ALLOWLIST |
Рӯйхати суроғаҳои иҷозатдодашудаи web_fetch |
text |
— |
— |
Web UI (separate port)
| Калид |
Ном |
Навъ |
Пешфарз |
Чӣ мекунад |
AIHUMMER_WEBUI_API_BASE |
URL-и базавии API, ки Web UI муроҷиат мекунад |
text |
— |
Origin-и мутлақ (мас. https://api.example.com), ки SPA-и алоҳида ҷойгиршуда барои даъватҳои /v1/admin/* ба он муроҷиат мекунад. Холӣ = баргашт ба URL-и ҷамъиятии шлюз, сипас ба суроғаи маҳаллии шлюз. Бояд аз браузери администратор дастрас бошад; API бояд origin-и ин Web UI-ро тавассути CORS иҷозат диҳад (дар поён худкор илова мешавад). |
AIHUMMER_WEBUI_ENABLED |
Пешниҳоди Web UI-и админ дар порти хусусии он |
bool |
1 |
Ба таври пешфарз фаъол: SPA-и админ дар РЕШАи шунавандаи алоҳида (AIHUMMER_WEBUI_ADDR) дода мешавад, ки онро ба интерфейси танҳо дохилӣ пайваст кардан мумкин аст. Порти асосии шлюз API + pairing + WS + SSE-ро нигоҳ медорад ва /admin/-ро НАМЕДИҲАД. Барои пурра хомӯш кардани шунавандаи Web UI 0 таъин кунед. |
AIHUMMER_WEBUI_ORIGIN |
Origin-и браузери Web UI (CORS) |
text |
— |
Origin-и браузерии Web UI (мас. https://admin.example.com), ки худкор бо маълумоти дастрасӣ ба рӯйхати иҷозати CORS-и API илова мешавад. Холӣ = аз AIHUMMER_WEBUI_ADDR бароварда мешавад (http://host:port). Инро вақте таъин кунед, ки браузер ба Web UI тавассути прокси/номи хосте меояд, ки аз суроғаи пайвастшавӣ фарқ мекунад. |
Танзимоти барои оператор дастрас: 138.
Дар ин ҷо ҳамаи танзимоте оварда шудаанд, ки оператор дар сервери AiHummer тағйир дода метавонад. Саҳифа аз каталоги худи маҳсулот сохта мешавад, бинобар ин ба сервери шумо мувофиқ аст.
Қимат дар веб-интерфейс ё бо фармони `aihummer settings set KEY VALUE` дода мешавад ([Сатри фармон](/tg/v1.0/reference/cli)). Сутуни қимати пешфарз он чизеро нишон медиҳад, ки сервер то додани қимати шумо истифода мебарад.
> [!NOTE]
> Қиматҳои махфӣ дар ин ҷо чоп намешаванд, калидҳои хизматии таъминкунанда бошанд, тамоман оварда намешаванд — маҳсулот онҳоро аз ҳамаи рӯйхатҳо пинҳон мекунад. Тире қимати холӣ ё шарҳеро мефаҳмонад, ки танҳо дар веб-интерфейс нишон дода мешавад.
## API
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_PERSONAL_API_KEYS` | Калидҳои шахсии API барои API-и мутобиқ бо OpenAI | bool | `1` | \\"off\\" аутентификатсияро бо калидҳои шахсӣ дар эндпоинти мувофиқи OpenAI хомӯш мекунад. Ҳар қимати дигар = фаъол. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
## Agent
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_APPROVAL_TOOLS` | Абзорҳое, ки тасдиқ талаб мекунанд | text | — | — |
| `AIHUMMER_SUBAGENT_MAX_DEPTH` | Умқи ниҳоии зер-агентҳо | int | `2` | — |
| `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | Вақти интизории зер-агент (сония) | int | `180` | Вақти ҳадди аксари як иҷрои зерагент, бо сония. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_TOOL_SEARCH` | Боркунии танбали абзорҳо (tool_search) | bool | `false` | Танҳо абзорҳои асосӣ ва мета-абзори ҷустуҷӯро нишон додан, боқимондаро бо дархост ошкор кардан. Ҳангоми зиёд будани абзорҳо навбатҳоро тезтар ва арзонтар мекунад, бо хатари хурди он ки модел абзори камистифодаро нодида монад. |
| `AIHUMMER_TOOL_SEARCH_CORE` | Боркунии танбал: абзорҳои ҳамеша фаъол | text | — | Номҳои абзорҳо бо вергул, ки ҳатто дар реҷаи танбал дарҳол нишон дода мешаванд. |
| `AIHUMMER_TOOL_SEARCH_THRESHOLD` | Боркунии танбал: ҳадди ақали абзорҳо барои ба таъхир андохтан | int | `12` | Танҳо вақте ба таъхир гузоред, ки пас аз филтри профили агент аз ин шумора зиёдтар абзор монад. |
## Agent · Reasoning
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_AGENT_BEST_OF_N` | Намунаҳои best-of-N (0/1=хомӯш, ≥2=фаъол) | int | `0` | ≥2 N номзад сэмпл мекунад ва довар беҳтаринро интихоб мекунад. Арзиши он N× генератсия аст. |
| `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | Баҳс: промпти довар (бознависӣ) | text | — | Промпти довари мубоҳисаро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_AGENT_DEBATE_N` | Андозаи панели баҳс (0/1=хомӯш, ≥2=фаъол) | int | `0` | ≥2 панели мубоҳисаи N номзад + доварро оғоз мекунад. Арзиши он N× генератсия аст. |
| `AIHUMMER_AGENT_DEBATE_PROMPT` | Баҳс: промпти номзад (бознависӣ) | text | — | Промпти номзади мубоҳисаро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_AGENT_DEBATE_ROUNDS` | Баҳс: даврҳо | int | `1` | Шумораи даврҳои мубоҳисаи панели номзадҳо. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_AGENT_JUDGE_PROMPT` | Промпти довари best-of-N (бознависӣ) | text | — | Промпти довари best-of-N-ро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_AGENT_PLAN_PROMPT` | Промпти нақшакаш (бознависӣ) | text | — | Промпти нақшакашро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_AGENT_PLAN_STEPS` | Нақшакаш-иҷрокунанда: ҳадди ниҳоии қадамҳои нақша (0=хомӯш) | int | `0` | ⟩0 гузариши алоҳидаи нақшакаш→иҷрокунанда→синтезро оғоз мекунад (барои вазифаҳои мураккаби бисёрқадама муфид). 0 = хомӯш. Одатан 4–8. |
| `AIHUMMER_AGENT_PLAN_STEP_ITERS` | Нақшакаш: такрори абзорҳо дар ҳар қадам (0=пешфарз) | int | `0` | Шумораи такрори даъвати абзорҳоро дар ҳар қадами нақша маҳдуд мекунад. 0 = қимати дарунсохти пешфарз (4). |
| `AIHUMMER_AGENT_REFLECT` | Гузариши худтанқидӣ | bool | `0` | Пеш аз ҷавоби ниҳоӣ гузариши таҳлил/худтанқидиро илова мекунад. |
| `AIHUMMER_AGENT_REFLECT_PROMPT` | Промпти рефлексия (бознависӣ) | text | — | Промпти худтанқидиро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_AGENT_SELF_HEAL` | Худбарқароршавӣ: такрор ҳангоми хатогиҳои абзорҳо (0=хомӯш) | int | `0` | ⟩0 даъватҳои нобарори абзорҳоро бо ишораи ислоҳкунанда то ҳамин ҳад такрор мекунад. |
## Agent · System prompt
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_LOCALE` | Локали пешфарз | text | `ru-RU` | Забон/локали пешфарзи ҷавоб, мас. ru-RU. Дастурҳои персона/оператор афзалият доранд. |
| `AIHUMMER_TIMEZONE` | Минтақаи вақт | text | `UTC` | Минтақаи вақти IANA барои дохил кардани сана, мас. Europe/Moscow. Пешфарз UTC. |
## Channels
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_CONFIDENTIAL_PERSONA` | Персонаи махфии веб | bool | `0` | Ҳангоми фаъол будан агенти веб-чат маълумоти персона/шахсияти худро ошкор ва нигоҳ намедорад ва танҳо аз рӯи вазифа ҷавоб медиҳад — барои ҷойгиркуниҳои веби беном ё ба махфият ҳассос. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_INBOUND_REQUIRE_BINDING` | Танҳо ба корбарони бақайдгирифташуда ҷавоб додан | text | `true` | true = бот ҳар фиристандаро дар канал, ки корбари сабтшудаи AiHummer НЕСТ (корбар бо пайванди нақш), нодида мегирад — аъзои тасодуфии чат ва даъватҳои меҳмон ҷавоб намегиранд. false (пешфарз) = ба ҳама ҷавоб додан. |
## Integrations
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_A2A_PUBLISH` | Нашри агент тавассути Agent2Agent (A2A) | bool | `0` | Агентро ҳамчун сервери A2A нашр кунед (Agent Card + POST /a2a/message). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_MCP_EXPORT_TOOLS` | — | text | — | — |
| `AIHUMMER_MCP_PUBLISH` | Нашри абзорҳо тавассути MCP | bool | `0` | Абзорҳоро ҳамчун сервери MCP дар POST /v1/mcp нашр кунед. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
## Knowledge connectors
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_KB_SYNC_INTERVAL` | Фосилаи азнавҳамоҳангсозии банақшагирифташудаи коннекторҳо (0/холӣ = хомӯш) | text | — | Мӯҳлат (мас. 6h, 30m) барои аз нав синхронкунии худкори фонии ҳамаи коннекторҳои дониши танзимшуда дар ҳамаи фазоҳои корӣ. Холӣ/0 = хомӯш. Синхронкунии такрорӣ идемпотентӣ аст (иваз аз рӯи source, бе такрор). slack_export дохил намешавад (zip-и он дастӣ бор карда мешавад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
## LLM
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_CASCADE_MIN_CHARS` | Каскад: ҳадди ақали аломатҳо барои эскалатсия | int | `0` | Ҳадди дарозии дархост (аломатҳо), ки аз он модели қавитари каскад фаъол мешавад. 0 = пешфарз. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_CASCADE_STRONG_MODEL` | Каскад: модели захиравии қавитар | text | — | Модел, ки барои дархостҳои дароз/мураккаб каскадӣ истифода мешавад (холӣ = хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_CODEX_BASE_URL` | URL-и базавии Codex | text | — | Базаи транспорти Codex (обунаи ChatGPT). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_CODEX_MAX_OUTPUT_TOKENS` | Ҳадди ниҳоии токенҳои баромад (0 = бе маҳдудият) | int | `0` | Маҳдудияти max_output_tokens барои як навбати чат. 0 = бе маҳдудият. Дар моделҳои reasoning токенҳои мулоҳиза низ ба ҳамин буҷет ҳисоб мешаванд, бинобар ин қимати хеле хурд ҷавоби холии «incomplete: max_output_tokens» медиҳад. Дарҳол татбиқ мешавад (бе бозоғозӣ). |
| `AIHUMMER_CODEX_MODEL` | Идентификатори модел (транспорти Codex / gpt-5.5) | text | `gpt-5.5` | Идентификатори модели транспорти асосии Codex/ChatGPT (мас. gpt-5.5, gpt-5.5-codex). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_CODEX_REASONING_EFFORT` | Умқи мулоҳизаронӣ | enum: none \\\| low \\\| medium \\\| high \\\| xhigh | `low` | Умқи мулоҳизаи модел барои навбатҳои чат, вақте параметрҳои агент онро таъин намекунанд. Қиматҳои дурусти gpt-5.5: none, low, medium, high, xhigh (НЕ minimal — gpt-5.5 онро бо HTTP 400 рад мекунад). Баландтар = сифати беҳтар, вале сусттар/гаронтар. Қимати нодуруст бехатар ба low табдил меёбад. Дарҳол татбиқ мешавад (бе бозоғозӣ). |
| `AIHUMMER_LLM_CALL_TIMEOUT_S` | Вақти интизории як даъват (сония) | int | `120` | Буҷети вақт барои ЯК даъвати модел (зидди дармондагӣ: gpt-5.5 метавонад беохир «фикр» кунад ва навбатро кушода нигоҳ дорад). Пас аз ба охир расидани мӯҳлат даъват бо хатогии ErrCallTimeout бе такрор қатъ мешавад. 0 = бе маҳдудият. Дарҳол татбиқ мешавад (бе бозоғозӣ). |
| `AIHUMMER_LLM_GATEWAY_URL` | URL-и дарвозаи LLM | text | — | URL-и базавии эндпоинти модели мувофиқи OpenAI, ки агент ба он муроҷиат мекунад (сервери маҳаллии llama.cpp/vLLM/Ollama ё шлюзи ҷойгиршуда). Холӣ монед — эндпоинти пешфарзи провайдер истифода мешавад. |
| `AIHUMMER_LLM_MODEL` | Модели LLM | text | — | Ном/идентификатори модел, ки дар ҳар навбат ба провайдер фиристода мешавад (модели эндпоинти шумо). Бояд бо моделе, ки эндпоинт воқеан пешниҳод мекунад, мувофиқ бошад. |
| `AIHUMMER_LLM_PROVIDER` | Провайдери LLM | text | — | Кадом бэкенди модел истифода шавад (эндпоинти мувофиқи OpenAI ё транспорти Codex/обунаи ChatGPT). Муайян мекунад, ки дархостҳо чӣ тавр фиристода ва аутентификатсия мешаванд. |
| `AIHUMMER_LLM_RETRIES` | Такрори LLM ҳангоми хатогии муваққатӣ | int | `3` | Шумораи такрори дархост ба LLM ҳангоми хатогии муваққатӣ. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_LLM_TEMPERATURE` | Ҳарорат | text | — | Ҳарорати сэмплкунӣ (0..2), вақте параметрҳои агент онро таъин намекунанд. Холӣ = нафиристодан. ДИҚҚАТ: моделҳои мулоҳизакори gpt-5.5 (Codex) temperature-ро рад мекунанд — барои онҳо майдонро холӣ монед; онро танҳо ҳангоми истифодаи бэкенди ғайримулоҳизавӣ таъин кунед. Дарҳол татбиқ мешавад (бе бозоғозӣ). |
| `AIHUMMER_LLM_TOP_P` | Top-p (nucleus-намунагирӣ) | text | — | Ҳадди сэмплкунии nucleus (0..1), вақте параметрҳои агент онро таъин намекунанд. Холӣ = нафиристодан. Мисли temperature, gpt-5.5 reasoning онро рад мекунад — танҳо барои бэкендҳои ғайримулоҳизавӣ таъин кунед. Дарҳол татбиқ мешавад (бе бозоғозӣ). |
| `AIHUMMER_OPENAI_API` | Услуби API-и OpenAI (chat \| responses) | enum: \\\| chat \\\| responses | — | chat = /chat/completions, responses = /responses. Холӣ = худкор/пешфарз. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_OPENAI_API_KEY` | Калиди API-и OpenAI-и нативӣ (пешфарз барои насб) | text | — | Калиди аккаунти OpenAI-и шумо барои сикли нативии OpenAI (агар OpenAI-ро ҳамчун провайдери пешфарз истифода баред). Бо BYOK-и фазои корӣ дар саҳифаи «Моделҳо» омехта накунед. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_OPENAI_BASE_URL` | URL-и базавии OpenAI-и нативӣ | text | — | Базаи API-и мувофиқи OpenAI (мас. https://api.openai.com/v1). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_OPENAI_MODEL` | Модели OpenAI-и нативӣ | text | — | Модел барои сикли нативии OpenAI (агар AIHUMMER_OPENAI_API_KEY таъин шуда бошад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_ROUTER_COMPLEX_MODEL` | Роутер: модел барои дархостҳои мураккаб | text | — | Модел барои дархостҳои мураккаб (холӣ = ин гурӯҳ хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_ROUTER_SIMPLE_MODEL` | Роутер: модел барои дархостҳои содда | text | — | Модел барои дархостҳои содда (холӣ = ин гурӯҳ хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_ROUTER_STANDARD_MODEL` | Роутер: модел барои дархостҳои муқаррарӣ | text | — | Модел барои дархостҳои муқаррарӣ (холӣ = ин гурӯҳ хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
## Media
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_DEEPGRAM_API_KEY` | Калиди API-и Deepgram | text | — | API-калиди Deepgram (муҳаррики STT = deepgram). Аз ин ҷо ё аз AIHUMMER_STT_API_KEY гирифта мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_DEEPGRAM_MODEL` | Модели Deepgram | text | `nova-2` | Модели Deepgram (мас. nova-2, nova-3, base). Аз дастрасии лоиҳа барои ҳамин калид вобаста аст. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_DEEPGRAM_URL` | URL-и базавии Deepgram | text | — | Базаи Deepgram API. Холӣ = https://api.deepgram.com. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_IMAGE_BASE_URL` | URL-и базавии API-и тасвирҳо (захиравии OpenAI) | text | — | Базаи /images API ҳангоми кор тавассути калиди OpenAI (холӣ = https://api.openai.com/v1). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_IMAGE_MODEL` | Модели тавлиди тасвир | text | — | Модел барои image_generate (пешфарз gpt-image-2). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_MEDIA_MAX_UPLOAD_MB` | Ҳаҷми ниҳоии боркунии медиа (МБ) | int | `256` | Ҳаҷми ҳадди аксари як боркунии медиа (PUT /v1/media/{id}/content), бо мегабайт. Навиштанро ба диск тавассути порти ҷамъиятӣ маҳдуд мекунад (ҳифз аз саршавӣ). Пешфарз 256. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_STT_API_KEY` | Калиди API-и STT (ихтиёрӣ) | text | — | Bearer-и ихтиёрӣ, агар сайдкари STT онро талаб кунад (install.sh метавонад онро созад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_STT_CODEX_URL` | URL-и муҳаррики STT барои Codex | text | — | Базаи /v1/audio/transcriptions-и мувофиқи OpenAI барои муҳаррики codex (табдили нутқ ба матн тавассути обунаи ChatGPT). Холӣ = базаи Codex. Bearer аз AIHUMMER_STT_API_KEY ё AIHUMMER_CODEX_ACCESS_TOKEN гирифта мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_STT_ENGINE` | Муҳаррики STT | enum: faster-whisper \\\| deepgram \\\| off | `faster-whisper` | Муҳаррики шинохти нутқ. faster-whisper = сайдкари ройгони маҳаллӣ (пешфарз, аз қуттӣ насб мешавад, URL = AIHUMMER_STT_URL, бе бор ба API-ҳои беруна). deepgram = Deepgram-и абрӣ (тез, калиди AIHUMMER_DEEPGRAM_API_KEY, пулакӣ бо ҳудуди ройгон). off = шинохт хомӯш. (Обунаи Codex/ChatGPT табдили аудиоро ба матн дастгирӣ НАМЕКУНАД.) Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_STT_LANGUAGE` | Забони STT | text | — | Забони шинохт (BCP-47, мас. ru/en). Аз ҷониби муҳаррики deepgram истифода мешавад (модели nova-2). Холӣ = муайянкунии худкор/пешфарзи муҳаррик. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_STT_MODEL` | Модели STT | text | `Systran/faster-whisper-small` | Модели faster-whisper (мас. small/medium/large-v3 ё Systran/faster-whisper-⟨size⟩). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_STT_URL` | URL-и табдили нутқ ба матн (faster-whisper) | text | — | URL-и сайдкари маҳаллии faster-whisper (мувофиқи OpenAI /v1/audio/transcriptions). Холӣ = пешфарзи худкори http://127.0.0.1:8001, ки install.sh худаш менависад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_TTS_API_KEY` | Калиди API-и TTS (edge-tts) | text | — | Bearer байни шлюз ва сайдкари edge-tts (install.sh онро худкор месозад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_TTS_ENABLED` | Синтези нутқ фаъол аст | bool | `1` | Синтези нутқро фаъол мекунад (абзори tts + реҷаи овозӣ). Сайдкари edge-tts аз қуттӣ насб мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_TTS_MODEL` | Модели TTS | text | — | Номи модел барои хидмати edge-tts. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_TTS_URL` | URL-и синтези нутқ (edge-tts) | text | — | URL-и сайдкари маҳаллии edge-tts (мувофиқи OpenAI /v1/audio/speech). Холӣ = пешфарзи худкори http://127.0.0.1:8002, ки install.sh худаш менависад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_TTS_VOICE` | Овози TTS (пешфарз de-DE-FlorianMultilingualNeural) | text | `de-DE-FlorianMultilingualNeural` | Овози пешфарзи edge-tts (бисёрзабона, аз ҷумла русӣ). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_VIDEO_API_KEY` | Калиди API-и таҳлили видео | text | — | Калиди дастрасӣ ба сайдкари таҳлили видео (агар лозим бошад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_VIDEO_URL` | URL-и таҳлили видео (ffmpeg) | text | — | URL-и сайдкари таҳлили видео. Холӣ = хомӯш. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
## Media · Voice
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_VOICE_AEC` | Бартарафсозии акс-садо (AEC) | bool | `1` | Талаб кардани echoCancellation ҳангоми сабт (WebRTC). Акси садои TTS-ро дар микрофон бартараф мекунад (Moltis #1129). |
| `AIHUMMER_VOICE_AGC` | Танзими худкори баландӣ | bool | `1` | — |
| `AIHUMMER_VOICE_BARGEIN_FRAMES` | Кадрҳо барои қатъ кардан (barge-in) | int | `5` | Чанд кадри пайдарпайи овоздор (≈20мс) пахши садои ботро қатъ мекунад. |
| `AIHUMMER_VOICE_DUPLEX` | Овози зиндаи пурраи дуҷониба | bool | `0` | Реҷаи зиндаи пурраи дутарафаро фаъол мекунад (стриминг + VAD + barge-in). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_VOICE_NOISE_SUPPRESSION` | Пахши садоҳои изофӣ | bool | `1` | — |
| `AIHUMMER_VOICE_VAD_THRESHOLD` | Ҳадди энергияи VAD (0..1) | text | `0.02` | Ҳадди энергияи нутқ барои гейтинги VAD ҳангоми сабт; пасттар = ҳассостар. |
## Memory
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_EMBEDDER_DIM` | Андозаи вектори эмбеддер | int | `768` | Ченаки вектор — бояд бо модел мувофиқ бошад (multilingual-e5-base=768, bge-m3=1024). |
| `AIHUMMER_EMBEDDER_KEEPALIVE` | Keep-alive-и эмбеддер | text | `5m` | keep_alive барои эмбеддери Ollama (танҳо ҳангоми AIHUMMER_MEMORY_RETRIEVAL=embedding). Пешфарз 5m — модели бекор аз хотира бароварда мешавад ва раннери бекормондаи ollama худаш тоза мешавад. -1 (абадӣ нигоҳ доштан) ТАВСИЯ НАМЕШАВАД: аз сабаби хатогии ollama раннери бандшуда метавонад рӯзҳо як ядрои CPU-ро банд кунад. Оғози сард пас аз бекорӣ бо гармкунӣ ҳангоми оғози шлюз ҷуброн мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_EMBEDDER_MODEL` | Модели эмбеддер | text | `yxchia/multilingual-e5-base` | Модели эмбеддинги Ollama. Пешфарз multilingual-e5-base — бисёрзабона (аз ҷумла русӣ), 768-ченака, сабук ва тез дар CPU (~1-2с ба ҳар эмбеддинг). Префиксҳои query/passage барои e5 худкор татбиқ мешаванд. Барои сифати ҳадди аксар дар GPU bge-m3-ро истифода баред (DIM=1024 таъин кунед). Бояд бо AIHUMMER_EMBEDDER_DIM мувофиқ бошад. |
| `AIHUMMER_EMBEDDER_PASSAGE_PREFIX` | Префикси ҳуҷҷати эмбеддер | text | — | Префикси ҳуҷҷати нигоҳдошташавандаро бознависӣ кунед (моделҳои e5 худкор \\"passage: \\"-ро истифода мебаранд). Барои муайянкунии худкор аз рӯи номи модел холӣ монед. |
| `AIHUMMER_EMBEDDER_QUERY_PREFIX` | Префикси дархости эмбеддер | text | — | Префикси дархости ҷустуҷӯро бознависӣ кунед (моделҳои e5 худкор \\"query: \\"-ро истифода мебаранд). Барои муайянкунии худкор аз рӯи номи модел холӣ монед. |
| `AIHUMMER_EMBEDDER_URL` | URL-и эмбеддер (мутобиқ бо Ollama) | text | — | Эмбеддингҳои воқеии семантикӣ. Насбкунанда сайдкари Ollama-ро ҷойгир мекунад ва инро худкор таъин мекунад; ТАЪИН НАШУДА = эмбеддери hash (танҳо лексикӣ, ёдоварии заиф). |
| `AIHUMMER_MEMORY_CAPTURE` | Реҷаи сабти хотира | enum: auto \\\| review \\\| off | `auto` | auto = худкор дар хотир гирифтан ва ба ёд овардан; review = ҳамчун номзадҳое, ки тасдиқи дастӣ мехоҳанд, нигоҳ доштан; off = бе сабт. |
| `AIHUMMER_MEMORY_CONTEXT_TIMEOUT` | Вақти интизории боркунии хотира | text | `3s` | Ҳадди интизорӣ барои боркунии хотира дар оғози ҷавоб (эмбеддинги дархост + ҷустуҷӯ). Агар эмбеддер бор бошад ва ба мӯҳлат нарасад, ҷавоб БЕ блоки хотира давом мекунад ва овезон намемонад. Формати Go duration (мас. 2s, 1500ms). 0 = бе маҳдудият. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_MEMORY_DREAM_INTERVAL` | Фосилаи гузариши «хоб» | string | `1h` | Чанд вақт як бор гузариши худнигаҳдорандаи dream даъвоҳои санҷидашударо дар ҳамаи доираҳо барои зиддият месанҷад (Go duration, мас. 30m/1h/6h). 0 = хомӯш кардан. |
| `AIHUMMER_MEMORY_EXTRACT` | Истихроҷи фактҳо тавассути LLM | bool | `1` | Ба ҷои нигоҳ доштани порчаҳои хоми ҷумла, далелҳои муназзами субъект/предикат/объектро тавассути LLM ҷудо кардан (пешфарз ФАЪОЛ) — барои кори механизмҳои граф/зиддият/dream зарур аст. Ба ҳар паёми сабтшуда як даъвати LLM илова мекунад; барои сарфаи он хомӯш кунед. |
| `AIHUMMER_MEMORY_RETRIEVAL` | Реҷаи бозёбии хотира | enum: fulltext \\\| embedding | `fulltext` | Хотира чӣ тавр ҷустуҷӯ мешавад. fulltext (пешфарз) = ҷустуҷӯи пурраматнии Postgres аз рӯи матни далелҳо — БЕ модели эмбеддер, бе сайдкар, бе бори CPU (мисли einstein-и кӯҳна дар AiHummer). embedding = ҷустуҷӯи семантикии векторӣ тавассути эмбеддер (AIHUMMER_EMBEDDER_URL/ollama) — аз рӯи маъно дақиқтар, вале CPU-ро бор мекунад ва сайдкар талаб мекунад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_MEMORY_TOKEN` | Токени хидматии хотираи дурдаст | text | — | Токени хидматӣ барои авторизатсия дар Einstein Retrieval API (ҳамчун Authorization: Bearer … фиристода мешавад). Танҳо ҳангоми таъин будани AIHUMMER_MEMORY_URL лозим аст. Холӣ = бе авторизатсия (танҳо барои насбҳои dev бо авторизатсияи retrieval хомӯш). |
| `AIHUMMER_MEMORY_URL` | URL-и хотираи дурдаст (плагини Einstein) | text | — | URL-и плагини мустақили хотираи Einstein (қарордоди aihummer.memory.v1, мас. http://127.0.0.1:8820). ХОЛӢ (пешфарз) = модули дарунсохти хотираи Go. Ҳангоми таъин будан боркунии контексти навбат тавассути HTTP ба /context + /retrieval-и плагин меравад; ҳангоми хато/дастнорасӣ мулоим ба модули дарунсохт бармегардад (бе фурӯпошӣ). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_QDRANT_API_KEY` | Калиди API-и Qdrant | text | — | — |
| `AIHUMMER_QDRANT_URL` | URL-и Qdrant (анбори доимии векторӣ) | text | — | ТАЪИН НАШУДА = анбор дар хотира (векторҳо ҳангоми бозоғозӣ ГУМ мешаванд). Барои нигоҳдории боэътимод дар муҳити корӣ таъин кунед. |
| `AIHUMMER_RERANKER_URL` | URL-и сайдкари азнавтартиббандии RAG | text | — | HTTP-URL-и сайдкари кросс-энкодер барои аз нав рутбабандии ҷустуҷӯи гибридӣ. Холӣ = аз нав рутбабандӣ хомӯш. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
## Moderation
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_MODERATION` | Модератсияи воридот | bool | `1` | \\"off\\" ҳифзи дарунсохтро аз jailbreak/prompt-injection хомӯш мекунад. Ҳар қимати дигар = фаъол. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_MODERATION_REFUSAL` | Паёми радкунии модератсия | text | — | Матни рад, ки ҳангоми басташавии дархост аз ҷониби модератор бармегардад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
## Public access
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_PUBLIC_URL` | URL-и оммавии дарвоза (Web UI + мизоҷон) | text | — | Ин хостро → ба порти шлюз прокси кунед (AIHUMMER_GATEWAY_ADDR, пешфарз :8780). Аз ҷониби Web UI ва мизоҷони iOS/веб истифода мешавад. |
| `POCKET_AGENT_GATEWAY_BASE_URL` | URL-и оммавии дарвозаи pocket-agent | text | — | → ба порти шлюзи pocket-agent прокси кунед (POCKET_AGENT_PORT, пешфарз 8080). Агенти дурдаст тавассути тикети яквақта ба ин ҷо пайваст мешавад. |
| `TELEGRAM_PUBLIC_URL` | URL-и оммавии вебхуки Telegram | text | — | Танҳо барои реҷаи webhook — → ба порти telegram-connector прокси кунед (AIHUMMER_TELEGRAM_CONNECTOR_PORT, пешфарз 8091). Барои реҷаи polling холӣ монед (URL-и ҷамъиятӣ лозим нест). |
## SSO (LDAP/AD)
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_LDAP_BASE_DN` | DN-и базавии ҷустуҷӯи корбарон | text | — | Search root, e.g. OU=Users,DC=corp,DC=example. |
| `AIHUMMER_LDAP_BIND_DN` | DN-и хидматӣ барои пайвастшавӣ | text | — | Ҳисоб барои bind-и ҷустуҷӯи ибтидоӣ, мас. CN=svc-aihummer,OU=Service,DC=corp,DC=example. Холӣ = ҷустуҷӯи беном. |
| `AIHUMMER_LDAP_DEFAULT_ROLE` | LDAP: Нақши пешфарз (мутобиқати гурӯҳ нест) | text | — | Нақше, ки ҳангоми ба ягон маппинг мувофиқ наомадани гурӯҳ дода мешавад. Холӣ = бе нақш. |
| `AIHUMMER_LDAP_ENABLED` | Фаъол кардани вуруд тавассути LDAP/AD | bool | `0` | Ҳангоми фаъол будан вуруди администраторон ба каталог рӯй меорад. Пароли bind дар Secrets нигоҳ дошта мешавад (доираи ldap, номи bind_password). |
| `AIHUMMER_LDAP_GROUP_ATTR` | Атрибути гурӯҳ (пешфарз memberOf) | text | — | Атрибути сабти корбар, ки DN-ҳои гурӯҳҳоро номбар мекунад. Холӣ маппинги гурӯҳ→нақшро хомӯш мекунад. |
| `AIHUMMER_LDAP_ROLE_MAPPINGS` | LDAP: Мутобиқати гурӯҳ→нақш (JSON) | text | — | Объекти JSON аз DN-и гурӯҳ (ё танҳо CN) → нақш, мас. {\\"CN=Admins,OU=Groups,DC=corp,DC=example\\":\\"admin\\",\\"Operators\\":\\"operator\\"}. |
| `AIHUMMER_LDAP_SKIP_TLS_VERIFY` | Гузаштан аз санҷиши TLS (танҳо барои лаборатория, 1/0) | bool | `0` | Санҷиши сертификати каталогро хомӯш мекунад. Ҳеҷ гоҳ дар муҳити корӣ фаъол накунед. |
| `AIHUMMER_LDAP_URL` | URL-и каталог | text | — | e.g. ldaps://ad.corp.example:636 (TLS) or ldap://dc1.corp.example:389. |
| `AIHUMMER_LDAP_USER_ATTR` | Атрибути вуруд (пешфарз sAMAccountName) | text | — | Атрибути LDAP/Active Directory, ки бо логини воридкардаи корбар муқоиса мешавад (пешфарз sAMAccountName; uid барои OpenLDAP, userPrincipalName барои вуруди навъи UPN). |
| `AIHUMMER_LDAP_USER_FILTER` | Филтри ҷустуҷӯи корбарон | text | — | Бояд барои логин %s дошта бошад. AD: (sAMAccountName=%s); OpenLDAP: (uid=%s). |
## SSO (OIDC)
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_OIDC_AUDIENCE` | Audience-и OIDC | text | — | Claim-и интизории `aud` — audience-и ҲАМИН ресурсро таъин кунед, то токенҳои барои тарафи дигар барорида радд шаванд. Claim-и `aud` акнун ба таври пешфарз дар ҳар токен ҲАТМӢ аст (токени бе aud рад мешавад); ҳангоми таъин будани ин, aud бояд онро низ дошта бошад. Дар муҳити корӣ сахт тавсия мешавад. |
| `AIHUMMER_OIDC_ISSUER` | URL-и нашркунандаи OIDC | text | — | Барорандаи IdP (мас. https://login.example.com). Ҳангоми таъин будан аутентификатсияи OIDC JWT-ро фаъол мекунад. |
| `AIHUMMER_OIDC_JWKS_URL` | URL-и JWKS-и OIDC | text | — | Эндпоинти JSON Web Key Set барои санҷиши имзои токенҳо. |
| `AIHUMMER_OIDC_TENANT_CLAIM` | Claim-и фазои корӣ дар OIDC | text | — | Claim-и JWT, ки идентификатори фазои кориро дорад (мас. tenant_id / org). |
## SSO (SAML)
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_SAML_DEFAULT_ROLE` | SAML: Нақши пешфарз (мутобиқати гурӯҳ нест) | text | — | Нақше, ки ҳангоми ба ҳеҷ маппинг мувофиқ наомадани қимати тасдиқшуда дода мешавад. Холӣ = бе нақш. |
| `AIHUMMER_SAML_ENABLED` | Фаъол кардани SSO-и SAML 2.0 | bool | `0` | /saml/metadata, /saml/acs, /saml/login-ро мекушояд. Калиди хусусии SP дар Secrets нигоҳ дошта мешавад (доираи saml, номи sp_key). |
| `AIHUMMER_SAML_ENTITY_ID` | Entity ID-и SP | text | — | Entity ID-и провайдери хидмат (агар холӣ бошад, пешфарз ⟨root⟩/saml/metadata). |
| `AIHUMMER_SAML_IDP_METADATA` | XML-и метаиттилооти IdP | text | — | Ҳуҷҷати метамаълумоти SAML-и IdP-и худро гузоред (Okta/Azure AD/ADFS). |
| `AIHUMMER_SAML_ROLE_ATTRIBUTE` | Атрибути нақш/гурӯҳ (пешфарз groups) | text | — | Атрибути assertion, ки қиматҳои гурӯҳ/нақшро дорад. |
| `AIHUMMER_SAML_ROLE_MAPPINGS` | SAML: Мутобиқати гурӯҳ→нақш (JSON) | text | — | Объекти JSON аз қимати тасдиқшуда → нақш, мас. {\\"AdminGroup\\":\\"admin\\",\\"Ops\\":\\"operator\\"}. |
| `AIHUMMER_SAML_ROOT_URL` | URL-и решагии SP | text | — | URL-и базавии аз берун дастраси ин шлюз, мас. https://app.example.com. ACS = ⟨root⟩/saml/acs. |
| `AIHUMMER_SAML_SP_CERT` | Сертификати SP (PEM) | text | — | Сертификати ҷамъиятии имзои SP (PEM). Калиди хусусии мувофиқ дар Secrets ҷойгир мешавад (доираи saml, номи sp_key). |
## Security
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_AIRGAPPED` | Реҷаи ҷудошуда (air-gapped, 1/0) | bool | `0` | Баромади бо модел идорашавандаро ба интернети ҷамъиятӣ манъ мекунад (танҳо хостҳои дохилӣ/рӯйхати иҷозатдодашуда). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_AUDIT_RETENTION_DAYS` | Нигоҳдории аудит-лог (рӯз, 0=ҳамеша) | int | `0` | Чанд рӯз нигоҳ доштани лоҷи аудит; сабтҳои кӯҳнатар ҳар рӯз нест мешаванд. 0/холӣ = абадӣ нигоҳ доштан. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_CODE_EXEC_ALLOW_HOST` | Иҷозати code_exec дар хост (БЕ песочка) | bool | `0` | ⚠️ Иҷозат додани иҷрои код бевосита дар хост бе муҳити ҷудокардашуда. Танҳо барои homelab-и боэътимод. Бехатартар аст, ки AIHUMMER_CODE_EXEC_SANDBOX_IMAGE таъин карда шавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_CORS_ORIGINS` | Origin-ҳои иҷозатдодашуда барои CORS (бо вергул) | text | — | Рӯйхати Origin-ҳои иҷозатдодашуда бо вергул. Холӣ = CORS иҷозат дода намешавад (танҳо same-origin). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_CSP` | Сарлавҳаи Content-Security-Policy (бознависӣ) | text | — | Сарлавҳаи CSP-ро бознависӣ мекунад. Холӣ = пешфарзи бехатар. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_INBOUND_SECRET` | Сирри муштараки коннектор → дарвоза | text | — | Сирри умумӣ, ки гузариши коннектор→шлюзро аутентификатсия мекунад (бояд бо қимати тарафи коннектор мувофиқ бошад). Холӣ = эндпоинти вурудӣ БЕ аутентификатсия аст. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_OPENAI_COMPAT_KEY` | Вуруди мутобиқ бо OpenAI: калиди статикии API | text | — | Калиди статикӣ, ки бо он мизоҷони мувофиқи OpenAI дар эндпоинти дарунсохти /v1-и шлюз аутентификатсия мешаванд (P8 home gateway). Холӣ = аутентификатсияи статикӣ хомӯш (калидҳои шахсӣ боқӣ мемонанд). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_OPENAI_COMPAT_WORKSPACE` | Вуруди мутобиқ бо OpenAI: ID-и фазои корӣ | text | — | ID-и фазои корӣ, ки аутентификатсияи статикии мувофиқи OpenAI ба он маппинг мешавад. Холӣ = AIHUMMER_DEFAULT_WORKSPACE_ID. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_REQUIRE_2FA` | Талаб кардани 2FA барои операторон | bool | `0` | Барои операторон талаб кардани омили дуюм (TOTP/passkey). Ҳангоми фаъол будан ба операторони бе 2FA ҳангоми вуруд дарҳол пешниҳод мешавад, ки онро танзим кунанд (бе басташавӣ, то соҳиб дар берун намонад). Дарҳол татбиқ мешавад. |
| `AIHUMMER_REQUIRE_SECURE` | Танҳо пайвастҳои ҳифзшуда (HTTPS/WSS) қабул кардан | bool | `0` | Ҳангоми фаъол будан дархостҳои оддии HTTP ба HTTPS равона (барои GET/HEAD) ё рад (403) мешаванд; дастрасӣ аз localhost ҳамеша иҷозат аст, то оператор дар берун намонад. X-Forwarded-Proto-ро аз прокси-и баръакси хотимадиҳандаи TLS ба назар мегирад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_TRUSTED_PROXIES` | CIDR-ҳои боэътимоди прокси-и баръакс (бо вергул) | text | — | Рӯйхати шабакаҳои боэътимоди прокси-и баръакс бо вергул (CIDR, мас. 10.0.0.0/8,192.168.0.0/16, ё IP-ҳои алоҳида). Танҳо барои дархостҳое, ки АЗ ин суроғаҳо меоянд, сарлавҳаи X-Forwarded-For барои муайян кардани IP-и мизоҷ истифода мешавад (аудит, рӯйхати иҷозати IP, ҳифз аз интихоби зӯроваронаи парол). Холӣ = танҳо ба суроғаи воқеии peer бовар кардан (XFF нодида гирифта мешавад, ҷаълкунии IP имконнопазир). Дарҳол татбиқ мешавад. |
## Tools
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_CODE_EXEC` | Фаъол кардани code_exec | bool | `0` | — |
| `AIHUMMER_CODE_EXEC_INTERPRETERS` | Интерпретаторҳои code-exec (JSON) | text | — | Объекти JSON {language: path_to_binary}, мас. {\\"python\\":\\"/usr/bin/python3\\"}. Холӣ = муайянкунии худкор. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Тасвири песочкаи code-exec | text | — | Образи контейнер барои ҷудокунии code_exec (бе шабака, rootfs танҳо барои хондан, маҳдудиятҳо). Холӣ = иҷро дар худи хост (муҳити боэътимод). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_DB_QUERY_DSN` | DSN барои db_query (нақши бо ҳуқуқи ҳадди ақал, на соҳиб — дархостҳо бо маҳдудияти RLS аз рӯи фазои кории фаъол иҷро мешаванд) | text | — | — |
| `AIHUMMER_FS_ROOT` | Решаи абзори системаи файлӣ | text | — | — |
| `AIHUMMER_HTTP_ALLOWLIST` | Рӯйхати суроғаҳои иҷозатдодашудаи http_request | text | — | — |
| `AIHUMMER_HTTP_AUTH_JSON` | Авторизатсияи http_request (JSON) | text | — | — |
| `AIHUMMER_MCP_SERVERS` | Серверҳои MCP (JSON) | text | — | — |
| `AIHUMMER_WEBFETCH_ALLOWLIST` | Рӯйхати суроғаҳои иҷозатдодашудаи web_fetch | text | — | — |
## Web UI (separate port)
| Калид | Ном | Навъ | Пешфарз | Чӣ мекунад |
| --- | --- | --- | --- | --- |
| `AIHUMMER_WEBUI_API_BASE` | URL-и базавии API, ки Web UI муроҷиат мекунад | text | — | Origin-и мутлақ (мас. https://api.example.com), ки SPA-и алоҳида ҷойгиршуда барои даъватҳои /v1/admin/* ба он муроҷиат мекунад. Холӣ = баргашт ба URL-и ҷамъиятии шлюз, сипас ба суроғаи маҳаллии шлюз. Бояд аз браузери администратор дастрас бошад; API бояд origin-и ин Web UI-ро тавассути CORS иҷозат диҳад (дар поён худкор илова мешавад). |
| `AIHUMMER_WEBUI_ENABLED` | Пешниҳоди Web UI-и админ дар порти хусусии он | bool | `1` | Ба таври пешфарз фаъол: SPA-и админ дар РЕШАи шунавандаи алоҳида (AIHUMMER_WEBUI_ADDR) дода мешавад, ки онро ба интерфейси танҳо дохилӣ пайваст кардан мумкин аст. Порти асосии шлюз API + pairing + WS + SSE-ро нигоҳ медорад ва /admin/-ро НАМЕДИҲАД. Барои пурра хомӯш кардани шунавандаи Web UI 0 таъин кунед. |
| `AIHUMMER_WEBUI_ORIGIN` | Origin-и браузери Web UI (CORS) | text | — | Origin-и браузерии Web UI (мас. https://admin.example.com), ки худкор бо маълумоти дастрасӣ ба рӯйхати иҷозати CORS-и API илова мешавад. Холӣ = аз AIHUMMER_WEBUI_ADDR бароварда мешавад (http://host:port). Инро вақте таъин кунед, ки браузер ба Web UI тавассути прокси/номи хосте меояд, ки аз суроғаи пайвастшавӣ фарқ мекунад. |
Танзимоти барои оператор дастрас: 138.