Маълумотнома / Маълумотнома оид ба танзимот
Маълумотнома оид ба танзимот v1.1.x · навсозӣ шуд 2026-10-02 ⧉ Нусхабардорӣ ҳамчун Markdown ✓ Нусхабардорӣ шуд
Дар ин ҷо ҳамаи танзимоте оварда шудаанд, ки оператор дар сервери AiHummer тағйир дода метавонад. Саҳифа аз каталоги худи маҳсулот сохта мешавад, бинобар ин ба сервери шумо мувофиқ аст.
Қимат дар веб-интерфейс ё бо фармони aihummer settings set KEY VALUE дода мешавад (Сатри фармон ). Сутуни қимати пешфарз он чизеро нишон медиҳад, ки сервер то додани қимати шумо истифода мебарад.
[!NOTE]
Қиматҳои махфӣ дар ин ҷо чоп намешаванд, калидҳои хизматии таъминкунанда бошанд, тамоман оварда намешаванд — маҳсулот онҳоро аз ҳамаи рӯйхатҳо пинҳон мекунад. Тире қимати холӣ ё шарҳеро мефаҳмонад, ки танҳо дар веб-интерфейс нишон дода мешавад.
API
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_PERSONAL_API_KEYS
Калидҳои шахсии API барои API-и мутобиқ бо OpenAI
bool
1
пас аз бозоғозӣ
\“off\” аутентификатсияро бо калидҳои шахсӣ дар эндпоинти мувофиқи OpenAI хомӯш мекунад. Ҳар қимати дигар = фаъол. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
Agent
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_AGENT_ANNOUNCE_SLOW_TOOLS
Агент: пеш аз амалҳои дароз огоҳ кардан
bool
1
фавран
Пеш аз амали дароз (тасвир, ҷустуҷӯи амиқ, видео, супориш ба зерагент) агент мухтасар менависад, ки чӣ кор мекунад, то интизорӣ хомӯш набошад. Агар чунин паёмҳо халал расонанд, хомӯш кунед.
AIHUMMER_AGENT_COMPACT_AT_PCT
Агент: таърихро ҳангоми пуршавӣ фишурдан, % ҷои он
int 50…99
85
фавран
Вақте ки таърихи сӯҳбат ин қадар фоизи ҷои ба он ҷудошуда дар равзанаи моделро ишғол кунад, паёмҳои кӯҳна ба хулоса ҷамъ мешаванд — дар замина, пас аз ҷавоб, гардиш интизор намешавад. Пасттар — фишурдан зудтар, аммо модел айнан камтар дар ёд дорад; баландтар — камтар, аммо гардишҳо вазнинтар. 50–99; барои агент қимати худро муайян кардан мумкин аст.
AIHUMMER_AGENT_COMPACT_TO_PCT
Агент: пас аз фишурдан нигоҳ доштан, % ҷои таърих
int 10…90
50
фавран
Пас аз фишурдан чанд фоизи ҷои таърих айнан мемонад; ҳама чизи кӯҳнатар ба хулоса меравад. Бояд аз ҳадди фишурдан пасттар бошад: фарқи байни онҳо нишон медиҳад, ки то фишурдани навбатӣ чанд гардиш мегузарад. 10–90; барои агент қимати худро муайян кардан мумкин аст.
AIHUMMER_AGENT_HISTORY_TURNS
Агент: навбатҳои гуфтугӯ, ки айнан нигоҳ дошта мешаванд
int 1…1000
30
фавран
Модел чанд навбати охирини гуфтугӯро айнан мебинад (то вақти фишурдан боз то 10 зиёдтар). Паёмҳои кӯҳна дар замина ба хулоса табдил меёбанд; худи гуфтугӯ ҳеҷ гоҳ нест карда намешавад. Равзанаи контексти модел худкор ба назар гирифта мешавад. 1–1000; барои агент қимати алоҳида гузоштан мумкин аст.
AIHUMMER_AGENT_MAX_ITERATIONS
Агент: ҳадди аксари қадамҳои асбоб дар як навбат
int 1…256
25
фавран
Агент пеш аз ҷавоб додан дар як навбат чанд маротиба асбобҳоро даъват карда метавонад. Дар ҳад навбат ноком намешавад: агент мегӯяд, ки чӣ иҷро шуд ва чӣ монд, ва шумо метавонед хоҳиш кунед, ки идома диҳад. Се даъвати якхела пайиҳам бо ҳамон натиҷа навбатро барвақттар қатъ мекунад. 1–256; барои агент қимати алоҳида гузоштан мумкин аст.
AIHUMMER_AGENT_MEMORY_FLUSH
Агент: пеш аз фишурдан қайдро дар хотира нигоҳ доштан
bool
1
фавран
Пеш аз он ки паёмҳои кӯҳна ба хулоса муттаҳид шаванд, агент қайди кӯтоҳро дар бораи ҳадафҳо, қарорҳо ва корҳои кушода дар хотира менависад. Барои сарфаи даъвати модел хомӯш кунед.
AIHUMMER_AGENT_MEMORY_FLUSH_PROMPT
Агент: дар ёддошт пеш аз фишурдан чӣ сабт шавад
text
—
фавран
Супориши худи шумо барои ёддошт пеш аз фишурдан: аз паёмҳое, ки ба хулоса мераванд, чӣ нигоҳ дошта шавад (масалан, «танҳо харидҳо, мӯҳлатҳо ва созишҳоро навис»). Холӣ — дарунсохт: ҳадафҳо, қарорҳо, корҳои анҷомнаёфта. Ҳифз хомӯш намешавад: матни гуфтугӯ маълумот боқӣ мемонад, на дастур, ва паролҳо ва калидҳо сабт намешаванд. То 4000 аломат; агент метавонад супориши худро дошта бошад.
AIHUMMER_AGENT_NEW_REMINDERS_MEMORY
Агентҳои нав: ёдраскуниҳо ва сабт дар хотира
bool
1
фавран
Агенти наве, ки дастӣ сохта шудааст (устои оғози аввал, «Сохтани агент», API), аз қадами аввал худаш ёдраскуниҳо ва ҷадвалҳои ХУДРО мегузорад, тағйир медиҳад ва бекор мекунад ва далелҳоро ба хотираи худ менависад — мисли қолаби ёрдамчии шахсӣ. Барои агенти алоҳида ин дар корти он («Имкониятҳо») хомӯш карда мешавад. Қолабҳои китобхона интихоби худро муайян мекунанд, нусхаи агент ҳуқуқҳои аслро нигоҳ медорад, агентҳое, ки агенти дигар сохтааст, бе онҳо оғоз мекунанд; агентҳои мавҷуда тағйир намеёбанд. Барои агенти навбатии сохташаванда амал мекунад.
AIHUMMER_AGENT_PROMPT_PART_MAX_CHARS
Агент: ҳадди аломатҳо барои як қисми промпт
int 1000…1000000
20000
фавран
Модел аз ЯК қисми шахсияти агент — бахши профил, қисми промпт ё промпти асосӣ — чанд аломат мегирад. Дар қисми дарозтар ибтидо (3/4) ва охир (1/4) бо қайди он ки чӣ қадар бурида шуд, нигоҳ дошта мешаванд; ин дар корти сӯҳбат ва дар таркиби промпти агент намоён аст. Ном, тарзи муроҷиат ва маҳдудиятҳои шахсият ҳеҷ гоҳ бурида намешаванд. 1000–1000000; барои агент қимати худро гузоштан мумкин аст.
AIHUMMER_AGENT_PROMPT_TOTAL_MAX_CHARS
Агент: ҳадди умумии аломатҳои шахсият
int 1000…2000000
60000
фавран
Ҳадди умумии шахсияти агент: ҳамаи қисмҳо якҷоя. Агар аз он гузарад, аввал қисмҳои дарозтарин ҷой медиҳанд ва қисмҳои кӯтоҳ пурра мемонанд. 1000–2000000; барои агент қимати худро гузоштан мумкин аст.
AIHUMMER_AGENT_SELF_INTRO
Агент: худро муаррифӣ кардан
enum: first_contact \\| each_dialog \\| never
first_contact
фавран
«Як бор, ҳангоми шиносоии аввал» — агент дар аввалин суҳбат бо шахс, агар ӯ фавран ба кор гузаштанро нахоҳад, худро мухтасар муаррифӣ мекунад; ба шахси шинос дубора худро муаррифӣ намекунад ва ба салом табиӣ ҷавоб медиҳад. «Худро муаррифӣ накардан» — агент ҳеҷ гоҳ худро худаш ном намебарад. «Дар оғози ҳар суҳбати нав» — дар оғози ҳар суҳбати нав ва пас аз танаффуси дароз, мухтасар ва бе хулосаи корҳои гузашта. Агент метавонад дар корти худ («Контекст ва рафтор») интихоби дигар дошта бошад.
AIHUMMER_AGENT_SESSION_IDLE_RESET_MINUTES
Агент: пас аз хомӯшӣ сӯҳбатро аз нав оғоз кардан (дақиқа)
int 0…525600
360
фавран
Барои реҷаҳои «пас аз хомӯшӣ» ва «ҳар рӯз ва пас аз хомӯшӣ»: агар шахс пас аз хомӯшии дарозтар аз ин нависад, агент сӯҳбатро аз нав оғоз мекунад. Барои агентҳое амал мекунад, ки дар кортаашон қимати худ муқаррар нашудааст. 0 — на аз рӯи хомӯшӣ. 0–525600; 360 = 6 соат, 1440 = як шабонарӯз.
AIHUMMER_AGENT_SESSION_INDEX_MAX_ENTRIES
Агент: дар рӯйхат на бештар аз ин қадар сеанс нигоҳ доштан
int 0…100000
0
фавран
Аввал хомӯштаринҳо мебароянд; ҳеҷ чиз нест карда намешавад. 0 — бе маҳдудият. 0–100000. Барои агентҳое, ки дар кортаашон арзиши худ надоранд, амал мекунад.
AIHUMMER_AGENT_SESSION_INDEX_PRUNE_DAYS
Агент: пас аз ин қадар рӯзи хомӯшӣ аз рӯйхати сеансҳо баровардан
int 0…3650
0
фавран
Ҳеҷ чиз нест карда намешавад: сӯҳбат аз рӯйхат мебарояд ва бо паёми нав бармегардад. 0 — нигоҳ доштан. 0–3650. Барои агентҳое, ки дар кортаашон арзиши худ надоранд, амал мекунад.
AIHUMMER_AGENT_SESSION_RESET_AT_HOUR
Агент: соати ҳаррӯзаи аз нав оғоз кардан
int 0…23
4
фавран
Барои реҷаҳои «ҳар рӯз»: суҳбате, ки пеш аз ин соат оғоз шудааст, аз паёми навбатии шахс аз нав оғоз мешавад. Соат аз рӯи минтақаи вақти сервер аст (танзими «Минтақаи вақт» дар «Система ва танзимот»). 0–23; 4 — шаб, вақте ки қариб ҳеҷ кас наменависад.
AIHUMMER_AGENT_SESSION_RESET_GROUP_IDLE_MINUTES
Агент: пас аз хомӯшӣ чати умумиро аз нав оғоз кардан (дақиқа)
int 0…525600
0
фавран
Барои чатҳои умумӣ дар реҷаҳои «пас аз хомӯшӣ» ва «ҳар рӯз ва пас аз хомӯшӣ»: дақиқаҳои хомӯшӣ, ки пас аз онҳо чати умумӣ аз нав оғоз мешавад. 0 — мисли чатҳои шахсӣ. 0–525600.
AIHUMMER_AGENT_SESSION_RESET_GROUP_MODE
Агент: чати умумӣ кай аз нав оғоз мешавад
enum: inherit \\| daily \\| idle \\| both \\| none
inherit
фавран
Қоидаи алоҳида барои чатҳои умумӣ (гурӯҳҳои Telegram, сӯҳбатҳои VK, чатҳои MAX ва дигарон): мисли чатҳои шахсӣ, ҳар рӯз дар соати барқарорсозӣ, пас аз хомӯшӣ, кадоме ки пештар расад, ё ҳеҷ гоҳ. Соати барқарорсозӣ умумӣ аст. Ба агентҳое дахл дорад, ки дар корти худ қоидаи худро надоранд.
AIHUMMER_AGENT_SESSION_RESET_MODE
Агент: сӯҳбат кай аз нав оғоз мешавад
enum: idle \\| daily \\| both \\| none
idle
фавран
Агент сӯҳбатро кай аз нав оғоз мекунад: ҳар рӯз дар соати барқарорсозӣ (аз рӯи минтақаи вақт дар танзимот), пас аз хомӯшӣ, ҳар кадом, ки пештар ояд, ё ҳеҷ гоҳ. Ҳангоми аз нав оғоз кардан агент дар хотираи худ қайде дар бораи сӯҳбати гузашта менависад ва гардиши якуми он хулосаи пештара ва паёмҳои охиринро мегирад; худи паёмҳо дар бойгонӣ ва ҷустуҷӯ боқӣ мемонанд. Барои агентҳое амал мекунад, ки дар кортаашон қоидаи худ надоранд; дар он ҷо барои чатҳои умумӣ қоидаи алоҳида гузоштан мумкин аст.
AIHUMMER_AGENT_SESSION_SCOPE
Агент: сӯҳбатҳои шахсӣ куҷо ҷамъ мешаванд
enum: chat \\| per-channel-peer \\| per-peer
chat
фавран
«Як барои ҳар шахс» Telegram, барнома ва дигар чатҳои шахсии як одамро ба як сӯҳбат муттаҳид мекунад. Чатҳои гурӯҳӣ ҳамеша сӯҳбати худро нигоҳ медоранд. Аз паёми навбатӣ амал мекунад. Барои агентҳое, ки дар кортаашон арзиши худ надоранд, амал мекунад.
AIHUMMER_AGENT_SILENT_REPLY
Агент: метавонад хомӯш монад
enum: groups \\| all \\| off
groups
фавран
Дар чатҳои умумӣ агент метавонад хомӯш монад, агар паём ба ӯ равона нашуда бошад ё чизе барои илова надошта бошад; дар мукотибаи шахсӣ ҳамеша ҷавоб медиҳад. Хомӯширо дар мукотибаи шахсӣ низ иҷозат додан ё хомӯш кардан мумкин аст. Қадами хомӯш чизе намефиристад, дар корти гуфтугӯ ҳамчун «агент хомӯш монд» қайд мешавад ва модел онро дар таърих намебинад. Аз қадами навбатӣ амал мекунад.
AIHUMMER_AGENT_SKILLS_PROMPT_MAX_CHARS
Агент: ҳадди аломатҳои рӯйхати малакаҳо дар промпт
int 1000…200000
18000
фавран
Дар ҳар гардиш модел на матни малакаҳо, балки рӯйхати онҳоро мебинад: идентификатор, ном ва кай истифода бурдан; дастури малакаро агент худаш бор мекунад, вақте ки вазифа мувофиқ аст. Агар рӯйхат дарозтар бошад, аввал тавсифҳо, баъд охири рӯйхат хориҷ мешаванд — боқимондаро агент бо дархост меёбад. 1000–200000.
AIHUMMER_AGENT_STALE_GAP_HOURS
Агент: танаффусе, ки баъди он сӯҳбати гузашта таърих аст (соат)
int 0…8760
12
фавран
Агар шахс пас аз танаффуси дарозтар аз ин нависад, агент қайд мегирад: ҳар чизе, ки пештар муҳокима шуд, таърих аст — бе дархост такрор намешавад ва вазифаҳои пешина идома дода намешаванд. Ҳар паём аллакай вақти худ ва чӣ қадар аз паёми қаблӣ гузаштанро дорад. 0 — қайд накардан. 0–8760.
AIHUMMER_AGENT_TOOL_HISTORY_TURNS
Агент: навбатҳое, ки натиҷаҳои абзорҳо дар хотир мемонанд
int 0…100
5
фавран
Дар чанд навбати охир модел даъватҳои абзорҳо ва натиҷаҳои онҳоро пурра мебинад (натиҷа то 16 КБ нигоҳ дошта мешавад). Дар навбатҳои кӯҳнатар даъват ва ибтидои натиҷа мемонад. Ҳамин тавр агент ба ҷои аз нав даъват кардани абзорҳо дар хотир дорад, ки чӣ ёфт ва чӣ кард. 0 — натиҷаҳоро ба навбатҳои баъдӣ нагузаронидан. 0–100; барои агент арзиши худро додан мумкин аст.
AIHUMMER_APPROVAL_TOOLS
Абзорҳое, ки тасдиқ талаб мекунанд
multiselect
—
фавран
Рӯйхати абзорҳо бо вергул, ки фарохонии онҳо пеш аз иҷро тасдиқи дастии операторро талаб мекунад. Холӣ = тасдиқ лозим нест. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест.
AIHUMMER_SUBAGENT_MAX_DEPTH
Умқи ниҳоии зер-агентҳо
int 0…10
2
фавран
Умқи ҳадди аксари ҷойгиршавии зерагентҳо (агенте, ки агентро оғоз мекунад). Бо нобаёнӣ 2 — муҳофизат аз рекурсияи беохир.
AIHUMMER_SUBAGENT_TIMEOUT_SEC
Вақти интизории зер-агент (сония)
int 0…86400
180
фавран
Вақти ҳадди аксари як иҷрои зерагент, бо сония.
AIHUMMER_TOOL_SEARCH
Боркунии таъхирноки абзорҳо
bool
false
фавран
Ядрои кории абзорҳо ба модел фавран нишон дода мешавад, боқимондаи каталоги калон бошад, дар паси абзори ҷустуҷӯ пинҳон мешавад, ки номи ҳар абзори пинҳонро мегӯяд. Танҳо дар каталогҳои калон (даҳҳо абзори плагин, MCP ё OpenAPI) худро сафед мекунад: аз ҳадди андоза поёнтар ҳамаи абзорҳо фавран нишон дода мешаванд, зеро муроҷиати иловагӣ ба модел барои ёфтани абзор аз худи нақшаҳо гаронтар аст. Аз гардиши навбатӣ амал мекунад.
AIHUMMER_TOOL_SEARCH_CORE
Боркунии танбал: абзорҳои ҳамеша фаъол
multiselect
web_search,web_fetch,memory_search,memory_get,memory_store,search_history,search_knowledge,code_exec,process,filesystem_read,message,schedule_list,schedule_create,schedule_delete,generate_pairing_code
фавран
Абзорҳое, ки дар реҷаи танбал ҳамеша фавран намоёнанд. Пешфарз — ядрои корӣ: ҷустуҷӯ дар интернет, хондани саҳифаҳо, хотира, таърихи мукотиба, пойгоҳи дониш, код, файлҳо, паёмҳо, ҷадвалҳо ва пайвасткунии барнома. Ҷустуҷӯ дар хотира ва пойгоҳи дониш (memory_search, memory_get, search_knowledge) новобаста аз ин рӯйхат ҳамеша намоён аст. Рӯйхати холӣ ин ядроро бармегардонад.
AIHUMMER_TOOL_SEARCH_MIN_POOL_TOKENS
Боркунии танбал: ҳаҷми ҳадди ақали абзорҳои пинҳон (токенҳо)
int 0…1000000
4000
фавран
Абзорҳоро танҳо вақте пинҳон кунед, ки нақшаҳои берун аз ядро дар маҷмӯъ на камтар аз ин қадар токен вазн дошта бошанд (ҳар кадоме тақрибан 4 аломат). Аз ҳад поёнтар ҳамаи абзорҳо фавран нишон дода мешаванд: муроҷиати иловагӣ ба модел барои ёфтани абзор аз нишон додани нақшаҳо гаронтар аст.
AIHUMMER_TOOL_SEARCH_THRESHOLD
Боркунии танбал: ҳадди ақали абзорҳо барои ба таъхир андохтан
int 0…1000
12
фавран
Танҳо вақте ба таъхир гузоред, ки пас аз филтри профили агент аз ин шумора зиёдтар абзор монад.
Agent · Reasoning
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_AGENT_BEST_OF_N
Беҳтарин аз N: шумораи вариантҳо
int 0…8
0
фавран
Агент ин қадар варианти ҷавоб омода карда, беҳтаринашро нигоҳ медорад. 0 ё 1 — хомӯш, аз 2 — фаъол. Ҳар вариант мисли ҷавоби алоҳида арзиш дорад.
AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT
Баҳс: промпти довар (бознависӣ)
text
—
фавран
Промпти довари мубоҳисаро бознависӣ мекунад (холӣ = дарунсохт).
AIHUMMER_AGENT_DEBATE_N
Мубоҳиса: шумораи вариантҳои ҷавоб
int 0…8
0
фавран
Агент ин қадар варианти ҷавоб омода мекунад, онҳоро байни худ муқоиса намуда, беҳтаринашро медиҳад. 0 ё 1 — хомӯш, аз 2 — фаъол. Ҳар вариант мисли ҷавоби алоҳида арзиш дорад.
AIHUMMER_AGENT_DEBATE_PROMPT
Баҳс: промпти номзад (бознависӣ)
text
—
фавран
Промпти номзади мубоҳисаро бознависӣ мекунад (холӣ = дарунсохт).
AIHUMMER_AGENT_DEBATE_ROUNDS
Баҳс: даврҳо
int 1…10
1
фавран
Шумораи даврҳои мубоҳисаи панели номзадҳо.
AIHUMMER_AGENT_JUDGE_PROMPT
Промпти довари best-of-N (бознависӣ)
text
—
фавран
Промпти довари best-of-N-ро бознависӣ мекунад (холӣ = дарунсохт).
AIHUMMER_AGENT_PLAN_PROMPT
Промпти нақшакаш (бознависӣ)
text
—
фавран
Промпти нақшакашро бознависӣ мекунад (холӣ = дарунсохт).
AIHUMMER_AGENT_PLAN_STEPS
Нақшакаш-иҷрокунанда: ҳадди ниҳоии қадамҳои нақша (0=хомӯш)
int 0…32
0
фавран
⟩0 гузариши алоҳидаи нақшакаш→иҷрокунанда→синтезро оғоз мекунад (барои вазифаҳои мураккаби бисёрқадама муфид). 0 = хомӯш. Одатан 4–8.
AIHUMMER_AGENT_PLAN_STEP_ITERS
Нақшакаш: такрори абзорҳо дар ҳар қадам (0=пешфарз)
int 0…64
0
фавран
Шумораи такрори даъвати абзорҳоро дар ҳар қадами нақша маҳдуд мекунад. 0 = қимати дарунсохти пешфарз (4).
AIHUMMER_AGENT_REFLECT
Гузариши худтанқидӣ
bool
0
фавран
Пеш аз ҷавоби ниҳоӣ гузариши таҳлил/худтанқидиро илова мекунад.
AIHUMMER_AGENT_REFLECT_PROMPT
Промпти рефлексия (бознависӣ)
text
—
фавран
Промпти худтанқидиро бознависӣ мекунад (холӣ = дарунсохт).
AIHUMMER_AGENT_SELF_HEAL
Худбарқароршавӣ: такрор ҳангоми хатогиҳои абзорҳо (0=хомӯш)
int 0…10
0
фавран
⟩0 даъватҳои нобарори абзорҳоро бо ишораи ислоҳкунанда то ҳамин ҳад такрор мекунад.
Agent · System prompt
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_LOCALE
Локали пешфарз
enum: ru-RU \\| en-US \\| az-AZ \\| hy-AM \\| be-BY \\| kk-KZ \\| ky-KG \\| tg-TJ \\| tk-TM \\| uz-UZ \\| ka-GE \\| ro-RO \\| es-ES \\| zh-CN \\| fr-FR \\| de-DE \\| hi-IN \\| pl-PL \\| lt-LT \\| lv-LV \\| et-EE \\| fi-FI \\| sv-SE \\| no-NO \\| da-DK \\| tr-TR \\| mn-MN
ru-RU
фавран
Забон/локали пешфарзи ҷавоб, мас. ru-RU. Дастурҳои персона/оператор афзалият доранд.
AIHUMMER_TIMEZONE
Минтақаи вақт
text
UTC
фавран
Минтақаи вақти IANA барои санаи ҷории агент ва ҷадвалҳои бе минтақаи худ, мас. Europe/Moscow. Пешфарз UTC.
Channels
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_CHANNEL_FAILURE_NOTICE
Ба ҳамсуҳбат дар бораи нокомии ҷавоб хабар додан
enum: always \\| once \\| off
always
фавран
Вақте агент ҷавоб дода натавонист, ҳамсӯҳбат дар канал (Telegram ва дигарон) чӣ мегирад: «Ҳар дафъа» — паёми кӯтоҳ бо забони худаш; «На зиёда аз як бор дар 4 соат» — дар 4 соат як паём барои суҳбат; «Хабар надодан» — ҳеҷ чиз. Дар паём рамзҳои хато ва номи таъминкунандагон нест; тафсилотро дар «Ҷаласаҳо» ва огоҳиномаҳо мебинед.
AIHUMMER_CHANNEL_FAILURE_TEXT_BLOCKED
Матн дар бораи нокомӣ: инстанс боздошта шудааст
text
—
фавран
Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад.
AIHUMMER_CHANNEL_FAILURE_TEXT_BUDGET
Матн дар бораи нокомӣ: буҷаи соҳиб тамом шуд
text
—
фавран
Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад.
AIHUMMER_CHANNEL_FAILURE_TEXT_BUSY
Матн дар бораи нокомӣ: шлюз аз ҳад зиёд бор дорад
text
—
фавран
Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад.
AIHUMMER_CHANNEL_FAILURE_TEXT_CONFIG
Матн дар бораи нокомӣ: пайвасти модел соҳибро талаб мекунад
text
—
фавран
Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад.
AIHUMMER_CHANNEL_FAILURE_TEXT_FAILED
Матн дар бораи нокомӣ: нокомии дигар
text
—
фавран
Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад.
AIHUMMER_CHANNEL_FAILURE_TEXT_QUOTA
Матн дар бораи нокомӣ: маҳдудияти истифодаи модел тамом шуд
text
—
фавран
Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад.
AIHUMMER_CHANNEL_FAILURE_TEXT_STEP_LIMIT
Матн дар бораи нокомӣ: вазифа ба як ҷавоб нагунҷид
text
—
фавран
Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад.
AIHUMMER_CHANNEL_FAILURE_TEXT_TOO_LONG
Матн дар бораи нокомӣ: гуфтугӯ барои модел хеле дароз аст
text
—
фавран
Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад.
AIHUMMER_CHANNEL_FAILURE_TEXT_UNAVAILABLE
Матн дар бораи нокомӣ: модел муваққатан дастнорас аст
text
—
фавран
Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад.
AIHUMMER_CONFIDENTIAL_PERSONA
Персонаи махфии веб
bool
0
фавран
Ҳангоми фаъол будан агенти веб-чат маълумоти персона/шахсияти худро ошкор ва нигоҳ намедорад ва танҳо аз рӯи вазифа ҷавоб медиҳад — барои ҷойгиркуниҳои веби беном ё ба махфият ҳассос. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест.
AIHUMMER_INBOUND_COALESCE_MS
Равзанаи муттаҳидсозии паёмҳо (мс)
int
500
фавран
Якчанд паёме, ки як шахс пай дар пай ба як чат мефиристад (паёмҳои кӯтоҳ, албоми аксҳо, ислоҳи зуд), агар танаффуси байни онҳо аз ин равзана кӯтоҳтар бошад, ЯК ҷавоб мегиранд. Ба паёмҳое, ки ҳангоми омода шудани ҷавоб мерасанд, фавран пас аз он ҷавоб дода мешавад, ҳеҷ гоҳ ҳамзамон не. Пешфарз 500 мс; 0 — бе интизорӣ байни паёмҳои алоҳида; албоми аксҳо ба ҳар ҳол ҷамъ карда мешавад (танаффус то 3 с, на зиёда аз 20 с), то як ҷавоб гирад. Муттаҳидсозӣ дар Telegram кор мекунад; Slack, WhatsApp, VK, почта ва дигар пайвасткунандаҳое, ки ба ҳар паём ҷавоб интизоранд (ва интегратсияҳо тавассути /v1/inbound/generic), ба ҳар паём ҷавоб мегиранд — мисли пештара якто-якто ва бо тартиб. Фавран татбиқ мешавад.
AIHUMMER_INBOUND_EDIT_MODE
Вақте ки одам паёми ҷавобдодашударо таҳрир мекунад
enum: correct \\| history
correct
фавран
correct — бот бо донистани он ки ин ислоҳ аст, боз ҷавоб медиҳад («буд / шуд»); history — таҳрир танҳо таърихи гуфтугӯро ислоҳ мекунад, ҷавоби нав нест (барои хатоҳои чопӣ қулай). Таҳрири паёме, ки бот ҳанӯз ба он ҷавоб надодааст, ҳамеша танҳо матнашро иваз мекунад. Дар ҷое кор мекунад, ки канал дар бораи таҳрирҳо хабар медиҳад (Telegram). Фавран амал мекунад.
AIHUMMER_INBOUND_QUEUE_MODE
Паёмҳое, ки ҳангоми кори агент навишта мешаванд
enum: steer \\| collect \\| followup
steer
фавран
Бо паёме, ки ҳамон шахс ҳангоми ҳанӯз омода кардани ҷавоб аз ҷониби агент (ҷустуҷӯ, иҷрои абзорҳо) мефиристад, чӣ мешавад: steer (пешфарз) — агент онро пеш аз қадами навбатӣ мебинад ва дар ҳамон ҷавоб ба инобат мегирад; collect — ба он ҷавоби навбатӣ дода мешавад. followup — ба ҳар чунин паём навбат ба навбат ҷавоби алоҳида дода мешавад. Суратҳо, файлҳо, ҷавобҳо ба паём ва фиристодани такрорӣ ҳамеша ҷавоби навбатиро интизоранд. Фавран амал мекунад.
AIHUMMER_INBOUND_REQUIRE_BINDING
Танҳо ба корбарони бақайдгирифташуда ҷавоб додан
bool
true
фавран
true = бот ҳар фиристандаро дар канал, ки корбари сабтшудаи AiHummer НЕСТ (корбар бо пайванди нақш), нодида мегирад — аъзои тасодуфии чат ва даъватҳои меҳмон ҷавоб намегиранд. false (пешфарз) = ба ҳама ҷавоб додан.
Integrations
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_A2A_PUBLISH
Нашри агент тавассути Agent2Agent (A2A)
bool
0
пас аз бозоғозӣ
Агентро ҳамчун сервери A2A нашр кунед (Agent Card + POST /a2a/message). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_MCP_EXPORT_TOOLS
Абзорҳои барои ёрдамчиёни берунӣ кушода
multiselect
—
пас аз бозоғозӣ
Рӯйхати возеҳи номҳои абзор барои муштариёни берунии MCP, ки бо вергул ҷудо карда шудааст, иҷозат дода шудааст. Холӣ = ягон асбобро нашр накунед. Синфҳои хатарноки сатҳи мизбон ба таври илова аз ҷониби сиёсати дарунсохт манъ карда мешаванд, ҳатто агар рӯйхат карда шаванд. Ҳангоми оғоз/пас аз бозоғоз истифода мешавад.
AIHUMMER_MCP_PUBLISH
Нашри абзорҳо тавассути MCP
bool
0
пас аз бозоғозӣ
Ба ёрдамчиёни берунӣ (масалан, Claude Desktop) иҷозат медиҳад, ки аз абзорҳои агентҳои шумо истифода баранд. Кадом абзорҳоро кушодан дар танзими ҳамсоя интихоб мешавад: то рӯйхат холӣ аст, ягонтои он кушода намешавад.
AIHUMMER_MODULE_CPU_QUOTA
Ҳадди протсессори плагин (барои ҳар як)
text
75%
фавран
Ҳар плагин чӣ ҳиссаи протсессорро ишғол карда метавонад (systemd CPUQuota): 75% — се чоряки як ядро, 150% — якуним ядро. Қимати навро плагин ҳангоми насби навбатӣ, навсозӣ ё нигоҳ доштани танзимоташ мегирад; то он вақт плагинҳои кунунӣ бо ҳадди пешина кор мекунанд.
AIHUMMER_MODULE_MEMORY_MAX
Ҳадди хотираи плагин (барои ҳар як)
text
512M
фавран
Ҳар плагин чӣ қадар хотираро ишғол карда метавонад (systemd MemoryMax): андозае мисли 512M, 1G ё 2048M (на камтар аз 64M) ё infinity — бе ҳад. Плагинеро, ки аз ҳад гузашт, система қатъ мекунад. Қимати навро плагин ҳангоми насби навбатӣ, навсозӣ ё нигоҳ доштани танзимоташ мегирад; то он вақт плагинҳои кунунӣ бо ҳадди пешина кор мекунанд.
Knowledge connectors
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_KB_SYNC_INTERVAL
Пойгоҳи донишро аз манбаъҳо чӣ қадар зуд-зуд навсозӣ кардан
text
—
фавран
Сервер тағйиротро аз манбаъҳои пайвастшудаи пойгоҳи дониш худаш чӣ қадар зуд-зуд мегирад. Масалан: 30m — ҳар 30 дақиқа, 6h — ҳар 6 соат. Холӣ ё 0 — танҳо дастӣ. Боркунии такрорӣ нусхаҳои такрорӣ намесозад. Содироти Slack дастӣ бор карда мешавад.
LLM
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_AUX_FALLBACK_MODELS
Вазифаҳои хидматӣ: моделҳои эҳтиётӣ
list
—
фавран
Моделҳо бо вергул — агар модели хидматӣ кор накунад (квота, нуқсон), бо тартиб санҷида мешаванд. Барои он ки хулоса гум нашавад, дар охир ҳамеша модели асосӣ санҷида мешавад. Ҳар гузариш дар журнал сабт мешавад. Фавран амал мекунад.
AIHUMMER_AUX_MODEL
Модел барои вазифаҳои хидматӣ (хулосаҳо, қайдҳо, сарлавҳаҳо)
text
—
фавран
Модели вазифаҳои хидматии пасзамина: фишурдани таърихи кӯҳна ба хулоса, қайд дар хотира пеш аз фишурдан, сарлавҳаҳои сӯҳбатҳо, истихроҷи далелҳо, аз нав ифода кардани дархостҳои ҷустуҷӯ ва тарҷума. Холӣ = худкор: модели арзонтари ҳамон таъминкунанда (Claude → claude-haiku-4-5, Codex → gpt-…-luna/mini); агар чунин набошад — модели асосӣ. «main» — ҳамеша модели асосӣ. Фавран амал мекунад.
AIHUMMER_CASCADE_MIN_CHARS
Каскад: ҳадди ақали аломатҳо барои эскалатсия
int
0
фавран
Ҳадди дарозии дархост (аломатҳо), ки аз он модели қавитари каскад фаъол мешавад. 0 = пешфарз.
AIHUMMER_CASCADE_STRONG_MODEL
Каскад: модели захиравии қавитар
text
—
фавран
Модел, ки барои дархостҳои дароз/мураккаб каскадӣ истифода мешавад (холӣ = хомӯш).
AIHUMMER_CLAUDE_AUTH_URL
Обунаи Claude: суроғаи саҳифаи воридшавӣ
text
—
фавран
Саҳифае, ки дар он пайвасти обунаи Claude-ро иҷозат медиҳед. Холӣ — суроғаи стандартӣ; танҳо бо хоҳиши дастгирӣ иваз кунед.
AIHUMMER_CLAUDE_CLIENT_ID
Обунаи Claude: ID мизоҷи OAuth
text
—
фавран
Шиносаи барнома барои воридшавӣ бо обунаи Claude. Холӣ — стандартӣ; танҳо бо хоҳиши дастгирӣ иваз кунед.
AIHUMMER_CLAUDE_EFFORT
Claude: умқи андеша
enum: low \\| medium \\| high \\| xhigh \\| max
medium
фавран
Агар дар агент умқ муқаррар нашуда бошад, моделҳои Claude пеш аз ҷавоб то чӣ андоза чуқур андеша мекунанд. Баландтар — дар вазифаҳои душвор дақиқтар, вале дарозтар ва квотаи бештар сарф мекунад; пасттар — зудтар ва арзонтар. Моделе, ки сатҳи интихобшударо намедонад, наздиктарин сатҳи пасттарро мегирад; Haiku 4.5 ва моделҳои кӯҳна андешаро дастгирӣ намекунанд. Умқи дар агент муқарраршуда афзалият дорад. Аз гардиши навбатӣ амал мекунад.
AIHUMMER_CLAUDE_MAX_TOKENS
Claude: дарозии ниҳоии ҷавоб (токен)
int
16000
фавран
Як ҷавоби Claude чанд токенро ишғол карда метавонад — ҳам бо обуна, ҳам бо калид. Мулоҳизаҳои модел ба ҳамин маҳдудият дохил мешаванд: қимати хеле хурд ҷавобро дар нимаи ҷумла қатъ мекунад ё ҷавоби холӣ медиҳад. Агар агент дарозии ҷавоби худро дошта бошад, ҳамон амал мекунад.
AIHUMMER_CLAUDE_REDIRECT_URI
Обунаи Claude: масир URI
text
—
фавран
Суроғаи бозгашт, ки дар таъминкунанда ба қайд гирифта шудааст. Он чизе ки дар паҳлӯи он танзим шудааст, бояд мувофиқат кунад, вагарна мубодилаи код рад карда мешавад.
AIHUMMER_CLAUDE_TOKEN_URL
Обунаи Claude: суроғаи гирифтани дастрасӣ
text
—
фавран
Суроғае, ки сервер дастрасиро ба обунаи Claude мегирад ва тамдид мекунад. Холӣ — суроғаи стандартӣ; танҳо бо хоҳиши дастгирӣ иваз кунед.
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
medium
фавран
Агар дар агент муқаррар нашуда бошад, модели ChatGPT (Codex) пеш аз ҷавоб чӣ қадар амиқ фикр мекунад. Пешфарз — «Миёна». Баландтар — дақиқтар, вале дарозтар ва гаронтар.
AIHUMMER_LLM_CALL_TIMEOUT_S
Вақти интизории як даъват (сония)
int
120
фавран
Ба як дархост ҷавоби моделро чанд сония интизор шудан. Агар модел зиёдтар хомӯш монад, дархост қатъ мешавад ва ҷавоб ба модели навбатии рӯйхат мегузарад. Барои Claude на тамоми ҷавоб, балки танаффус дар ҷараёни ҷавоб ҳисоб мешавад: ҷавоби дароз, вале давомдор қатъ намешавад. 0 — бе маҳдудият.
AIHUMMER_LLM_FALLBACK_MODELS
Моделҳои эҳтиётӣ (барои ҳамаи агентҳо)
text
auto
фавран
Вақте ки модели асосӣ ва дигар таъминкунандагон рад мекунанд (маҳдудияти истифода тамом шуд, хатогӣ, дархостҳои аз ҳад зиёд), кӣ ҷавоб медиҳад. auto — модели арзонтари ҳар таъминкунанда ҳамчун такягоҳи охирин (Claude: claude-haiku-4-5, Codex: gpt-…-luna/mini); рӯйхат бо вергул — тартиби худатон, ҳар модел ба таъминкунандагони истеҳсолкунандаи худ меравад; off — бе моделҳои эҳтиётӣ. Модели эҳтиётии худи агент бартарӣ дорад. Фавран татбиқ мешавад.
AIHUMMER_LLM_GATEWAY_URL
URL-и дарвозаи LLM
text
—
қисман пас аз бозоғозӣ
URL-и базавии эндпоинти модели мувофиқи OpenAI, ки агент ба он муроҷиат мекунад (сервери маҳаллии llama.cpp/vLLM/Ollama ё шлюзи ҷойгиршуда). Холӣ монед — эндпоинти пешфарзи провайдер истифода мешавад.
AIHUMMER_LLM_MODEL
Модели LLM
text
—
қисман пас аз бозоғозӣ
Ном/идентификатори модел, ки дар ҳар навбат ба провайдер фиристода мешавад (модели эндпоинти шумо). Бояд бо моделе, ки эндпоинт воқеан пешниҳод мекунад, мувофиқ бошад.
AIHUMMER_LLM_PAUSE_AUTH_MIN
Таваққуф пас аз радди маълумоти ҳисоб, дақ
int
10
фавран
Чанд дақиқа ба таъминкунандае, ки маълумоти ҳисобро рад кард, муроҷиат накардан. Такрор таваққуфро ду баробар мекунад, вале на зиёда аз шаш баробар. Санҷиши бомуваффақияти пайвастшавӣ ва тугмаи «Ҳозир идома додан» таъминкунандаро фавран бармегардонанд. Аз радди навбатӣ амал мекунад.
AIHUMMER_LLM_PAUSE_MODEL_MIN
Таваққуфи модели ба таъминкунанда хизматнашаванда, дақ
int
60
фавран
Чанд дақиқа ба таъминкунанда моделеро пешниҳод накардан, ки ба гуфтаи ӯ хизмат намерасонад; ба дигар моделҳои ӯ одатан муроҷиат мекунем. Аз радди навбатӣ амал мекунад.
AIHUMMER_LLM_PAUSE_QUOTA_MIN
Таваққуф пас аз тамом шудани лимит, дақ
int
300
фавран
Вақте ки лимити истифода тамом шуда, таъминкунанда мӯҳлати барқароршавиро нагуфтааст, чанд дақиқа ба модел (агар лимити ҳисоб тамом шуда бошад — Codex, калиди OpenAI, пардохт — ба тамоми ҳисоб) муроҷиат накардан. Такрор таваққуфро ду баробар мекунад, вале на зиёда аз як шабонарӯз. Мӯҳлати гуфтаи таъминкунанда афзалтар аст. Аз радди навбатӣ амал мекунад.
AIHUMMER_LLM_PAUSE_SHORT_S
Таваққуфи таъминкунанда пас аз нокомӣ, с
int
30
фавран
Пас аз нокомӣ, қатъи алоқа ё ҷавоби «аз ҳад зиёд зуд» чанд сония ба таъминкунанда муроҷиат накардан. Радди дуюми пай дар пай таваққуфро ду баробар, сеюм ва минбаъда даҳ баробар дароз мекунад. Агар таъминкунанда мӯҳлатро худ номбар карда бошад, ҳамонро интизор мешавем. Аз радди навбатӣ амал мекунад.
AIHUMMER_LLM_PROVIDER
Провайдери LLM
text
—
қисман пас аз бозоғозӣ
Кадом бэкенди модел истифода шавад (эндпоинти мувофиқи OpenAI ё транспорти Codex/обунаи ChatGPT). Муайян мекунад, ки дархостҳо чӣ тавр фиристода ва аутентификатсия мешаванд.
AIHUMMER_LLM_RETRIES
Такрори LLM ҳангоми хатогии муваққатӣ
int
3
фавран
Шумораи такрори дархост ба LLM ҳангоми хатогии муваққатӣ.
AIHUMMER_LLM_TEMPERATURE
Ҳарорат
text
—
фавран
Агар дар агент муқаррар нашуда бошад, ҷавобҳои модел чӣ қадар гуногун бошанд (0–2): камтар — дақиқтар ва пешгӯишаванда, бештар — зиндатар. Холӣ — модел худаш қарор медиҳад. Моделҳои андешаманд (ChatGPT/Codex, Claude насли 5) инро қабул намекунанд — барои онҳо майдонро холӣ гузоред.
AIHUMMER_LLM_TOP_P
Top-p (nucleus-намунагирӣ)
text
—
фавран
Боз як роҳи гуногун кардани ҷавобҳо (0–1), агар дар агент муқаррар нашуда бошад. Холӣ — модел худаш қарор медиҳад. Одатан танҳо якеро муқаррар мекунанд: ё ҳарорат, ё инро; моделҳои андешаманд онро қабул намекунанд.
AIHUMMER_MODEL_GUARD_INTERVAL_MIN
Санҷиши модели агент: фосила, дақ
int
60
фавран
Чӣ қадар зуд-зуд санҷидан лозим аст, ки модели ҳар агентро таъминкунандаи фаъол пешниҳод мекунад. Модели агент ҳеҷ гоҳ иваз карда намешавад: то вақте ки касе онро пешниҳод намекунад, аввалин модели тартиби ҷавоб, ки дар таваққуф нест, ҷавоб медиҳад ва огоҳинома агентҳоро ном мебарад — вақте ки модели онҳо бармегардад, боз як огоҳинома меояд. Ҳангоми оғози шлюз санҷиш ҳамеша иҷро мешавад, 0 бошад, танҳо такрорро хомӯш мекунад. Давраи нав дар давоми як дақиқа амал мекунад.
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_SUBSCRIPTION_QUOTA_REFRESH_MIN
Квотаҳои обуна: давраи пурсиш, дақ
int
15
фавран
Панел аз ChatGPT (Codex) равзанаҳои квотаи обунаро чӣ қадар зуд мепурсад: дар давра на бештар аз як бор, на зудтар аз ҳар 5 дақиқа ва танҳо вақте ки квотаҳо кушодаанд; дар байн нусхаи нигоҳдошта нишон дода мешавад. Аз Claude ҳеҷ гоҳ пурсида намешавад: ҳудудҳои он баҳои мост. Аз кушодани навбатии квотаҳо амал мекунад.
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_DEEPGRAM_API_KEY
Калиди API-и Deepgram
text
—
фавран
Калиди хизмати Deepgram — агар паёмҳои овозиро Deepgram шиносад, лозим аст. Агар холӣ бошад, калиди умумии шинохти нутқ аз танзими ҳамсоя гирифта мешавад. Фавран амал мекунад.
AIHUMMER_DEEPGRAM_DETECT_LANGUAGE
Муайянкунии забони Deepgram
bool
0
фавран
Ба ҷойи фиристодани забони собит забонро муайян мекунад. Фавран татбиқ мешавад.
AIHUMMER_DEEPGRAM_MODEL
Модели Deepgram
text
nova-2
фавран
Модели Deepgram (мас. nova-2, nova-3, base). Аз дастрасии лоиҳа барои ҳамин калид вобаста аст. Фавран татбиқ мешавад.
AIHUMMER_DEEPGRAM_PUNCTUATE
Аломатҳои китобати Deepgram
bool
1
фавран
Аломатҳои китобат ва ҳарфҳои калон илова мекунад. Фавран татбиқ мешавад.
AIHUMMER_DEEPGRAM_SMART_FORMAT
Шаклбандии ҳушманди Deepgram
bool
1
фавран
Рақамҳо ва санаҳои шинохташударо шаклбандӣ мекунад. Фавран татбиқ мешавад.
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
фавран
Бузургтарин файл (акс, паёми овозӣ, видео), ки якбора бор кардан мумкин аст, бо мегабайт. Диски серверро аз пуршавӣ муҳофизат мекунад. Пешфарз 256. Фавран амал мекунад.
AIHUMMER_SIDECAR_STT
Шинохти нутқ дар ин сервер (faster-whisper)
bool
0
фавран
Шинохти нутқи маҳаллӣ (faster-whisper). Ба баста дохил НЕСТ: зеркашии иловаи имзошударо фаъол созед (~620 МБ барои ҳама версияҳои Python) ва хидматро дар ҳост насб кунед. 🔴 Илова бо қарори алоҳидаи фурӯшанда нашр карда мешавад (бастаҳои он ffmpeg дар доираи GPL доранд); агар он барои барориши шумо нашр нашавад, аз он ҷумла дар ин бора ростқавл хоҳад буд ва ҳеҷ чизро вайрон намекунад. Нақшаи абрӣ: эътироф аз ҷониби провайдер танзим карда мешавад.
AIHUMMER_SIDECAR_TTS
Овоздиҳии ҷавобҳо (edge-tts)
bool
0
фавран
Синтези нутқ (edge-tts, овозҳои Microsoft Edge). Ба баста дохил НЕСТ: имкон додани зеркашии замимаи имзошуда (~26 МБ) ва насб кардани хидмат дар ҳост. Худи синтез барои овозҳо онлайн мешавад - “офлайн” дар ин ҷо ба насб кардани баста ишора мекунад, кор намекунад.
AIHUMMER_STT_API_KEY
Калиди API-и STT (ихтиёрӣ)
text
—
фавран
Калиди дастрасӣ ба хизмати шинохти нутқ, агар он талаб кунад. Барои хизмат дар ин сервер онро насбкунанда муқаррар мекунад — иваз кардан лозим нест. Фавран амал мекунад.
AIHUMMER_STT_ENGINE
Муҳаррики STT
enum: auto \\| faster-whisper \\| deepgram \\| codex \\| off
auto
фавран
Паёмҳои овозиро бо чӣ ба матн табдил додан. Автоматӣ (пешфарз): агар калиди он муқаррар бошад, Deepgram, вагарна хидмати маҳаллӣ, агар насб шуда бошад (калиди боло), вагарна бо ҳеҷ чиз — ва бот ба фиристанда ростқавлона мегӯяд, ки ҳоло гӯш карда наметавонад. faster-whisper: хидмати маҳаллӣ ё /v1/audio/transcriptions-и берунаи мувофиқ. deepgram: Deepgram-и абрӣ бо калиди худ. codex: обунаи пайвастшудаи ChatGPT (Моделҳо → Пайваст кардани ChatGPT), квотаи онро сарф мекунад. off: табдил надодан. Фавран татбиқ мешавад.
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_TTS_API_KEY
Калиди API-и TTS (edge-tts)
text
—
қисман пас аз бозоғозӣ
Калиди дастрасӣ ба хизмати овоздиҳӣ. Ҳангоми насб худкор муқаррар мешавад — иваз кардан лозим нест.
AIHUMMER_TTS_ENABLED
Синтези нутқ фаъол аст
bool
1
қисман пас аз бозоғозӣ
Ба агент иҷозат медиҳад, ки бо овоз ҷавоб диҳад. Барои ин хизмати овоздиҳӣ лозим аст — онро дар боло, дар бахши «Хизматҳои иловагӣ» насб мекунанд.
AIHUMMER_TTS_MODEL
Модели TTS
text
—
қисман пас аз бозоғозӣ
Номи модел барои хидмати edge-tts. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_TTS_VOICE
Овози TTS
enum: de-DE-FlorianMultilingualNeural \\| de-DE-SeraphinaMultilingualNeural \\| en-US-AndrewMultilingualNeural \\| en-US-AvaMultilingualNeural \\| en-US-BrianMultilingualNeural \\| en-US-EmmaMultilingualNeural \\| fr-FR-RemyMultilingualNeural \\| fr-FR-VivienneMultilingualNeural \\| ru-RU-SvetlanaNeural \\| ru-RU-DmitryNeural \\| en-US-JennyNeural \\| en-US-GuyNeural \\| en-GB-SoniaNeural \\| de-DE-KatjaNeural \\| fr-FR-DeniseNeural \\| es-ES-ElviraNeural \\| tr-TR-EmelNeural \\| pl-PL-ZofiaNeural \\| zh-CN-XiaoxiaoNeural
de-DE-FlorianMultilingualNeural
қисман пас аз бозоғозӣ
Овози пешфарзи edge-tts (бисёрзабона, аз ҷумла русӣ). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_VIDEO_API_KEY
Калиди API-и таҳлили видео
text
—
фавран
Калиди дастрасӣ ба хизмати таҳлили видео, агар он талаб кунад. Холӣ — хизмат бе калид истифода мешавад.
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_TTS_AUTO_REPLY
Ҷавобҳои овозии худкор
enum: off \\| always \\| inbound \\| tagged
inbound
фавран
Хомӯш, ҳамеша, ҳангоми гирифтани аудио ё бо нишонаи ошкор. Барои ҳар суҳбат тағйир додан мумкин аст.
AIHUMMER_TTS_MAX_CHARS
Ҳадди аломатҳои матни овозӣ
int
0
фавран
0: тамоми матн; 100–10000: ҳадди матни хондашаванда. Ҷавоби пурра дар таърих мемонад.
AIHUMMER_TTS_SUMMARIZE
Кӯтоҳ кардани ҷавобҳои овозии дароз
bool
1
фавран
Ҷавобҳои дарозро барои хондан кӯтоҳ мекунад. Ҳангоми хато аввали матн дар доираи ҳадд хонда мешавад.
AIHUMMER_VOICE_AEC
Бартарафсозии акс-садо (AEC)
bool
1
фавран
Акси садоро бартараф мекунад: овози худи агент аз баландгӯяк ба микрофон барнамегардад ва суҳбатро қатъ намекунад. Танҳо вақте хомӯш кунед, ки овоз дар гӯшмонак вайрон садо диҳад.
AIHUMMER_VOICE_AGC
Танзими худкори баландӣ
bool
1
фавран
Дар ҳолати овозӣ талаб кардани танзими худкори баландии микрофон (WebRTC autoGainControl).
AIHUMMER_VOICE_BARGEIN_FRAMES
Қатъ кардани агент: чӣ қадар гап задан лозим
int
5
фавран
Чӣ қадар гап задан лозим аст (бо кадрҳои 20 мс), то агент хомӯш шуда, гӯш кунад. Пешфарз 5 — тақрибан 0,1 сония.
AIHUMMER_VOICE_DUPLEX
Овози зиндаи пурраи дуҷониба
bool
0
фавран
Реҷаи зиндаи пурраи дутарафаро фаъол мекунад (стриминг + VAD + barge-in). Фавран татбиқ мешавад.
AIHUMMER_VOICE_NOISE_SUPPRESSION
Пахши садоҳои изофӣ
bool
1
фавран
Дар ҳолати овозӣ талаб кардани пахши садо ҳангоми сабт аз микрофон (WebRTC noiseSuppression).
AIHUMMER_VOICE_VAD_THRESHOLD
Ҳассосият ба овоз (0–1)
text
0.02
фавран
Аз кадом баландӣ садо нутқ ҳисоб мешавад. Камтар — ҳассостар: агент нутқи оромро мешунавад, вале садои бегонаро ҳам. Пешфарз 0.02.
Memory
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_EMBEDDER_DIM
Андозагирии модели ҷустуҷӯи маъноӣ
int
768
пас аз бозоғозӣ
Ченаки вектор — бояд бо модел мувофиқ бошад (multilingual-e5-base=768, bge-m3=1024).
AIHUMMER_EMBEDDER_KEEPALIVE
Keep-alive-и эмбеддер
text
5m
пас аз бозоғозӣ
Модели ҷустуҷӯи маъноӣ пас аз дархости охирин чӣ қадар боршуда мемонад (танҳо дар реҷаи «Аз рӯи маъно»). Пешфарз 5m — 5 дақиқа: баъд модел холӣ карда шуда, хотира ва протсессорро озод мекунад. Ҳамеша нигоҳ доштан (-1) тавсия дода намешавад: модели овезон метавонад рӯзҳо як ядрои протсессорро банд кунад. Формат: 30s, 5m, 1h.
AIHUMMER_EMBEDDER_MODEL
Модели ҷустуҷӯи маъноӣ
text
yxchia/multilingual-e5-base
пас аз бозоғозӣ
Модели, ки дар хотира аз рӯи маъно ҷустуҷӯ карданро имкон медиҳад. Пешфарз multilingual-e5-base забони русиро мефаҳмад, сабук аст ва дар протсессори оддӣ зуд кор мекунад. Барои сифати беҳтар дар видеокорт bge-m3 мувофиқ аст, вале он гоҳ дар танзими ҳамсояи андозагирӣ 1024 нависед: рақам бояд ба модел мувофиқ бошад.
AIHUMMER_EMBEDDER_PASSAGE_PREFIX
Префикси ҳуҷҷати эмбеддер
text
—
пас аз бозоғозӣ
Префикси ҳуҷҷати нигоҳдошташавандаро бознависӣ кунед (моделҳои e5 худкор \“passage: \”-ро истифода мебаранд). Барои муайянкунии худкор аз рӯи номи модел холӣ монед.
AIHUMMER_EMBEDDER_QUERY_PREFIX
Префикси дархости эмбеддер
text
—
пас аз бозоғозӣ
Префикси дархости ҷустуҷӯро бознависӣ кунед (моделҳои e5 худкор \“query: \”-ро истифода мебаранд). Барои муайянкунии худкор аз рӯи номи модел холӣ монед.
AIHUMMER_EMBEDDER_THREADS
Риштаҳои протсессори эмбеддер
int 0…256
0
пас аз бозоғозӣ
Модели ҷустуҷӯ аз рӯи маъно барои як дархост чанд риштаи протсессорро мегирад. 0 — худкор: нисфи риштаҳои сервер, вале на камтар аз 2. Бе маҳдудият аз нав ҳисоб кардани векторҳои пойгоҳи дониш дар сервери заиф соатҳо тамоми протсессорро банд мекард ва ба ҷавобҳои агентҳо халал мерасонд. Бештар — аз нав ҳисобкунӣ тезтар, вале сарборӣ вазнинтар.
AIHUMMER_MEMORY_AGENT_WRITES
Далелҳое, ки агент худаш нигоҳ медорад
enum: strangers \\| immediate \\| review
strangers
фавран
Бо он чизе, ки агент худаш дар ёд нигоҳ медорад, чӣ мешавад — масалан, бо хоҳиши «дар хотир дор». «Фавран ба хотира; аз бегонаҳо — барои санҷиш» (пешфарз) — агар инро соҳиб ё ҳалқаи боэътимоди агент гуфта бошад, фавран ба хотира; аз дигарон — барои санҷиш. «Фавран ба хотира» — агент онро фавран меёбад. «Барои санҷиш» — аввал ба навбати «Хотира → барои санҷиш», ба ҷавобҳо танҳо пас аз тасдиқи шумо медарояд. Дар корти агент (Хотира → Танзимот) метавон реҷаи худро интихоб кард.
AIHUMMER_MEMORY_AUTOREPAIR
Ислоҳи худкори хотира
bool
1
фавран
Пас аз худсанҷӣ хотираро ислоҳ кардан: такрориҳоро муттаҳид кардан, зиддиятҳои ғолиби равшандоштаро бастан (тасдиқи инсон, санаи дертари рӯйдод, манбаи вазнинтар), далелҳои «тасдиқшуда»-еро, ки ягон инсон тасдиқ накардааст, аз рӯи манбаъҳояшон аз нав санҷидан (тасдиқнашудаҳо ба санҷиш мераванд, ҳеҷ чиз нест намешавад). Баҳсбарангез — танҳо ба навбат. Ҳар ислоҳ бо тугмаи бекоркунӣ ба журнал сабт мешавад; агар пас аз гузариш хотира бадтар ёбад, гузариш худ бармегардад ва огоҳинома меояд. Дарҳол амал мекунад, бозоғозӣ лозим нест.
AIHUMMER_MEMORY_CAPTURE
Реҷаи сабти хотира
enum: auto \\| review \\| off
review
фавран
Бо далелҳое, ки агент пас аз ҳар ҷавоб дар мукотиба худаш пай мебарад, чӣ кор кардан. «Барои санҷиш» — ба навбати «Хотира → барои санҷиш»: ба ҷавобҳо танҳо пас аз тасдиқи шумо медароянд. «Фавран ба хотира» — бе санҷиш: зудтар, вале зиёдатӣ бештар. «Нигоҳ надоштан» — аз мукотиба далел нагирифтан. Он чизе ки агент бо хоҳиш дар ёд нигоҳ медорад, алоҳида танзим мешавад.
AIHUMMER_MEMORY_CONTEXT_TIMEOUT
Вақти интизории боркунии хотира
text
3s
фавран
Агент пеш аз оғози ҷавоб то пайдо шудани хотираҳои мувофиқ чӣ қадар интизор мешавад. Агар ҷустуҷӯ нарасад, агент овезон намешавад, балки бе онҳо ҷавоб медиҳад. Масалан: 2s — 2 сония, 1500ms — 1,5 сония. 0 — чӣ қадар лозим бошад, интизор шудан.
AIHUMMER_MEMORY_DIARY_BOOT
Рӯзномаи агент дар оғози сессия
bool
1
фавран
Дар ҳар қадами сессия дар ҳар канал рӯзномаи имрӯз ва дирӯзи агентро пеши назари ӯ нигоҳ доред: қайдҳои сессияҳои пешина, хулосаи шабона ва сабтҳои худи агент. Танҳо сабтҳо дар бораи ҳамсуҳбати ҷорӣ ва сабтҳои умумӣ (аз они шумо, боргузоришуда) нишон дода мешаванд — як мизоҷ ҳеҷ гоҳ сабтҳои дигареро намебинад. На бештар аз ~6000 аломат; боқимондаро агент худаш мехонад (memory_get). Фавран амал мекунад, бозоғозӣ лозим нест.
AIHUMMER_MEMORY_DIARY_HOUR
Соати хулосаи шабона
int
3
фавран
Пас аз кадом соат (0–23, аз рӯи минтақаи вақти инстанс) хулосаи рӯзи гузашта навишта шавад. Пешфарз 3 — шабона, вақте ки сӯҳбатҳои рӯз ба охир расидаанд. Фавран амал мекунад, бозоғозӣ лозим нест.
AIHUMMER_MEMORY_DIARY_NIGHTLY
Хулосаи шабонаи рӯз дар рӯзномаи агент
bool
1
фавран
Рӯзе як бор ба рӯзномаи агент хулосаи рӯзи гузаштаро нависед — алоҳида барои ҳар ҳамсуҳбат (ҳамаи каналҳои ӯ якҷоя): чӣ хоҳиш карданд ва чӣ иҷро шуд, созишҳо, корҳо бо санаҳо. Барои ҳар агент ва ҳамсуҳбат як даъвати модели вазифаҳои хидматӣ, дар як гузариш ҳар 10 дақиқа на бештар аз 3; рӯзҳои аз даст рафта то як ҳафта пеш пур карда мешаванд. Сӯҳбатҳо бо «дар хотир нигоҳ надор» гирифта намешаванд. Ҳангоми хомӯш будани ҷамъоварии хотира навишта намешавад. Натиҷаи гузариши охирин дар корти агент → Хотира → Рӯзнома намоён аст. Фавран амал мекунад, бозоғозӣ лозим нест.
AIHUMMER_MEMORY_DREAM_INTERVAL
Фосилаи гузариши «хоб»
string
1h
фавран
Чанд вақт як бор гузариши худнигаҳдорандаи dream даъвоҳои санҷидашударо дар ҳамаи доираҳо барои зиддият месанҷад (Go duration, мас. 30m/1h/6h). 0 = хомӯш кардан. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест.
AIHUMMER_MEMORY_EXTRACT
Истихроҷи фактҳо тавассути LLM
bool
1
фавран
Ба ҷои нигоҳ доштани порчаҳои хоми ҷумла, далелҳои муназзами субъект/предикат/объектро тавассути LLM ҷудо кардан (пешфарз ФАЪОЛ) — барои кори механизмҳои граф/зиддият/dream зарур аст. Ба ҳар паёми сабтшуда як даъвати LLM илова мекунад; барои сарфаи он хомӯш кунед. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест.
AIHUMMER_MEMORY_MEANING_TIMEOUT
Мӯҳлати ҷустуҷӯ аз рӯи маъно
text
4s
фавран
Ҷустуҷӯ дар хотира ва пойгоҳи дониш ҷустуҷӯ аз рӯи маъноро чӣ қадар интизор мешавад. Агар модели маъно банд бошад (масалан, пас аз воридот векторҳоро ҳисоб мекунад) ва сари вақт ҷавоб надиҳад, агент ба ҷои даҳҳо сония интизорӣ ёфтаҳоро аз рӯи калимаҳо бо қайд фавран мегирад. Масалан: 4s — 4 сония, 1500ms — 1,5 сония. 0 — чӣ қадар лозим бошад, интизор шудан. Фавран амал мекунад, бозоғозӣ лозим нест.
AIHUMMER_MEMORY_QUALITY_CHECK
Худсанҷиши ҳаррӯзаи хотира
bool
1
фавран
Шабонарӯзе як бор хотира ба худ оид ба далелҳои тасдиқшудааш саволҳои назоратӣ (то 60 далел, ҳар рӯз ҳамон саволҳо) ва саволҳои бе ҷавоб медиҳад, онҳоро аз ҷустуҷӯи хотира ва ёдоварии худкор мегузаронад ва пуррагӣ, дақиқӣ, MRR ва ёдовариҳои бардурӯғро ҳисоб мекунад. Натиҷа ва ҷадвали рӯзона: Хотира → Сифати хотира. Саволҳоро ба далелҳои нав модели хидматӣ як бор тартиб медиҳад (ҳамон модел, ки аз мукотиба далел мебарорад; бе он — бо қолиб); натиҷаҳо дар инстанс мемонанд. Дарҳол амал мекунад, бозоғозӣ лозим нест.
AIHUMMER_MEMORY_RECALL
Ба ёд овардани худкори хотира
enum: strong \\| always \\| off
strong
фавран
Оё ёфтаҳои хотираро ба ҷавоб худкор илова кардан. «Танҳо мутобиқатҳои дақиқ» — далел бояд бо паём ҳадди ақал дар ду калимаи муҳим мувофиқ ояд; саломҳо ва «ок» хотираро намекашанд. «Ҳама чизи монанд» — ҳар чизе ки ба навъе мувофиқ омад ва сабтҳои алоқаманд: зиёдатӣ бештар. «Илова накардан» — агент ҳангоми зарурат худаш дар хотира меҷӯяд.
AIHUMMER_MEMORY_RECALL_MAX
Далелҳо барои як ҷавоб
int
5
фавран
Шумораи ҳадди аксари далелҳои хотира, ки ба як ҷавоб илова мешаванд (пешфарз 5). Баёнҳои гуногуни ҳамон як далел як ҳисоб мешаванд. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест.
AIHUMMER_MEMORY_RECALL_MIN_SCORE
Мутобиқати ҳадди ақал барои ба ёд овардани худкор, %
int
10
фавран
Далел бояд чанд фоизи калимаҳои маънодори паёмро (бо назардошти камёбӣ) фаро гирад, то худкор илова шавад. Пешфарз 10 — дар мукотибаи воқеӣ танзим шудааст. Бештар = камтар ва дақиқтар, камтар = бештар ва бо садои зиёдтар. Ба ҷустуҷӯи ошкори memory_search таъсир намерасонад. 0 — бе ҳад: ду калимаи маънодори мувофиқ кифоя аст. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест.
AIHUMMER_MEMORY_RECALL_MIN_SIMILARITY
Ҳадди ақали монандии маъноӣ барои иловаи худкор, %
int
86
фавран
Танҳо барои ҷустуҷӯи хотира аз рӯи маъно (эмбеддер): далел бояд аз ҷиҳати маъно ба паём то чӣ андоза наздик бошад, то худкор илова шавад, бо фоизи монандӣ. Пешфарз 86 — барои модели multilingual-e5-base дар хотираи воқеӣ интихоб шудааст: аз он поёнтар қариб ба ҳар паём далелҳои бегона илова мешаванд. Моделҳои дигар (масалан, bge-m3) монандиро дигар хел ҳисоб мекунанд — қиматро бо «Аз хотира пурсидан» дар корти агент интихоб кунед. 0 — бе ҳад. Ба ҷустуҷӯи ошкори memory_search таъсир намерасонад. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест.
AIHUMMER_MEMORY_RETRIEVAL
Реҷаи бозёбии хотира
enum: fulltext \\| embedding
fulltext
пас аз бозоғозӣ
Агент дар хотира чизи лозимиро чӣ гуна меҷӯяд. «Аз рӯи калимаҳо» — ҷустуҷӯи оддии матн: фавран кор мекунад ва серверро бор намекунад. «Аз рӯи маъно» — чизи аз ҷиҳати маъно наздикро меёбад, ҳатто бо калимаҳои дигар гуфташударо, вале модели ҷустуҷӯи маъноӣ (бахши «Хизматҳои иловагӣ») ва сарбории назарраси протсессор лозим аст.
AIHUMMER_QDRANT_API_KEY
Калиди API-и Qdrant
text
—
пас аз бозоғозӣ
Калиди API-и Qdrant, агар анбори векторӣ иҷозат талаб кунад. Танҳо ҳангоми муайян будани суроғаи Qdrant лозим аст. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_QDRANT_URL
URL-и Qdrant (анбори доимии векторӣ)
text
—
пас аз бозоғозӣ
Суроғаи анбори Qdrant барои ҷустуҷӯи маъноӣ. Холӣ — маълумоти ҷустуҷӯ дар хотира нигоҳ дошта мешавад ва ҳангоми бозоғози сервер гум мешавад; барои кори доимӣ суроға муқаррар кунед.
AIHUMMER_RAG_QUERY_EXPANSION
Бо модел дубора таҳрир кардани дархостҳо ба пойгоҳи дониш
bool
0
фавран
Пеш аз ҷустуҷӯ дар пойгоҳи дониш аз модели вазифаҳои хидматӣ 3 баёни дигари дархостро пурсидан ва бо ҳамааш ҷустуҷӯ кардан. Баъзан бештар меёбад, вале ин дар ҲАР ҷустуҷӯ даъвати иловагии модел аст (квота ва таъхир); агар модел ноком шавад, танҳо бо баёни аслӣ ҷустуҷӯ мешавад ва хато дар журнал ва натиҷаи ҷустуҷӯ дида мешавад. Бо пешфарз хомӯш: калимаҳо ба ҳар ҳол бо ҷустуҷӯи пурраматнӣ ёфт мешаванд. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест.
AIHUMMER_RERANKER_URL
URL-и сайдкари азнавтартиббандии RAG
text
—
пас аз бозоғозӣ
HTTP-URL-и сайдкари кросс-энкодер барои аз нав рутбабандии ҷустуҷӯи гибридӣ. Холӣ = аз нав рутбабандӣ хомӯш. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
Moderation
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_MODERATION
Модератсияи воридот
bool
1
фавран
«off» муҳофизати дарунсохтро аз jailbreak/prompt-injection хомӯш мекунад. Ҳар қимати дигар = фаъол. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест.
AIHUMMER_MODERATION_REFUSAL
Паёми радкунии модератсия
text
—
фавран
Матни радкунӣ, ки ҳангоми бастани дархост аз ҷониби модератор бармегардад (холӣ = дарунсохт). Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест.
Network
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_OUTBOUND_PROXY_CUSTOM_URL
Проксии баромад: нишонии худ
text
—
фавран
URL-и проксии HTTPS; HTTP танҳо барои loopback, бе роҳ, дархост ва фрагмент иҷозат аст. Аввал суроғаро захира кунед, баъд custom-ро интихоб кунед. Дар API пинҳон ва дар танзимоти барнома захира мешавад.
AIHUMMER_OUTBOUND_PROXY_MODE
Проксии баромад барои таъминкунандагони моделҳои хориҷӣ
enum: auto \\| off \\| custom
auto
фавран
Сервер ба таъминкунандагони хориҷии моделҳо чӣ тавр муроҷиат мекунад. «Мисли таъминкунанда» — тавре ки дар кабинети таъминкунанда муқаррар шудааст; «Мустақим, бе прокси» — бе миёнаравҳо; «Тавассути прокси худ» — тавассути суроғае, ки дар поён нигоҳ доштед. Кор кардан ё накардан аз қоидаҳои таъминкунандаи мушаххас вобаста аст.
AIHUMMER_RUSSIAN_TRUSTED_EXTRA_HOSTS
Хостҳои берун аз .ru барои решаҳои Вазорати рушди рақамии Русия
list
—
пас аз бозоғозӣ
Рӯйхати ҳостҳое, ки бо вергул ҷудо шудаанд, ки барои тафтиши решаҳои Вазорати рушди рақамии Русия OVER доменҳои русӣ иҷозат дода шудаанд (.ru/.su/.рф - аллакай дохил карда шудаанд). Агар гиреҳи шумо бо сертификати Вазорати рушди рақамии Русия дар домени дигар зиндагӣ кунад, лозим аст. Бо ном ё сарҳади зердомен мувофиқат кунед: example.com api.example.com-ро фаро мегирад. Холӣ = танҳо доменҳои русӣ. Ҳангоми оғоз/пас аз бозоғоз истифода мешавад.
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_CHANNEL_TURN_QUEUE_WAIT_SEC
Интизорӣ дар навбат: паёми канал (сония)
int 10…1200
600
фавран
Вақте ки ҳамаи ҷойҳои қадамҳо банданд, паёми канал (Telegram ва дигарон) ҷойи холиро чанд вақт интизор мешавад. Агар сари вақт ҷой наёбад, ба инсон хабар дода мешавад, ки сервер банд аст ва метавонад боз нависад. Интизорӣ ба ҳадди 30-дақиқаинаи қадам дохил мешавад. 10–1200. Фавран амал мекунад.
AIHUMMER_MAX_ACTIVE_TURNS
Қадамҳои агентҳо дар як вақт (тамоми сервер)
int 1…512
32
фавран
Сервер дар як вақт чанд қадами агентро (ҷавобҳо дар каналҳо ва веб-чат, ҷадвалҳо) иҷро мекунад. Боқимонда дар навбат то он қадар интизор мешаванд, ки танзимоти «Интизорӣ дар навбат» дар поён иҷозат медиҳанд, ва инсон «сервер банд аст, дар навбат» мебинад. Бештар — интизорӣ камтар, аммо хотира, пайвастҳо бо пойгоҳи додаҳо ва дархостҳои ҳамзамон ба модел бештар. Нисфи ин шумора дархостҳои ёрирасони ҳамзамони моделро (истихроҷи хотира, хулосаҳо) маҳдуд мекунад. 1–512. Фавран амал мекунад.
AIHUMMER_SYNC_INBOUND_QUEUE_WAIT_SEC
Интизорӣ дар навбат: дархости синхронии интегратсия (сония)
int 1…120
10
фавран
Вақте ки ҳамаи ҷойҳои қадамҳо банданд, дархости интегратсияе, ки ҷавобро дар ҳамон дархост интизор аст, ҷойи холиро чанд вақт интизор мешавад. Агар ҷой наёбад, интегратсия бо маслиҳати пас аз ҳамон миқдори сония такрор кардан «сервер банд аст» мегирад; такрор бо ҳамон рақами паём онро бори дуюм сабт намекунад. 1–120. Фавран амал мекунад.
AIHUMMER_WEB_TURN_QUEUE_WAIT_SEC
Интизорӣ дар навбат: паёми веб-чат (сония)
int 10…1200
180
фавран
Вақте ки ҳамаи ҷойҳои қадамҳо банданд, паёми веб-чат ҷойи холиро чанд вақт интизор мешавад. Дар ин муддат дар чат «сервер банд аст, дар навбат» намоён аст; агар сари вақт ҷой наёбад, ҷавоб бо тугмаи «Такрор» рад карда мешавад, ки пас аз аз нав боркунии саҳифа низ дар таърих мемонад. 10–1200. Фавран амал мекунад.
Public access
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_PUBLIC_URL
Суроғаи ҷамъиятии сервер
text
—
қисман пас аз бозоғозӣ
Суроғае, ки панел ва барномаҳо аз интернет кушода мешаванд, масалан https://ai.example.com . Онро тавассути прокси (nginx, Caddy) ба порти сервер равона кунед — бо пешфарз 8780.
AIHUMMER_WIDGET_ALLOWED_ORIGINS
Виджети веб: origin-ҳои иҷозатшудаи сайтҳо
list
—
фавран
Рӯйхати browser origin-ҳо бо вергул, ки метавонанд виджети веб-чатро ҷойгир кунанд, масалан https://example.com,https://www.example.com . Схема ва порт бояд дақиқ мувофиқат кунанд. Холӣ = ҳеҷ сайти беруна виджетро истифода бурда наметавонад. Сабти * қасдан нодида гирифта мешавад, зеро дар акси ҳол ҳар саҳифаи интернет метавонист буҷети ин инстансро сарф кунад.
POCKET_AGENT_GATEWAY_BASE_URL
URL-и оммавии дарвозаи pocket-agent
text
—
фавран
→ ба порти шлюзи pocket-agent прокси кунед (POCKET_AGENT_PORT, пешфарз 8080). Агенти дурдаст тавассути тикети яквақта ба ин ҷо пайваст мешавад.
TELEGRAM_PUBLIC_URL
URL-и оммавии вебхуки Telegram
text
—
фавран
Танҳо барои реҷаи webhook — → ба порти telegram-connector прокси кунед (пешфарз 8091). Барои реҷаи polling холӣ монед (URL-и ҷамъиятӣ лозим нест).
SSO (LDAP/AD)
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_LDAP_BASE_DN
DN-и базавии ҷустуҷӯи корбарон
text
—
пас аз бозоғозӣ
Ҷустуҷӯи реша, масалан. OU = Истифодабарандагон, DC = corp, DC = мисол.
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
—
пас аз бозоғозӣ
масалан. ldaps://ad.corp.example:636 (TLS) ё 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).
Schedules
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_SCHEDULE_AGENT_MAX_ACTIVE
Агент: ҳадди ҷадвалҳои фаъол
int
20
фавран
Як агент ҳангоми худаш сохтан ё фаъол кардани ҷадвал (бо абзорҳои ҷадвали худ) чанд ҷадвали фаъол дошта метавонад. Ҷадвалҳои дар панел сохташуда низ ба ҳисоб медароянд, аммо ба панел ҳеҷ гоҳ рад карда намешавад. Дар ҳадд аз агент хоҳиш мекунанд, ки аввал якеро боздорад ё нест кунад. Фавран амал мекунад.
AIHUMMER_SCHEDULE_AGENT_MAX_FIRES_PER_DAY
Агент: иҷроҳои ҷадвал дар як шабонарӯз
int
288
фавран
Ҳамаи ҷадвалҳои як агент якҷоя дар як шабонарӯз (аз рӯи UTC) чанд маротиба иҷро шуда метавонанд, аз ҷумла ҷадвалҳои дар панел сохташуда ва иҷроҳои дастӣ. Иҷроҳои болотар аз ҳадд гузаронида мешаванд ва дар маҷаллаи иҷроҳо намоёнанд. Фавран амал мекунад.
AIHUMMER_SCHEDULE_AGENT_MIN_INTERVAL_MINUTES
Агент: фосилаи ҳадди ақали ҷадвал, дақиқа
int
5
фавран
Кӯтоҳтарин фосила байни ду иҷрои ҷадвали такрорие, ки агент худаш месозад ё тағйир медиҳад. Ҷадвали зудтар рад карда мешавад. Ҷадвалҳои дар панел сохташуда бо ин маҳдуд намешаванд. Фавран амал мекунад.
AIHUMMER_SCHEDULE_COMMANDS
Фармонҳои сервер дар ҷадвалҳо
bool
0
фавран
Ба ҷадвал иҷозат медиҳад, ки дар ин сервер барнома иҷро кунад — ҷамъоваранда, ҳисобот, санҷиши нусхаи эҳтиётӣ. Бо пешфарз хомӯш аст. Танҳо фармонҳои рӯйхати «Фармонҳои иҷозатдодашуда», айнан тавре ки навишта шудаанд, иҷро мешаванд; shell нест. Баровард ба агент ё мустақиман ба чат меравад ва ҳар иҷро дар маҷаллаи иҷроҳои ҷадвал намоён аст. Фавран амал мекунад.
AIHUMMER_SCHEDULE_COMMANDS_ALLOWLIST
Фармонҳои иҷозатдодашуда
argvlist
—
фавран
Фармонҳои дақиқе, ки ҷадвал метавонад иҷро кунад: барнома (номе мисли df ё роҳи пурра) ва аргументҳои он. Ҷадвал танҳо фармонеро иҷро мекунад, ки бо аргументҳояш ба сабт пурра мувофиқ аст. Фармони хориҷшуда ҷадвалҳоеро, ки онро истифода мебаранд, қатъ мекунад ва иҷроҳои онҳо сабабро мегӯянд. Фавран амал мекунад.
AIHUMMER_SCHEDULE_COMMANDS_MAX_OUTPUT_KB
Ҳадди бароварди фармони ҷадвал, КБ
int 1…1024
64
фавран
Чӣ қадар аз бароварди фармон (1–1024 КБ) дар маҷаллаи иҷроҳо нигоҳ дошта шуда, ба агент ё чат дода мешавад; боқимонда бурида мешавад ва маҷалла инро мегӯяд. Фавран амал мекунад.
AIHUMMER_SCHEDULE_COMMANDS_SANDBOX
Фармонҳои ҷадвалро дар қуттии регии СО иҷро кардан
bool
1
фавран
Фаъол: фармон мисли иҷрои код дар қуттии регии СО кор мекунад — сирҳои насб ва калидҳои SSH пинҳон карда мешаванд ва он танҳо ба ҷузвдони муваққатии худ навишта метавонад. Агар дар сервер қуттии регӣ (bubblewrap) набошад, фармон иҷро намешавад ва маҷалла сабабро мегӯяд. Хомӯш: он бо ҳуқуқҳои дарвоза кор мекунад. Фавран амал мекунад.
AIHUMMER_SCHEDULE_FAILURE_ADMIN
Дар бораи нокомиҳои супоришҳо ба маъмур хабар додан
bool
1
фавран
Агар супориши банақшагирифта иҷро нашавад ё оғоз шуда натавонад, дар зангӯлаи огоҳиҳои панел огоҳӣ бо номи он, сабаб ва ҷое, ки онро ислоҳ кардан мумкин аст, пайдо мешавад ва ҳамин паём ба чатҳои шахсии каналии соҳибон фиристода мешавад (барои ҳар супориш на бештар аз як бор дар 6 соат). Ин илова ба паём ба гирандаи супориш аст. Хомӯш: маъмур дар бораи нокомиҳо танҳо аз журнали иҷроҳо огоҳ мешавад. Фавран амал мекунад.
AIHUMMER_SCHEDULE_FAILURE_NOTIFY
Дар бораи нокомии вазифа ба гиранда хабар додан
bool
1
фавран
Агар вазифаи ҷадвалӣ иҷро нашавад, ба ҳамон гиранда паёми кӯтоҳ фиристода мешавад (пас аз нокомии аввал, на бештар аз як бор дар 6 соат). Хомӯш — нокомиҳо танҳо дар маҷаллаи иҷроҳо дида мешаванд. Барои вазифаи алоҳида инро дар шакли он хомӯш кардан мумкин аст. Фавран амал мекунад.
Security
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_AIRGAPPED
Реҷаи ҷудошуда (бе интернет)
bool
0
фавран
Ба агентҳо баромадан ба интернетро манъ мекунад: ҷустуҷӯи веб, кушодани саҳифаҳо ва дархостҳо танҳо ба суроғаҳои дохилӣ ва суроғаҳои рӯйхатҳои иҷозатдодашуда мерасанд. Барои шабакаҳои пӯшида бе баромад ба берун фаъол кунед.
AIHUMMER_AUDIT_RETENTION_DAYS
Маҷаллаи амалҳоро чанд рӯз нигоҳ доштан
int
0
пас аз бозоғозӣ
Сабтҳои лоҷи аудит ва таърихи тағйироти танзимот, ки аз ин мӯҳлат кӯҳнаанд, рӯзе як бор нест карда мешаванд. 0 ё холӣ — ҳамеша нигоҳ доштан.
AIHUMMER_CORS_ORIGINS
Origin-ҳои иҷозатдодашуда барои CORS
list
—
пас аз бозоғозӣ
Рӯйхати Origin-ҳои иҷозатдодашуда бо вергул. Холӣ = CORS иҷозат дода намешавад (танҳо same-origin). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_CSP
Сарлавҳаи Content-Security-Policy (бознависӣ)
text
—
пас аз бозоғозӣ
Сарлавҳаи CSP-ро бознависӣ мекунад. Холӣ = пешфарзи бехатар. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_INBOUND_SECRET
Калиди пайвасти плагинҳои канал бо сервер
text
—
пас аз бозоғозӣ
Каналҳои пайвастшуда (Telegram, VK ва дигарон) бо он тасдиқ мекунанд, ки паёмҳо маҳз аз онҳо омадаанд. Ҳангоми насб худкор муқаррар мешавад — иваз кардан лозим нест. Агар холӣ бошад, то муқаррар шудани калид сервер ҳамаи каналҳоро рад мекунад.
AIHUMMER_OPENAI_COMPAT_KEY
Вуруди мутобиқ бо OpenAI: калиди статикии API
text
—
пас аз бозоғозӣ
Калиди умумӣ барои барномаҳое, ки ба сервер ҳамчун хизмати мутобиқ ба OpenAI пайваст мешаванд. Холӣ — калиди умумӣ хомӯш аст; бо калидҳои шахсӣ аз саҳифаи «Калидҳои API» пайваст шудан мумкин аст.
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
Проксиҳои боэътимод
list
—
фавран
Агар дар пеши сервер прокси (nginx, Caddy, мувозинатгар) бошад, суроға ё шабакаи онро бо вергул нависед, масалан 10.0.0.0/8. Он гоҳ дар маҷаллаи амалҳо, рӯйхати IP-ҳои иҷозатдодашуда ва ҳифз аз интихоби парол суроғаи воқеии меҳмон дида мешавад. Холӣ — танҳо суроғаи пайвасти мустақим ба ҳисоб гирифта мешавад ва онро иваз кардан ғайриимкон аст.
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_BROWSER_ALLOWED_HOSTNAMES
Браузер: истисноҳои мизбони хусусӣ
list
—
фавран
Номҳои дақиқ бо вергул, бе қолаб, URL ва порт. Истисноҳои иловагии хусусӣ барои CDP-и маҳаллӣ дар сервери худ, ҷудо аз web_fetch.
AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK
Браузер: иҷозаи шабакаи хусусӣ
bool
—
фавран
Холӣ қоидаи пешинаро нигоҳ медорад; true ё false санҷиши CDP-и маҳаллиро фаъол мекунад. Дастрасии хусусӣ танҳо дар сервери худ. Loopback, link-local ва metadata баста мемонанд.
AIHUMMER_BROWSER_PROFILE_SOCKET
Сокети идораи профилҳои браузер
text
—
фавран
Ихтиёрӣ. Холӣ бошад — шлюз сокети идоракунии managed-profiles.sock-и хидмати браузерро дар ҷои стандартии насб худаш меёбад. Профилҳои воридшуда ба сайтҳо дар саҳифаи «Пайвастҳо» → «Профилҳои браузер» сохта мешаванд. Ин URL нест ва роҳ ба профили аслӣ ҳам нест.
AIHUMMER_CODE_EXEC
Иҷрои код аз ҷониби агент
enum: off \\| host \\| sandbox
off
фавран
Абзори иҷрои коди агент (code_exec). Бо пешфарз — «Хомӯш». «Дар ҳамин сервер»: фармонҳо дар сервери шлюз иҷро мешаванд; муҳити ҷудошудаи СА (bubblewrap) сирҳои насбро пинҳон мекунад, аммо агент дар реҷаи «Бе маҳдудият» калидҳои SSH-ро мебинад ва метавонад берун аз ҷузвдони худ нависад — танҳо барои сервери боэътимод. «Танҳо дар муҳити ҷудошуда»: ҳамеша дар муҳити ҷудошудаи СА — сирҳо ва калидҳо пинҳонанд, навиштан танҳо ба ҷузвдони агент; бе bubblewrap (ё тасвири контейнер) ин реҷа нигоҳ дошта намешавад. Он чи ҳар агент метавонад иҷро кунад, дар худи агент муайян мешавад: «Агентҳо → профил → Абзорҳо».
AIHUMMER_CODE_EXEC_INTERPRETERS
Интерпретаторҳои code-exec (JSON)
text
—
фавран
Объекти JSON {language: path_to_binary}, мас. {\“python\”:\“/usr/bin/python3\”}. Холӣ = муайянкунии худкор.
AIHUMMER_CODE_EXEC_NET_PORTS
Портҳои шабакаи барои рамзи агент кушода
list
53,80,443
фавран
Портҳои TCP, ки рамзи агент дар қуттии регии системаи амалиётӣ (иҷрои рамз ва фармонҳои ҷадвал) метавонад ба онҳо пайваст шавад, бо вергул ҷудо. Бо пешфарз 53, 80 ва 443: DNS ва сомонаҳо. Хидматҳои дигари ин сервер ва шабакаи маҳаллии он (пойгоҳи додаҳо, лавҳаи идоракунӣ, браузер, adb, моделҳои маҳаллӣ, Home Assistant) барои рамзи агент пӯшида мемонанд. Порти рӯйхат дар ҳар суроға, аз ҷумла дар ин сервер кушода аст, пас танҳо он чиро илова кунед, ки ба рамз лозим аст, масалан 22 барои SSH. Барои бекор кардани маҳдудият any нависед. Агентҳо дар реҷаи «Бе маҳдудият» маҳдуд намешаванд. Linux 6.7 ё навтар лозим аст; бе он маҳдудият амал намекунад ва дар Агентҳо → Абзорҳо дар ин бора гуфта мешавад. Фавран амал мекунад.
AIHUMMER_CODE_EXEC_READ_DIRS
Ҷузвдонҳои барои хондани рамзи агент кушода
list
—
фавран
Ҷузвдонҳои ин сервер, ки рамзи агент метавонад хонад: иҷрои рамз ва фармонҳои ҷадвал дар қуттии регии системаи амалиётӣ. Бо вергул ё дар ҳар сатр як, масалан ~/reports. Шумо метавонед як файли алоҳидаро низ нишон диҳед, масалан ~/scripts/report.py. Он чи дар ин ҷо кушода мешавад, ба рамзи ҳамаи агентҳо намоён аст, пас танҳо он чиро кушоед, ки ба рамз лозим аст. Бо пешфарз холӣ: дар қуттии регӣ рамз танҳо ҷузвдони агенти худ ва ҷузвдонҳои системавиро мебинад; ҷузвдони хонагии корбари дарвоза, маълумоти насб, ҷузвдонҳои агентҳои дигар, калидҳо ва таърихи фармонҳо пинҳон мемонанд. Решаро, тамоми ҷузвдони хонагӣ, маълумоти насб ва ҷойҳои калиддорро кушодан мумкин нест. Рамз ба ин ҷузвдонҳо навишта наметавонад. Дарҳол амал мекунад.
AIHUMMER_CODE_EXEC_SANDBOX_IMAGE
Тасвири песочкаи code-exec
text
—
фавран
Ихтиёрӣ, танҳо барои реҷаи «Танҳо дар муҳити ҷудошуда»: тасвири контейнери Docker ба ҷои муҳити ҷудошудаи СА (бе шабака, решаи танҳо барои хондан, маҳдудиятҳо); дар сервер Docker лозим аст. Холӣ = муҳити ҷудошудаи СА (bubblewrap).
AIHUMMER_CODE_EXEC_TIMEOUT_SECONDS
Маҳдудияти вақти иҷрои код (сония)
int
1800
фавран
Як фармони агент, аз ҷумла фармонҳои заминавӣ, чӣ қадар кор карда метавонад: аз 10 сония то 24 соат. Фармоне, ки дар 30 сония ҷавоб надод, қатъ намешавад, балки ба замина мегузарад ва агент онро бо абзори process месанҷад. Агент метавонад мӯҳлати кӯтоҳтар талаб кунад, на дарозтар.
AIHUMMER_DB_QUERY_DSN
Пайвастшавӣ ба пойгоҳ барои абзори «Дархост ба пойгоҳ»
text
—
фавран
Сатри пайвастшавӣ ба пойгоҳи додаҳо, ки агент хонда метавонад (танҳо хондан), масалан postgres://reader:парол@host/db. Корбари дорои ҳуқуқҳои ҳадди ақалро нишон диҳед — на соҳиби пойгоҳро. Холӣ — абзор хомӯш аст.
AIHUMMER_FS_ROOT
Решаи абзори системаи файлӣ
text
—
фавран
Ҷузвдоне, ки дар доираи он агент файлҳои серверро мехонад (filesystem_read; агент файл навишта наметавонад). Холӣ = тамоми сервер бо ҳуқуқҳои корбари дарвоза, ба истиснои сирҳо: танзимоти насб (gateway.env), калидҳои SSH/GPG ва муҳити равандҳо. Барои маҳдуд кардани дастрасӣ ҷузвдонро нишон диҳед.
AIHUMMER_HTTP_ALLOWLIST
Суроғаҳо барои дархостҳои HTTP-и агент
list
—
фавран
Рӯйхати хостҳо бо вергул, ки абзори http_request метавонад ба онҳо муроҷиат кунад. Холӣ = ҳама иҷозат дода мешаванд, ба ҷуз суроғаҳои дохилӣ ва хусусӣ.
AIHUMMER_HTTP_AUTH_JSON
Авторизатсияи http_request (JSON)
text
—
фавран
Харитаи JSON-и мутобиқати хост ба сарлавҳаҳои иҷозат барои абзори http_request, то токенҳо дар промпт нигоҳ дошта нашаванд. Холӣ = бе иҷозат.
AIHUMMER_MCP_SERVERS
Серверҳои MCP (JSON)
text
—
фавран
Тавсифи JSON-и серверҳои берунии MCP, ки абзорҳояшон ба агент васл мешаванд. Холӣ = MCP-и берунӣ нест.
AIHUMMER_PROJECT_STUDIOS_PUBLIC_NETWORK
Студияҳои лоиҳаҳо: шабакаи умумӣ
bool
false
фавран
HTTP(S)-и умумиро барои провайдерҳои интихобшуда ва боргириҳои ошкоро дархостшудаи моделҳо иҷозат диҳед. Нишониҳои хусусӣ, маҳаллӣ ва метамаълумот баста мемонанд. Ҳолати офлайн бартарӣ дорад. Фавран татбиқ мешавад.
AIHUMMER_SIDECAR_CLOAKBROWSER
Браузер барои агент (CloakBrowser)
bool
0
фавран
Браузери зидди ошкор (асбобҳои CloakBrowser, browser/computer). Он чизе, ки ба бастаи таҳвил дохил карда нашудааст: дохилкунӣ иловаи имзошударо зеркашӣ мекунад (~ 477 МБ, аз он Chromium ~ 207 МБ) ва хидматро дар ҳост насб мекунад. Вазнинтарин вагонҳои паҳлӯӣ - танҳо дар ҳолате фаъол созед, ки агент бояд вебсайтҳоро кушояд.
AIHUMMER_SIDECAR_SEARXNG
Ҷустуҷӯи веб (SearXNG)
bool
0
фавран
Ҷустуҷӯи веб (SearXNG, web_search асбоб). Ба баста дохил НЕСТ: фурӯзон кардани замимаи имзошуда (~154 МБ) зеркашӣ карда, хидматро дар ҳост насб мекунад, хомӯш кардани он онро қатъ мекунад ва ҷой холӣ мекунад. Насбкунӣ дар замина сурат мегирад ва чанд дақиқа мегирад; давлат дар ин ҷо нишон медиҳад, ки дар асл дар сервер аст,.
AIHUMMER_WEBFETCH_ALLOWLIST
Сайтҳое, ки агент кушода метавонад
list
—
фавран
Рӯйхати доменҳо бо вергул, ки абзори web_fetch метавонад ба онҳо муроҷиат кунад. Холӣ = ҳама иҷозат дода мешаванд, ба ҷуз суроғаҳои дохилӣ ва хусусӣ.
AIHUMMER_WEB_SEARCH_LANGUAGE
Ҷустуҷӯи веб: забони пешфарзи натиҷаҳо
text
auto
фавран
Забони натиҷаҳо, вақте ки агент онро нишон намедиҳад: рамз ба монанди ru, en ё de, ё auto барои муайян кардан аз худи дархост (қариб ҳамеша мувофиқ аст). Агент метавонад барои ҷустуҷӯи мушаххас забони дигар интихоб кунад.
AIHUMMER_WEB_SEARCH_RESULTS
Ҷустуҷӯи веб: натиҷаҳо дар як ҷустуҷӯ
int
5
фавран
Ҷустуҷӯ чанд натиҷа бармегардонад, вақте ки агент шумораи дигар намехоҳад: аз 1 то 10. Натиҷаҳои бештар ҷавоби пурратар медиҳанд, аммо контекст дарозтар мешавад.
AIHUMMER_WEB_SEARCH_SOURCE
Манбаи ҷустуҷӯи веб
enum: auto \\| searxng \\| provider
auto
фавран
Агент дар интернет аз куҷо ҷустуҷӯ мекунад (абзори web_search). auto — SearXNG, агар насб бошад, вагарна ҷустуҷӯи дарунсохти провайдери модел. searxng — танҳо SearXNG: бе он ҷустуҷӯ нест. provider — ҷустуҷӯи дарунсохти провайдер дар ҷое ки ҳаст, ва SearXNG барои моделҳои дигар. Ҷустуҷӯи дарунсохт дар Codex (обунаи ChatGPT) ва OpenAI (api.openai.com) ҳаст; дар GigaChat, YandexGPT ва дигар моделҳои мувофиқ бо OpenAI нест — бе SearXNG агентҳо дар ин моделҳо ҷустуҷӯ намекунанд. Claude (api.anthropic.com ва обунаи Claude) ҷустуҷӯи дарунсохти Anthropic-ро истифода мебарад; агар ҳисоб онро рад кунад, шлюз инро дар маҷалла менависад ва минбаъд ба агент танҳо SearXNG пешниҳод мекунад. Ба кадом агентҳо ҷустуҷӯ иҷозат аст, мисли пештара дар корти агент муқаррар мешавад. Аз қадами навбатӣ амал мекунад.
AIHUMMER_WEB_SEARCH_TIMEOUT_SECONDS
Муҳлати ҷустуҷӯи веб (сония)
int
30
фавран
Барои ҳар ҷустуҷӯ1–600 сония. Муҳлати кӯтоҳтари вазифа боқӣ мемонад.
Updates
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_RESTART_APPLY
Татбиқи танзимоте, ки бозоғозиро талаб мекунанд
enum: quiet \\| manual
quiet
фавран
quiet (пешфарз) — танзимоти захирашуда, ки танҳо бо оғози нави дарвоза эътибор пайдо мекунанд, худашон татбиқ мешаванд: дарвоза дар наздиктарин лаҳзаи ором, вақте ки агентҳо ҳеҷ кор намекунанд ва одамон на камтар аз равзанаи хомӯшӣ хомӯшанд, аз нав оғоз мешавад. manual — танҳо нишонаи «интизори бозоғозӣ» ва тугма. Бозоғозӣ чанд сония давом мекунад; суҳбатҳо ва вазифаҳо гум намешаванд. Фавран эътибор пайдо мекунад.
AIHUMMER_RESTART_QUIET_MINUTES
Лаҳзаи ором: дақиқаҳои хомӯшӣ пеш аз бозоғозии худкор
int 0…1440
10
фавран
Одамон чанд дақиқа бояд хомӯш бошанд (ва агентҳо бекор), то дарвоза худаш аз нав оғоз шуда, танзимоти захирашударо татбиқ кунад. 0 — ҳамин ки агентҳо кори ҷориро анҷом диҳанд. 0–1440. Фавран эътибор пайдо мекунад.
Web UI (separate port)
Калид
Ном
Навъ
Пешфарз
Ба амал медарояд
Чӣ мекунад
AIHUMMER_WEBUI_API_BASE
Суроғаи сервер барои панели алоҳида ҷойгиршуда
text
—
пас аз бозоғозӣ
Танҳо вақте лозим аст, ки панел аз суроғаи дигар ғайр аз худи сервер кушода шавад. Суроғаеро нишон диҳед, ки браузер ба сервер мерасад, масалан https://api.example.com . Холӣ — суроғаи ҷамъиятии сервер, агар набошад — суроғаи маҳаллӣ истифода мешавад.
AIHUMMER_WEBUI_ENABLED
Панел дар порти алоҳида
bool
1
пас аз бозоғозӣ
Фаъол — панел дар порти дохилии алоҳида кушода мешавад, ки онро аз интернет бастан мумкин аст, порти ҷамъиятӣ бошад танҳо ба барномаҳо ва каналҳо хизмат мекунад. Барои тамоман дастнорас кардани панел хомӯш кунед.
AIHUMMER_WEBUI_ORIGIN
Суроғае, ки панелро мекушоянд
text
—
пас аз бозоғозӣ
Пур кунед, агар панелро тавассути прокси ё бо номе кушоянд, ки аз суроғаи порташ фарқ мекунад, масалан https://admin.example.com . Сервер ба браузер аз ин суроға иҷозат медиҳад, ки ба он муроҷиат кунад. Холӣ — суроғаи порти панел гирифта мешавад.
Танзимоти барои оператор дастрас: 237.
← Қаблӣ
Иловаи барнома барои мобилӣ ва мизи корӣ
Баъдӣ →
Муҳити тағйирёбанда
Дар ин ҷо ҳамаи танзимоте оварда шудаанд, ки оператор дар сервери AiHummer тағйир дода метавонад. Саҳифа аз каталоги худи маҳсулот сохта мешавад, бинобар ин ба сервери шумо мувофиқ аст.
Қимат дар веб-интерфейс ё бо фармони `aihummer settings set KEY VALUE` дода мешавад ([Сатри фармон](/tg/v1.4/reference/cli/)). Сутуни қимати пешфарз он чизеро нишон медиҳад, ки сервер то додани қимати шумо истифода мебарад.
> [!NOTE]
> Қиматҳои махфӣ дар ин ҷо чоп намешаванд, калидҳои хизматии таъминкунанда бошанд, тамоман оварда намешаванд — маҳсулот онҳоро аз ҳамаи рӯйхатҳо пинҳон мекунад. Тире қимати холӣ ё шарҳеро мефаҳмонад, ки танҳо дар веб-интерфейс нишон дода мешавад.
## API
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_PERSONAL_API_KEYS` | Калидҳои шахсии API барои API-и мутобиқ бо OpenAI | `bool` | `1` | пас аз бозоғозӣ | \\"off\\" аутентификатсияро бо калидҳои шахсӣ дар эндпоинти мувофиқи OpenAI хомӯш мекунад. Ҳар қимати дигар = фаъол. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
## Agent
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_AGENT_ANNOUNCE_SLOW_TOOLS` | Агент: пеш аз амалҳои дароз огоҳ кардан | `bool` | `1` | фавран | Пеш аз амали дароз (тасвир, ҷустуҷӯи амиқ, видео, супориш ба зерагент) агент мухтасар менависад, ки чӣ кор мекунад, то интизорӣ хомӯш набошад. Агар чунин паёмҳо халал расонанд, хомӯш кунед. |
| `AIHUMMER_AGENT_COMPACT_AT_PCT` | Агент: таърихро ҳангоми пуршавӣ фишурдан, % ҷои он | `int 50…99` | `85` | фавран | Вақте ки таърихи сӯҳбат ин қадар фоизи ҷои ба он ҷудошуда дар равзанаи моделро ишғол кунад, паёмҳои кӯҳна ба хулоса ҷамъ мешаванд — дар замина, пас аз ҷавоб, гардиш интизор намешавад. Пасттар — фишурдан зудтар, аммо модел айнан камтар дар ёд дорад; баландтар — камтар, аммо гардишҳо вазнинтар. 50–99; барои агент қимати худро муайян кардан мумкин аст. |
| `AIHUMMER_AGENT_COMPACT_TO_PCT` | Агент: пас аз фишурдан нигоҳ доштан, % ҷои таърих | `int 10…90` | `50` | фавран | Пас аз фишурдан чанд фоизи ҷои таърих айнан мемонад; ҳама чизи кӯҳнатар ба хулоса меравад. Бояд аз ҳадди фишурдан пасттар бошад: фарқи байни онҳо нишон медиҳад, ки то фишурдани навбатӣ чанд гардиш мегузарад. 10–90; барои агент қимати худро муайян кардан мумкин аст. |
| `AIHUMMER_AGENT_HISTORY_TURNS` | Агент: навбатҳои гуфтугӯ, ки айнан нигоҳ дошта мешаванд | `int 1…1000` | `30` | фавран | Модел чанд навбати охирини гуфтугӯро айнан мебинад (то вақти фишурдан боз то 10 зиёдтар). Паёмҳои кӯҳна дар замина ба хулоса табдил меёбанд; худи гуфтугӯ ҳеҷ гоҳ нест карда намешавад. Равзанаи контексти модел худкор ба назар гирифта мешавад. 1–1000; барои агент қимати алоҳида гузоштан мумкин аст. |
| `AIHUMMER_AGENT_MAX_ITERATIONS` | Агент: ҳадди аксари қадамҳои асбоб дар як навбат | `int 1…256` | `25` | фавран | Агент пеш аз ҷавоб додан дар як навбат чанд маротиба асбобҳоро даъват карда метавонад. Дар ҳад навбат ноком намешавад: агент мегӯяд, ки чӣ иҷро шуд ва чӣ монд, ва шумо метавонед хоҳиш кунед, ки идома диҳад. Се даъвати якхела пайиҳам бо ҳамон натиҷа навбатро барвақттар қатъ мекунад. 1–256; барои агент қимати алоҳида гузоштан мумкин аст. |
| `AIHUMMER_AGENT_MEMORY_FLUSH` | Агент: пеш аз фишурдан қайдро дар хотира нигоҳ доштан | `bool` | `1` | фавран | Пеш аз он ки паёмҳои кӯҳна ба хулоса муттаҳид шаванд, агент қайди кӯтоҳро дар бораи ҳадафҳо, қарорҳо ва корҳои кушода дар хотира менависад. Барои сарфаи даъвати модел хомӯш кунед. |
| `AIHUMMER_AGENT_MEMORY_FLUSH_PROMPT` | Агент: дар ёддошт пеш аз фишурдан чӣ сабт шавад | `text` | — | фавран | Супориши худи шумо барои ёддошт пеш аз фишурдан: аз паёмҳое, ки ба хулоса мераванд, чӣ нигоҳ дошта шавад (масалан, «танҳо харидҳо, мӯҳлатҳо ва созишҳоро навис»). Холӣ — дарунсохт: ҳадафҳо, қарорҳо, корҳои анҷомнаёфта. Ҳифз хомӯш намешавад: матни гуфтугӯ маълумот боқӣ мемонад, на дастур, ва паролҳо ва калидҳо сабт намешаванд. То 4000 аломат; агент метавонад супориши худро дошта бошад. |
| `AIHUMMER_AGENT_NEW_REMINDERS_MEMORY` | Агентҳои нав: ёдраскуниҳо ва сабт дар хотира | `bool` | `1` | фавран | Агенти наве, ки дастӣ сохта шудааст (устои оғози аввал, «Сохтани агент», API), аз қадами аввал худаш ёдраскуниҳо ва ҷадвалҳои ХУДРО мегузорад, тағйир медиҳад ва бекор мекунад ва далелҳоро ба хотираи худ менависад — мисли қолаби ёрдамчии шахсӣ. Барои агенти алоҳида ин дар корти он («Имкониятҳо») хомӯш карда мешавад. Қолабҳои китобхона интихоби худро муайян мекунанд, нусхаи агент ҳуқуқҳои аслро нигоҳ медорад, агентҳое, ки агенти дигар сохтааст, бе онҳо оғоз мекунанд; агентҳои мавҷуда тағйир намеёбанд. Барои агенти навбатии сохташаванда амал мекунад. |
| `AIHUMMER_AGENT_PROMPT_PART_MAX_CHARS` | Агент: ҳадди аломатҳо барои як қисми промпт | `int 1000…1000000` | `20000` | фавран | Модел аз ЯК қисми шахсияти агент — бахши профил, қисми промпт ё промпти асосӣ — чанд аломат мегирад. Дар қисми дарозтар ибтидо (3/4) ва охир (1/4) бо қайди он ки чӣ қадар бурида шуд, нигоҳ дошта мешаванд; ин дар корти сӯҳбат ва дар таркиби промпти агент намоён аст. Ном, тарзи муроҷиат ва маҳдудиятҳои шахсият ҳеҷ гоҳ бурида намешаванд. 1000–1000000; барои агент қимати худро гузоштан мумкин аст. |
| `AIHUMMER_AGENT_PROMPT_TOTAL_MAX_CHARS` | Агент: ҳадди умумии аломатҳои шахсият | `int 1000…2000000` | `60000` | фавран | Ҳадди умумии шахсияти агент: ҳамаи қисмҳо якҷоя. Агар аз он гузарад, аввал қисмҳои дарозтарин ҷой медиҳанд ва қисмҳои кӯтоҳ пурра мемонанд. 1000–2000000; барои агент қимати худро гузоштан мумкин аст. |
| `AIHUMMER_AGENT_SELF_INTRO` | Агент: худро муаррифӣ кардан | `enum: first_contact \\\| each_dialog \\\| never` | `first_contact` | фавран | «Як бор, ҳангоми шиносоии аввал» — агент дар аввалин суҳбат бо шахс, агар ӯ фавран ба кор гузаштанро нахоҳад, худро мухтасар муаррифӣ мекунад; ба шахси шинос дубора худро муаррифӣ намекунад ва ба салом табиӣ ҷавоб медиҳад. «Худро муаррифӣ накардан» — агент ҳеҷ гоҳ худро худаш ном намебарад. «Дар оғози ҳар суҳбати нав» — дар оғози ҳар суҳбати нав ва пас аз танаффуси дароз, мухтасар ва бе хулосаи корҳои гузашта. Агент метавонад дар корти худ («Контекст ва рафтор») интихоби дигар дошта бошад. |
| `AIHUMMER_AGENT_SESSION_IDLE_RESET_MINUTES` | Агент: пас аз хомӯшӣ сӯҳбатро аз нав оғоз кардан (дақиқа) | `int 0…525600` | `360` | фавран | Барои реҷаҳои «пас аз хомӯшӣ» ва «ҳар рӯз ва пас аз хомӯшӣ»: агар шахс пас аз хомӯшии дарозтар аз ин нависад, агент сӯҳбатро аз нав оғоз мекунад. Барои агентҳое амал мекунад, ки дар кортаашон қимати худ муқаррар нашудааст. 0 — на аз рӯи хомӯшӣ. 0–525600; 360 = 6 соат, 1440 = як шабонарӯз. |
| `AIHUMMER_AGENT_SESSION_INDEX_MAX_ENTRIES` | Агент: дар рӯйхат на бештар аз ин қадар сеанс нигоҳ доштан | `int 0…100000` | `0` | фавран | Аввал хомӯштаринҳо мебароянд; ҳеҷ чиз нест карда намешавад. 0 — бе маҳдудият. 0–100000. Барои агентҳое, ки дар кортаашон арзиши худ надоранд, амал мекунад. |
| `AIHUMMER_AGENT_SESSION_INDEX_PRUNE_DAYS` | Агент: пас аз ин қадар рӯзи хомӯшӣ аз рӯйхати сеансҳо баровардан | `int 0…3650` | `0` | фавран | Ҳеҷ чиз нест карда намешавад: сӯҳбат аз рӯйхат мебарояд ва бо паёми нав бармегардад. 0 — нигоҳ доштан. 0–3650. Барои агентҳое, ки дар кортаашон арзиши худ надоранд, амал мекунад. |
| `AIHUMMER_AGENT_SESSION_RESET_AT_HOUR` | Агент: соати ҳаррӯзаи аз нав оғоз кардан | `int 0…23` | `4` | фавран | Барои реҷаҳои «ҳар рӯз»: суҳбате, ки пеш аз ин соат оғоз шудааст, аз паёми навбатии шахс аз нав оғоз мешавад. Соат аз рӯи минтақаи вақти сервер аст (танзими «Минтақаи вақт» дар «Система ва танзимот»). 0–23; 4 — шаб, вақте ки қариб ҳеҷ кас наменависад. |
| `AIHUMMER_AGENT_SESSION_RESET_GROUP_IDLE_MINUTES` | Агент: пас аз хомӯшӣ чати умумиро аз нав оғоз кардан (дақиқа) | `int 0…525600` | `0` | фавран | Барои чатҳои умумӣ дар реҷаҳои «пас аз хомӯшӣ» ва «ҳар рӯз ва пас аз хомӯшӣ»: дақиқаҳои хомӯшӣ, ки пас аз онҳо чати умумӣ аз нав оғоз мешавад. 0 — мисли чатҳои шахсӣ. 0–525600. |
| `AIHUMMER_AGENT_SESSION_RESET_GROUP_MODE` | Агент: чати умумӣ кай аз нав оғоз мешавад | `enum: inherit \\\| daily \\\| idle \\\| both \\\| none` | `inherit` | фавран | Қоидаи алоҳида барои чатҳои умумӣ (гурӯҳҳои Telegram, сӯҳбатҳои VK, чатҳои MAX ва дигарон): мисли чатҳои шахсӣ, ҳар рӯз дар соати барқарорсозӣ, пас аз хомӯшӣ, кадоме ки пештар расад, ё ҳеҷ гоҳ. Соати барқарорсозӣ умумӣ аст. Ба агентҳое дахл дорад, ки дар корти худ қоидаи худро надоранд. |
| `AIHUMMER_AGENT_SESSION_RESET_MODE` | Агент: сӯҳбат кай аз нав оғоз мешавад | `enum: idle \\\| daily \\\| both \\\| none` | `idle` | фавран | Агент сӯҳбатро кай аз нав оғоз мекунад: ҳар рӯз дар соати барқарорсозӣ (аз рӯи минтақаи вақт дар танзимот), пас аз хомӯшӣ, ҳар кадом, ки пештар ояд, ё ҳеҷ гоҳ. Ҳангоми аз нав оғоз кардан агент дар хотираи худ қайде дар бораи сӯҳбати гузашта менависад ва гардиши якуми он хулосаи пештара ва паёмҳои охиринро мегирад; худи паёмҳо дар бойгонӣ ва ҷустуҷӯ боқӣ мемонанд. Барои агентҳое амал мекунад, ки дар кортаашон қоидаи худ надоранд; дар он ҷо барои чатҳои умумӣ қоидаи алоҳида гузоштан мумкин аст. |
| `AIHUMMER_AGENT_SESSION_SCOPE` | Агент: сӯҳбатҳои шахсӣ куҷо ҷамъ мешаванд | `enum: chat \\\| per-channel-peer \\\| per-peer` | `chat` | фавран | «Як барои ҳар шахс» Telegram, барнома ва дигар чатҳои шахсии як одамро ба як сӯҳбат муттаҳид мекунад. Чатҳои гурӯҳӣ ҳамеша сӯҳбати худро нигоҳ медоранд. Аз паёми навбатӣ амал мекунад. Барои агентҳое, ки дар кортаашон арзиши худ надоранд, амал мекунад. |
| `AIHUMMER_AGENT_SILENT_REPLY` | Агент: метавонад хомӯш монад | `enum: groups \\\| all \\\| off` | `groups` | фавран | Дар чатҳои умумӣ агент метавонад хомӯш монад, агар паём ба ӯ равона нашуда бошад ё чизе барои илова надошта бошад; дар мукотибаи шахсӣ ҳамеша ҷавоб медиҳад. Хомӯширо дар мукотибаи шахсӣ низ иҷозат додан ё хомӯш кардан мумкин аст. Қадами хомӯш чизе намефиристад, дар корти гуфтугӯ ҳамчун «агент хомӯш монд» қайд мешавад ва модел онро дар таърих намебинад. Аз қадами навбатӣ амал мекунад. |
| `AIHUMMER_AGENT_SKILLS_PROMPT_MAX_CHARS` | Агент: ҳадди аломатҳои рӯйхати малакаҳо дар промпт | `int 1000…200000` | `18000` | фавран | Дар ҳар гардиш модел на матни малакаҳо, балки рӯйхати онҳоро мебинад: идентификатор, ном ва кай истифода бурдан; дастури малакаро агент худаш бор мекунад, вақте ки вазифа мувофиқ аст. Агар рӯйхат дарозтар бошад, аввал тавсифҳо, баъд охири рӯйхат хориҷ мешаванд — боқимондаро агент бо дархост меёбад. 1000–200000. |
| `AIHUMMER_AGENT_STALE_GAP_HOURS` | Агент: танаффусе, ки баъди он сӯҳбати гузашта таърих аст (соат) | `int 0…8760` | `12` | фавран | Агар шахс пас аз танаффуси дарозтар аз ин нависад, агент қайд мегирад: ҳар чизе, ки пештар муҳокима шуд, таърих аст — бе дархост такрор намешавад ва вазифаҳои пешина идома дода намешаванд. Ҳар паём аллакай вақти худ ва чӣ қадар аз паёми қаблӣ гузаштанро дорад. 0 — қайд накардан. 0–8760. |
| `AIHUMMER_AGENT_TOOL_HISTORY_TURNS` | Агент: навбатҳое, ки натиҷаҳои абзорҳо дар хотир мемонанд | `int 0…100` | `5` | фавран | Дар чанд навбати охир модел даъватҳои абзорҳо ва натиҷаҳои онҳоро пурра мебинад (натиҷа то 16 КБ нигоҳ дошта мешавад). Дар навбатҳои кӯҳнатар даъват ва ибтидои натиҷа мемонад. Ҳамин тавр агент ба ҷои аз нав даъват кардани абзорҳо дар хотир дорад, ки чӣ ёфт ва чӣ кард. 0 — натиҷаҳоро ба навбатҳои баъдӣ нагузаронидан. 0–100; барои агент арзиши худро додан мумкин аст. |
| `AIHUMMER_APPROVAL_TOOLS` | Абзорҳое, ки тасдиқ талаб мекунанд | `multiselect` | — | фавран | Рӯйхати абзорҳо бо вергул, ки фарохонии онҳо пеш аз иҷро тасдиқи дастии операторро талаб мекунад. Холӣ = тасдиқ лозим нест. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_SUBAGENT_MAX_DEPTH` | Умқи ниҳоии зер-агентҳо | `int 0…10` | `2` | фавран | Умқи ҳадди аксари ҷойгиршавии зерагентҳо (агенте, ки агентро оғоз мекунад). Бо нобаёнӣ 2 — муҳофизат аз рекурсияи беохир. |
| `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | Вақти интизории зер-агент (сония) | `int 0…86400` | `180` | фавран | Вақти ҳадди аксари як иҷрои зерагент, бо сония. |
| `AIHUMMER_TOOL_SEARCH` | Боркунии таъхирноки абзорҳо | `bool` | `false` | фавран | Ядрои кории абзорҳо ба модел фавран нишон дода мешавад, боқимондаи каталоги калон бошад, дар паси абзори ҷустуҷӯ пинҳон мешавад, ки номи ҳар абзори пинҳонро мегӯяд. Танҳо дар каталогҳои калон (даҳҳо абзори плагин, MCP ё OpenAPI) худро сафед мекунад: аз ҳадди андоза поёнтар ҳамаи абзорҳо фавран нишон дода мешаванд, зеро муроҷиати иловагӣ ба модел барои ёфтани абзор аз худи нақшаҳо гаронтар аст. Аз гардиши навбатӣ амал мекунад. |
| `AIHUMMER_TOOL_SEARCH_CORE` | Боркунии танбал: абзорҳои ҳамеша фаъол | `multiselect` | `web_search,web_fetch,memory_search,memory_get,memory_store,search_history,search_knowledge,code_exec,process,filesystem_read,message,schedule_list,schedule_create,schedule_delete,generate_pairing_code` | фавран | Абзорҳое, ки дар реҷаи танбал ҳамеша фавран намоёнанд. Пешфарз — ядрои корӣ: ҷустуҷӯ дар интернет, хондани саҳифаҳо, хотира, таърихи мукотиба, пойгоҳи дониш, код, файлҳо, паёмҳо, ҷадвалҳо ва пайвасткунии барнома. Ҷустуҷӯ дар хотира ва пойгоҳи дониш (memory_search, memory_get, search_knowledge) новобаста аз ин рӯйхат ҳамеша намоён аст. Рӯйхати холӣ ин ядроро бармегардонад. |
| `AIHUMMER_TOOL_SEARCH_MIN_POOL_TOKENS` | Боркунии танбал: ҳаҷми ҳадди ақали абзорҳои пинҳон (токенҳо) | `int 0…1000000` | `4000` | фавран | Абзорҳоро танҳо вақте пинҳон кунед, ки нақшаҳои берун аз ядро дар маҷмӯъ на камтар аз ин қадар токен вазн дошта бошанд (ҳар кадоме тақрибан 4 аломат). Аз ҳад поёнтар ҳамаи абзорҳо фавран нишон дода мешаванд: муроҷиати иловагӣ ба модел барои ёфтани абзор аз нишон додани нақшаҳо гаронтар аст. |
| `AIHUMMER_TOOL_SEARCH_THRESHOLD` | Боркунии танбал: ҳадди ақали абзорҳо барои ба таъхир андохтан | `int 0…1000` | `12` | фавран | Танҳо вақте ба таъхир гузоред, ки пас аз филтри профили агент аз ин шумора зиёдтар абзор монад. |
## Agent · Reasoning
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_AGENT_BEST_OF_N` | Беҳтарин аз N: шумораи вариантҳо | `int 0…8` | `0` | фавран | Агент ин қадар варианти ҷавоб омода карда, беҳтаринашро нигоҳ медорад. 0 ё 1 — хомӯш, аз 2 — фаъол. Ҳар вариант мисли ҷавоби алоҳида арзиш дорад. |
| `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | Баҳс: промпти довар (бознависӣ) | `text` | — | фавран | Промпти довари мубоҳисаро бознависӣ мекунад (холӣ = дарунсохт). |
| `AIHUMMER_AGENT_DEBATE_N` | Мубоҳиса: шумораи вариантҳои ҷавоб | `int 0…8` | `0` | фавран | Агент ин қадар варианти ҷавоб омода мекунад, онҳоро байни худ муқоиса намуда, беҳтаринашро медиҳад. 0 ё 1 — хомӯш, аз 2 — фаъол. Ҳар вариант мисли ҷавоби алоҳида арзиш дорад. |
| `AIHUMMER_AGENT_DEBATE_PROMPT` | Баҳс: промпти номзад (бознависӣ) | `text` | — | фавран | Промпти номзади мубоҳисаро бознависӣ мекунад (холӣ = дарунсохт). |
| `AIHUMMER_AGENT_DEBATE_ROUNDS` | Баҳс: даврҳо | `int 1…10` | `1` | фавран | Шумораи даврҳои мубоҳисаи панели номзадҳо. |
| `AIHUMMER_AGENT_JUDGE_PROMPT` | Промпти довари best-of-N (бознависӣ) | `text` | — | фавран | Промпти довари best-of-N-ро бознависӣ мекунад (холӣ = дарунсохт). |
| `AIHUMMER_AGENT_PLAN_PROMPT` | Промпти нақшакаш (бознависӣ) | `text` | — | фавран | Промпти нақшакашро бознависӣ мекунад (холӣ = дарунсохт). |
| `AIHUMMER_AGENT_PLAN_STEPS` | Нақшакаш-иҷрокунанда: ҳадди ниҳоии қадамҳои нақша (0=хомӯш) | `int 0…32` | `0` | фавран | ⟩0 гузариши алоҳидаи нақшакаш→иҷрокунанда→синтезро оғоз мекунад (барои вазифаҳои мураккаби бисёрқадама муфид). 0 = хомӯш. Одатан 4–8. |
| `AIHUMMER_AGENT_PLAN_STEP_ITERS` | Нақшакаш: такрори абзорҳо дар ҳар қадам (0=пешфарз) | `int 0…64` | `0` | фавран | Шумораи такрори даъвати абзорҳоро дар ҳар қадами нақша маҳдуд мекунад. 0 = қимати дарунсохти пешфарз (4). |
| `AIHUMMER_AGENT_REFLECT` | Гузариши худтанқидӣ | `bool` | `0` | фавран | Пеш аз ҷавоби ниҳоӣ гузариши таҳлил/худтанқидиро илова мекунад. |
| `AIHUMMER_AGENT_REFLECT_PROMPT` | Промпти рефлексия (бознависӣ) | `text` | — | фавран | Промпти худтанқидиро бознависӣ мекунад (холӣ = дарунсохт). |
| `AIHUMMER_AGENT_SELF_HEAL` | Худбарқароршавӣ: такрор ҳангоми хатогиҳои абзорҳо (0=хомӯш) | `int 0…10` | `0` | фавран | ⟩0 даъватҳои нобарори абзорҳоро бо ишораи ислоҳкунанда то ҳамин ҳад такрор мекунад. |
## Agent · System prompt
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_LOCALE` | Локали пешфарз | `enum: ru-RU \\\| en-US \\\| az-AZ \\\| hy-AM \\\| be-BY \\\| kk-KZ \\\| ky-KG \\\| tg-TJ \\\| tk-TM \\\| uz-UZ \\\| ka-GE \\\| ro-RO \\\| es-ES \\\| zh-CN \\\| fr-FR \\\| de-DE \\\| hi-IN \\\| pl-PL \\\| lt-LT \\\| lv-LV \\\| et-EE \\\| fi-FI \\\| sv-SE \\\| no-NO \\\| da-DK \\\| tr-TR \\\| mn-MN` | `ru-RU` | фавран | Забон/локали пешфарзи ҷавоб, мас. ru-RU. Дастурҳои персона/оператор афзалият доранд. |
| `AIHUMMER_TIMEZONE` | Минтақаи вақт | `text` | `UTC` | фавран | Минтақаи вақти IANA барои санаи ҷории агент ва ҷадвалҳои бе минтақаи худ, мас. Europe/Moscow. Пешфарз UTC. |
## Channels
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_CHANNEL_FAILURE_NOTICE` | Ба ҳамсуҳбат дар бораи нокомии ҷавоб хабар додан | `enum: always \\\| once \\\| off` | `always` | фавран | Вақте агент ҷавоб дода натавонист, ҳамсӯҳбат дар канал (Telegram ва дигарон) чӣ мегирад: «Ҳар дафъа» — паёми кӯтоҳ бо забони худаш; «На зиёда аз як бор дар 4 соат» — дар 4 соат як паём барои суҳбат; «Хабар надодан» — ҳеҷ чиз. Дар паём рамзҳои хато ва номи таъминкунандагон нест; тафсилотро дар «Ҷаласаҳо» ва огоҳиномаҳо мебинед. |
| `AIHUMMER_CHANNEL_FAILURE_TEXT_BLOCKED` | Матн дар бораи нокомӣ: инстанс боздошта шудааст | `text` | — | фавран | Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад. |
| `AIHUMMER_CHANNEL_FAILURE_TEXT_BUDGET` | Матн дар бораи нокомӣ: буҷаи соҳиб тамом шуд | `text` | — | фавран | Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад. |
| `AIHUMMER_CHANNEL_FAILURE_TEXT_BUSY` | Матн дар бораи нокомӣ: шлюз аз ҳад зиёд бор дорад | `text` | — | фавран | Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад. |
| `AIHUMMER_CHANNEL_FAILURE_TEXT_CONFIG` | Матн дар бораи нокомӣ: пайвасти модел соҳибро талаб мекунад | `text` | — | фавран | Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад. |
| `AIHUMMER_CHANNEL_FAILURE_TEXT_FAILED` | Матн дар бораи нокомӣ: нокомии дигар | `text` | — | фавран | Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад. |
| `AIHUMMER_CHANNEL_FAILURE_TEXT_QUOTA` | Матн дар бораи нокомӣ: маҳдудияти истифодаи модел тамом шуд | `text` | — | фавран | Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад. |
| `AIHUMMER_CHANNEL_FAILURE_TEXT_STEP_LIMIT` | Матн дар бораи нокомӣ: вазифа ба як ҷавоб нагунҷид | `text` | — | фавран | Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад. |
| `AIHUMMER_CHANNEL_FAILURE_TEXT_TOO_LONG` | Матн дар бораи нокомӣ: гуфтугӯ барои модел хеле дароз аст | `text` | — | фавран | Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад. |
| `AIHUMMER_CHANNEL_FAILURE_TEXT_UNAVAILABLE` | Матн дар бораи нокомӣ: модел муваққатан дастнорас аст | `text` | — | фавран | Холӣ монед — паёми дарунсохт бо забони ҳамсуҳбат фиристода мешавад. Матни шумо ҳамон тавре ки навишта шудааст, бо забоне ки навиштаед, фиристода мешавад; {ref} рамзи ҷавобро мегузорад, ки бо он қадамро дар «Ҷаласаҳо» меёбед. Фавран амал мекунад. |
| `AIHUMMER_CONFIDENTIAL_PERSONA` | Персонаи махфии веб | `bool` | `0` | фавран | Ҳангоми фаъол будан агенти веб-чат маълумоти персона/шахсияти худро ошкор ва нигоҳ намедорад ва танҳо аз рӯи вазифа ҷавоб медиҳад — барои ҷойгиркуниҳои веби беном ё ба махфият ҳассос. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_INBOUND_COALESCE_MS` | Равзанаи муттаҳидсозии паёмҳо (мс) | `int` | `500` | фавран | Якчанд паёме, ки як шахс пай дар пай ба як чат мефиристад (паёмҳои кӯтоҳ, албоми аксҳо, ислоҳи зуд), агар танаффуси байни онҳо аз ин равзана кӯтоҳтар бошад, ЯК ҷавоб мегиранд. Ба паёмҳое, ки ҳангоми омода шудани ҷавоб мерасанд, фавран пас аз он ҷавоб дода мешавад, ҳеҷ гоҳ ҳамзамон не. Пешфарз 500 мс; 0 — бе интизорӣ байни паёмҳои алоҳида; албоми аксҳо ба ҳар ҳол ҷамъ карда мешавад (танаффус то 3 с, на зиёда аз 20 с), то як ҷавоб гирад. Муттаҳидсозӣ дар Telegram кор мекунад; Slack, WhatsApp, VK, почта ва дигар пайвасткунандаҳое, ки ба ҳар паём ҷавоб интизоранд (ва интегратсияҳо тавассути /v1/inbound/generic), ба ҳар паём ҷавоб мегиранд — мисли пештара якто-якто ва бо тартиб. Фавран татбиқ мешавад. |
| `AIHUMMER_INBOUND_EDIT_MODE` | Вақте ки одам паёми ҷавобдодашударо таҳрир мекунад | `enum: correct \\\| history` | `correct` | фавран | correct — бот бо донистани он ки ин ислоҳ аст, боз ҷавоб медиҳад («буд / шуд»); history — таҳрир танҳо таърихи гуфтугӯро ислоҳ мекунад, ҷавоби нав нест (барои хатоҳои чопӣ қулай). Таҳрири паёме, ки бот ҳанӯз ба он ҷавоб надодааст, ҳамеша танҳо матнашро иваз мекунад. Дар ҷое кор мекунад, ки канал дар бораи таҳрирҳо хабар медиҳад (Telegram). Фавран амал мекунад. |
| `AIHUMMER_INBOUND_QUEUE_MODE` | Паёмҳое, ки ҳангоми кори агент навишта мешаванд | `enum: steer \\\| collect \\\| followup` | `steer` | фавран | Бо паёме, ки ҳамон шахс ҳангоми ҳанӯз омода кардани ҷавоб аз ҷониби агент (ҷустуҷӯ, иҷрои абзорҳо) мефиристад, чӣ мешавад: steer (пешфарз) — агент онро пеш аз қадами навбатӣ мебинад ва дар ҳамон ҷавоб ба инобат мегирад; collect — ба он ҷавоби навбатӣ дода мешавад. followup — ба ҳар чунин паём навбат ба навбат ҷавоби алоҳида дода мешавад. Суратҳо, файлҳо, ҷавобҳо ба паём ва фиристодани такрорӣ ҳамеша ҷавоби навбатиро интизоранд. Фавран амал мекунад. |
| `AIHUMMER_INBOUND_REQUIRE_BINDING` | Танҳо ба корбарони бақайдгирифташуда ҷавоб додан | `bool` | `true` | фавран | true = бот ҳар фиристандаро дар канал, ки корбари сабтшудаи AiHummer НЕСТ (корбар бо пайванди нақш), нодида мегирад — аъзои тасодуфии чат ва даъватҳои меҳмон ҷавоб намегиранд. false (пешфарз) = ба ҳама ҷавоб додан. |
## Integrations
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_A2A_PUBLISH` | Нашри агент тавассути Agent2Agent (A2A) | `bool` | `0` | пас аз бозоғозӣ | Агентро ҳамчун сервери A2A нашр кунед (Agent Card + POST /a2a/message). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_MCP_EXPORT_TOOLS` | Абзорҳои барои ёрдамчиёни берунӣ кушода | `multiselect` | — | пас аз бозоғозӣ | Рӯйхати возеҳи номҳои абзор барои муштариёни берунии MCP, ки бо вергул ҷудо карда шудааст, иҷозат дода шудааст. Холӣ = ягон асбобро нашр накунед. Синфҳои хатарноки сатҳи мизбон ба таври илова аз ҷониби сиёсати дарунсохт манъ карда мешаванд, ҳатто агар рӯйхат карда шаванд. Ҳангоми оғоз/пас аз бозоғоз истифода мешавад. |
| `AIHUMMER_MCP_PUBLISH` | Нашри абзорҳо тавассути MCP | `bool` | `0` | пас аз бозоғозӣ | Ба ёрдамчиёни берунӣ (масалан, Claude Desktop) иҷозат медиҳад, ки аз абзорҳои агентҳои шумо истифода баранд. Кадом абзорҳоро кушодан дар танзими ҳамсоя интихоб мешавад: то рӯйхат холӣ аст, ягонтои он кушода намешавад. |
| `AIHUMMER_MODULE_CPU_QUOTA` | Ҳадди протсессори плагин (барои ҳар як) | `text` | `75%` | фавран | Ҳар плагин чӣ ҳиссаи протсессорро ишғол карда метавонад (systemd CPUQuota): 75% — се чоряки як ядро, 150% — якуним ядро. Қимати навро плагин ҳангоми насби навбатӣ, навсозӣ ё нигоҳ доштани танзимоташ мегирад; то он вақт плагинҳои кунунӣ бо ҳадди пешина кор мекунанд. |
| `AIHUMMER_MODULE_MEMORY_MAX` | Ҳадди хотираи плагин (барои ҳар як) | `text` | `512M` | фавран | Ҳар плагин чӣ қадар хотираро ишғол карда метавонад (systemd MemoryMax): андозае мисли 512M, 1G ё 2048M (на камтар аз 64M) ё infinity — бе ҳад. Плагинеро, ки аз ҳад гузашт, система қатъ мекунад. Қимати навро плагин ҳангоми насби навбатӣ, навсозӣ ё нигоҳ доштани танзимоташ мегирад; то он вақт плагинҳои кунунӣ бо ҳадди пешина кор мекунанд. |
## Knowledge connectors
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_KB_SYNC_INTERVAL` | Пойгоҳи донишро аз манбаъҳо чӣ қадар зуд-зуд навсозӣ кардан | `text` | — | фавран | Сервер тағйиротро аз манбаъҳои пайвастшудаи пойгоҳи дониш худаш чӣ қадар зуд-зуд мегирад. Масалан: 30m — ҳар 30 дақиқа, 6h — ҳар 6 соат. Холӣ ё 0 — танҳо дастӣ. Боркунии такрорӣ нусхаҳои такрорӣ намесозад. Содироти Slack дастӣ бор карда мешавад. |
## LLM
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_AUX_FALLBACK_MODELS` | Вазифаҳои хидматӣ: моделҳои эҳтиётӣ | `list` | — | фавран | Моделҳо бо вергул — агар модели хидматӣ кор накунад (квота, нуқсон), бо тартиб санҷида мешаванд. Барои он ки хулоса гум нашавад, дар охир ҳамеша модели асосӣ санҷида мешавад. Ҳар гузариш дар журнал сабт мешавад. Фавран амал мекунад. |
| `AIHUMMER_AUX_MODEL` | Модел барои вазифаҳои хидматӣ (хулосаҳо, қайдҳо, сарлавҳаҳо) | `text` | — | фавран | Модели вазифаҳои хидматии пасзамина: фишурдани таърихи кӯҳна ба хулоса, қайд дар хотира пеш аз фишурдан, сарлавҳаҳои сӯҳбатҳо, истихроҷи далелҳо, аз нав ифода кардани дархостҳои ҷустуҷӯ ва тарҷума. Холӣ = худкор: модели арзонтари ҳамон таъминкунанда (Claude → claude-haiku-4-5, Codex → gpt-…-luna/mini); агар чунин набошад — модели асосӣ. «main» — ҳамеша модели асосӣ. Фавран амал мекунад. |
| `AIHUMMER_CASCADE_MIN_CHARS` | Каскад: ҳадди ақали аломатҳо барои эскалатсия | `int` | `0` | фавран | Ҳадди дарозии дархост (аломатҳо), ки аз он модели қавитари каскад фаъол мешавад. 0 = пешфарз. |
| `AIHUMMER_CASCADE_STRONG_MODEL` | Каскад: модели захиравии қавитар | `text` | — | фавран | Модел, ки барои дархостҳои дароз/мураккаб каскадӣ истифода мешавад (холӣ = хомӯш). |
| `AIHUMMER_CLAUDE_AUTH_URL` | Обунаи Claude: суроғаи саҳифаи воридшавӣ | `text` | — | фавран | Саҳифае, ки дар он пайвасти обунаи Claude-ро иҷозат медиҳед. Холӣ — суроғаи стандартӣ; танҳо бо хоҳиши дастгирӣ иваз кунед. |
| `AIHUMMER_CLAUDE_CLIENT_ID` | Обунаи Claude: ID мизоҷи OAuth | `text` | — | фавран | Шиносаи барнома барои воридшавӣ бо обунаи Claude. Холӣ — стандартӣ; танҳо бо хоҳиши дастгирӣ иваз кунед. |
| `AIHUMMER_CLAUDE_EFFORT` | Claude: умқи андеша | `enum: low \\\| medium \\\| high \\\| xhigh \\\| max` | `medium` | фавран | Агар дар агент умқ муқаррар нашуда бошад, моделҳои Claude пеш аз ҷавоб то чӣ андоза чуқур андеша мекунанд. Баландтар — дар вазифаҳои душвор дақиқтар, вале дарозтар ва квотаи бештар сарф мекунад; пасттар — зудтар ва арзонтар. Моделе, ки сатҳи интихобшударо намедонад, наздиктарин сатҳи пасттарро мегирад; Haiku 4.5 ва моделҳои кӯҳна андешаро дастгирӣ намекунанд. Умқи дар агент муқарраршуда афзалият дорад. Аз гардиши навбатӣ амал мекунад. |
| `AIHUMMER_CLAUDE_MAX_TOKENS` | Claude: дарозии ниҳоии ҷавоб (токен) | `int` | `16000` | фавран | Як ҷавоби Claude чанд токенро ишғол карда метавонад — ҳам бо обуна, ҳам бо калид. Мулоҳизаҳои модел ба ҳамин маҳдудият дохил мешаванд: қимати хеле хурд ҷавобро дар нимаи ҷумла қатъ мекунад ё ҷавоби холӣ медиҳад. Агар агент дарозии ҷавоби худро дошта бошад, ҳамон амал мекунад. |
| `AIHUMMER_CLAUDE_REDIRECT_URI` | Обунаи Claude: масир URI | `text` | — | фавран | Суроғаи бозгашт, ки дар таъминкунанда ба қайд гирифта шудааст. Он чизе ки дар паҳлӯи он танзим шудааст, бояд мувофиқат кунад, вагарна мубодилаи код рад карда мешавад. |
| `AIHUMMER_CLAUDE_TOKEN_URL` | Обунаи Claude: суроғаи гирифтани дастрасӣ | `text` | — | фавран | Суроғае, ки сервер дастрасиро ба обунаи Claude мегирад ва тамдид мекунад. Холӣ — суроғаи стандартӣ; танҳо бо хоҳиши дастгирӣ иваз кунед. |
| `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` | `medium` | фавран | Агар дар агент муқаррар нашуда бошад, модели ChatGPT (Codex) пеш аз ҷавоб чӣ қадар амиқ фикр мекунад. Пешфарз — «Миёна». Баландтар — дақиқтар, вале дарозтар ва гаронтар. |
| `AIHUMMER_LLM_CALL_TIMEOUT_S` | Вақти интизории як даъват (сония) | `int` | `120` | фавран | Ба як дархост ҷавоби моделро чанд сония интизор шудан. Агар модел зиёдтар хомӯш монад, дархост қатъ мешавад ва ҷавоб ба модели навбатии рӯйхат мегузарад. Барои Claude на тамоми ҷавоб, балки танаффус дар ҷараёни ҷавоб ҳисоб мешавад: ҷавоби дароз, вале давомдор қатъ намешавад. 0 — бе маҳдудият. |
| `AIHUMMER_LLM_FALLBACK_MODELS` | Моделҳои эҳтиётӣ (барои ҳамаи агентҳо) | `text` | `auto` | фавран | Вақте ки модели асосӣ ва дигар таъминкунандагон рад мекунанд (маҳдудияти истифода тамом шуд, хатогӣ, дархостҳои аз ҳад зиёд), кӣ ҷавоб медиҳад. auto — модели арзонтари ҳар таъминкунанда ҳамчун такягоҳи охирин (Claude: claude-haiku-4-5, Codex: gpt-…-luna/mini); рӯйхат бо вергул — тартиби худатон, ҳар модел ба таъминкунандагони истеҳсолкунандаи худ меравад; off — бе моделҳои эҳтиётӣ. Модели эҳтиётии худи агент бартарӣ дорад. Фавран татбиқ мешавад. |
| `AIHUMMER_LLM_GATEWAY_URL` | URL-и дарвозаи LLM | `text` | — | қисман пас аз бозоғозӣ | URL-и базавии эндпоинти модели мувофиқи OpenAI, ки агент ба он муроҷиат мекунад (сервери маҳаллии llama.cpp/vLLM/Ollama ё шлюзи ҷойгиршуда). Холӣ монед — эндпоинти пешфарзи провайдер истифода мешавад. |
| `AIHUMMER_LLM_MODEL` | Модели LLM | `text` | — | қисман пас аз бозоғозӣ | Ном/идентификатори модел, ки дар ҳар навбат ба провайдер фиристода мешавад (модели эндпоинти шумо). Бояд бо моделе, ки эндпоинт воқеан пешниҳод мекунад, мувофиқ бошад. |
| `AIHUMMER_LLM_PAUSE_AUTH_MIN` | Таваққуф пас аз радди маълумоти ҳисоб, дақ | `int` | `10` | фавран | Чанд дақиқа ба таъминкунандае, ки маълумоти ҳисобро рад кард, муроҷиат накардан. Такрор таваққуфро ду баробар мекунад, вале на зиёда аз шаш баробар. Санҷиши бомуваффақияти пайвастшавӣ ва тугмаи «Ҳозир идома додан» таъминкунандаро фавран бармегардонанд. Аз радди навбатӣ амал мекунад. |
| `AIHUMMER_LLM_PAUSE_MODEL_MIN` | Таваққуфи модели ба таъминкунанда хизматнашаванда, дақ | `int` | `60` | фавран | Чанд дақиқа ба таъминкунанда моделеро пешниҳод накардан, ки ба гуфтаи ӯ хизмат намерасонад; ба дигар моделҳои ӯ одатан муроҷиат мекунем. Аз радди навбатӣ амал мекунад. |
| `AIHUMMER_LLM_PAUSE_QUOTA_MIN` | Таваққуф пас аз тамом шудани лимит, дақ | `int` | `300` | фавран | Вақте ки лимити истифода тамом шуда, таъминкунанда мӯҳлати барқароршавиро нагуфтааст, чанд дақиқа ба модел (агар лимити ҳисоб тамом шуда бошад — Codex, калиди OpenAI, пардохт — ба тамоми ҳисоб) муроҷиат накардан. Такрор таваққуфро ду баробар мекунад, вале на зиёда аз як шабонарӯз. Мӯҳлати гуфтаи таъминкунанда афзалтар аст. Аз радди навбатӣ амал мекунад. |
| `AIHUMMER_LLM_PAUSE_SHORT_S` | Таваққуфи таъминкунанда пас аз нокомӣ, с | `int` | `30` | фавран | Пас аз нокомӣ, қатъи алоқа ё ҷавоби «аз ҳад зиёд зуд» чанд сония ба таъминкунанда муроҷиат накардан. Радди дуюми пай дар пай таваққуфро ду баробар, сеюм ва минбаъда даҳ баробар дароз мекунад. Агар таъминкунанда мӯҳлатро худ номбар карда бошад, ҳамонро интизор мешавем. Аз радди навбатӣ амал мекунад. |
| `AIHUMMER_LLM_PROVIDER` | Провайдери LLM | `text` | — | қисман пас аз бозоғозӣ | Кадом бэкенди модел истифода шавад (эндпоинти мувофиқи OpenAI ё транспорти Codex/обунаи ChatGPT). Муайян мекунад, ки дархостҳо чӣ тавр фиристода ва аутентификатсия мешаванд. |
| `AIHUMMER_LLM_RETRIES` | Такрори LLM ҳангоми хатогии муваққатӣ | `int` | `3` | фавран | Шумораи такрори дархост ба LLM ҳангоми хатогии муваққатӣ. |
| `AIHUMMER_LLM_TEMPERATURE` | Ҳарорат | `text` | — | фавран | Агар дар агент муқаррар нашуда бошад, ҷавобҳои модел чӣ қадар гуногун бошанд (0–2): камтар — дақиқтар ва пешгӯишаванда, бештар — зиндатар. Холӣ — модел худаш қарор медиҳад. Моделҳои андешаманд (ChatGPT/Codex, Claude насли 5) инро қабул намекунанд — барои онҳо майдонро холӣ гузоред. |
| `AIHUMMER_LLM_TOP_P` | Top-p (nucleus-намунагирӣ) | `text` | — | фавран | Боз як роҳи гуногун кардани ҷавобҳо (0–1), агар дар агент муқаррар нашуда бошад. Холӣ — модел худаш қарор медиҳад. Одатан танҳо якеро муқаррар мекунанд: ё ҳарорат, ё инро; моделҳои андешаманд онро қабул намекунанд. |
| `AIHUMMER_MODEL_GUARD_INTERVAL_MIN` | Санҷиши модели агент: фосила, дақ | `int` | `60` | фавран | Чӣ қадар зуд-зуд санҷидан лозим аст, ки модели ҳар агентро таъминкунандаи фаъол пешниҳод мекунад. Модели агент ҳеҷ гоҳ иваз карда намешавад: то вақте ки касе онро пешниҳод намекунад, аввалин модели тартиби ҷавоб, ки дар таваққуф нест, ҷавоб медиҳад ва огоҳинома агентҳоро ном мебарад — вақте ки модели онҳо бармегардад, боз як огоҳинома меояд. Ҳангоми оғози шлюз санҷиш ҳамеша иҷро мешавад, 0 бошад, танҳо такрорро хомӯш мекунад. Давраи нав дар давоми як дақиқа амал мекунад. |
| `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_SUBSCRIPTION_QUOTA_REFRESH_MIN` | Квотаҳои обуна: давраи пурсиш, дақ | `int` | `15` | фавран | Панел аз ChatGPT (Codex) равзанаҳои квотаи обунаро чӣ қадар зуд мепурсад: дар давра на бештар аз як бор, на зудтар аз ҳар 5 дақиқа ва танҳо вақте ки квотаҳо кушодаанд; дар байн нусхаи нигоҳдошта нишон дода мешавад. Аз Claude ҳеҷ гоҳ пурсида намешавад: ҳудудҳои он баҳои мост. Аз кушодани навбатии квотаҳо амал мекунад. |
## Media
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_DEEPGRAM_API_KEY` | Калиди API-и Deepgram | `text` | — | фавран | Калиди хизмати Deepgram — агар паёмҳои овозиро Deepgram шиносад, лозим аст. Агар холӣ бошад, калиди умумии шинохти нутқ аз танзими ҳамсоя гирифта мешавад. Фавран амал мекунад. |
| `AIHUMMER_DEEPGRAM_DETECT_LANGUAGE` | Муайянкунии забони Deepgram | `bool` | `0` | фавран | Ба ҷойи фиристодани забони собит забонро муайян мекунад. Фавран татбиқ мешавад. |
| `AIHUMMER_DEEPGRAM_MODEL` | Модели Deepgram | `text` | `nova-2` | фавран | Модели Deepgram (мас. nova-2, nova-3, base). Аз дастрасии лоиҳа барои ҳамин калид вобаста аст. Фавран татбиқ мешавад. |
| `AIHUMMER_DEEPGRAM_PUNCTUATE` | Аломатҳои китобати Deepgram | `bool` | `1` | фавран | Аломатҳои китобат ва ҳарфҳои калон илова мекунад. Фавран татбиқ мешавад. |
| `AIHUMMER_DEEPGRAM_SMART_FORMAT` | Шаклбандии ҳушманди Deepgram | `bool` | `1` | фавран | Рақамҳо ва санаҳои шинохташударо шаклбандӣ мекунад. Фавран татбиқ мешавад. |
| `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` | фавран | Бузургтарин файл (акс, паёми овозӣ, видео), ки якбора бор кардан мумкин аст, бо мегабайт. Диски серверро аз пуршавӣ муҳофизат мекунад. Пешфарз 256. Фавран амал мекунад. |
| `AIHUMMER_SIDECAR_STT` | Шинохти нутқ дар ин сервер (faster-whisper) | `bool` | `0` | фавран | Шинохти нутқи маҳаллӣ (faster-whisper). Ба баста дохил НЕСТ: зеркашии иловаи имзошударо фаъол созед (~620 МБ барои ҳама версияҳои Python) ва хидматро дар ҳост насб кунед. 🔴 Илова бо қарори алоҳидаи фурӯшанда нашр карда мешавад (бастаҳои он ffmpeg дар доираи GPL доранд); агар он барои барориши шумо нашр нашавад, аз он ҷумла дар ин бора ростқавл хоҳад буд ва ҳеҷ чизро вайрон намекунад. Нақшаи абрӣ: эътироф аз ҷониби провайдер танзим карда мешавад. |
| `AIHUMMER_SIDECAR_TTS` | Овоздиҳии ҷавобҳо (edge-tts) | `bool` | `0` | фавран | Синтези нутқ (edge-tts, овозҳои Microsoft Edge). Ба баста дохил НЕСТ: имкон додани зеркашии замимаи имзошуда (~26 МБ) ва насб кардани хидмат дар ҳост. Худи синтез барои овозҳо онлайн мешавад - "офлайн" дар ин ҷо ба насб кардани баста ишора мекунад, кор намекунад. |
| `AIHUMMER_STT_API_KEY` | Калиди API-и STT (ихтиёрӣ) | `text` | — | фавран | Калиди дастрасӣ ба хизмати шинохти нутқ, агар он талаб кунад. Барои хизмат дар ин сервер онро насбкунанда муқаррар мекунад — иваз кардан лозим нест. Фавран амал мекунад. |
| `AIHUMMER_STT_ENGINE` | Муҳаррики STT | `enum: auto \\\| faster-whisper \\\| deepgram \\\| codex \\\| off` | `auto` | фавран | Паёмҳои овозиро бо чӣ ба матн табдил додан. Автоматӣ (пешфарз): агар калиди он муқаррар бошад, Deepgram, вагарна хидмати маҳаллӣ, агар насб шуда бошад (калиди боло), вагарна бо ҳеҷ чиз — ва бот ба фиристанда ростқавлона мегӯяд, ки ҳоло гӯш карда наметавонад. faster-whisper: хидмати маҳаллӣ ё /v1/audio/transcriptions-и берунаи мувофиқ. deepgram: Deepgram-и абрӣ бо калиди худ. codex: обунаи пайвастшудаи ChatGPT (Моделҳо → Пайваст кардани ChatGPT), квотаи онро сарф мекунад. off: табдил надодан. Фавран татбиқ мешавад. |
| `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_TTS_API_KEY` | Калиди API-и TTS (edge-tts) | `text` | — | қисман пас аз бозоғозӣ | Калиди дастрасӣ ба хизмати овоздиҳӣ. Ҳангоми насб худкор муқаррар мешавад — иваз кардан лозим нест. |
| `AIHUMMER_TTS_ENABLED` | Синтези нутқ фаъол аст | `bool` | `1` | қисман пас аз бозоғозӣ | Ба агент иҷозат медиҳад, ки бо овоз ҷавоб диҳад. Барои ин хизмати овоздиҳӣ лозим аст — онро дар боло, дар бахши «Хизматҳои иловагӣ» насб мекунанд. |
| `AIHUMMER_TTS_MODEL` | Модели TTS | `text` | — | қисман пас аз бозоғозӣ | Номи модел барои хидмати edge-tts. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_TTS_VOICE` | Овози TTS | `enum: de-DE-FlorianMultilingualNeural \\\| de-DE-SeraphinaMultilingualNeural \\\| en-US-AndrewMultilingualNeural \\\| en-US-AvaMultilingualNeural \\\| en-US-BrianMultilingualNeural \\\| en-US-EmmaMultilingualNeural \\\| fr-FR-RemyMultilingualNeural \\\| fr-FR-VivienneMultilingualNeural \\\| ru-RU-SvetlanaNeural \\\| ru-RU-DmitryNeural \\\| en-US-JennyNeural \\\| en-US-GuyNeural \\\| en-GB-SoniaNeural \\\| de-DE-KatjaNeural \\\| fr-FR-DeniseNeural \\\| es-ES-ElviraNeural \\\| tr-TR-EmelNeural \\\| pl-PL-ZofiaNeural \\\| zh-CN-XiaoxiaoNeural` | `de-DE-FlorianMultilingualNeural` | қисман пас аз бозоғозӣ | Овози пешфарзи edge-tts (бисёрзабона, аз ҷумла русӣ). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_VIDEO_API_KEY` | Калиди API-и таҳлили видео | `text` | — | фавран | Калиди дастрасӣ ба хизмати таҳлили видео, агар он талаб кунад. Холӣ — хизмат бе калид истифода мешавад. |
## Media · Voice
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_TTS_AUTO_REPLY` | Ҷавобҳои овозии худкор | `enum: off \\\| always \\\| inbound \\\| tagged` | `inbound` | фавран | Хомӯш, ҳамеша, ҳангоми гирифтани аудио ё бо нишонаи ошкор. Барои ҳар суҳбат тағйир додан мумкин аст. |
| `AIHUMMER_TTS_MAX_CHARS` | Ҳадди аломатҳои матни овозӣ | `int` | `0` | фавран | 0: тамоми матн; 100–10000: ҳадди матни хондашаванда. Ҷавоби пурра дар таърих мемонад. |
| `AIHUMMER_TTS_SUMMARIZE` | Кӯтоҳ кардани ҷавобҳои овозии дароз | `bool` | `1` | фавран | Ҷавобҳои дарозро барои хондан кӯтоҳ мекунад. Ҳангоми хато аввали матн дар доираи ҳадд хонда мешавад. |
| `AIHUMMER_VOICE_AEC` | Бартарафсозии акс-садо (AEC) | `bool` | `1` | фавран | Акси садоро бартараф мекунад: овози худи агент аз баландгӯяк ба микрофон барнамегардад ва суҳбатро қатъ намекунад. Танҳо вақте хомӯш кунед, ки овоз дар гӯшмонак вайрон садо диҳад. |
| `AIHUMMER_VOICE_AGC` | Танзими худкори баландӣ | `bool` | `1` | фавран | Дар ҳолати овозӣ талаб кардани танзими худкори баландии микрофон (WebRTC autoGainControl). |
| `AIHUMMER_VOICE_BARGEIN_FRAMES` | Қатъ кардани агент: чӣ қадар гап задан лозим | `int` | `5` | фавран | Чӣ қадар гап задан лозим аст (бо кадрҳои 20 мс), то агент хомӯш шуда, гӯш кунад. Пешфарз 5 — тақрибан 0,1 сония. |
| `AIHUMMER_VOICE_DUPLEX` | Овози зиндаи пурраи дуҷониба | `bool` | `0` | фавран | Реҷаи зиндаи пурраи дутарафаро фаъол мекунад (стриминг + VAD + barge-in). Фавран татбиқ мешавад. |
| `AIHUMMER_VOICE_NOISE_SUPPRESSION` | Пахши садоҳои изофӣ | `bool` | `1` | фавран | Дар ҳолати овозӣ талаб кардани пахши садо ҳангоми сабт аз микрофон (WebRTC noiseSuppression). |
| `AIHUMMER_VOICE_VAD_THRESHOLD` | Ҳассосият ба овоз (0–1) | `text` | `0.02` | фавран | Аз кадом баландӣ садо нутқ ҳисоб мешавад. Камтар — ҳассостар: агент нутқи оромро мешунавад, вале садои бегонаро ҳам. Пешфарз 0.02. |
## Memory
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_EMBEDDER_DIM` | Андозагирии модели ҷустуҷӯи маъноӣ | `int` | `768` | пас аз бозоғозӣ | Ченаки вектор — бояд бо модел мувофиқ бошад (multilingual-e5-base=768, bge-m3=1024). |
| `AIHUMMER_EMBEDDER_KEEPALIVE` | Keep-alive-и эмбеддер | `text` | `5m` | пас аз бозоғозӣ | Модели ҷустуҷӯи маъноӣ пас аз дархости охирин чӣ қадар боршуда мемонад (танҳо дар реҷаи «Аз рӯи маъно»). Пешфарз 5m — 5 дақиқа: баъд модел холӣ карда шуда, хотира ва протсессорро озод мекунад. Ҳамеша нигоҳ доштан (-1) тавсия дода намешавад: модели овезон метавонад рӯзҳо як ядрои протсессорро банд кунад. Формат: 30s, 5m, 1h. |
| `AIHUMMER_EMBEDDER_MODEL` | Модели ҷустуҷӯи маъноӣ | `text` | `yxchia/multilingual-e5-base` | пас аз бозоғозӣ | Модели, ки дар хотира аз рӯи маъно ҷустуҷӯ карданро имкон медиҳад. Пешфарз multilingual-e5-base забони русиро мефаҳмад, сабук аст ва дар протсессори оддӣ зуд кор мекунад. Барои сифати беҳтар дар видеокорт bge-m3 мувофиқ аст, вале он гоҳ дар танзими ҳамсояи андозагирӣ 1024 нависед: рақам бояд ба модел мувофиқ бошад. |
| `AIHUMMER_EMBEDDER_PASSAGE_PREFIX` | Префикси ҳуҷҷати эмбеддер | `text` | — | пас аз бозоғозӣ | Префикси ҳуҷҷати нигоҳдошташавандаро бознависӣ кунед (моделҳои e5 худкор \\"passage: \\"-ро истифода мебаранд). Барои муайянкунии худкор аз рӯи номи модел холӣ монед. |
| `AIHUMMER_EMBEDDER_QUERY_PREFIX` | Префикси дархости эмбеддер | `text` | — | пас аз бозоғозӣ | Префикси дархости ҷустуҷӯро бознависӣ кунед (моделҳои e5 худкор \\"query: \\"-ро истифода мебаранд). Барои муайянкунии худкор аз рӯи номи модел холӣ монед. |
| `AIHUMMER_EMBEDDER_THREADS` | Риштаҳои протсессори эмбеддер | `int 0…256` | `0` | пас аз бозоғозӣ | Модели ҷустуҷӯ аз рӯи маъно барои як дархост чанд риштаи протсессорро мегирад. 0 — худкор: нисфи риштаҳои сервер, вале на камтар аз 2. Бе маҳдудият аз нав ҳисоб кардани векторҳои пойгоҳи дониш дар сервери заиф соатҳо тамоми протсессорро банд мекард ва ба ҷавобҳои агентҳо халал мерасонд. Бештар — аз нав ҳисобкунӣ тезтар, вале сарборӣ вазнинтар. |
| `AIHUMMER_MEMORY_AGENT_WRITES` | Далелҳое, ки агент худаш нигоҳ медорад | `enum: strangers \\\| immediate \\\| review` | `strangers` | фавран | Бо он чизе, ки агент худаш дар ёд нигоҳ медорад, чӣ мешавад — масалан, бо хоҳиши «дар хотир дор». «Фавран ба хотира; аз бегонаҳо — барои санҷиш» (пешфарз) — агар инро соҳиб ё ҳалқаи боэътимоди агент гуфта бошад, фавран ба хотира; аз дигарон — барои санҷиш. «Фавран ба хотира» — агент онро фавран меёбад. «Барои санҷиш» — аввал ба навбати «Хотира → барои санҷиш», ба ҷавобҳо танҳо пас аз тасдиқи шумо медарояд. Дар корти агент (Хотира → Танзимот) метавон реҷаи худро интихоб кард. |
| `AIHUMMER_MEMORY_AUTOREPAIR` | Ислоҳи худкори хотира | `bool` | `1` | фавран | Пас аз худсанҷӣ хотираро ислоҳ кардан: такрориҳоро муттаҳид кардан, зиддиятҳои ғолиби равшандоштаро бастан (тасдиқи инсон, санаи дертари рӯйдод, манбаи вазнинтар), далелҳои «тасдиқшуда»-еро, ки ягон инсон тасдиқ накардааст, аз рӯи манбаъҳояшон аз нав санҷидан (тасдиқнашудаҳо ба санҷиш мераванд, ҳеҷ чиз нест намешавад). Баҳсбарангез — танҳо ба навбат. Ҳар ислоҳ бо тугмаи бекоркунӣ ба журнал сабт мешавад; агар пас аз гузариш хотира бадтар ёбад, гузариш худ бармегардад ва огоҳинома меояд. Дарҳол амал мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MEMORY_CAPTURE` | Реҷаи сабти хотира | `enum: auto \\\| review \\\| off` | `review` | фавран | Бо далелҳое, ки агент пас аз ҳар ҷавоб дар мукотиба худаш пай мебарад, чӣ кор кардан. «Барои санҷиш» — ба навбати «Хотира → барои санҷиш»: ба ҷавобҳо танҳо пас аз тасдиқи шумо медароянд. «Фавран ба хотира» — бе санҷиш: зудтар, вале зиёдатӣ бештар. «Нигоҳ надоштан» — аз мукотиба далел нагирифтан. Он чизе ки агент бо хоҳиш дар ёд нигоҳ медорад, алоҳида танзим мешавад. |
| `AIHUMMER_MEMORY_CONTEXT_TIMEOUT` | Вақти интизории боркунии хотира | `text` | `3s` | фавран | Агент пеш аз оғози ҷавоб то пайдо шудани хотираҳои мувофиқ чӣ қадар интизор мешавад. Агар ҷустуҷӯ нарасад, агент овезон намешавад, балки бе онҳо ҷавоб медиҳад. Масалан: 2s — 2 сония, 1500ms — 1,5 сония. 0 — чӣ қадар лозим бошад, интизор шудан. |
| `AIHUMMER_MEMORY_DIARY_BOOT` | Рӯзномаи агент дар оғози сессия | `bool` | `1` | фавран | Дар ҳар қадами сессия дар ҳар канал рӯзномаи имрӯз ва дирӯзи агентро пеши назари ӯ нигоҳ доред: қайдҳои сессияҳои пешина, хулосаи шабона ва сабтҳои худи агент. Танҳо сабтҳо дар бораи ҳамсуҳбати ҷорӣ ва сабтҳои умумӣ (аз они шумо, боргузоришуда) нишон дода мешаванд — як мизоҷ ҳеҷ гоҳ сабтҳои дигареро намебинад. На бештар аз ~6000 аломат; боқимондаро агент худаш мехонад (memory_get). Фавран амал мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MEMORY_DIARY_HOUR` | Соати хулосаи шабона | `int` | `3` | фавран | Пас аз кадом соат (0–23, аз рӯи минтақаи вақти инстанс) хулосаи рӯзи гузашта навишта шавад. Пешфарз 3 — шабона, вақте ки сӯҳбатҳои рӯз ба охир расидаанд. Фавран амал мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MEMORY_DIARY_NIGHTLY` | Хулосаи шабонаи рӯз дар рӯзномаи агент | `bool` | `1` | фавран | Рӯзе як бор ба рӯзномаи агент хулосаи рӯзи гузаштаро нависед — алоҳида барои ҳар ҳамсуҳбат (ҳамаи каналҳои ӯ якҷоя): чӣ хоҳиш карданд ва чӣ иҷро шуд, созишҳо, корҳо бо санаҳо. Барои ҳар агент ва ҳамсуҳбат як даъвати модели вазифаҳои хидматӣ, дар як гузариш ҳар 10 дақиқа на бештар аз 3; рӯзҳои аз даст рафта то як ҳафта пеш пур карда мешаванд. Сӯҳбатҳо бо «дар хотир нигоҳ надор» гирифта намешаванд. Ҳангоми хомӯш будани ҷамъоварии хотира навишта намешавад. Натиҷаи гузариши охирин дар корти агент → Хотира → Рӯзнома намоён аст. Фавран амал мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MEMORY_DREAM_INTERVAL` | Фосилаи гузариши «хоб» | `string` | `1h` | фавран | Чанд вақт як бор гузариши худнигаҳдорандаи dream даъвоҳои санҷидашударо дар ҳамаи доираҳо барои зиддият месанҷад (Go duration, мас. 30m/1h/6h). 0 = хомӯш кардан. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MEMORY_EXTRACT` | Истихроҷи фактҳо тавассути LLM | `bool` | `1` | фавран | Ба ҷои нигоҳ доштани порчаҳои хоми ҷумла, далелҳои муназзами субъект/предикат/объектро тавассути LLM ҷудо кардан (пешфарз ФАЪОЛ) — барои кори механизмҳои граф/зиддият/dream зарур аст. Ба ҳар паёми сабтшуда як даъвати LLM илова мекунад; барои сарфаи он хомӯш кунед. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MEMORY_MEANING_TIMEOUT` | Мӯҳлати ҷустуҷӯ аз рӯи маъно | `text` | `4s` | фавран | Ҷустуҷӯ дар хотира ва пойгоҳи дониш ҷустуҷӯ аз рӯи маъноро чӣ қадар интизор мешавад. Агар модели маъно банд бошад (масалан, пас аз воридот векторҳоро ҳисоб мекунад) ва сари вақт ҷавоб надиҳад, агент ба ҷои даҳҳо сония интизорӣ ёфтаҳоро аз рӯи калимаҳо бо қайд фавран мегирад. Масалан: 4s — 4 сония, 1500ms — 1,5 сония. 0 — чӣ қадар лозим бошад, интизор шудан. Фавран амал мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MEMORY_QUALITY_CHECK` | Худсанҷиши ҳаррӯзаи хотира | `bool` | `1` | фавран | Шабонарӯзе як бор хотира ба худ оид ба далелҳои тасдиқшудааш саволҳои назоратӣ (то 60 далел, ҳар рӯз ҳамон саволҳо) ва саволҳои бе ҷавоб медиҳад, онҳоро аз ҷустуҷӯи хотира ва ёдоварии худкор мегузаронад ва пуррагӣ, дақиқӣ, MRR ва ёдовариҳои бардурӯғро ҳисоб мекунад. Натиҷа ва ҷадвали рӯзона: Хотира → Сифати хотира. Саволҳоро ба далелҳои нав модели хидматӣ як бор тартиб медиҳад (ҳамон модел, ки аз мукотиба далел мебарорад; бе он — бо қолиб); натиҷаҳо дар инстанс мемонанд. Дарҳол амал мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MEMORY_RECALL` | Ба ёд овардани худкори хотира | `enum: strong \\\| always \\\| off` | `strong` | фавран | Оё ёфтаҳои хотираро ба ҷавоб худкор илова кардан. «Танҳо мутобиқатҳои дақиқ» — далел бояд бо паём ҳадди ақал дар ду калимаи муҳим мувофиқ ояд; саломҳо ва «ок» хотираро намекашанд. «Ҳама чизи монанд» — ҳар чизе ки ба навъе мувофиқ омад ва сабтҳои алоқаманд: зиёдатӣ бештар. «Илова накардан» — агент ҳангоми зарурат худаш дар хотира меҷӯяд. |
| `AIHUMMER_MEMORY_RECALL_MAX` | Далелҳо барои як ҷавоб | `int` | `5` | фавран | Шумораи ҳадди аксари далелҳои хотира, ки ба як ҷавоб илова мешаванд (пешфарз 5). Баёнҳои гуногуни ҳамон як далел як ҳисоб мешаванд. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MEMORY_RECALL_MIN_SCORE` | Мутобиқати ҳадди ақал барои ба ёд овардани худкор, % | `int` | `10` | фавран | Далел бояд чанд фоизи калимаҳои маънодори паёмро (бо назардошти камёбӣ) фаро гирад, то худкор илова шавад. Пешфарз 10 — дар мукотибаи воқеӣ танзим шудааст. Бештар = камтар ва дақиқтар, камтар = бештар ва бо садои зиёдтар. Ба ҷустуҷӯи ошкори memory_search таъсир намерасонад. 0 — бе ҳад: ду калимаи маънодори мувофиқ кифоя аст. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MEMORY_RECALL_MIN_SIMILARITY` | Ҳадди ақали монандии маъноӣ барои иловаи худкор, % | `int` | `86` | фавран | Танҳо барои ҷустуҷӯи хотира аз рӯи маъно (эмбеддер): далел бояд аз ҷиҳати маъно ба паём то чӣ андоза наздик бошад, то худкор илова шавад, бо фоизи монандӣ. Пешфарз 86 — барои модели multilingual-e5-base дар хотираи воқеӣ интихоб шудааст: аз он поёнтар қариб ба ҳар паём далелҳои бегона илова мешаванд. Моделҳои дигар (масалан, bge-m3) монандиро дигар хел ҳисоб мекунанд — қиматро бо «Аз хотира пурсидан» дар корти агент интихоб кунед. 0 — бе ҳад. Ба ҷустуҷӯи ошкори memory_search таъсир намерасонад. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MEMORY_RETRIEVAL` | Реҷаи бозёбии хотира | `enum: fulltext \\\| embedding` | `fulltext` | пас аз бозоғозӣ | Агент дар хотира чизи лозимиро чӣ гуна меҷӯяд. «Аз рӯи калимаҳо» — ҷустуҷӯи оддии матн: фавран кор мекунад ва серверро бор намекунад. «Аз рӯи маъно» — чизи аз ҷиҳати маъно наздикро меёбад, ҳатто бо калимаҳои дигар гуфташударо, вале модели ҷустуҷӯи маъноӣ (бахши «Хизматҳои иловагӣ») ва сарбории назарраси протсессор лозим аст. |
| `AIHUMMER_QDRANT_API_KEY` | Калиди API-и Qdrant | `text` | — | пас аз бозоғозӣ | Калиди API-и Qdrant, агар анбори векторӣ иҷозат талаб кунад. Танҳо ҳангоми муайян будани суроғаи Qdrant лозим аст. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_QDRANT_URL` | URL-и Qdrant (анбори доимии векторӣ) | `text` | — | пас аз бозоғозӣ | Суроғаи анбори Qdrant барои ҷустуҷӯи маъноӣ. Холӣ — маълумоти ҷустуҷӯ дар хотира нигоҳ дошта мешавад ва ҳангоми бозоғози сервер гум мешавад; барои кори доимӣ суроға муқаррар кунед. |
| `AIHUMMER_RAG_QUERY_EXPANSION` | Бо модел дубора таҳрир кардани дархостҳо ба пойгоҳи дониш | `bool` | `0` | фавран | Пеш аз ҷустуҷӯ дар пойгоҳи дониш аз модели вазифаҳои хидматӣ 3 баёни дигари дархостро пурсидан ва бо ҳамааш ҷустуҷӯ кардан. Баъзан бештар меёбад, вале ин дар ҲАР ҷустуҷӯ даъвати иловагии модел аст (квота ва таъхир); агар модел ноком шавад, танҳо бо баёни аслӣ ҷустуҷӯ мешавад ва хато дар журнал ва натиҷаи ҷустуҷӯ дида мешавад. Бо пешфарз хомӯш: калимаҳо ба ҳар ҳол бо ҷустуҷӯи пурраматнӣ ёфт мешаванд. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_RERANKER_URL` | URL-и сайдкари азнавтартиббандии RAG | `text` | — | пас аз бозоғозӣ | HTTP-URL-и сайдкари кросс-энкодер барои аз нав рутбабандии ҷустуҷӯи гибридӣ. Холӣ = аз нав рутбабандӣ хомӯш. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
## Moderation
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_MODERATION` | Модератсияи воридот | `bool` | `1` | фавран | «off» муҳофизати дарунсохтро аз jailbreak/prompt-injection хомӯш мекунад. Ҳар қимати дигар = фаъол. Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест. |
| `AIHUMMER_MODERATION_REFUSAL` | Паёми радкунии модератсия | `text` | — | фавран | Матни радкунӣ, ки ҳангоми бастани дархост аз ҷониби модератор бармегардад (холӣ = дарунсохт). Фавран эътибор пайдо мекунад, бозоғозӣ лозим нест. |
## Network
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_OUTBOUND_PROXY_CUSTOM_URL` | Проксии баромад: нишонии худ | `text` | — | фавран | URL-и проксии HTTPS; HTTP танҳо барои loopback, бе роҳ, дархост ва фрагмент иҷозат аст. Аввал суроғаро захира кунед, баъд custom-ро интихоб кунед. Дар API пинҳон ва дар танзимоти барнома захира мешавад. |
| `AIHUMMER_OUTBOUND_PROXY_MODE` | Проксии баромад барои таъминкунандагони моделҳои хориҷӣ | `enum: auto \\\| off \\\| custom` | `auto` | фавран | Сервер ба таъминкунандагони хориҷии моделҳо чӣ тавр муроҷиат мекунад. «Мисли таъминкунанда» — тавре ки дар кабинети таъминкунанда муқаррар шудааст; «Мустақим, бе прокси» — бе миёнаравҳо; «Тавассути прокси худ» — тавассути суроғае, ки дар поён нигоҳ доштед. Кор кардан ё накардан аз қоидаҳои таъминкунандаи мушаххас вобаста аст. |
| `AIHUMMER_RUSSIAN_TRUSTED_EXTRA_HOSTS` | Хостҳои берун аз .ru барои решаҳои Вазорати рушди рақамии Русия | `list` | — | пас аз бозоғозӣ | Рӯйхати ҳостҳое, ки бо вергул ҷудо шудаанд, ки барои тафтиши решаҳои Вазорати рушди рақамии Русия OVER доменҳои русӣ иҷозат дода шудаанд (.ru/.su/.рф - аллакай дохил карда шудаанд). Агар гиреҳи шумо бо сертификати Вазорати рушди рақамии Русия дар домени дигар зиндагӣ кунад, лозим аст. Бо ном ё сарҳади зердомен мувофиқат кунед: example.com api.example.com-ро фаро мегирад. Холӣ = танҳо доменҳои русӣ. Ҳангоми оғоз/пас аз бозоғоз истифода мешавад. |
## Performance
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_CHANNEL_TURN_QUEUE_WAIT_SEC` | Интизорӣ дар навбат: паёми канал (сония) | `int 10…1200` | `600` | фавран | Вақте ки ҳамаи ҷойҳои қадамҳо банданд, паёми канал (Telegram ва дигарон) ҷойи холиро чанд вақт интизор мешавад. Агар сари вақт ҷой наёбад, ба инсон хабар дода мешавад, ки сервер банд аст ва метавонад боз нависад. Интизорӣ ба ҳадди 30-дақиқаинаи қадам дохил мешавад. 10–1200. Фавран амал мекунад. |
| `AIHUMMER_MAX_ACTIVE_TURNS` | Қадамҳои агентҳо дар як вақт (тамоми сервер) | `int 1…512` | `32` | фавран | Сервер дар як вақт чанд қадами агентро (ҷавобҳо дар каналҳо ва веб-чат, ҷадвалҳо) иҷро мекунад. Боқимонда дар навбат то он қадар интизор мешаванд, ки танзимоти «Интизорӣ дар навбат» дар поён иҷозат медиҳанд, ва инсон «сервер банд аст, дар навбат» мебинад. Бештар — интизорӣ камтар, аммо хотира, пайвастҳо бо пойгоҳи додаҳо ва дархостҳои ҳамзамон ба модел бештар. Нисфи ин шумора дархостҳои ёрирасони ҳамзамони моделро (истихроҷи хотира, хулосаҳо) маҳдуд мекунад. 1–512. Фавран амал мекунад. |
| `AIHUMMER_SYNC_INBOUND_QUEUE_WAIT_SEC` | Интизорӣ дар навбат: дархости синхронии интегратсия (сония) | `int 1…120` | `10` | фавран | Вақте ки ҳамаи ҷойҳои қадамҳо банданд, дархости интегратсияе, ки ҷавобро дар ҳамон дархост интизор аст, ҷойи холиро чанд вақт интизор мешавад. Агар ҷой наёбад, интегратсия бо маслиҳати пас аз ҳамон миқдори сония такрор кардан «сервер банд аст» мегирад; такрор бо ҳамон рақами паём онро бори дуюм сабт намекунад. 1–120. Фавран амал мекунад. |
| `AIHUMMER_WEB_TURN_QUEUE_WAIT_SEC` | Интизорӣ дар навбат: паёми веб-чат (сония) | `int 10…1200` | `180` | фавран | Вақте ки ҳамаи ҷойҳои қадамҳо банданд, паёми веб-чат ҷойи холиро чанд вақт интизор мешавад. Дар ин муддат дар чат «сервер банд аст, дар навбат» намоён аст; агар сари вақт ҷой наёбад, ҷавоб бо тугмаи «Такрор» рад карда мешавад, ки пас аз аз нав боркунии саҳифа низ дар таърих мемонад. 10–1200. Фавран амал мекунад. |
## Public access
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_PUBLIC_URL` | Суроғаи ҷамъиятии сервер | `text` | — | қисман пас аз бозоғозӣ | Суроғае, ки панел ва барномаҳо аз интернет кушода мешаванд, масалан https://ai.example.com. Онро тавассути прокси (nginx, Caddy) ба порти сервер равона кунед — бо пешфарз 8780. |
| `AIHUMMER_WIDGET_ALLOWED_ORIGINS` | Виджети веб: origin-ҳои иҷозатшудаи сайтҳо | `list` | — | фавран | Рӯйхати browser origin-ҳо бо вергул, ки метавонанд виджети веб-чатро ҷойгир кунанд, масалан https://example.com,https://www.example.com. Схема ва порт бояд дақиқ мувофиқат кунанд. Холӣ = ҳеҷ сайти беруна виджетро истифода бурда наметавонад. Сабти `*` қасдан нодида гирифта мешавад, зеро дар акси ҳол ҳар саҳифаи интернет метавонист буҷети ин инстансро сарф кунад. |
| `POCKET_AGENT_GATEWAY_BASE_URL` | URL-и оммавии дарвозаи pocket-agent | `text` | — | фавран | → ба порти шлюзи pocket-agent прокси кунед (POCKET_AGENT_PORT, пешфарз 8080). Агенти дурдаст тавассути тикети яквақта ба ин ҷо пайваст мешавад. |
| `TELEGRAM_PUBLIC_URL` | URL-и оммавии вебхуки Telegram | `text` | — | фавран | Танҳо барои реҷаи webhook — → ба порти telegram-connector прокси кунед (пешфарз 8091). Барои реҷаи polling холӣ монед (URL-и ҷамъиятӣ лозим нест). |
## SSO (LDAP/AD)
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_LDAP_BASE_DN` | DN-и базавии ҷустуҷӯи корбарон | `text` | — | пас аз бозоғозӣ | Ҷустуҷӯи реша, масалан. OU = Истифодабарандагон, DC = corp, DC = мисол. |
| `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` | — | пас аз бозоғозӣ | масалан. ldaps://ad.corp.example:636 (TLS) ё 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). |
## Schedules
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_SCHEDULE_AGENT_MAX_ACTIVE` | Агент: ҳадди ҷадвалҳои фаъол | `int` | `20` | фавран | Як агент ҳангоми худаш сохтан ё фаъол кардани ҷадвал (бо абзорҳои ҷадвали худ) чанд ҷадвали фаъол дошта метавонад. Ҷадвалҳои дар панел сохташуда низ ба ҳисоб медароянд, аммо ба панел ҳеҷ гоҳ рад карда намешавад. Дар ҳадд аз агент хоҳиш мекунанд, ки аввал якеро боздорад ё нест кунад. Фавран амал мекунад. |
| `AIHUMMER_SCHEDULE_AGENT_MAX_FIRES_PER_DAY` | Агент: иҷроҳои ҷадвал дар як шабонарӯз | `int` | `288` | фавран | Ҳамаи ҷадвалҳои як агент якҷоя дар як шабонарӯз (аз рӯи UTC) чанд маротиба иҷро шуда метавонанд, аз ҷумла ҷадвалҳои дар панел сохташуда ва иҷроҳои дастӣ. Иҷроҳои болотар аз ҳадд гузаронида мешаванд ва дар маҷаллаи иҷроҳо намоёнанд. Фавран амал мекунад. |
| `AIHUMMER_SCHEDULE_AGENT_MIN_INTERVAL_MINUTES` | Агент: фосилаи ҳадди ақали ҷадвал, дақиқа | `int` | `5` | фавран | Кӯтоҳтарин фосила байни ду иҷрои ҷадвали такрорие, ки агент худаш месозад ё тағйир медиҳад. Ҷадвали зудтар рад карда мешавад. Ҷадвалҳои дар панел сохташуда бо ин маҳдуд намешаванд. Фавран амал мекунад. |
| `AIHUMMER_SCHEDULE_COMMANDS` | Фармонҳои сервер дар ҷадвалҳо | `bool` | `0` | фавран | Ба ҷадвал иҷозат медиҳад, ки дар ин сервер барнома иҷро кунад — ҷамъоваранда, ҳисобот, санҷиши нусхаи эҳтиётӣ. Бо пешфарз хомӯш аст. Танҳо фармонҳои рӯйхати «Фармонҳои иҷозатдодашуда», айнан тавре ки навишта шудаанд, иҷро мешаванд; shell нест. Баровард ба агент ё мустақиман ба чат меравад ва ҳар иҷро дар маҷаллаи иҷроҳои ҷадвал намоён аст. Фавран амал мекунад. |
| `AIHUMMER_SCHEDULE_COMMANDS_ALLOWLIST` | Фармонҳои иҷозатдодашуда | `argvlist` | — | фавран | Фармонҳои дақиқе, ки ҷадвал метавонад иҷро кунад: барнома (номе мисли df ё роҳи пурра) ва аргументҳои он. Ҷадвал танҳо фармонеро иҷро мекунад, ки бо аргументҳояш ба сабт пурра мувофиқ аст. Фармони хориҷшуда ҷадвалҳоеро, ки онро истифода мебаранд, қатъ мекунад ва иҷроҳои онҳо сабабро мегӯянд. Фавран амал мекунад. |
| `AIHUMMER_SCHEDULE_COMMANDS_MAX_OUTPUT_KB` | Ҳадди бароварди фармони ҷадвал, КБ | `int 1…1024` | `64` | фавран | Чӣ қадар аз бароварди фармон (1–1024 КБ) дар маҷаллаи иҷроҳо нигоҳ дошта шуда, ба агент ё чат дода мешавад; боқимонда бурида мешавад ва маҷалла инро мегӯяд. Фавран амал мекунад. |
| `AIHUMMER_SCHEDULE_COMMANDS_SANDBOX` | Фармонҳои ҷадвалро дар қуттии регии СО иҷро кардан | `bool` | `1` | фавран | Фаъол: фармон мисли иҷрои код дар қуттии регии СО кор мекунад — сирҳои насб ва калидҳои SSH пинҳон карда мешаванд ва он танҳо ба ҷузвдони муваққатии худ навишта метавонад. Агар дар сервер қуттии регӣ (bubblewrap) набошад, фармон иҷро намешавад ва маҷалла сабабро мегӯяд. Хомӯш: он бо ҳуқуқҳои дарвоза кор мекунад. Фавран амал мекунад. |
| `AIHUMMER_SCHEDULE_FAILURE_ADMIN` | Дар бораи нокомиҳои супоришҳо ба маъмур хабар додан | `bool` | `1` | фавран | Агар супориши банақшагирифта иҷро нашавад ё оғоз шуда натавонад, дар зангӯлаи огоҳиҳои панел огоҳӣ бо номи он, сабаб ва ҷое, ки онро ислоҳ кардан мумкин аст, пайдо мешавад ва ҳамин паём ба чатҳои шахсии каналии соҳибон фиристода мешавад (барои ҳар супориш на бештар аз як бор дар 6 соат). Ин илова ба паём ба гирандаи супориш аст. Хомӯш: маъмур дар бораи нокомиҳо танҳо аз журнали иҷроҳо огоҳ мешавад. Фавран амал мекунад. |
| `AIHUMMER_SCHEDULE_FAILURE_NOTIFY` | Дар бораи нокомии вазифа ба гиранда хабар додан | `bool` | `1` | фавран | Агар вазифаи ҷадвалӣ иҷро нашавад, ба ҳамон гиранда паёми кӯтоҳ фиристода мешавад (пас аз нокомии аввал, на бештар аз як бор дар 6 соат). Хомӯш — нокомиҳо танҳо дар маҷаллаи иҷроҳо дида мешаванд. Барои вазифаи алоҳида инро дар шакли он хомӯш кардан мумкин аст. Фавран амал мекунад. |
## Security
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_AIRGAPPED` | Реҷаи ҷудошуда (бе интернет) | `bool` | `0` | фавран | Ба агентҳо баромадан ба интернетро манъ мекунад: ҷустуҷӯи веб, кушодани саҳифаҳо ва дархостҳо танҳо ба суроғаҳои дохилӣ ва суроғаҳои рӯйхатҳои иҷозатдодашуда мерасанд. Барои шабакаҳои пӯшида бе баромад ба берун фаъол кунед. |
| `AIHUMMER_AUDIT_RETENTION_DAYS` | Маҷаллаи амалҳоро чанд рӯз нигоҳ доштан | `int` | `0` | пас аз бозоғозӣ | Сабтҳои лоҷи аудит ва таърихи тағйироти танзимот, ки аз ин мӯҳлат кӯҳнаанд, рӯзе як бор нест карда мешаванд. 0 ё холӣ — ҳамеша нигоҳ доштан. |
| `AIHUMMER_CORS_ORIGINS` | Origin-ҳои иҷозатдодашуда барои CORS | `list` | — | пас аз бозоғозӣ | Рӯйхати Origin-ҳои иҷозатдодашуда бо вергул. Холӣ = CORS иҷозат дода намешавад (танҳо same-origin). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_CSP` | Сарлавҳаи Content-Security-Policy (бознависӣ) | `text` | — | пас аз бозоғозӣ | Сарлавҳаи CSP-ро бознависӣ мекунад. Холӣ = пешфарзи бехатар. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад. |
| `AIHUMMER_INBOUND_SECRET` | Калиди пайвасти плагинҳои канал бо сервер | `text` | — | пас аз бозоғозӣ | Каналҳои пайвастшуда (Telegram, VK ва дигарон) бо он тасдиқ мекунанд, ки паёмҳо маҳз аз онҳо омадаанд. Ҳангоми насб худкор муқаррар мешавад — иваз кардан лозим нест. Агар холӣ бошад, то муқаррар шудани калид сервер ҳамаи каналҳоро рад мекунад. |
| `AIHUMMER_OPENAI_COMPAT_KEY` | Вуруди мутобиқ бо OpenAI: калиди статикии API | `text` | — | пас аз бозоғозӣ | Калиди умумӣ барои барномаҳое, ки ба сервер ҳамчун хизмати мутобиқ ба OpenAI пайваст мешаванд. Холӣ — калиди умумӣ хомӯш аст; бо калидҳои шахсӣ аз саҳифаи «Калидҳои API» пайваст шудан мумкин аст. |
| `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` | Проксиҳои боэътимод | `list` | — | фавран | Агар дар пеши сервер прокси (nginx, Caddy, мувозинатгар) бошад, суроға ё шабакаи онро бо вергул нависед, масалан 10.0.0.0/8. Он гоҳ дар маҷаллаи амалҳо, рӯйхати IP-ҳои иҷозатдодашуда ва ҳифз аз интихоби парол суроғаи воқеии меҳмон дида мешавад. Холӣ — танҳо суроғаи пайвасти мустақим ба ҳисоб гирифта мешавад ва онро иваз кардан ғайриимкон аст. |
## Tools
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_BROWSER_ALLOWED_HOSTNAMES` | Браузер: истисноҳои мизбони хусусӣ | `list` | — | фавран | Номҳои дақиқ бо вергул, бе қолаб, URL ва порт. Истисноҳои иловагии хусусӣ барои CDP-и маҳаллӣ дар сервери худ, ҷудо аз web_fetch. |
| `AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK` | Браузер: иҷозаи шабакаи хусусӣ | `bool` | — | фавран | Холӣ қоидаи пешинаро нигоҳ медорад; true ё false санҷиши CDP-и маҳаллиро фаъол мекунад. Дастрасии хусусӣ танҳо дар сервери худ. Loopback, link-local ва metadata баста мемонанд. |
| `AIHUMMER_BROWSER_PROFILE_SOCKET` | Сокети идораи профилҳои браузер | `text` | — | фавран | Ихтиёрӣ. Холӣ бошад — шлюз сокети идоракунии managed-profiles.sock-и хидмати браузерро дар ҷои стандартии насб худаш меёбад. Профилҳои воридшуда ба сайтҳо дар саҳифаи «Пайвастҳо» → «Профилҳои браузер» сохта мешаванд. Ин URL нест ва роҳ ба профили аслӣ ҳам нест. |
| `AIHUMMER_CODE_EXEC` | Иҷрои код аз ҷониби агент | `enum: off \\\| host \\\| sandbox` | `off` | фавран | Абзори иҷрои коди агент (code_exec). Бо пешфарз — «Хомӯш». «Дар ҳамин сервер»: фармонҳо дар сервери шлюз иҷро мешаванд; муҳити ҷудошудаи СА (bubblewrap) сирҳои насбро пинҳон мекунад, аммо агент дар реҷаи «Бе маҳдудият» калидҳои SSH-ро мебинад ва метавонад берун аз ҷузвдони худ нависад — танҳо барои сервери боэътимод. «Танҳо дар муҳити ҷудошуда»: ҳамеша дар муҳити ҷудошудаи СА — сирҳо ва калидҳо пинҳонанд, навиштан танҳо ба ҷузвдони агент; бе bubblewrap (ё тасвири контейнер) ин реҷа нигоҳ дошта намешавад. Он чи ҳар агент метавонад иҷро кунад, дар худи агент муайян мешавад: «Агентҳо → профил → Абзорҳо». |
| `AIHUMMER_CODE_EXEC_INTERPRETERS` | Интерпретаторҳои code-exec (JSON) | `text` | — | фавран | Объекти JSON {language: path_to_binary}, мас. {\\"python\\":\\"/usr/bin/python3\\"}. Холӣ = муайянкунии худкор. |
| `AIHUMMER_CODE_EXEC_NET_PORTS` | Портҳои шабакаи барои рамзи агент кушода | `list` | `53,80,443` | фавран | Портҳои TCP, ки рамзи агент дар қуттии регии системаи амалиётӣ (иҷрои рамз ва фармонҳои ҷадвал) метавонад ба онҳо пайваст шавад, бо вергул ҷудо. Бо пешфарз 53, 80 ва 443: DNS ва сомонаҳо. Хидматҳои дигари ин сервер ва шабакаи маҳаллии он (пойгоҳи додаҳо, лавҳаи идоракунӣ, браузер, adb, моделҳои маҳаллӣ, Home Assistant) барои рамзи агент пӯшида мемонанд. Порти рӯйхат дар ҳар суроға, аз ҷумла дар ин сервер кушода аст, пас танҳо он чиро илова кунед, ки ба рамз лозим аст, масалан 22 барои SSH. Барои бекор кардани маҳдудият any нависед. Агентҳо дар реҷаи «Бе маҳдудият» маҳдуд намешаванд. Linux 6.7 ё навтар лозим аст; бе он маҳдудият амал намекунад ва дар Агентҳо → Абзорҳо дар ин бора гуфта мешавад. Фавран амал мекунад. |
| `AIHUMMER_CODE_EXEC_READ_DIRS` | Ҷузвдонҳои барои хондани рамзи агент кушода | `list` | — | фавран | Ҷузвдонҳои ин сервер, ки рамзи агент метавонад хонад: иҷрои рамз ва фармонҳои ҷадвал дар қуттии регии системаи амалиётӣ. Бо вергул ё дар ҳар сатр як, масалан ~/reports. Шумо метавонед як файли алоҳидаро низ нишон диҳед, масалан ~/scripts/report.py. Он чи дар ин ҷо кушода мешавад, ба рамзи ҳамаи агентҳо намоён аст, пас танҳо он чиро кушоед, ки ба рамз лозим аст. Бо пешфарз холӣ: дар қуттии регӣ рамз танҳо ҷузвдони агенти худ ва ҷузвдонҳои системавиро мебинад; ҷузвдони хонагии корбари дарвоза, маълумоти насб, ҷузвдонҳои агентҳои дигар, калидҳо ва таърихи фармонҳо пинҳон мемонанд. Решаро, тамоми ҷузвдони хонагӣ, маълумоти насб ва ҷойҳои калиддорро кушодан мумкин нест. Рамз ба ин ҷузвдонҳо навишта наметавонад. Дарҳол амал мекунад. |
| `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Тасвири песочкаи code-exec | `text` | — | фавран | Ихтиёрӣ, танҳо барои реҷаи «Танҳо дар муҳити ҷудошуда»: тасвири контейнери Docker ба ҷои муҳити ҷудошудаи СА (бе шабака, решаи танҳо барои хондан, маҳдудиятҳо); дар сервер Docker лозим аст. Холӣ = муҳити ҷудошудаи СА (bubblewrap). |
| `AIHUMMER_CODE_EXEC_TIMEOUT_SECONDS` | Маҳдудияти вақти иҷрои код (сония) | `int` | `1800` | фавран | Як фармони агент, аз ҷумла фармонҳои заминавӣ, чӣ қадар кор карда метавонад: аз 10 сония то 24 соат. Фармоне, ки дар 30 сония ҷавоб надод, қатъ намешавад, балки ба замина мегузарад ва агент онро бо абзори process месанҷад. Агент метавонад мӯҳлати кӯтоҳтар талаб кунад, на дарозтар. |
| `AIHUMMER_DB_QUERY_DSN` | Пайвастшавӣ ба пойгоҳ барои абзори «Дархост ба пойгоҳ» | `text` | — | фавран | Сатри пайвастшавӣ ба пойгоҳи додаҳо, ки агент хонда метавонад (танҳо хондан), масалан postgres://reader:парол@host/db. Корбари дорои ҳуқуқҳои ҳадди ақалро нишон диҳед — на соҳиби пойгоҳро. Холӣ — абзор хомӯш аст. |
| `AIHUMMER_FS_ROOT` | Решаи абзори системаи файлӣ | `text` | — | фавран | Ҷузвдоне, ки дар доираи он агент файлҳои серверро мехонад (filesystem_read; агент файл навишта наметавонад). Холӣ = тамоми сервер бо ҳуқуқҳои корбари дарвоза, ба истиснои сирҳо: танзимоти насб (gateway.env), калидҳои SSH/GPG ва муҳити равандҳо. Барои маҳдуд кардани дастрасӣ ҷузвдонро нишон диҳед. |
| `AIHUMMER_HTTP_ALLOWLIST` | Суроғаҳо барои дархостҳои HTTP-и агент | `list` | — | фавран | Рӯйхати хостҳо бо вергул, ки абзори http_request метавонад ба онҳо муроҷиат кунад. Холӣ = ҳама иҷозат дода мешаванд, ба ҷуз суроғаҳои дохилӣ ва хусусӣ. |
| `AIHUMMER_HTTP_AUTH_JSON` | Авторизатсияи http_request (JSON) | `text` | — | фавран | Харитаи JSON-и мутобиқати хост ба сарлавҳаҳои иҷозат барои абзори http_request, то токенҳо дар промпт нигоҳ дошта нашаванд. Холӣ = бе иҷозат. |
| `AIHUMMER_MCP_SERVERS` | Серверҳои MCP (JSON) | `text` | — | фавран | Тавсифи JSON-и серверҳои берунии MCP, ки абзорҳояшон ба агент васл мешаванд. Холӣ = MCP-и берунӣ нест. |
| `AIHUMMER_PROJECT_STUDIOS_PUBLIC_NETWORK` | Студияҳои лоиҳаҳо: шабакаи умумӣ | `bool` | `false` | фавран | HTTP(S)-и умумиро барои провайдерҳои интихобшуда ва боргириҳои ошкоро дархостшудаи моделҳо иҷозат диҳед. Нишониҳои хусусӣ, маҳаллӣ ва метамаълумот баста мемонанд. Ҳолати офлайн бартарӣ дорад. Фавран татбиқ мешавад. |
| `AIHUMMER_SIDECAR_CLOAKBROWSER` | Браузер барои агент (CloakBrowser) | `bool` | `0` | фавран | Браузери зидди ошкор (асбобҳои CloakBrowser, browser/computer). Он чизе, ки ба бастаи таҳвил дохил карда нашудааст: дохилкунӣ иловаи имзошударо зеркашӣ мекунад (~ 477 МБ, аз он Chromium ~ 207 МБ) ва хидматро дар ҳост насб мекунад. Вазнинтарин вагонҳои паҳлӯӣ - танҳо дар ҳолате фаъол созед, ки агент бояд вебсайтҳоро кушояд. |
| `AIHUMMER_SIDECAR_SEARXNG` | Ҷустуҷӯи веб (SearXNG) | `bool` | `0` | фавран | Ҷустуҷӯи веб (SearXNG, web_search асбоб). Ба баста дохил НЕСТ: фурӯзон кардани замимаи имзошуда (~154 МБ) зеркашӣ карда, хидматро дар ҳост насб мекунад, хомӯш кардани он онро қатъ мекунад ва ҷой холӣ мекунад. Насбкунӣ дар замина сурат мегирад ва чанд дақиқа мегирад; давлат дар ин ҷо нишон медиҳад, ки дар асл дар сервер аст,. |
| `AIHUMMER_WEBFETCH_ALLOWLIST` | Сайтҳое, ки агент кушода метавонад | `list` | — | фавран | Рӯйхати доменҳо бо вергул, ки абзори web_fetch метавонад ба онҳо муроҷиат кунад. Холӣ = ҳама иҷозат дода мешаванд, ба ҷуз суроғаҳои дохилӣ ва хусусӣ. |
| `AIHUMMER_WEB_SEARCH_LANGUAGE` | Ҷустуҷӯи веб: забони пешфарзи натиҷаҳо | `text` | `auto` | фавран | Забони натиҷаҳо, вақте ки агент онро нишон намедиҳад: рамз ба монанди ru, en ё de, ё auto барои муайян кардан аз худи дархост (қариб ҳамеша мувофиқ аст). Агент метавонад барои ҷустуҷӯи мушаххас забони дигар интихоб кунад. |
| `AIHUMMER_WEB_SEARCH_RESULTS` | Ҷустуҷӯи веб: натиҷаҳо дар як ҷустуҷӯ | `int` | `5` | фавран | Ҷустуҷӯ чанд натиҷа бармегардонад, вақте ки агент шумораи дигар намехоҳад: аз 1 то 10. Натиҷаҳои бештар ҷавоби пурратар медиҳанд, аммо контекст дарозтар мешавад. |
| `AIHUMMER_WEB_SEARCH_SOURCE` | Манбаи ҷустуҷӯи веб | `enum: auto \\\| searxng \\\| provider` | `auto` | фавран | Агент дар интернет аз куҷо ҷустуҷӯ мекунад (абзори web_search). auto — SearXNG, агар насб бошад, вагарна ҷустуҷӯи дарунсохти провайдери модел. searxng — танҳо SearXNG: бе он ҷустуҷӯ нест. provider — ҷустуҷӯи дарунсохти провайдер дар ҷое ки ҳаст, ва SearXNG барои моделҳои дигар. Ҷустуҷӯи дарунсохт дар Codex (обунаи ChatGPT) ва OpenAI (api.openai.com) ҳаст; дар GigaChat, YandexGPT ва дигар моделҳои мувофиқ бо OpenAI нест — бе SearXNG агентҳо дар ин моделҳо ҷустуҷӯ намекунанд. Claude (api.anthropic.com ва обунаи Claude) ҷустуҷӯи дарунсохти Anthropic-ро истифода мебарад; агар ҳисоб онро рад кунад, шлюз инро дар маҷалла менависад ва минбаъд ба агент танҳо SearXNG пешниҳод мекунад. Ба кадом агентҳо ҷустуҷӯ иҷозат аст, мисли пештара дар корти агент муқаррар мешавад. Аз қадами навбатӣ амал мекунад. |
| `AIHUMMER_WEB_SEARCH_TIMEOUT_SECONDS` | Муҳлати ҷустуҷӯи веб (сония) | `int` | `30` | фавран | Барои ҳар ҷустуҷӯ1–600 сония. Муҳлати кӯтоҳтари вазифа боқӣ мемонад. |
## Updates
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_RESTART_APPLY` | Татбиқи танзимоте, ки бозоғозиро талаб мекунанд | `enum: quiet \\\| manual` | `quiet` | фавран | quiet (пешфарз) — танзимоти захирашуда, ки танҳо бо оғози нави дарвоза эътибор пайдо мекунанд, худашон татбиқ мешаванд: дарвоза дар наздиктарин лаҳзаи ором, вақте ки агентҳо ҳеҷ кор намекунанд ва одамон на камтар аз равзанаи хомӯшӣ хомӯшанд, аз нав оғоз мешавад. manual — танҳо нишонаи «интизори бозоғозӣ» ва тугма. Бозоғозӣ чанд сония давом мекунад; суҳбатҳо ва вазифаҳо гум намешаванд. Фавран эътибор пайдо мекунад. |
| `AIHUMMER_RESTART_QUIET_MINUTES` | Лаҳзаи ором: дақиқаҳои хомӯшӣ пеш аз бозоғозии худкор | `int 0…1440` | `10` | фавран | Одамон чанд дақиқа бояд хомӯш бошанд (ва агентҳо бекор), то дарвоза худаш аз нав оғоз шуда, танзимоти захирашударо татбиқ кунад. 0 — ҳамин ки агентҳо кори ҷориро анҷом диҳанд. 0–1440. Фавран эътибор пайдо мекунад. |
## Web UI (separate port)
| Калид | Ном | Навъ | Пешфарз | Ба амал медарояд | Чӣ мекунад |
| --- | --- | --- | --- | --- | --- |
| `AIHUMMER_WEBUI_API_BASE` | Суроғаи сервер барои панели алоҳида ҷойгиршуда | `text` | — | пас аз бозоғозӣ | Танҳо вақте лозим аст, ки панел аз суроғаи дигар ғайр аз худи сервер кушода шавад. Суроғаеро нишон диҳед, ки браузер ба сервер мерасад, масалан https://api.example.com. Холӣ — суроғаи ҷамъиятии сервер, агар набошад — суроғаи маҳаллӣ истифода мешавад. |
| `AIHUMMER_WEBUI_ENABLED` | Панел дар порти алоҳида | `bool` | `1` | пас аз бозоғозӣ | Фаъол — панел дар порти дохилии алоҳида кушода мешавад, ки онро аз интернет бастан мумкин аст, порти ҷамъиятӣ бошад танҳо ба барномаҳо ва каналҳо хизмат мекунад. Барои тамоман дастнорас кардани панел хомӯш кунед. |
| `AIHUMMER_WEBUI_ORIGIN` | Суроғае, ки панелро мекушоянд | `text` | — | пас аз бозоғозӣ | Пур кунед, агар панелро тавассути прокси ё бо номе кушоянд, ки аз суроғаи порташ фарқ мекунад, масалан https://admin.example.com. Сервер ба браузер аз ин суроға иҷозат медиҳад, ки ба он муроҷиат кунад. Холӣ — суроғаи порти панел гирифта мешавад. |
Танзимоти барои оператор дастрас: 237.