Баптаулар анықтамалығы

Мұнда оператор AiHummer серверінде өзгерте алатын барлық баптаулар тізілген. Бет өнімнің өз каталогынан жиналады, сондықтан сіздің серверіңізбен дәл келеді. Мән веб-интерфейсте немесе `aihummer settings set KEY VALUE` командасымен беріледі ([Командалық жол](/kk/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 клиент идентификаторы | `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` | Медианың ең үлкен жүктеу өлшемі (МБ) | `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` | — | қайта іске қосқаннан кейін | Гибридті іздеуді қайта саралауға арналған кросс-энкодер сайдкарының 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=Users,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` | қайта іске қосқаннан кейін | Қосулы болғанда әкімшілердің кіруі каталогқа ауысады. Байланыс құпиясөзі 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 тектері | `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-объект {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) агент коды үшін жабық. Тізімдегі порт кез келген мекенжайда, осы серверде де ашық, сондықтан кодқа қажеттісін ғана қосыңыз, мысалы 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.