Жөндөөлөр справочниги

Бул жерде оператор AiHummer серверинде өзгөртө ала турган бардык жөндөөлөр саналат. Барак өнүмдүн өз каталогунан чогултулгандыктан, сиздин сервериңизге дал келет. Маани веб-интерфейсте же `aihummer settings set KEY VALUE` буйругу менен берилет ([Буйрук сабы](/ky/v1.4/reference/cli/)). Демейки маани мамычасында сервер өзүңүздүн мааниңиз берилгенге чейин колдонгон маани көрсөтүлөт. > [!NOTE] > Купуя маанилер бул жерде басылбайт, ал эми жеткирүүчүнүн кызматтык ачкычтары такыр саналбайт — өнүм аларды бардык тизмеден жашырат. Сызыкча бош маанини же веб-интерфейсте гана көрсөтүлгөн түшүндүрмөнү билдирет. ## API | Ачкыч | Аталышы | Түрү | Демейки | Күчүнө кирет | Эмне кылат | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PERSONAL_API_KEYS` | OpenAI-шайкеш үчүн жеке API ачкычтары | `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 жазылуу: OAuth кардар id | `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` | Codex базалык URL дареги | `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` | LLM шлюзунун URL дареги | `text` | — | жарым-жартылай кайра иштеткенден кийин | Агент кайрылган OpenAI менен шайкеш модель эндпоинтинин базалык URL'и (сиздин жергиликтүү 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` | OpenAI API стили (chat \| responses) | `enum: \\\| chat \\\| responses` | — | жарым-жартылай кайра иштеткенден кийин | chat = /chat/completions, responses = /responses. Бош = авто/демейки. Иштетүүдө/кайра иштетүүдөн кийин колдонулат. | | `AIHUMMER_OPENAI_API_KEY` | Нативдик OpenAI API ачкычы (орнотуу үчүн демейки) | `text` | — | жарым-жартылай кайра иштеткенден кийин | Нативдүү OpenAI цикли үчүн OpenAI аккаунтуңуздун ачкычы (эгер OpenAI'ди демейки провайдер катары колдонсоңуз). «Моделдер» барагындагы жумуш мейкиндигинин BYOK'у менен чаташтырбаңыз. Иштетүүдө/кайра иштетүүдөн кийин колдонулат. | | `AIHUMMER_OPENAI_BASE_URL` | Нативдик OpenAI базалык URL дареги | `text` | — | кайра иштеткенден кийин | OpenAI менен шайкеш API'нин базасы (мис. 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` | Deepgram API ачкычы | `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` | Deepgram базалык URL дареги | `text` | — | дароо | Deepgram API'нин базасы. Бош = https://api.deepgram.com. Дароо колдонулат. | | `AIHUMMER_IMAGE_BASE_URL` | Сүрөт API базалык URL дареги (резервдик OpenAI) | `text` | — | дароо | OpenAI ачкычы аркылуу иштегенде /images API'нин базасы (бош = https://api.openai.com/v1). | | `AIHUMMER_IMAGE_MODEL` | Сүрөт түзүү модели | `text` | — | дароо | image_generate үчүн модель (демейки gpt-image-2). | | `AIHUMMER_MEDIA_MAX_UPLOAD_MB` | Медианын макс. жүктөө көлөмү (MB) | `int` | `256` | дароо | Бир жолу жүктөөгө боло турган эң чоң файл (сүрөт, үндүү билдирүү, видео), мегабайт менен. Сервердин дискин толуп калуудан коргойт. Демейки 256. Дароо күчүнө кирет. | | `AIHUMMER_SIDECAR_STT` | Бул серверде сүйлөөнү таануу (faster-whisper) | `bool` | `0` | дароо | Жергиликтүү кепти таануу (faster-whisper). Пакетке ЭМЕС: кол коюлган кошумчаны (Pythonдун бардык версиялары үчүн ~620 МБ) жүктөө жана кызматты хостко орнотууну иштетүү. 🔴 Кошумча өзүнчө сатуучунун чечими менен жарыяланат (анын пакеттери GPL боюнча ffmpeg камтыйт); эгерде ал сиздин релизиңиз үчүн жарыяланбаса, анын ичинде ал бул жөнүндө чынчыл болот жана эч нерсени бузбайт. Булут планы: таануу провайдер тарабынан конфигурацияланган. | | `AIHUMMER_SIDECAR_TTS` | Жоопторду үнгө айландыруу (edge-tts) | `bool` | `0` | дароо | Кеп синтези (edge-tts, Microsoft Edge үндөрү). Пакетке ЭМЕС: кол коюлган кошумчаны жүктөө (~26 МБ) жана кызматты хостко орнотууну иштетүү. Синтездин өзү добуштар үчүн онлайнга өтөт - бул жерде "офлайн" пакетти орнотууну билдирет, иштебей жатат. | | `AIHUMMER_STT_API_KEY` | STT API ачкычы (милдеттүү эмес) | `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` | TTS API ачкычы (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` | Qdrant API ачкычы | `text` | — | кайра иштеткенден кийин | Qdrant API ачкычы, эгер вектордук сактагыч авторизацияны талап кылса. Qdrant дареги көрсөтүлгөндө гана керек. Иштетүүдө/кайра иштетүүдөн кийин колдонулат. | | `AIHUMMER_QDRANT_URL` | Qdrant URL дареги (туруктуу вектор сактагыч) | `text` | — | кайра иштеткенден кийин | Маани боюнча издөө үчүн Qdrant кампасынын дареги. Бош — издөө маалыматтары эс тутумда сакталат жана сервер кайра күйгүзүлгөндө жоголот; туруктуу иш үчүн даректи көрсөтүңүз. | | `AIHUMMER_RAG_QUERY_EXPANSION` | Билим базасына суроолорду модель менен кайра түзүү | `bool` | `0` | дароо | Билим базасынан издөөдөн мурун кызматтык тапшырмалар моделинен суроонун 3 башка түзүлүшүн сурап, баары менен издөө. Кээде көбүрөөк табат, бирок бул АР БИР издөөдө моделге кошумча чакыруу (квота жана кечигүү); модель иштебей калса, баштапкы түзүлүш менен гана изделет, ал эми ката журналда жана издөө жыйынтыгында көрүнөт. Демейки боюнча өчүк: сөздөр толук тексттик издөө менен баары бир табылат. Дароо күчүнө кирет, кайра иштетүү керек эмес. | | `AIHUMMER_RERANKER_URL` | RAG кайра иреттөө сайдкарынын URL дареги | `text` | — | кайра иштеткенден кийин | Гибрид издөөнүн натыйжаларын кайра иреттөө үчүн cross-encoder sidecar'ынын HTTP-URL'и. Бош = кайра иреттөө өчүк. Иштетүүдө/кайра иштетүүдөн кийин колдонулат. | ## Moderation | Ачкыч | Аталышы | Түрү | Демейки | Күчүнө кирет | Эмне кылат | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_MODERATION` | Кирүүчүлөрдү модерациялоо | `bool` | `1` | дароо | «off» jailbreak/prompt-injection'го каршы ички коргоону өчүрөт. Башка каалаган маани = күйгүзүлгөн. Дароо күчүнө кирет, кайра иштетүү керек эмес. | | `AIHUMMER_MODERATION_REFUSAL` | Модерация баш тартуу билдирүүсү | `text` | — | дароо | Модератор сурамды бөгөттөгөндө кайтарылуучу баш тартуу тексти (бош = ички). Дароо күчүнө кирет, кайра иштетүү керек эмес. | ## Network | Ачкыч | Аталышы | Түрү | Демейки | Күчүнө кирет | Эмне кылат | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OUTBOUND_PROXY_CUSTOM_URL` | Чыгуучу прокси: өз дареги | `text` | — | дароо | HTTPS прокси URL-и; 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` | Pocket-agent шлюзунун ачык URL дареги | `text` | — | дароо | → pocket-agent шлюзунун портуна проксилеңиз (POCKET_AGENT_PORT, демейки 8080). Алыскы агент бул жерге бир жолку тикет менен туташат. | | `TELEGRAM_PUBLIC_URL` | Telegram вебхугунун ачык URL дареги | `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'те сакталат (scope ldap, name bind_password). | | `AIHUMMER_LDAP_GROUP_ATTR` | Топ атрибуту (демейки memberOf) | `text` | — | кайра иштеткенден кийин | Колдонуучунун жазуусундагы топтордун DN'дерин тизген атрибут. Бош болсо топ→рол дал келтирүү өчөт. | | `AIHUMMER_LDAP_ROLE_MAPPINGS` | LDAP: Топ→роль дал келүүлөрү (JSON) | `text` | — | кайра иштеткенден кийин | Топтун DN'и (же жөнөкөй CN) → рол JSON-объекти, мис. {\\"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; OpenLDAP үчүн uid, UPN түрүндөгү логиндер үчүн userPrincipalName). | | `AIHUMMER_LDAP_USER_FILTER` | Колдонуучуларды издөө чыпкасы | `text` | — | кайра иштеткенден кийин | Логин үчүн %s камтышы керек. AD: (sAMAccountName=%s); OpenLDAP: (uid=%s). | ## SSO (OIDC) | Ачкыч | Аталышы | Түрү | Демейки | Күчүнө кирет | Эмне кылат | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OIDC_AUDIENCE` | OIDC аудитория | `text` | — | кайра иштеткенден кийин | Күтүлгөн `aud` claim — башка тарап үчүн чыгарылган токендерди четке кагуу үчүн бул жерге УШУЛ ресурстун audience'ин коюңуз. `aud` claim эми демейки боюнча ар бир токенде МИЛДЕТТҮҮ (aud'сыз токен четке кагылат); бул коюлганда aud аны да камтышы керек. Продакшенде күчтүү сунушталат. | | `AIHUMMER_OIDC_ISSUER` | OIDC чыгаруучунун URL дареги | `text` | — | кайра иштеткенден кийин | IdP'нин чыгаруучусу (мис. https://login.example.com). Коюлганда OIDC JWT аутентификациясын күйгүзөт. | | `AIHUMMER_OIDC_JWKS_URL` | OIDC JWKS URL дареги | `text` | — | кайра иштеткенден кийин | Токендердин колтамгаларын текшерүү үчүн JSON Web Key Set эндпоинти. | | `AIHUMMER_OIDC_TENANT_CLAIM` | OIDC'деги жумуш мейкиндигинин claim'и | `text` | — | кайра иштеткенден кийин | Жумуш мейкиндигинин идентификаторун алып жүргөн JWT claim (мис. tenant_id / org). | ## SSO (SAML) | Ачкыч | Аталышы | Түрү | Демейки | Күчүнө кирет | Эмне кылат | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SAML_DEFAULT_ROLE` | SAML: Демейки роль (топ дал келбегенде) | `text` | — | кайра иштеткенден кийин | Эч бир ырасталган маани дал келбегенде берилүүчү рол. Бош = ролсуз. | | `AIHUMMER_SAML_ENABLED` | SAML 2.0 SSO күйгүзүү | `bool` | `0` | кайра иштеткенден кийин | /saml/metadata, /saml/acs, /saml/login дарегин ачат. SP'нин жеке ачкычы Secrets'те сакталат (scope saml, name sp_key). | | `AIHUMMER_SAML_ENTITY_ID` | SP'нин entity ID'си | `text` | — | кайра иштеткенден кийин | SP entity ID (бош болсо демейки ⟨root⟩/saml/metadata). | | `AIHUMMER_SAML_IDP_METADATA` | IdP метадайындарынын XML | `text` | — | кайра иштеткенден кийин | IdP'ңиздин SAML-метамаалыматтар документин киргизиңиз (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` | SP түп URL дареги | `text` | — | кайра иштеткенден кийин | Бул шлюздун сырттан жеткиликтүү базалык URL'и, мис. https://app.example.com. ACS = ⟨root⟩/saml/acs. | | `AIHUMMER_SAML_SP_CERT` | SP сертификаты (PEM) | `text` | — | кайра иштеткенден кийин | SP'нин кол коюу үчүн ачык сертификаты (PEM). Ага дал келген жеке ачкыч Secrets'ке коюлат (scope saml, name 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` | Уруксат берилген CORS Origin | `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` | — | кайра иштеткенден кийин | Статикалык OpenAI-шайкеш аутентификация дал келтирилүүчү жумуш мейкиндигинин ID'си. Бош = 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'тон кирүү дайыма уруксат берилет, ошондо оператор бөгөттөлүп калбайт. TLS'ти аяктаган тескери проксиден X-Forwarded-Proto'ну эске алат. Иштетүүдө/кайра иштетүүдөн кийин колдонулат. | | `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-объект {тил: бинарга_жол}, мис. {\\"python\\":\\"/usr/bin/python3\\"}. Бош = авто-аныктоо. | | `AIHUMMER_CODE_EXEC_NET_PORTS` | Агенттин кодуна ачык тармак порттору | `list` | `53,80,443` | дароо | ОС кум кутусундагы агенттин коду (кодду аткаруу жана график буйруктары) туташа ала турган TCP порттору, үтүр менен бөлүнгөн. Демейки боюнча 53, 80 жана 443: DNS жана сайттар. Бул сервердин жана анын жергиликтүү тармагынын башка кызматтары (маалымат базасы, башкаруу панели, браузер, adb, жергиликтүү моделдер, Home Assistant) агенттин коду үчүн жабык. Тизмедеги порт ар кандай даректе, ошондой эле бул серверде ачык, ошондуктан кодго керектүүсүн гана кошуңуз, мисалы SSH үчүн 22. Чектөөнү алып салуу үчүн 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` | — | дароо | http_request аспабы үчүн хостту авторизация аталыштарына дал келтирген JSON картасы — токендер промптто сакталбашы үчүн. Бош = авторизациясыз. | | `AIHUMMER_MCP_SERVERS` | MCP серверлери (JSON) | `text` | — | дароо | Аспаптары агентке туташтырылган тышкы MCP серверлеринин JSON сүрөттөмөсү. Бош = тышкы 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.