Sozlamalar ma'lumotnomasi

Bu yerda operator AiHummer serverida o'zgartira oladigan barcha sozlamalar keltirilgan. Sahifa mahsulotning o'z katalogidan yig'iladi, shuning uchun sizning serveringizga mos keladi. Qiymat veb-interfeysda yoki `aihummer settings set KEY VALUE` buyrug'i bilan beriladi ([Buyruqlar satri](/uz/v1.4/reference/cli/)). Standart qiymat ustunida server o'z qiymatingiz berilmaguncha ishlatadigan qiymat ko'rsatilgan. > [!NOTE] > Maxfiy qiymatlar bu yerda chop etilmaydi, yetkazib beruvchining xizmat kalitlari esa umuman keltirilmaydi — mahsulot ularni barcha ro'yxatlardan yashiradi. Tire bo'sh qiymatni yoki faqat veb-interfeysda ko'rsatiladigan izohni bildiradi. ## API | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PERSONAL_API_KEYS` | OpenAI-mos API uchun shaxsiy API kalitlari | `bool` | `1` | qayta ishga tushirilgandan keyin | \\"off\\" OpenAI bilan mos endpointda shaxsiy kalitlar boʻyicha autentifikatsiyani oʻchiradi. Boshqa har qanday qiymat = yoqilgan. Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | ## Agent | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_ANNOUNCE_SLOW_TOOLS` | Agent: uzoq amallardan oldin ogohlantirish | `bool` | `1` | darhol | Uzoq amaldan oldin (rasm, chuqur qidiruv, video, subagentga topshiriq) agent nima qilayotganini qisqacha yozadi, kutish jim o'tmasligi uchun. Bunday xabarlar xalaqit bersa, o'chiring. | | `AIHUMMER_AGENT_COMPACT_AT_PCT` | Agent: tarixni shu toʻlganda siq, byudjetining % | `int 50…99` | `85` | darhol | Suhbat tarixi model oynasidagi oʻz joyining shu ulushini toʻldirganda eski xabarlar qisqa bayonga aylantiriladi — fonda, javobdan keyin; yurish kutmaydi. Pastroq — siqish tez-tez, lekin model soʻzma-soʻz kamroq eslaydi; yuqoriroq — kamroq, lekin yurishlar ogʻirlashadi. 50–99; agent oʻz qiymatini belgilashi mumkin. | | `AIHUMMER_AGENT_COMPACT_TO_PCT` | Agent: siqishdan keyin qoldir, tarix byudjetining % | `int 10…90` | `50` | darhol | Siqishdan keyin tarix joyining qanchasi soʻzma-soʻz qoladi; eskiroq hammasi qisqa bayonga oʻtadi. Siqish chegarasidan past boʻlishi kerak: ular orasidagi farq keyingi siqishgacha nechta yurish oʻtishini belgilaydi. 10–90; agent oʻz qiymatini belgilashi mumkin. | | `AIHUMMER_AGENT_HISTORY_TURNS` | Agent: so‘zma-so‘z saqlanadigan suhbat navbatlari | `int 1…1000` | `30` | darhol | Model suhbatning oxirgi nechta navbatini so‘zma-so‘z ko‘radi (siqish vaqti kelguncha yana 10 tagacha). Eski xabarlar fonda xulosaga aylantiriladi; suhbatning o‘zi hech qachon o‘chirilmaydi. Modelning kontekst oynasi avtomatik hisobga olinadi. 1–1000; agent uchun alohida qiymat qo‘yish mumkin. | | `AIHUMMER_AGENT_MAX_ITERATIONS` | Agent: bir navbatdagi eng ko‘p vosita qadamlari | `int 1…256` | `25` | darhol | Agent javob berishdan oldin bir navbatda vositalarni necha marta chaqira olishi. Chegaraga yetganda navbat xato bilan tugamaydi: agent nima qilingani va nima qolganini aytadi, siz undan davom etishni so‘rashingiz mumkin. Natijasi bir xil bo‘lgan uchta bir xil chaqiruv ketma-ket kelsa, navbat erta to‘xtaydi. 1–256; agent uchun alohida qiymat qo‘yish mumkin. | | `AIHUMMER_AGENT_MEMORY_FLUSH` | Agent: siqishdan oldin xotiraga eslatma saqlash | `bool` | `1` | darhol | Eski xabarlar xulosaga birlashtirilishidan oldin agent maqsadlar, qarorlar va ochiq ishlar haqida qisqa eslatmani xotiraga yozadi. Model chaqiruvini tejash uchun o‘chiring. | | `AIHUMMER_AGENT_MEMORY_FLUSH_PROMPT` | Agent: siqishdan oldingi qaydda nima saqlansin | `text` | — | darhol | Siqishdan oldingi qayd uchun o‘z topshirig‘ingiz: xulosaga ketayotgan xabarlardan nimani saqlash kerak (masalan, «faqat xaridlar, muddatlar va kelishuvlarni yoz»). Bo‘sh — o‘rnatilgan: maqsadlar, qarorlar, tugallanmagan ishlar. Himoya o‘chirilmaydi: suhbat matni ko‘rsatma emas, ma’lumot bo‘lib qoladi, parollar va kalitlar yozilmaydi. 4000 belgigacha; agentning o‘z topshirig‘i bo‘lishi mumkin. | | `AIHUMMER_AGENT_NEW_REMINDERS_MEMORY` | Yangi agentlar: eslatmalar va xotiraga yozish | `bool` | `1` | darhol | Qo‘lda yaratilgan yangi agent (birinchi ishga tushirish ustasi, «Agent yaratish», API) birinchi qadamdanoq O‘Z eslatmalari va jadvallarini o‘zi qo‘yadi, o‘zgartiradi va bekor qiladi hamda faktlarni o‘z xotirasiga yozadi — shaxsiy yordamchi shabloni kabi. Alohida agent uchun bu uning kartasida («Imkoniyatlar») o‘chiriladi. Kutubxona shablonlari o‘z tanlovini belgilaydi, agent nusxasi asl nusxaning huquqlarini saqlaydi, boshqa agent yaratgan agentlar ularsiz boshlanadi; mavjud agentlar o‘zgarmaydi. Keyingi yaratiladigan agentga taalluqli. | | `AIHUMMER_AGENT_PROMPT_PART_MAX_CHARS` | Agent: prompt qismiga maksimal belgilar | `int 1000…1000000` | `20000` | darhol | Model agent shaxsiyatining BITTA qismidan — profil bo'limi, prompt qismi yoki asosiy promptdan — nechta belgi oladi. Uzunroq qismda boshi (3/4) va oxiri (1/4) qancha kesilgani haqidagi belgi bilan saqlanadi; bu suhbat kartasida va agent promptining tarkibida ko'rinadi. Ism, murojaat shakli va shaxsiyat cheklovlari hech qachon kesilmaydi. 1000–1000000; agent uchun o'z qiymatini berish mumkin. | | `AIHUMMER_AGENT_PROMPT_TOTAL_MAX_CHARS` | Agent: butun shaxsiyat uchun maksimal belgilar | `int 1000…2000000` | `60000` | darhol | Agent shaxsiyatining umumiy chegarasi: barcha qismlar birgalikda. U oshib ketsa, avval eng uzun qismlar joy bo'shatadi, qisqalari butun qoladi. 1000–2000000; agent uchun o'z qiymatini berish mumkin. | | `AIHUMMER_AGENT_SELF_INTRO` | Agent: o'zini tanishtirish | `enum: first_contact \\\| each_dialog \\\| never` | `first_contact` | darhol | «Bir marta, birinchi tanishuvda» — agent odam bilan eng birinchi suhbatda, u darhol ishga o‘tishni so‘ramasa, o‘zini qisqacha tanishtiradi; tanish odamga qayta tanishtirmaydi va salomga tabiiy javob beradi. «O‘zini tanishtirmaslik» — agent hech qachon o‘zini o‘zi nomlamaydi. «Har bir yangi suhbat boshida» — har bir yangi suhbat boshida va uzoq tanaffusdan keyin, qisqacha va o‘tgan ishlar xulosasisiz. Agent o‘z kartasida («Kontekst va xulq») boshqacha tanlashi mumkin. | | `AIHUMMER_AGENT_SESSION_IDLE_RESET_MINUTES` | Agent: sukutdan keyin suhbatni qaytadan boshlash (daqiqa) | `int 0…525600` | `360` | darhol | “Jimlikdan keyin” va “har kuni va jimlikdan keyin” rejimlari uchun: inson bundan uzoqroq jimlikdan keyin yozsa, agent suhbatni qaytadan boshlaydi. Kartochkasida o‘z qiymati berilmagan agentlarga tegishli. 0 — jimlik bo‘yicha emas. 0–525600; 360 = 6 soat, 1440 = bir kun. | | `AIHUMMER_AGENT_SESSION_INDEX_MAX_ENTRIES` | Agent: ro'yxatda ko'pi bilan shuncha seans saqlash | `int 0…100000` | `0` | darhol | Avval eng jimlari chiqadi; hech narsa o'chirilmaydi. 0 — cheklovsiz. 0–100000. Kartochkasida o'z qiymati yo'q agentlarga qo'llaniladi. | | `AIHUMMER_AGENT_SESSION_INDEX_PRUNE_DAYS` | Agent: shuncha kun jimlikdan so'ng seanslar ro'yxatidan olib tashlash | `int 0…3650` | `0` | darhol | Hech narsa o'chirilmaydi: suhbat ro'yxatdan chiqadi va yangi xabar bilan qaytadi. 0 — saqlash. 0–3650. Kartochkasida o'z qiymati yo'q agentlarga qo'llaniladi. | | `AIHUMMER_AGENT_SESSION_RESET_AT_HOUR` | Agent: har kungi qaytadan boshlash soati | `int 0…23` | `4` | darhol | «Har kuni» rejimlari uchun: shu soatdan oldin boshlangan suhbat odamning keyingi xabaridan boshlab qaytadan boshlanadi. Soat server vaqt mintaqasi bo‘yicha («Tizim va sozlamalar»dagi «Vaqt mintaqasi» sozlamasi). 0–23; 4 — tunda, deyarli hech kim yozmaydigan payt. | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_IDLE_MINUTES` | Agent: sukutdan keyin guruh suhbatini qaytadan boshlash (daqiqa) | `int 0…525600` | `0` | darhol | “Sukutdan keyin” va “har kuni va sukutdan keyin” rejimlaridagi guruh suhbatlari uchun: guruh suhbati qaytadan boshlanadigan sukut daqiqalari. 0 — shaxsiy suhbatlardagidek. 0–525600. | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_MODE` | Agent: guruh suhbati qachon qaytadan boshlanadi | `enum: inherit \\\| daily \\\| idle \\\| both \\\| none` | `inherit` | darhol | Guruh suhbatlari uchun alohida qoida (Telegram guruhlari, VK suhbatlari, MAX chatlari va boshqalar): shaxsiy suhbatlardagidek, har kuni qayta tiklash soatida, sukutdan keyin, qaysi biri oldin bo‘lsa, yoki hech qachon. Qayta tiklash soati umumiy. Kartasida o‘z qoidasi bo‘lmagan agentlarga tegishli. | | `AIHUMMER_AGENT_SESSION_RESET_MODE` | Agent: suhbat qachon qaytadan boshlanadi | `enum: idle \\\| daily \\\| both \\\| none` | `idle` | darhol | Agent suhbatni qachon qaytadan boshlaydi: har kuni qayta tiklash soatida (sozlamalardagi vaqt mintaqasi bo‘yicha), jimlikdan keyin, qaysi biri oldin bo‘lsa, yoki hech qachon. Qaytadan boshlaganda agent o‘z xotirasiga oldingi suhbat haqida qayd yozadi, uning birinchi yurishi esa oldingi xulosa va oxirgi xabarlarni oladi; xabarlarning o‘zi arxivda va qidiruvda qoladi. Kartochkasida o‘z qoidasi bo‘lmagan agentlarga tegishli; u yerda guruh chatlari uchun alohida qoida belgilash mumkin. | | `AIHUMMER_AGENT_SESSION_SCOPE` | Agent: shaxsiy suhbatlar qayerga tushadi | `enum: chat \\\| per-channel-peer \\\| per-peer` | `chat` | darhol | «Har odamga bitta» bir odamning Telegram, ilova va boshqa shaxsiy chatlarini bitta suhbatga birlashtiradi. Guruh chatlari doim o'z suhbatini saqlaydi. Keyingi xabardan kuchga kiradi. Kartochkasida o'z qiymati yo'q agentlarga qo'llaniladi. | | `AIHUMMER_AGENT_SILENT_REPLY` | Agent: jim qolishi mumkin | `enum: groups \\\| all \\\| off` | `groups` | darhol | Umumiy chatlarda xabar agentga qaratilmagan bo‘lsa yoki qo‘shadigan narsasi bo‘lmasa, u jim qolishi mumkin; shaxsiy yozishmada doim javob beradi. Jim qolishni shaxsiy yozishmada ham ruxsat berish yoki o‘chirish mumkin. Jim qolingan qadam hech narsa yubormaydi, suhbat kartasida «agent jim qoldi» deb belgilanadi va model uni tarixda ko‘rmaydi. Keyingi qadamdan kuchga kiradi. | | `AIHUMMER_AGENT_SKILLS_PROMPT_MAX_CHARS` | Agent: promptdagi ko'nikmalar ro'yxatining maksimal belgilari | `int 1000…200000` | `18000` | darhol | Har bir navbatda model ko'nikmalar matnini emas, ularning ro'yxatini ko'radi: identifikator, nom va qachon qo'llash; vazifa mos kelganda agent ko'nikma yo'riqnomasini o'zi yuklaydi. Ro'yxat uzunroq bo'lsa, avval tavsiflar, keyin ro'yxat oxiri olib tashlanadi — qolganlarini agent so'rov bo'yicha topadi. 1000–200000. | | `AIHUMMER_AGENT_STALE_GAP_HOURS` | Agent: o‘tgan suhbat tarixga aylanadigan tanaffus (soat) | `int 0…8760` | `12` | darhol | Agar odam bundan uzoqroq tanaffusdan keyin yozsa, agent belgi oladi: avval muhokama qilingan hamma narsa tarix — so‘ralmasa qayta aytilmaydi va eski vazifalar davom ettirilmaydi. Har bir xabar allaqachon o‘z vaqtini va oldingisidan qancha vaqt o‘tganini o‘z ichiga oladi. 0 = belgilamaslik. 0–8760. | | `AIHUMMER_AGENT_TOOL_HISTORY_TURNS` | Agent: vosita natijalari saqlanadigan navbatlar | `int 0…100` | `5` | darhol | Model oxirgi nechta navbatda vosita chaqiruvlari va ularning natijalarini to‘liq ko‘radi (natija 16 KB gacha saqlanadi). Eskiroq navbatlarda chaqiruv va natijaning boshi qoladi. Shunday qilib agent vositalarni qayta chaqirish o‘rniga nima topgani va nima qilganini eslab qoladi. 0 = natijalarni keyingi navbatlarga o‘tkazmaslik. 0–100; agent o‘z qiymatini belgilashi mumkin. | | `AIHUMMER_APPROVAL_TOOLS` | Tasdiqlash talab qiladigan vositalar | `multiselect` | — | darhol | Chaqiruvi bajarilishidan oldin operatorning qoʻlda tasdigʻini talab qiladigan vositalarning vergul bilan ajratilgan roʻyxati. Boʻsh = tasdiq talab qilinmaydi. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | Sub-agentning maksimal chuqurligi | `int 0…10` | `2` | darhol | Subagentlarning maksimal ichma-ich joylashish chuqurligi (agentni ishga tushiruvchi agent). Sukut boʻyicha 2 — cheksiz rekursiyadan himoya. | | `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | Sub-agent taymauti (soniya) | `int 0…86400` | `180` | darhol | Bitta subagent ishga tushishining maksimal vaqti, sekundlarda. | | `AIHUMMER_TOOL_SEARCH` | Vositalarni kechiktirib yuklash | `bool` | `false` | darhol | Vositalarning ishchi yadrosini modelga darhol koʻrsatadi, katta katalogning qolgan qismini esa har bir yashirin vositani nomi bilan aytadigan qidiruv vositasi ortiga yashiradi. Faqat katta kataloglarda (oʻnlab plagin, MCP yoki OpenAPI vositalari) oʻzini oqlaydi: oʻlcham chegarasidan past boʻlsa barcha vositalar darhol koʻrsatiladi, chunki vosita qidirish uchun modelga qoʻshimcha murojaat sxemalarning oʻzidan qimmatroq. Keyingi qadamdan kuchga kiradi. | | `AIHUMMER_TOOL_SEARCH_CORE` | Vositalarni dangasa yuklash: doim yoqilgan vositalar | `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` | darhol | Dangasa rejimda doim darhol koʻrinadigan vositalar. Standart boʻyicha — ishchi yadro: internetda qidiruv, sahifalarni oʻqish, xotira, yozishmalar tarixi, bilimlar bazasi, kod, fayllar, xabarlar, jadvallar va ilovani ulash. Xotira va bilimlar bazasidan qidiruv (memory_search, memory_get, search_knowledge) bu roʻyxatda nima boʻlishidan qatʼi nazar doim koʻrinadi. Boʻsh roʻyxat bu yadroni qaytaradi. | | `AIHUMMER_TOOL_SEARCH_MIN_POOL_TOKENS` | Vositalarni dangasa yuklash: yashirin vositalarning eng kam hajmi (tokenlar) | `int 0…1000000` | `4000` | darhol | Vositalarni faqat yadrodan tashqaridagi sxemalar jami kamida shuncha token boʻlganda yashiring (har biri taxminan 4 belgi). Undan past boʻlsa barcha vositalar darhol koʻrsatiladi: vosita qidirish uchun modelga qoʻshimcha murojaat sxemalarni koʻrsatishdan qimmatroq. | | `AIHUMMER_TOOL_SEARCH_THRESHOLD` | Vositalarni dangasa yuklash: kechiktirish uchun minimal vositalar | `int 0…1000` | `12` | darhol | Agent profili filtridan keyin shu sondan koʻproq vosita qolgandagina kechiktirish. | ## Agent · Reasoning | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_BEST_OF_N` | N tadan eng yaxshisi: variantlar soni | `int 0…8` | `0` | darhol | Agent shuncha javob variantini tayyorlaydi va eng yaxshisini qoldiradi. 0 yoki 1 — o‘chirilgan, 2 dan — yoqilgan. Har bir variant alohida javobdek turadi. | | `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | Bahs: hakam prompti (bekor qilish) | `text` | — | darhol | Debat sudyasining promptini qayta belgilaydi (boʻsh = ichki). | | `AIHUMMER_AGENT_DEBATE_N` | Munozara: javob variantlari soni | `int 0…8` | `0` | darhol | Agent shuncha javob variantini tayyorlaydi, ularni o‘zaro solishtiradi va eng yaxshisini beradi. 0 yoki 1 — o‘chirilgan, 2 dan — yoqilgan. Har bir variant alohida javobdek turadi. | | `AIHUMMER_AGENT_DEBATE_PROMPT` | Bahs: nomzod prompti (bekor qilish) | `text` | — | darhol | Debat nomzodining promptini qayta belgilaydi (boʻsh = ichki). | | `AIHUMMER_AGENT_DEBATE_ROUNDS` | Bahs: raundlar | `int 1…10` | `1` | darhol | Nomzodlar paneli uchun debat raundlari soni. | | `AIHUMMER_AGENT_JUDGE_PROMPT` | Best-of-N hakam prompti (bekor qilish) | `text` | — | darhol | best-of-N sudyasining promptini qayta belgilaydi (boʻsh = ichki). | | `AIHUMMER_AGENT_PLAN_PROMPT` | Rejalashtiruvchi prompti (bekor qilish) | `text` | — | darhol | Rejalashtiruvchining promptini qayta belgilaydi (boʻsh = ichki). | | `AIHUMMER_AGENT_PLAN_STEPS` | Rejalashtiruvchi-ijrochi: reja qadamlari maksimumi (0=oʻchiq) | `int 0…32` | `0` | darhol | ⟩0 boʻlsa alohida rejalashtiruvchi→ijrochi→sintez bosqichi ishlaydi (murakkab koʻp bosqichli vazifalar uchun foydali). 0 = oʻchirilgan. Odatda 4–8. | | `AIHUMMER_AGENT_PLAN_STEP_ITERS` | Rejalashtiruvchi: har qadamdagi vosita iteratsiyalari (0=standart) | `int 0…64` | `0` | darhol | Reja qadamiga vosita chaqiruvlari iteratsiyalari sonini cheklaydi. 0 = ichki standart qiymat (4). | | `AIHUMMER_AGENT_REFLECT` | Oʻz-oʻzini tanqid qilish bosqichi | `bool` | `0` | darhol | Yakuniy javobdan oldin refleksiya/oʻz-oʻzini tanqid bosqichini qoʻshadi. | | `AIHUMMER_AGENT_REFLECT_PROMPT` | Refleksiya prompti (bekor qilish) | `text` | — | darhol | Oʻz-oʻzini tanqid promptini qayta belgilaydi (boʻsh = ichki). | | `AIHUMMER_AGENT_SELF_HEAL` | Oʻz-oʻzini tuzatish: vosita xatolarida qayta urinishlar (0=oʻchiq) | `int 0…10` | `0` | darhol | ⟩0 boʻlsa muvaffaqiyatsiz vosita chaqiruvlarini tuzatuvchi maslahat bilan shu chegaragacha takrorlaydi. | ## Agent · System prompt | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LOCALE` | Standart lokal | `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` | darhol | Sukut boʻyicha javob tili/lokali, masalan ru-RU. Persona/operator koʻrsatmalari ustunlikka ega. | | `AIHUMMER_TIMEZONE` | Vaqt mintaqasi | `text` | `UTC` | darhol | Agentning joriy sanasi va o‘z mintaqasi bo‘lmagan jadvallar uchun IANA vaqt mintaqasi, masalan Europe/Moscow. Sukut bo‘yicha UTC. | ## Channels | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_FAILURE_NOTICE` | Javob chiqmaganda suhbatdoshga xabar berish | `enum: always \\\| once \\\| off` | `always` | darhol | Agent javob bera olmaganda kanaldagi (Telegram va boshqalar) suhbatdosh nima oladi: «Har safar» — o‘z tilida qisqa xabar; «4 soatda bir martadan ko‘p emas» — 4 soatda suhbatga bitta xabar; «Xabar bermaslik» — hech narsa. Xabarda xato kodlari va yetkazib beruvchilar nomi yo‘q; tafsilotlarni «Seanslar» va bildirishnomalarda ko‘rasiz. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BLOCKED` | Nosozlik haqida matn: instans to‘xtatilgan | `text` | — | darhol | Bo‘sh qoldiring — suhbatdoshning o‘z tilida ichki xabar yuboriladi. Sizning matningiz qanday yozilgan bo‘lsa, shunday, yozgan tilingizda yuboriladi; {ref} javob kodini qo‘yadi, u orqali qadamni «Seanslar» bo‘limidan topasiz. Darhol qo‘llanadi. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUDGET` | Nosozlik haqida matn: egasining byudjeti tugadi | `text` | — | darhol | Bo‘sh qoldiring — suhbatdoshning o‘z tilida ichki xabar yuboriladi. Sizning matningiz qanday yozilgan bo‘lsa, shunday, yozgan tilingizda yuboriladi; {ref} javob kodini qo‘yadi, u orqali qadamni «Seanslar» bo‘limidan topasiz. Darhol qo‘llanadi. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUSY` | Nosozlik haqida matn: shlyuz haddan tashqari yuklangan | `text` | — | darhol | Bo‘sh qoldiring — suhbatdoshning o‘z tilida ichki xabar yuboriladi. Sizning matningiz qanday yozilgan bo‘lsa, shunday, yozgan tilingizda yuboriladi; {ref} javob kodini qo‘yadi, u orqali qadamni «Seanslar» bo‘limidan topasiz. Darhol qo‘llanadi. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_CONFIG` | Nosozlik haqida matn: model ulanishi egasini talab qiladi | `text` | — | darhol | Bo‘sh qoldiring — suhbatdoshning o‘z tilida ichki xabar yuboriladi. Sizning matningiz qanday yozilgan bo‘lsa, shunday, yozgan tilingizda yuboriladi; {ref} javob kodini qo‘yadi, u orqali qadamni «Seanslar» bo‘limidan topasiz. Darhol qo‘llanadi. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_FAILED` | Nosozlik haqida matn: boshqa nosozlik | `text` | — | darhol | Bo‘sh qoldiring — suhbatdoshning o‘z tilida ichki xabar yuboriladi. Sizning matningiz qanday yozilgan bo‘lsa, shunday, yozgan tilingizda yuboriladi; {ref} javob kodini qo‘yadi, u orqali qadamni «Seanslar» bo‘limidan topasiz. Darhol qo‘llanadi. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_QUOTA` | Nosozlik haqida matn: modelning foydalanish limiti tugadi | `text` | — | darhol | Bo‘sh qoldiring — suhbatdoshning o‘z tilida ichki xabar yuboriladi. Sizning matningiz qanday yozilgan bo‘lsa, shunday, yozgan tilingizda yuboriladi; {ref} javob kodini qo‘yadi, u orqali qadamni «Seanslar» bo‘limidan topasiz. Darhol qo‘llanadi. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_STEP_LIMIT` | Nosozlik haqida matn: vazifa bitta javobga sig‘madi | `text` | — | darhol | Bo‘sh qoldiring — suhbatdoshning o‘z tilida ichki xabar yuboriladi. Sizning matningiz qanday yozilgan bo‘lsa, shunday, yozgan tilingizda yuboriladi; {ref} javob kodini qo‘yadi, u orqali qadamni «Seanslar» bo‘limidan topasiz. Darhol qo‘llanadi. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_TOO_LONG` | Nosozlik haqida matn: suhbat model uchun juda uzun | `text` | — | darhol | Bo‘sh qoldiring — suhbatdoshning o‘z tilida ichki xabar yuboriladi. Sizning matningiz qanday yozilgan bo‘lsa, shunday, yozgan tilingizda yuboriladi; {ref} javob kodini qo‘yadi, u orqali qadamni «Seanslar» bo‘limidan topasiz. Darhol qo‘llanadi. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_UNAVAILABLE` | Nosozlik haqida matn: model vaqtincha mavjud emas | `text` | — | darhol | Bo‘sh qoldiring — suhbatdoshning o‘z tilida ichki xabar yuboriladi. Sizning matningiz qanday yozilgan bo‘lsa, shunday, yozgan tilingizda yuboriladi; {ref} javob kodini qo‘yadi, u orqali qadamni «Seanslar» bo‘limidan topasiz. Darhol qo‘llanadi. | | `AIHUMMER_CONFIDENTIAL_PERSONA` | Maxfiy veb-persona | `bool` | `0` | darhol | Yoqilganda veb-chat agenti oʻz personasi/shaxsi haqidagi maʼlumotlarni oshkor qilmaydi va saqlamaydi hamda faqat vazifa doirasida javob beradi — anonim yoki maxfiylikka sezgir veb-joylashtirishlar uchun. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_INBOUND_COALESCE_MS` | Xabarlarni birlashtirish oynasi (ms) | `int` | `500` | darhol | Bir kishi bitta chatga ketma-ket yuborgan bir nechta xabar (qisqa xabarlar, foto albom, tezkor tuzatish) oralaridagi tanaffus shu oynadan qisqa boʻlsa, BITTA javob oladi. Javob tayyorlanayotganda kelgan xabarlarga undan keyin darhol javob beriladi, hech qachon parallel emas. Standart 500 ms; 0 — alohida xabarlar orasida kutmasdan; foto albom baribir bitta javob olishi uchun yig‘iladi (pauzalar 3 s gacha, ko‘pi bilan 20 s). Birlashtirish Telegram'da ishlaydi; har bir xabarga javob kutadigan Slack, WhatsApp, VK, e-pochta va boshqa konnektorlar (hamda /v1/inbound/generic orqali integratsiyalar) har bir xabarga javob oladi — avvalgidek birma-bir va navbat bilan. Darhol qoʻllaniladi. | | `AIHUMMER_INBOUND_EDIT_MODE` | Odam javob berilgan xabarni tahrirlaganda | `enum: correct \\\| history` | `correct` | darhol | correct — bot bu tuzatish ekanini bilgan holda yana javob beradi («edi / bo‘ldi»); history — tahrir faqat suhbat tarixini tuzatadi, yangi javob bo‘lmaydi (imlo xatolari uchun qulay). Bot hali javob bermagan xabarni tahrirlash har doim shunchaki uning matnini almashtiradi. Kanal tahrirlar haqida xabar beradigan joyda ishlaydi (Telegram). Darhol qo‘llanadi. | | `AIHUMMER_INBOUND_QUEUE_MODE` | Agent ishlayotganda yozilgan xabarlar | `enum: steer \\\| collect \\\| followup` | `steer` | darhol | Agent hali javob tayyorlayotganda (qidirayotganda, vositalarni ishga tushirayotganda) o'sha odam yuborgan xabar bilan nima bo'ladi: steer (standart) — agent uni keyingi qadamidan oldin ko'radi va aynan shu javobda hisobga oladi; collect — unga keyingi javob beriladi. followup — har bir bunday xabarga navbat bilan alohida javob beriladi. Rasmlar, fayllar, xabarga javoblar va qayta yuborishlar doim keyingi javobni kutadi. Darhol qo'llaniladi. | | `AIHUMMER_INBOUND_REQUIRE_BINDING` | Faqat roʻyxatga olingan foydalanuvchilarga javob berish | `bool` | `true` | darhol | true = bot kanalda AiHummer foydalanuvchisi BOʻLMAGAN (ya'ni rol bogʻlanishiga ega boʻlmagan) har qanday joʻnatuvchini eʼtiborsiz qoldiradi — tasodifiy chat aʼzolari va mehmon murojaatlari javob olmaydi. false (sukut boʻyicha) = hammaga javob berish. | ## Integrations | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_A2A_PUBLISH` | Agentni Agent2Agent (A2A) orqali nashr etish | `bool` | `0` | qayta ishga tushirilgandan keyin | Agentni A2A-server sifatida eʼlon qilish (Agent Card + POST /a2a/message). Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_MCP_EXPORT_TOOLS` | Tashqi yordamchilarga ochilgan vositalar | `multiselect` | — | qayta ishga tushirilgandan keyin | Tashqi MCP mijozlari uchun ruxsat berilgan asbob nomlarining vergul bilan ajratilgan aniq roʻyxati. Empty = do not publish any tools. Xavfli xost darajasidagi sinflar ro'yxatga kiritilgan bo'lsa ham, o'rnatilgan siyosat bilan qo'shimcha ravishda taqiqlanadi. Boshlash/qayta ishga tushirilgandan keyin amal qiladi. | | `AIHUMMER_MCP_PUBLISH` | Vositalarni MCP orqali nashr etish | `bool` | `0` | qayta ishga tushirilgandan keyin | Tashqi yordamchilarga (masalan, Claude Desktop) agentlaringiz vositalaridan foydalanishga ruxsat beradi. Qaysi vositalarni ochish qo‘shni sozlamada tanlanadi: ro‘yxat bo‘sh ekan, birortasi ham ochilmaydi. | | `AIHUMMER_MODULE_CPU_QUOTA` | Plagin protsessor chegarasi (har biri uchun) | `text` | `75%` | darhol | Har bir plagin protsessorning qancha qismini egallashi mumkin (systemd CPUQuota): 75% — bitta yadroning to‘rtdan uch qismi, 150% — bir yarim yadro. Yangi qiymatni plagin keyingi o‘rnatish, yangilash yoki sozlamalarini saqlashda oladi; ungacha ishlayotgan plaginlar avvalgi chegara bilan qoladi. | | `AIHUMMER_MODULE_MEMORY_MAX` | Plagin xotira chegarasi (har biri uchun) | `text` | `512M` | darhol | Har bir plagin qancha xotira egallashi mumkin (systemd MemoryMax): 512M, 1G yoki 2048M kabi o‘lcham (kamida 64M) yoki cheklovsiz uchun infinity. Chegaradan oshgan plaginni tizim to‘xtatadi. Yangi qiymatni plagin keyingi o‘rnatish, yangilash yoki sozlamalarini saqlashda oladi; ungacha ishlayotgan plaginlar avvalgi chegara bilan qoladi. | ## Knowledge connectors | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_KB_SYNC_INTERVAL` | Bilim bazasini manbalardan qanchalik tez-tez yangilash | `text` | — | darhol | Server ulangan bilim bazasi manbalaridan o‘zgarishlarni o‘zi qanchalik tez-tez oladi. Masalan: 30m — har 30 daqiqada, 6h — har 6 soatda. Bo‘sh yoki 0 — faqat qo‘lda. Qayta yuklash dublikat yaratmaydi. Slack eksporti qo‘lda yuklanadi. | ## LLM | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AUX_FALLBACK_MODELS` | Xizmat vazifalari: zaxira modellar | `list` | — | darhol | Vergul bilan ajratilgan modellar — xizmat modeli ishlamasa (kvota, nosozlik) navbat bilan sinab ko‘riladi. Xulosa yo‘qolmasligi uchun oxirida doim asosiy model sinab ko‘riladi. Har bir almashuv jurnalga yoziladi. Darhol kuchga kiradi. | | `AIHUMMER_AUX_MODEL` | Xizmat vazifalari uchun model (xulosalar, qaydlar, sarlavhalar) | `text` | — | darhol | Fon xizmat vazifalari uchun model: eski tarixni xulosaga siqish, siqishdan oldingi xotira qaydi, suhbat sarlavhalari, faktlarni ajratib olish, qidiruv so‘rovlarini qayta ifodalash va tarjima. Bo‘sh = avtomatik: o‘sha provayderning arzonroq modeli (Claude → claude-haiku-4-5, Codex → gpt-…-luna/mini); bunday bo‘lmasa — asosiy model. "main" = doim asosiy model. Darhol kuchga kiradi. | | `AIHUMMER_CASCADE_MIN_CHARS` | Kaskad: eskalatsiya uchun minimal belgilar | `int` | `0` | darhol | Kaskadning kuchliroq modeli yoqiladigan soʻrov uzunligi chegarasi (belgilar). 0 = sukut boʻyicha. | | `AIHUMMER_CASCADE_STRONG_MODEL` | Kaskad: kuchliroq zaxira model | `text` | — | darhol | Uzun/murakkab soʻrovlar uchun kaskad boʻyicha oʻtiladigan model (boʻsh = oʻchirilgan). | | `AIHUMMER_CLAUDE_AUTH_URL` | Claude obunasi: kirish sahifasi manzili | `text` | — | darhol | Claude obunasini ulashga ruxsat beradigan sahifa. Bo‘sh — standart manzil; faqat qo‘llab-quvvatlash so‘rasa o‘zgartiring. | | `AIHUMMER_CLAUDE_CLIENT_ID` | Claude obunasi: OAuth mijoz identifikatori | `text` | — | darhol | Claude obunasi bilan kirish uchun ilova identifikatori. Bo‘sh — standart; faqat qo‘llab-quvvatlash so‘rasa o‘zgartiring. | | `AIHUMMER_CLAUDE_EFFORT` | Claude: fikrlash chuqurligi | `enum: low \\\| medium \\\| high \\\| xhigh \\\| max` | `medium` | darhol | Agentda chuqurlik belgilanmagan bo‘lsa, Claude modellari javob berishdan oldin qanchalik chuqur fikrlaydi. Yuqoriroq — murakkab vazifalarda aniqroq, lekin sekinroq va kvotani ko‘proq sarflaydi; pastroq — tezroq va arzonroq. Tanlangan darajani bilmaydigan model eng yaqin pastroq darajani oladi; Haiku 4.5 va eski modellar fikrlashni qo‘llab-quvvatlamaydi. Agentda belgilangan chuqurlik ustun turadi. Keyingi yurishdan boshlab amal qiladi. | | `AIHUMMER_CLAUDE_MAX_TOKENS` | Claude: javobning eng katta uzunligi (token) | `int` | `16000` | darhol | Claude’ning bitta javobi qancha token egallashi mumkin — obuna bilan ham, kalit bilan ham. Modelning fikrlashi ham shu limitga kiradi: juda kichik qiymat javobni gap o‘rtasida uzadi yoki bo‘sh javob beradi. Agentning o‘z javob uzunligi belgilangan bo‘lsa, o‘sha amal qiladi. | | `AIHUMMER_CLAUDE_REDIRECT_URI` | Claude obunasi: URI-ni qayta yo'naltirish | `text` | — | darhol | Qaytish manzili etkazib beruvchida ro'yxatdan o'tgan. Uning tomonida konfiguratsiya qilingan narsaga mos kelishi kerak, aks holda kod almashinuvi rad etiladi. | | `AIHUMMER_CLAUDE_TOKEN_URL` | Claude obunasi: ruxsat olish manzili | `text` | — | darhol | Server Claude obunasiga ruxsatni oladigan va uzaytiradigan manzil. Bo‘sh — standart manzil; faqat qo‘llab-quvvatlash so‘rasa o‘zgartiring. | | `AIHUMMER_CODEX_BASE_URL` | Codex bazaviy URL manzili | `text` | — | qisman qayta ishga tushirilgandan keyin | Codex (ChatGPT obunasi) transportining bazasi. Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_CODEX_MAX_OUTPUT_TOKENS` | Maksimal chiquvchi tokenlar (0 = cheklovsiz) | `int` | `0` | darhol | Chat navbati uchun max_output_tokens chegarasi. 0 = cheklovsiz. Reasoning-modellarda fikrlash tokenlari ham shu byudjetdan hisoblanadi, shuning uchun juda kichik qiymat boʻsh «incomplete: max_output_tokens» javobini beradi. Tezkor qoʻllanadi (qayta ishga tushirishsiz). | | `AIHUMMER_CODEX_MODEL` | Model id (Codex / gpt-5.5 transporti) | `text` | `gpt-5.5` | qisman qayta ishga tushirilgandan keyin | Asosiy Codex/ChatGPT transportining model identifikatori (masalan gpt-5.5, gpt-5.5-codex). Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_CODEX_REASONING_EFFORT` | Mulohaza yuritish jiddiyligi | `enum: none \\\| low \\\| medium \\\| high \\\| xhigh` | `medium` | darhol | Agentda belgilanmagan bo‘lsa, ChatGPT (Codex) modeli javobdan oldin qanchalik chuqur o‘ylaydi. Sukut bo‘yicha — «O‘rta». Yuqoriroq — aniqroq, lekin sekinroq va qimmatroq. | | `AIHUMMER_LLM_CALL_TIMEOUT_S` | Har chaqiruv taymauti (soniya) | `int` | `120` | darhol | Bitta so‘rovga model javobini necha soniya kutish. Model bundan uzoqroq jim tursa, so‘rov uziladi va javob ro‘yxatdagi keyingi modelga o‘tadi. Claude uchun butun javob emas, javob oqimidagi pauza hisoblanadi: uzun, lekin davom etayotgan javob uzilmaydi. 0 — cheklovsiz. | | `AIHUMMER_LLM_FALLBACK_MODELS` | Zaxira modellar (barcha agentlar uchun) | `text` | `auto` | darhol | Asosiy model va boshqa taʼminotchilar rad etganda kim javob beradi (foydalanish limiti tugadi, nosozlik, juda koʻp soʻrov). auto — oxirgi tayanch sifatida har bir taʼminotchining arzonroq modeli (Claude: claude-haiku-4-5, Codex: gpt-…-luna/mini); vergul bilan ajratilgan roʻyxat — oʻz tartibingiz, har bir model oʻz ishlab chiqaruvchisining taʼminotchilariga boradi; off — zaxira modellarsiz. Agentning oʻz zaxira modeli ustun turadi. Darhol qoʻllanadi. | | `AIHUMMER_LLM_GATEWAY_URL` | LLM shlyuz URL manzili | `text` | — | qisman qayta ishga tushirilgandan keyin | Agent murojaat qiladigan OpenAI bilan mos model endpointining bazaviy URL manzili (sizning lokal llama.cpp/vLLM/Ollama serveringiz yoki hostingdagi shlyuz). Provayderning standart endpointidan foydalanish uchun boʻsh qoldiring. | | `AIHUMMER_LLM_MODEL` | LLM modeli | `text` | — | qisman qayta ishga tushirilgandan keyin | Har navbatda provayderga yuboriladigan model nomi/identifikatori (endpointingiz beradigan model). Endpoint haqiqatan taqdim etadigan model bilan mos boʻlishi kerak. | | `AIHUMMER_LLM_PAUSE_AUTH_MIN` | Hisob maʼlumotlari rad etilgandan keyingi pauza, daq | `int` | `10` | darhol | Hisob maʼlumotlarini rad etgan taʼminotchiga necha daqiqa murojaat qilmaslik. Takror pauzani ikki barobar oshiradi, lekin olti barobardan oshmaydi. Muvaffaqiyatli ulanish tekshiruvi va «Hozir davom ettirish» tugmasi taʼminotchini darhol qaytaradi. Keyingi raddan kuchga kiradi. | | `AIHUMMER_LLM_PAUSE_MODEL_MIN` | Taʼminotchi xizmat qilmaydigan model pauzasi, daq | `int` | `60` | darhol | Taʼminotchi xizmat qilmasligini aytgan modelni unga necha daqiqa taklif qilmaslik; uning boshqa modellariga odatdagidek murojaat qilinadi. Keyingi raddan kuchga kiradi. | | `AIHUMMER_LLM_PAUSE_QUOTA_MIN` | Limit tugagandan keyingi pauza, daq | `int` | `300` | darhol | Foydalanish limiti tugab, taʼminotchi tiklanish muddatini aytmagan boʻlsa, modelga (hisob limiti tugagan boʻlsa — Codex, OpenAI kaliti, toʻlov — butun hisobga) necha daqiqa murojaat qilmaslik. Takror pauzani ikki barobar oshiradi, lekin bir sutkadan oshmaydi. Taʼminotchi aytgan muddat ustun. Keyingi raddan kuchga kiradi. | | `AIHUMMER_LLM_PAUSE_SHORT_S` | Nosozlikdan keyin taʼminotchi pauzasi, s | `int` | `30` | darhol | Nosozlik, aloqa uzilishi yoki «juda tez-tez» javobidan keyin taʼminotchiga necha soniya murojaat qilmaslik. Ketma-ket ikkinchi rad pauzani ikki barobar, uchinchi va keyingilari oʻn barobar uzaytiradi. Taʼminotchi muddatni oʻzi aytgan boʻlsa, oʻshani kutamiz. Keyingi raddan kuchga kiradi. | | `AIHUMMER_LLM_PROVIDER` | LLM provayderi | `text` | — | qisman qayta ishga tushirilgandan keyin | Qaysi model backendidan foydalanish (OpenAI bilan mos endpoint yoki Codex/ChatGPT obunasi transporti). Soʻrovlar qanday yuborilishi va autentifikatsiya qilinishini belgilaydi. | | `AIHUMMER_LLM_RETRIES` | Vaqtinchalik xatoda LLM qayta urinishlari | `int` | `3` | darhol | Vaqtinchalik xatoda LLM soʻrovini qayta urinishlar soni. | | `AIHUMMER_LLM_TEMPERATURE` | Harorat | `text` | — | darhol | Agentda belgilanmagan bo‘lsa, model javoblari qanchalik xilma-xil (0–2): kamroq — aniqroq va oldindan bilinadigan, ko‘proq — jonliroq. Bo‘sh — model o‘zi hal qiladi. Fikrlovchi modellar (ChatGPT/Codex, Claude 5-avlod) buni qabul qilmaydi — ular uchun maydonni bo‘sh qoldiring. | | `AIHUMMER_LLM_TOP_P` | Top-p (nucleus namunalash) | `text` | — | darhol | Agentda belgilanmagan bo‘lsa, javoblarni xilma-xil qilishning yana bir yo‘li (0–1). Bo‘sh — model o‘zi hal qiladi. Odatda faqat bittasini belgilaydilar: yo harorat, yo shu; fikrlovchi modellar uni qabul qilmaydi. | | `AIHUMMER_MODEL_GUARD_INTERVAL_MIN` | Agent modelini tekshirish: interval, daq | `int` | `60` | darhol | Har bir agentning modelini yoqilgan taʼminotchi berayotganini qanchalik tez-tez tekshirish kerak. Agent modeli hech qachon oʻzgartirilmaydi: uni hech kim bermas ekan, javob tartibidagi pauzada boʻlmagan birinchi model javob beradi va bildirishnoma agentlarni ataydi — modeli qaytganda yana bir bildirishnoma keladi. Shlyuz ishga tushganda tekshirish har doim bajariladi, 0 esa faqat takrorlashni oʻchiradi. Yangi davr bir daqiqa ichida kuchga kiradi. | | `AIHUMMER_OPENAI_API` | OpenAI API uslubi (chat \| responses) | `enum: \\\| chat \\\| responses` | — | qisman qayta ishga tushirilgandan keyin | chat = /chat/completions, responses = /responses. Boʻsh = avto/sukut boʻyicha. Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_OPENAI_API_KEY` | Nativ OpenAI API kaliti (oʻrnatish uchun standart) | `text` | — | qisman qayta ishga tushirilgandan keyin | Nativ OpenAI sikli uchun OpenAI akkauntingiz kaliti (agar OpenAI ni standart provayder sifatida ishlatsangiz). «Modellar» sahifasidagi ish maydoni BYOK i bilan adashtirmang. Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_OPENAI_BASE_URL` | Nativ OpenAI bazaviy URL manzili | `text` | — | qayta ishga tushirilgandan keyin | OpenAI bilan mos API bazasi (masalan https://api.openai.com/v1). Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_OPENAI_MODEL` | Nativ OpenAI modeli | `text` | — | qayta ishga tushirilgandan keyin | Nativ OpenAI sikli uchun model (AIHUMMER_OPENAI_API_KEY belgilangan boʻlsa). Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_ROUTER_COMPLEX_MODEL` | Router: murakkab navbatlar uchun model | `text` | — | darhol | Oʻz modeli boʻlmagan agentning murakkab soʻrovlari uchun model (boʻsh = daraja oʻchirilgan). Keyingi qadamdan kuchga kiradi. | | `AIHUMMER_ROUTER_SIMPLE_MODEL` | Router: oddiy navbatlar uchun model | `text` | — | darhol | Oʻz modeli boʻlmagan agentning oddiy soʻrovlari uchun model (boʻsh = daraja oʻchirilgan). Keyingi qadamdan kuchga kiradi. | | `AIHUMMER_ROUTER_STANDARD_MODEL` | Router: standart navbatlar uchun model | `text` | — | darhol | Oʻz modeli boʻlmagan agentning odatiy soʻrovlari uchun model (boʻsh = daraja oʻchirilgan). Keyingi qadamdan kuchga kiradi. | | `AIHUMMER_SUBSCRIPTION_QUOTA_REFRESH_MIN` | Obuna kvotalari: soʻrov davri, daq | `int` | `15` | darhol | Panel ChatGPT’dan (Codex) obuna kvota oynalarini qanchalik tez-tez so‘raydi: davr ichida ko‘pi bilan bir marta, 5 daqiqadan tez emas va faqat kvotalar ochiq bo‘lganda; oraliqda saqlangan nusxa ko‘rsatiladi. Claude’dan hech qachon so‘ralmaydi: uning limitlari bizning taxminimiz. Kvotalar keyingi safar ochilganda kuchga kiradi. | ## Media | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_DEEPGRAM_API_KEY` | Deepgram API kaliti | `text` | — | darhol | Deepgram xizmati kaliti — ovozli xabarlarni Deepgram aniqlasa kerak. Bo‘sh bo‘lsa, qo‘shni sozlamadagi umumiy nutqni aniqlash kaliti olinadi. Darhol kuchga kiradi. | | `AIHUMMER_DEEPGRAM_DETECT_LANGUAGE` | Deepgram tilni aniqlash | `bool` | `0` | darhol | Belgilangan tilni yuborish o‘rniga tilni aniqlash. Darhol qoʻllanadi. | | `AIHUMMER_DEEPGRAM_MODEL` | Deepgram modeli | `text` | `nova-2` | darhol | Deepgram modeli (masalan nova-2, nova-3, base). Kalit boʻyicha loyihaning kirish huquqiga bogʻliq. Darhol qoʻllanadi. | | `AIHUMMER_DEEPGRAM_PUNCTUATE` | Deepgram tinish belgilari | `bool` | `1` | darhol | Tinish belgilari va bosh harflarni qo‘shish. Darhol qoʻllanadi. | | `AIHUMMER_DEEPGRAM_SMART_FORMAT` | Deepgram aqlli formatlash | `bool` | `1` | darhol | Aniqlangan raqam va sanalarni formatlash. Darhol qoʻllanadi. | | `AIHUMMER_DEEPGRAM_URL` | Deepgram bazaviy URL manzili | `text` | — | darhol | Deepgram API bazasi. Boʻsh = https://api.deepgram.com. Darhol qoʻllanadi. | | `AIHUMMER_IMAGE_BASE_URL` | Tasvir API bazaviy URL manzili (zaxira OpenAI) | `text` | — | darhol | OpenAI kaliti orqali ishlaganda /images API bazasi (boʻsh = https://api.openai.com/v1). | | `AIHUMMER_IMAGE_MODEL` | Tasvir generatsiyasi modeli | `text` | — | darhol | image_generate uchun model (sukut boʻyicha gpt-image-2). | | `AIHUMMER_MEDIA_MAX_UPLOAD_MB` | Media maksimal yuklash hajmi (MB) | `int` | `256` | darhol | Bir martada yuklash mumkin bo‘lgan eng katta fayl (rasm, ovozli xabar, video), megabaytda. Server diskini to‘lib qolishdan himoya qiladi. Sukut bo‘yicha 256. Darhol kuchga kiradi. | | `AIHUMMER_SIDECAR_STT` | Ushbu serverda nutqni aniqlash (faster-whisper) | `bool` | `0` | darhol | Mahalliy nutqni aniqlash (faster-whisper). Paketga kiritilmagan: imzolangan plaginni yuklab olishni yoqish (Pythonning barcha versiyalari uchun ~620 Mb) va xizmatni xostga o'rnatish. 🔴 Qo'shimcha sotuvchining alohida qarori bilan nashr etiladi (uning paketlari GPL bo'yicha ffmpegga ega); agar u sizning nashringiz uchun chop etilmasa, shu jumladan, bu haqda halol bo'ladi va hech narsani buzmaydi. Bulutli reja: tanib olish provayder tomonidan sozlangan. | | `AIHUMMER_SIDECAR_TTS` | Javoblarni ovozlashtirish (edge-tts) | `bool` | `0` | darhol | Nutq sintezi (edge-tts, ovozlar Microsoft Edge). Paketga kiritilmagan: imzolangan plaginni (~26 MiB) yuklab olishni yoqish va xizmatni xostga o'rnatish. Sintezning o'zi ovoz berish uchun onlayn bo'ladi - bu erda "oflayn" paketni o'rnatishni anglatadi, ishlamaydi. | | `AIHUMMER_STT_API_KEY` | STT API kaliti (ixtiyoriy) | `text` | — | darhol | Nutqni aniqlash xizmatiga kirish kaliti, agar u talab qilsa. Ushbu serverdagi xizmat uchun uni o‘rnatuvchi belgilaydi — o‘zgartirish shart emas. Darhol kuchga kiradi. | | `AIHUMMER_STT_ENGINE` | STT dvigateli | `enum: auto \\\| faster-whisper \\\| deepgram \\\| codex \\\| off` | `auto` | darhol | Ovozli xabarlarni nima bilan matnga aylantirish. Avto (standart): kaliti o‘rnatilgan bo‘lsa Deepgram, aks holda o‘rnatilgan bo‘lsa mahalliy xizmat (yuqoridagi kalit), aks holda hech narsa bilan — va bot yuboruvchiga hozircha tinglay olmasligini halol aytadi. faster-whisper: mahalliy xizmat yoki mos tashqi /v1/audio/transcriptions. deepgram: o‘z kalitingiz bilan bulutdagi Deepgram. codex: ulangan ChatGPT obunasi (Modellar → ChatGPT’ni ulash), uning kvotasini sarflaydi. off: matnga aylantirmaslik. Darhol qoʻllanadi. | | `AIHUMMER_STT_LANGUAGE` | STT tili | `text` | — | darhol | Tanish tili (BCP-47, masalan ru/en). deepgram dvigateli tomonidan ishlatiladi (nova-2 modeli). Boʻsh = avtoaniqlash yoki dvigatel standarti. Darhol qoʻllanadi. | | `AIHUMMER_STT_MODEL` | STT modeli | `text` | `Systran/faster-whisper-small` | darhol | faster-whisper modeli (masalan small/medium/large-v3 yoki Systran/faster-whisper-⟨size⟩). Darhol qoʻllanadi. | | `AIHUMMER_TTS_API_KEY` | TTS API kaliti (edge-tts) | `text` | — | qisman qayta ishga tushirilgandan keyin | Ovozlashtirish xizmatiga kirish kaliti. O‘rnatishda avtomatik belgilanadi — o‘zgartirish shart emas. | | `AIHUMMER_TTS_ENABLED` | Matnni nutqqa aylantirish yoqilgan | `bool` | `1` | qisman qayta ishga tushirilgandan keyin | Agentga ovoz bilan javob berishga ruxsat beradi. Buning uchun ovozlashtirish xizmati kerak — uni yuqoridagi «Qo‘shimcha xizmatlar» bo‘limida o‘rnatadilar. | | `AIHUMMER_TTS_MODEL` | TTS modeli | `text` | — | qisman qayta ishga tushirilgandan keyin | edge-tts xizmati uchun model nomi. Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_TTS_VOICE` | TTS ovozi | `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` | qisman qayta ishga tushirilgandan keyin | Sukut boʻyicha edge-tts ovozi (koʻp tilli, rus tili ham). Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_VIDEO_API_KEY` | Video tahlili API kaliti | `text` | — | darhol | Video tahlili xizmatiga kirish kaliti, agar u talab qilsa. Bo‘sh — xizmat kalitsiz ishlatiladi. | ## Media · Voice | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_TTS_AUTO_REPLY` | Avtomatik ovozli javoblar | `enum: off \\\| always \\\| inbound \\\| tagged` | `inbound` | darhol | O‘chirilgan, doim, ovozli xabar kelganda yoki aniq belgi qo‘yilganda. Har bir suhbat uchun o‘zgartirish mumkin. | | `AIHUMMER_TTS_MAX_CHARS` | O‘qiladigan matn belgilar chegarasi | `int` | `0` | darhol | 0: to‘liq matn; 100–10000: o‘qiladigan matn chegarasi. To‘liq javob tarixda qoladi. | | `AIHUMMER_TTS_SUMMARIZE` | Uzun ovozli javoblarni qisqartirish | `bool` | `1` | darhol | Uzun javoblarni ovoz uchun qisqartirish. Xatoda matn boshi belgilangan chegara ichida o‘qiladi. | | `AIHUMMER_VOICE_AEC` | Aks sadoni bostirish (AEC) | `bool` | `1` | darhol | Aks-sadoni yo‘qotadi: agentning karnaydan chiqqan o‘z ovozi mikrofonga qaytib tushmaydi va suhbatni bo‘lmaydi. Faqat quloqchinda ovoz buzilib eshitilsa o‘chiring. | | `AIHUMMER_VOICE_AGC` | Avtomatik kuchaytirishni boshqarish | `bool` | `1` | darhol | Ovozli rejimda mikrofon kuchaytirishini avtomatik boshqarishni (WebRTC autoGainControl) talab qilish. | | `AIHUMMER_VOICE_BARGEIN_FRAMES` | Agentning so‘zini bo‘lish: qancha gapirish kerak | `int` | `5` | darhol | Agent jim bo‘lib tinglashni boshlashi uchun qancha gapirish kerak (20 ms kadrlarda). Sukut bo‘yicha 5 — taxminan 0,1 soniya. | | `AIHUMMER_VOICE_DUPLEX` | Jonli toʻliq dupleksli ovoz | `bool` | `0` | darhol | Jonli toʻliq dupleks rejimini yoqadi (striming + VAD + barge-in). Darhol qoʻllanadi. | | `AIHUMMER_VOICE_NOISE_SUPPRESSION` | Shovqinni bostirish | `bool` | `1` | darhol | Ovozli rejimda mikrofondan yozib olishda shovqin bostirishni (WebRTC noiseSuppression) talab qilish. | | `AIHUMMER_VOICE_VAD_THRESHOLD` | Ovozga sezgirlik (0–1) | `text` | `0.02` | darhol | Qanday balandlikdagi tovush nutq hisoblanadi. Kamroq — sezgirroq: agent sokin nutqni ham, begona shovqinni ham eshitadi. Sukut bo‘yicha 0.02. | ## Memory | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_EMBEDDER_DIM` | Ma’no bo‘yicha qidiruv modeli o‘lchami | `int` | `768` | qayta ishga tushirilgandan keyin | Vektor oʻlchami — model bilan mos boʻlishi kerak (multilingual-e5-base=768, bge-m3=1024). | | `AIHUMMER_EMBEDDER_KEEPALIVE` | Embedder-jonli | `text` | `5m` | qayta ishga tushirilgandan keyin | Ma’no bo‘yicha qidiruv modeli oxirgi so‘rovdan keyin qancha vaqt yuklangan holda qoladi (faqat «Ma’no bo‘yicha» rejimida). Sukut bo‘yicha 5m — 5 daqiqa: so‘ng model tushiriladi va xotira hamda protsessorni bo‘shatadi. Doim ushlab turish (-1) tavsiya etilmaydi: qotib qolgan model kunlab protsessor yadrosini band qilishi mumkin. Format: 30s, 5m, 1h. | | `AIHUMMER_EMBEDDER_MODEL` | Ma’no bo‘yicha qidiruv modeli | `text` | `yxchia/multilingual-e5-base` | qayta ishga tushirilgandan keyin | Xotiradan ma’no bo‘yicha qidirishga yordam beradigan model. Sukut bo‘yicha multilingual-e5-base rus tilini tushunadi, yengil va oddiy protsessorda tez ishlaydi. Videokartada yaxshiroq sifat uchun bge-m3 mos keladi, lekin unda qo‘shni o‘lcham sozlamasida 1024 ni ko‘rsating: son modelga mos bo‘lishi kerak. | | `AIHUMMER_EMBEDDER_PASSAGE_PREFIX` | Embedder hujjat prefiksi | `text` | — | qayta ishga tushirilgandan keyin | Saqlanadigan hujjat prefiksini qayta belgilash (e5 modellari avtomatik \\"passage: \\" dan foydalanadi). Model nomi boʻyicha avtoaniqlash uchun boʻsh qoldiring. | | `AIHUMMER_EMBEDDER_QUERY_PREFIX` | Embedder soʻrov prefiksi | `text` | — | qayta ishga tushirilgandan keyin | Qidiruv soʻrovi prefiksini qayta belgilash (e5 modellari avtomatik \\"query: \\" dan foydalanadi). Model nomi boʻyicha avtoaniqlash uchun boʻsh qoldiring. | | `AIHUMMER_EMBEDDER_THREADS` | Embedderning protsessor oqimlari | `int 0…256` | `0` | qayta ishga tushirilgandan keyin | Ma’no bo‘yicha qidiruv modeli bitta so‘rov uchun protsessorning nechta oqimini oladi. 0 — avtomatik: server oqimlarining yarmi, lekin 2 tadan kam emas. Cheklovsiz zaif serverda bilimlar bazasi vektorlarini qayta hisoblash soatlab butun protsessorni band qilib, agentlar javoblariga xalal berardi. Ko‘proq — qayta hisoblash tezroq, lekin yuklama og‘irroq. | | `AIHUMMER_MEMORY_AGENT_WRITES` | Agent o‘zi saqlaydigan faktlar | `enum: strangers \\\| immediate \\\| review` | `strangers` | darhol | Agent o‘zi eslab qoladigan narsa bilan nima bo‘ladi — masalan, «eslab qol» so‘rovi bilan. «Darhol xotiraga; begonalardan — tekshiruvga» (standart) — egasi yoki agentning ishonchli doirasi aytgan bo‘lsa, darhol xotiraga; boshqalardan — tekshiruvga. «Darhol xotiraga» — agent uni darhol topadi. «Tekshiruvga» — avval «Xotira → tekshiruvga» navbatiga, javoblarga faqat siz tasdiqlagandan keyin tushadi. Agent kartasida (Xotira → Sozlamalar) o‘z rejimini tanlash mumkin. | | `AIHUMMER_MEMORY_AUTOREPAIR` | Xotirani avtomatik tuzatish | `bool` | `1` | darhol | O‘z-o‘zini tekshiruvdan so‘ng xotirani tuzatish: dublikatlarni birlashtirish, aniq g‘olibi bor qarama-qarshiliklarni yopish (inson tasdig‘i, voqeaning keyingi sanasi, salmoqliroq manba), hech bir inson tasdiqlamagan «tasdiqlangan» faktlarni manbalari bo‘yicha qayta tekshirish (tasdiqlanmaganlari tekshiruvga yuboriladi, hech narsa o‘chirilmaydi). Bahsli narsa faqat navbatga tushadi. Har bir tuzatish bekor qilish tugmasi bilan jurnalga yoziladi; o‘tishdan keyin xotira yomonroq topsa, o‘tish o‘zini qaytaradi va sizga bildirishnoma keladi. Darhol kuchga kiradi, qayta ishga tushirish kerak emas. | | `AIHUMMER_MEMORY_CAPTURE` | Xotira yozib olish rejimi | `enum: auto \\\| review \\\| off` | `review` | darhol | Agent har bir javobdan keyin yozishmada o‘zi payqagan faktlar bilan nima qilish. «Tekshiruvga» — «Xotira → tekshiruvga» navbatiga: javoblarga faqat siz tasdiqlagandan keyin tushadi. «Darhol xotiraga» — tekshiruvsiz: tezroq, lekin ortiqchasi ko‘p. «Saqlamaslik» — yozishmadan fakt olmaslik. Agent so‘rov bo‘yicha eslab qoladigani alohida sozlanadi. | | `AIHUMMER_MEMORY_CONTEXT_TIMEOUT` | Xotirani yuklash taymauti | `text` | `3s` | darhol | Agent javobni boshlashdan oldin mos xotiralar topilishini qancha kutadi. Qidiruv ulgurmasa, agent qotib qolmaydi, ularsiz javob beradi. Masalan: 2s — 2 soniya, 1500ms — 1,5 soniya. 0 — kerakli vaqtcha kutish. | | `AIHUMMER_MEMORY_DIARY_BOOT` | Sessiya boshida agent kundaligi | `bool` | `1` | darhol | Istalgan kanalda sessiyaning har bir qadamida agentning bugungi va kechagi kundaligini uning ko‘z oldida tutish: oldingi sessiyalar qaydlari, tungi xulosa va agentning o‘z yozuvlari. Faqat joriy suhbatdosh haqidagi va umumiy (sizniki, yuklangan) yozuvlar ko‘rsatiladi — bir mijoz boshqasinikini hech qachon ko‘rmaydi. Ko‘pi bilan ~6000 belgi; qolganini agent o‘zi o‘qiydi (memory_get). Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_MEMORY_DIARY_HOUR` | Tungi xulosa soati | `int` | `3` | darhol | O‘tgan kun xulosasi qaysi soatdan keyin (0–23, instansning vaqt mintaqasi bo‘yicha) yozilsin. Standart 3 — tunda, kunning suhbatlari tugaganda. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_MEMORY_DIARY_NIGHTLY` | Agent kundaligiga tungi kun xulosasi | `bool` | `1` | darhol | Sutkada bir marta agentning kundaligiga o‘tgan kun xulosasini yozish — har bir suhbatdosh bo‘yicha alohida (uning barcha kanallari birga): nima so‘raldi va nima qilindi, kelishuvlar, sanasi bor ishlar. Har bir agent va suhbatdosh uchun xizmat vazifalari modeliga bitta chaqiruv, har 10 daqiqadagi o‘tishda ko‘pi bilan 3; o‘tkazib yuborilgan kunlar bir haftagacha orqaga to‘ldiriladi. «Eslab qolma» deyilgan suhbatlar olinmaydi. Xotira yig‘ish o‘chirilgan bo‘lsa, yozilmaydi. Oxirgi o‘tishning natijasi agent kartasida → Xotira → Kundalik bo‘limida ko‘rinadi. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_MEMORY_DREAM_INTERVAL` | «Tush» bosqichi oraligʻi | `string` | `1h` | darhol | Oʻzini-oʻzi qoʻllab-quvvatlovchi dream bosqichi tekshirilgan daʼvolarni barcha doiralarda ziddiyatlarga qanchalik tez-tez skanerlaydi (Go duration, masalan 30m/1h/6h). Oʻchirish uchun 0 qoʻying. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_MEMORY_EXTRACT` | LLM orqali faktlarni ajratib olish | `bool` | `1` | darhol | Xom jumla parchalarini saqlash oʻrniga LLM orqali normallashtirilgan subyekt/predikat/obyekt faktlarini ajratib olish (sukut boʻyicha YOQILGAN) — graf/ziddiyat/dream mexanizmlari ishlashi uchun zarur. Har bir yozib olingan xabarga bitta LLM chaqiruvini qoʻshadi; chaqiruvni tejash uchun oʻchiring. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_MEMORY_MEANING_TIMEOUT` | Ma’no bo‘yicha qidiruv muddati | `text` | `4s` | darhol | Xotira va bilimlar bazasidagi qidiruv ma’no bo‘yicha qidiruvni qancha kutadi. Ma’no modeli band bo‘lsa (masalan, importdan keyin vektorlarni hisoblayotgan bo‘lsa) va o‘z vaqtida javob bermasa, agent o‘nlab soniya kutmasdan so‘zlar bo‘yicha topilganini izoh bilan darhol oladi. Masalan: 4s — 4 soniya, 1500ms — 1,5 soniya. 0 — qancha kerak bo‘lsa, shuncha kutish. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_MEMORY_QUALITY_CHECK` | Xotiraning kundalik o‘z-o‘zini tekshiruvi | `bool` | `1` | darhol | Sutkada bir marta xotira tasdiqlangan faktlari bo‘yicha o‘ziga nazorat savollarini (60 tagacha fakt, har kuni bir xil savollar) va javobi yo‘q savollarni beradi, ularni xotira qidiruvi va avtomatik eslatish orqali o‘tkazib, topilish ulushini, aniqlikni, MRR va soxta eslatishlarni o‘lchaydi. Natija va kunlik grafik: Xotira → Xotira sifati. Yangi faktlarga savollarni xizmat modeli bir marta tuzadi (yozishmalardan fakt ajratadigan o‘sha model; u bo‘lmasa — shablon bilan); natijalar instansda qoladi. Darhol kuchga kiradi, qayta ishga tushirish kerak emas. | | `AIHUMMER_MEMORY_RECALL` | Xotirani avtomatik eslash | `enum: strong \\\| always \\\| off` | `strong` | darhol | Xotiradan topilganini javobga avtomatik qo‘shish kerakmi. «Faqat aniq mosliklar» — fakt xabar bilan kamida ikkita muhim so‘zda mos kelishi kerak; salomlashuv va «ok» xotirani tortmaydi. «Barcha o‘xshashi» — qandaydir mos kelgan hamma narsa va bog‘liq yozuvlar: ortiqchasi ko‘p. «Qo‘shmaslik» — agent kerak deb bilganda xotiradan o‘zi qidiradi. | | `AIHUMMER_MEMORY_RECALL_MAX` | Bir javobga faktlar soni | `int` | `5` | darhol | Bitta javobga qo‘shiladigan xotira faktlarining eng ko‘p soni (standart 5). Bitta faktning turli ifodalari bitta deb hisoblanadi. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_MEMORY_RECALL_MIN_SCORE` | Avtomatik eslash uchun minimal moslik, % | `int` | `10` | darhol | Fakt avtomatik qo‘shilishi uchun xabardagi ma’noli so‘zlarning (kamyobligi bo‘yicha tortilgan) necha foizini qamrab olishi kerak. Standart 10 — haqiqiy yozishmalar asosida sozlangan. Yuqoriroq = kamroq va aniqroq, pastroq = tez-tez va shovqinliroq. Aniq memory_search qidiruviga ta’sir qilmaydi. 0 — chegarasiz: mos kelgan ikkita ma’noli so‘z yetarli. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_MEMORY_RECALL_MIN_SIMILARITY` | Avtomatik qo‘shish uchun eng kam ma’no o‘xshashligi, % | `int` | `86` | darhol | Faqat xotirani ma’no bo‘yicha qidirish uchun (embedder): fakt avtomatik qo‘shilishi uchun xabarga ma’no jihatidan qanchalik yaqin bo‘lishi kerakligi, o‘xshashlik foizida. Standart 86 — haqiqiy xotirada multilingual-e5-base modeli uchun tanlangan: undan pastda deyarli har bir xabarga begona faktlar qo‘shiladi. Boshqa modellar (masalan, bge-m3) o‘xshashlikni boshqacha hisoblaydi — qiymatni agent kartasidagi «Xotiradan so‘rash» orqali tanlang. 0 — chegarasiz. memory_search aniq qidiruviga ta’sir qilmaydi. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_MEMORY_RETRIEVAL` | Xotiradan olish rejimi | `enum: fulltext \\\| embedding` | `fulltext` | qayta ishga tushirilgandan keyin | Agent xotiradan keraklisini qanday qidiradi. «So‘zlar bo‘yicha» — oddiy matn qidiruvi: darhol ishlaydi va serverni yuklamaydi. «Ma’no bo‘yicha» — boshqa so‘zlar bilan aytilgan bo‘lsa ham, ma’nosi yaqinini topadi, lekin ma’no bo‘yicha qidiruv modeli («Qo‘shimcha xizmatlar» bo‘limi) va protsessorga sezilarli yuk kerak. | | `AIHUMMER_QDRANT_API_KEY` | Qdrant API kaliti | `text` | — | qayta ishga tushirilgandan keyin | Qdrant API kaliti, agar vektor ombori avtorizatsiyani talab qilsa. Faqat Qdrant manzili koʻrsatilganda kerak boʻladi. Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_QDRANT_URL` | Qdrant URL manzili (doimiy vektor ombori) | `text` | — | qayta ishga tushirilgandan keyin | Ma’no bo‘yicha qidiruv uchun Qdrant ombori manzili. Bo‘sh — qidiruv ma’lumotlari xotirada saqlanadi va server qayta ishga tushganda yo‘qoladi; doimiy ish uchun manzilni ko‘rsating. | | `AIHUMMER_RAG_QUERY_EXPANSION` | Bilimlar bazasiga so‘rovlarni model bilan qayta ifodalash | `bool` | `0` | darhol | Bilimlar bazasidan qidirishdan oldin xizmat vazifalari modelidan so‘rovning 3 ta boshqa ifodasini so‘rab, barchasi bilan qidirish. Ba’zan ko‘proq topadi, lekin bu HAR bir qidiruvda modelga qo‘shimcha chaqiruv (kvota va kechikish); model ishlamay qolsa, faqat asl ifoda bilan qidiriladi, xato esa jurnalda va qidiruv natijasida ko‘rinadi. Standart bo‘yicha o‘chiq: so‘zlar baribir to‘liq matnli qidiruv bilan topiladi. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_RERANKER_URL` | RAG qayta tartiblash sidecar URL manzili | `text` | — | qayta ishga tushirilgandan keyin | Gibrid qidiruv natijalarini qayta tartiblash uchun cross-encoder sidecar ining HTTP-URL manzili. Boʻsh = qayta tartiblash oʻchirilgan. Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | ## Moderation | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_MODERATION` | Kiruvchi moderatsiya | `bool` | `1` | darhol | "off" jailbreak/prompt-injectionga qarshi ichki himoyani oʻchiradi. Boshqa har qanday qiymat = yoqilgan. Darhol kuchga kiradi, qayta ishga tushirish shart emas. | | `AIHUMMER_MODERATION_REFUSAL` | Moderatsiya rad etish xabari | `text` | — | darhol | Moderator soʻrovni bloklaganda qaytariladigan rad javobi matni (boʻsh = ichki). Darhol kuchga kiradi, qayta ishga tushirish shart emas. | ## Network | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OUTBOUND_PROXY_CUSTOM_URL` | Chiquvchi proksi: o‘z manzili | `text` | — | darhol | HTTPS proksi URL-i; HTTP faqat loopback uchun, yo‘l, so‘rov yoki fragmentsiz ruxsat etiladi. Avval manzilni saqlab, keyin custom tanlang. API-da yashiriladi va ilova sozlamalarida saqlanadi. | | `AIHUMMER_OUTBOUND_PROXY_MODE` | Xorijiy model provayderlari uchun chiquvchi proksi | `enum: auto \\\| off \\\| custom` | `auto` | darhol | Server xorijiy model yetkazib beruvchilariga qanday murojaat qiladi. «Yetkazib beruvchidagidek» — yetkazib beruvchi kabinetida belgilanganidek; «To‘g‘ridan-to‘g‘ri, proksisiz» — vositachisiz; «O‘z proksingiz orqali» — pastda saqlagan manzilingiz orqali. Ishlashi aniq yetkazib beruvchining qoidalariga bog‘liq. | | `AIHUMMER_RUSSIAN_TRUSTED_EXTRA_HOSTS` | Rossiya Raqamli rivojlanish vazirligi ildizlari uchun .ru dan tashqari xostlar | `list` | — | qayta ishga tushirilgandan keyin | Rossiya Raqamli rivojlanish vazirligi OVER rus domenlari (.ru/.su/.rf - allaqachon kiritilgan) ildizlari bilan tekshirishga ruxsat berilgan, vergul bilan ajratilgan xostlar ro'yxati. Rossiya Raqamli rivojlanish vazirligi sertifikatiga ega tuguningiz boshqa domenda yashasa kerak. Nom yoki subdomen chegarasi boʻyicha moslang: example.com api.example.com ni qamrab oladi. Bo'sh = faqat rus domenlari. Boshlash/qayta ishga tushirilgandan keyin amal qiladi. | ## Performance | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_TURN_QUEUE_WAIT_SEC` | Navbatda kutish: kanal xabari (soniya) | `int 10…1200` | `600` | darhol | Qadamlarning barcha o'rinlari band bo'lganda kanal xabari (Telegram va boshqalar) bo'sh o'rinni qancha kutadi. Vaqtida o'rin topilmasa, insonga server band ekani va qayta yozishi mumkinligi aytiladi. Kutish qadamning 30 daqiqalik chegarasiga kiradi. 10–1200. Darhol kuchga kiradi. | | `AIHUMMER_MAX_ACTIVE_TURNS` | Bir vaqtda bajariladigan agent qadamlari (butun server) | `int 1…512` | `32` | darhol | Server bir vaqtda nechta agent qadamini (kanallar va veb-chatdagi javoblar, jadvallar) bajaradi. Qolganlari quyidagi «Navbatda kutish» sozlamalari ruxsat bergancha navbatda kutadi va inson «server band, navbatda» ni ko'radi. Ko'proq bo'lsa, kutish kamayadi, lekin xotira, ma'lumotlar bazasi ulanishlari va modelga bir vaqtdagi so'rovlar ko'payadi. Bu sonning yarmi modelning bir vaqtdagi yordamchi chaqiruvlarini (xotiradan ajratib olish, xulosalar) cheklaydi. 1–512. Darhol kuchga kiradi. | | `AIHUMMER_SYNC_INBOUND_QUEUE_WAIT_SEC` | Navbatda kutish: integratsiyaning sinxron chaqiruvi (soniya) | `int 1…120` | `10` | darhol | Qadamlarning barcha o'rinlari band bo'lganda javobni o'sha so'rov ichida kutadigan integratsiya chaqiruvi bo'sh o'rinni qancha kutadi. O'rin topilmasa, integratsiya xuddi shuncha soniyadan keyin qayta urinish maslahati bilan «server band» javobini oladi; xuddi shu xabar raqami bilan qayta urinish uni ikkinchi marta yozmaydi. 1–120. Darhol kuchga kiradi. | | `AIHUMMER_WEB_TURN_QUEUE_WAIT_SEC` | Navbatda kutish: veb-chat xabari (soniya) | `int 10…1200` | `180` | darhol | Qadamlarning barcha o'rinlari band bo'lganda veb-chat xabari bo'sh o'rinni qancha kutadi. Shu vaqt davomida chatda «server band, navbatda» ko'rinadi; vaqtida o'rin topilmasa, javob «Qayta urinish» tugmasi bilan rad etiladi va u sahifa qayta yuklangandan keyin ham tarixda qoladi. 10–1200. Darhol kuchga kiradi. | ## Public access | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PUBLIC_URL` | Serverning ommaviy manzili | `text` | — | qisman qayta ishga tushirilgandan keyin | Panel va ilovalar internetdan ochiladigan manzil, masalan https://ai.example.com. Uni proksingiz (nginx, Caddy) orqali server portiga yo‘naltiring — sukut bo‘yicha 8780. | | `AIHUMMER_WIDGET_ALLOWED_ORIGINS` | Veb-vidjet: ruxsat etilgan sayt originlari | `list` | — | darhol | Veb-chat vidjetini joylashtirishga ruxsat berilgan browser originlarining vergul bilan ajratilgan ro‘yxati, masalan https://example.com,https://www.example.com. Sxema va port aniq mos kelishi kerak. Bo‘sh = hech bir tashqi sayt vidjetdan foydalana olmaydi. `*` yozuvi ataylab e’tiborga olinmaydi, aks holda internetdagi istalgan sahifa bu instans byudjetini sarflashi mumkin. | | `POCKET_AGENT_GATEWAY_BASE_URL` | Pocket-agent shlyuzi ommaviy URL manzili | `text` | — | darhol | → pocket-agent shlyuzi portiga proksilang (POCKET_AGENT_PORT, sukut boʻyicha 8080). Masofaviy agent bu yerga bir martalik tiket orqali ulanadi. | | `TELEGRAM_PUBLIC_URL` | Telegram vebhuki ommaviy URL manzili | `text` | — | darhol | Faqat webhook rejimi uchun — → telegram-connector portiga proksilang (sukut boʻyicha 8091). polling rejimi uchun boʻsh qoldiring (ommaviy URL kerak emas). | ## SSO (LDAP/AD) | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LDAP_BASE_DN` | Foydalanuvchi qidiruvi bazaviy DN | `text` | — | qayta ishga tushirilgandan keyin | Ildizni qidirish, masalan. OU=Foydalanuvchilar,DC=korp,DC=misol. | | `AIHUMMER_LDAP_BIND_DN` | Xizmat bogʻlash DN | `text` | — | qayta ishga tushirilgandan keyin | Dastlabki qidiruv bind i uchun ishlatiladigan hisob, masalan CN=svc-aihummer,OU=Service,DC=corp,DC=example. Boʻsh = anonim qidiruv. | | `AIHUMMER_LDAP_DEFAULT_ROLE` | LDAP: Standart rol (guruh mos kelmasa) | `text` | — | qayta ishga tushirilgandan keyin | Hech bir guruh moslikka tushmaganda beriladigan rol. Boʻsh = rolsiz. | | `AIHUMMER_LDAP_ENABLED` | LDAP/AD orqali kirishni yoqish | `bool` | `0` | qayta ishga tushirilgandan keyin | Yoqilganda administrator kirishlari katalogga qaytadi. Bind paroli Secrets da saqlanadi (scope ldap, name bind_password). | | `AIHUMMER_LDAP_GROUP_ATTR` | Guruh atributi (standart memberOf) | `text` | — | qayta ishga tushirilgandan keyin | Foydalanuvchi yozuvidagi guruh DN larini sanab beruvchi atribut. Boʻsh boʻlsa guruh→rol moslashtiruvi oʻchadi. | | `AIHUMMER_LDAP_ROLE_MAPPINGS` | LDAP: Guruh→rol moslashtirishlari (JSON) | `text` | — | qayta ishga tushirilgandan keyin | Guruh DN (yoki oddiy CN) → rol JSON-obyekti, masalan {\\"CN=Admins,OU=Groups,DC=corp,DC=example\\":\\"admin\\",\\"Operators\\":\\"operator\\"}. | | `AIHUMMER_LDAP_SKIP_TLS_VERIFY` | TLS tekshiruvini oʻtkazib yuborish (faqat laboratoriya uchun, 1/0) | `bool` | `0` | qayta ishga tushirilgandan keyin | Katalog sertifikatini tekshirishni oʻchiradi. Prodakshenda hech qachon yoqmang. | | `AIHUMMER_LDAP_URL` | Katalog URL manzili | `text` | — | qayta ishga tushirilgandan keyin | masalan. ldaps://ad.corp.example:636 (TLS) yoki ldap://dc1.corp.example:389. | | `AIHUMMER_LDAP_USER_ATTR` | Login atributi (standart sAMAccountName) | `text` | — | qayta ishga tushirilgandan keyin | Foydalanuvchi kiritadigan login bilan solishtiriladigan LDAP/Active Directory atributi (sukut boʻyicha sAMAccountName; OpenLDAP uchun uid, UPN uslubidagi loginlar uchun userPrincipalName). | | `AIHUMMER_LDAP_USER_FILTER` | Foydalanuvchi qidiruvi filtri | `text` | — | qayta ishga tushirilgandan keyin | Login uchun %s ni oʻz ichiga olishi shart. AD: (sAMAccountName=%s); OpenLDAP: (uid=%s). | ## SSO (OIDC) | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OIDC_AUDIENCE` | OIDC tomoshabinlari | `text` | — | qayta ishga tushirilgandan keyin | Kutilayotgan `aud` claim — boshqa tomon uchun chiqarilgan tokenlarni rad etish uchun bu yerga SHU resursning audience ini yozing. `aud` claim endi sukut boʻyicha har bir tokenda MAJBURIY (aud siz token rad etiladi); bu belgilanganda aud uni ham oʻz ichiga olishi kerak. Prodakshenda qatʼiy tavsiya etiladi. | | `AIHUMMER_OIDC_ISSUER` | OIDC beruvchi URL manzili | `text` | — | qayta ishga tushirilgandan keyin | IdP emitenti (masalan https://login.example.com). Belgilanganda OIDC JWT autentifikatsiyasini yoqadi. | | `AIHUMMER_OIDC_JWKS_URL` | OIDC JWKS URL manzili | `text` | — | qayta ishga tushirilgandan keyin | Token imzolarini tekshirish uchun JSON Web Key Set endpointi. | | `AIHUMMER_OIDC_TENANT_CLAIM` | OIDC dagi ish maydoni claim i | `text` | — | qayta ishga tushirilgandan keyin | Ish maydoni identifikatorini olib yuruvchi JWT claim (masalan tenant_id / org). | ## SSO (SAML) | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SAML_DEFAULT_ROLE` | SAML: Standart rol (guruh mos kelmasa) | `text` | — | qayta ishga tushirilgandan keyin | Hech bir tasdiqlangan qiymat moslikka tushmaganda beriladigan rol. Boʻsh = rolsiz. | | `AIHUMMER_SAML_ENABLED` | SAML 2.0 SSO ni yoqish | `bool` | `0` | qayta ishga tushirilgandan keyin | /saml/metadata, /saml/acs, /saml/login ni ochadi. SP ning maxfiy kaliti Secrets da saqlanadi (scope saml, name sp_key). | | `AIHUMMER_SAML_ENTITY_ID` | SP ning entity ID si | `text` | — | qayta ishga tushirilgandan keyin | SP entity ID (boʻsh boʻlsa sukut boʻyicha ⟨root⟩/saml/metadata). | | `AIHUMMER_SAML_IDP_METADATA` | IdP metama'lumotlari XML | `text` | — | qayta ishga tushirilgandan keyin | IdP ingizning SAML-metamaʼlumotlar hujjatini joylashtiring (Okta/Azure AD/ADFS). | | `AIHUMMER_SAML_ROLE_ATTRIBUTE` | Rol/guruh atributi (standart groups) | `text` | — | qayta ishga tushirilgandan keyin | Guruh/rol qiymatlarini olib yuruvchi assertion atributi. | | `AIHUMMER_SAML_ROLE_MAPPINGS` | SAML: Guruh→rol moslashtirishlari (JSON) | `text` | — | qayta ishga tushirilgandan keyin | Tasdiqlangan qiymat → rol JSON-obyekti, masalan {\\"AdminGroup\\":\\"admin\\",\\"Ops\\":\\"operator\\"}. | | `AIHUMMER_SAML_ROOT_URL` | SP ildiz URL manzili | `text` | — | qayta ishga tushirilgandan keyin | Bu shlyuzning tashqaridan mavjud bazaviy URL manzili, masalan https://app.example.com. ACS = ⟨root⟩/saml/acs. | | `AIHUMMER_SAML_SP_CERT` | SP sertifikati (PEM) | `text` | — | qayta ishga tushirilgandan keyin | SP ning imzolash uchun ochiq sertifikati (PEM). Unga mos maxfiy kalit Secrets ga joylanadi (scope saml, name sp_key). | ## Schedules | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SCHEDULE_AGENT_MAX_ACTIVE` | Agent: faol jadvallar chegarasi | `int` | `20` | darhol | Agent jadvalni o'zi (o'z jadval vositalari bilan) yaratganda yoki yoqqanda uning nechta faol jadvali bo'lishi mumkin. Panelda yaratilgan jadvallar ham hisobga kiradi, lekin panelga hech qachon rad etilmaydi. Chegaraga yetganda agentdan avval bittasini to'xtatib turish yoki o'chirish so'raladi. Darhol kuchga kiradi. | | `AIHUMMER_SCHEDULE_AGENT_MAX_FIRES_PER_DAY` | Agent: bir sutkada jadval ishga tushishlari | `int` | `288` | darhol | Bitta agentning barcha jadvallari birgalikda bir sutkada (UTC bo'yicha) necha marta ishga tushishi mumkin — panelda yaratilgan jadvallar va qo'lda ishga tushirishlar ham kiradi. Chegaradan ortiq ishga tushishlar o'tkazib yuboriladi va ishga tushirishlar jurnalida ko'rinadi. Darhol kuchga kiradi. | | `AIHUMMER_SCHEDULE_AGENT_MIN_INTERVAL_MINUTES` | Agent: jadvalning eng kichik oralig'i, daqiqa | `int` | `5` | darhol | Agent o'zi yaratgan yoki o'zgartirgan takrorlanuvchi jadvalning ikki ishga tushishi orasidagi eng qisqa oraliq. Bundan tez-tez ishlaydigan jadval rad etiladi. Panelda yaratilgan jadvallarni bu cheklamaydi. Darhol kuchga kiradi. | | `AIHUMMER_SCHEDULE_COMMANDS` | Jadvallarda server buyruqlari | `bool` | `0` | darhol | Jadvalga shu serverda dastur ishga tushirishga ruxsat beradi — yig‘uvchi, hisobot, zaxira nusxa tekshiruvi. Odatda o‘chirilgan. Faqat «Ruxsat etilgan buyruqlar» ro‘yxatidagi buyruqlar, aynan yozilganidek ishlaydi; shell yo‘q. Chiqish agentga yoki to‘g‘ridan-to‘g‘ri chatga boradi, har bir ishga tushirish jadvalning ishga tushirish jurnalida ko‘rinadi. Darhol kuchga kiradi. | | `AIHUMMER_SCHEDULE_COMMANDS_ALLOWLIST` | Ruxsat etilgan buyruqlar | `argvlist` | — | darhol | Jadval ishga tushirishi mumkin bo‘lgan aniq buyruqlar: dastur (df kabi nom yoki to‘liq yo‘l) va uning argumentlari. Jadval faqat argumentlari bilan birga yozuvga to‘liq mos keladigan buyruqni ishga tushiradi. O‘chirilgan buyruq undan foydalanadigan jadvallarni to‘xtatadi, ularning ishga tushirishlari sababini aytadi. Darhol kuchga kiradi. | | `AIHUMMER_SCHEDULE_COMMANDS_MAX_OUTPUT_KB` | Jadval buyrug‘i chiqishi chegarasi, KB | `int 1…1024` | `64` | darhol | Buyruq chiqishining qancha qismi (1–1024 KB) ishga tushirish jurnalida saqlanib, agentga yoki chatga uzatiladi; qolgani kesiladi va jurnal buni aytadi. Darhol kuchga kiradi. | | `AIHUMMER_SCHEDULE_COMMANDS_SANDBOX` | Jadval buyruqlarini OT qum qutisida ishga tushirish | `bool` | `1` | darhol | Yoqilgan: buyruq kod bajarish kabi OT qum qutisida ishlaydi — o‘rnatma sirlari va SSH kalitlari yashiriladi, faqat o‘z vaqtinchalik jildiga yozadi. Serverda qum qutisi (bubblewrap) bo‘lmasa, buyruq ishlamaydi va jurnal sababini aytadi. O‘chirilgan: shlyuz huquqlari bilan ishlaydi. Darhol kuchga kiradi. | | `AIHUMMER_SCHEDULE_FAILURE_ADMIN` | Muvaffaqiyatsiz topshiriqlar haqida administratorga xabar berish | `bool` | `1` | darhol | Rejalashtirilgan topshiriq bajarilmasa yoki boshlana olmasa, panelning bildirishnoma qo'ng'irog'ida uning nomi, sababi va uni qayerda tuzatish mumkinligi bilan bildirishnoma paydo bo'ladi, xuddi shu xabar egalarning shaxsiy kanal chatlariga ham yuboriladi (har bir topshiriq uchun 6 soatda bir martadan ko'p emas). Bu topshiriq qabul qiluvchisiga yuboriladigan xabarga qo'shimcha. O'chirilgan: administrator nosozliklar haqida faqat ishga tushirishlar jurnalidan biladi. Darhol qo'llanadi. | | `AIHUMMER_SCHEDULE_FAILURE_NOTIFY` | Vazifa bajarilmasa, qabul qiluvchiga xabar berish | `bool` | `1` | darhol | Jadval bo‘yicha vazifa bajarilmasa, o‘sha qabul qiluvchiga qisqa xabar yuboriladi (birinchi xatodan keyin, 6 soatda bir martadan ko‘p emas). O‘chirilgan — xatolar faqat ishga tushirishlar jurnalida ko‘rinadi. Alohida vazifa uchun buni uning shaklida o‘chirish mumkin. Darhol kuchga kiradi. | ## Security | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AIRGAPPED` | Izolyatsiya rejimi (internetsiz) | `bool` | `0` | darhol | Agentlarga internetga chiqishni taqiqlaydi: veb-qidiruv, sahifalarni ochish va so‘rovlar faqat ichki manzillarga va ruxsat ro‘yxatlaridagi manzillarga boradi. Tashqariga chiqishi yo‘q yopiq tarmoqlar uchun yoqing. | | `AIHUMMER_AUDIT_RETENTION_DAYS` | Amallar jurnalini necha kun saqlash | `int` | `0` | qayta ishga tushirilgandan keyin | Audit jurnali va sozlamalar o‘zgarishlari tarixining bu muddatdan eski yozuvlari sutkada bir marta o‘chiriladi. 0 yoki bo‘sh — doim saqlash. | | `AIHUMMER_CORS_ORIGINS` | Ruxsat etilgan CORS manbalari | `list` | — | qayta ishga tushirilgandan keyin | Ruxsat etilgan Origin lar roʻyxati, vergul bilan ajratilgan. Boʻsh = CORS taqiqlangan (faqat same-origin). Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_CSP` | Content-Security-Policy sarlavhasi (bekor qilish) | `text` | — | qayta ishga tushirilgandan keyin | CSP sarlavhasini qayta belgilaydi. Boʻsh = xavfsiz standart. Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_INBOUND_SECRET` | Kanal plaginlarining server bilan aloqa kaliti | `text` | — | qayta ishga tushirilgandan keyin | Ulangan kanallar (Telegram, VK va boshqalar) u orqali xabarlar aynan ulardan kelganini tasdiqlaydi. O‘rnatishda avtomatik belgilanadi — o‘zgartirish shart emas. Bo‘sh bo‘lsa, kalit belgilanmaguncha server barcha kanallarni rad etadi. | | `AIHUMMER_OPENAI_COMPAT_KEY` | OpenAI-mos kiruvchi: statik API kaliti | `text` | — | qayta ishga tushirilgandan keyin | Serverga OpenAI bilan mos xizmat sifatida ulanadigan dasturlar uchun umumiy kalit. Bo‘sh — umumiy kalit o‘chirilgan; «API kalitlari» sahifasidagi shaxsiy kalitlar bilan ulanish mumkin. | | `AIHUMMER_OPENAI_COMPAT_WORKSPACE` | OpenAI-mos kiruvchi: ish maydoni ID si | `text` | — | qayta ishga tushirilgandan keyin | Statik OpenAI bilan mos autentifikatsiya moslashtiriladigan ish maydoni ID si. Boʻsh = AIHUMMER_DEFAULT_WORKSPACE_ID. Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_REQUIRE_2FA` | Operatorlar uchun 2FA talab qilish | `bool` | `0` | darhol | Operatorlar uchun ikkinchi omilni (TOTP/passkey) talab qilish. Yoqilganda 2FA siz operatorlarga kirishda uni darhol sozlash taklif qilinadi (bloklamasdan, egasi qulf ortida qolmasligi uchun). Darhol qoʻllanadi. | | `AIHUMMER_REQUIRE_SECURE` | Faqat xavfsiz (HTTPS/WSS) ulanishlarni qabul qilish | `bool` | `0` | qayta ishga tushirilgandan keyin | Yoqilganda oddiy HTTP soʻrovlari HTTPS ga yoʻnaltiriladi (GET/HEAD uchun) yoki rad etiladi (403); localhost dan kirish har doim ruxsat etilgan, shunda operator qulf ortida qolmaydi. TLS ni tugatuvchi teskari proksidan X-Forwarded-Proto ni hisobga oladi. Ishga tushirishda/qayta ishga tushirgandan keyin qoʻllanadi. | | `AIHUMMER_TRUSTED_PROXIES` | Ishonchli proksilar | `list` | — | darhol | Server oldida proksi (nginx, Caddy, balanslovchi) bo‘lsa, uning manzili yoki tarmog‘ini vergul bilan yozing, masalan 10.0.0.0/8. Shunda amallar jurnalida, ruxsat etilgan IP ro‘yxatida va parolni tanlashdan himoyada tashrif buyuruvchining haqiqiy manzili ko‘rinadi. Bo‘sh — faqat to‘g‘ridan-to‘g‘ri ulanish manzili hisobga olinadi va uni soxtalashtirib bo‘lmaydi. | ## Tools | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_BROWSER_ALLOWED_HOSTNAMES` | Brauzer: xususiy host istisnolari | `list` | — | darhol | Vergul bilan ajratilgan aniq nomlar; niqob, URL yoki port yo‘q. O‘z serveringizdagi mahalliy CDP uchun qo‘shimcha xususiy istisnolar; web_fetch-dan alohida. | | `AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK` | Brauzer: xususiy tarmoqqa ruxsat | `bool` | — | darhol | Bo‘sh qiymat eski qoidani saqlaydi; true yoki false tekshiriladigan mahalliy CDP-ni yoqadi. Xususiy kirish faqat o‘z serveringizda. Loopback, link-local va metadata yopiq qoladi. | | `AIHUMMER_BROWSER_PROFILE_SOCKET` | Brauzer profili boshqaruv soketi | `text` | — | darhol | Ixtiyoriy. Bo'sh qoldiring — shlyuz brauzer xizmatining managed-profiles.sock boshqaruv soketini standart o'rnatish joyidan o'zi topadi. Saytlarga kirilgan profillar «Ulanishlar» → «Brauzer profillari» sahifasida yaratiladi. Bu URL emas va manba profilga yo'l ham emas. | | `AIHUMMER_CODE_EXEC` | Agent tomonidan kodni bajarish | `enum: off \\\| host \\\| sandbox` | `off` | darhol | Agentning kodni bajarish vositasi (code_exec). Standart holatda — «O‘chiq». «Shu serverda»: buyruqlar shlyuz serverida bajariladi; OT qumtutgichi (bubblewrap) o‘rnatma sirlarini yashiradi, biroq «Cheklovsiz» rejimidagi agent SSH kalitlarini ko‘radi va o‘z jildidan tashqariga yoza oladi — faqat ishonchli server uchun. «Faqat qumtutgichda»: doimo OT qumtutgichida — sirlar va kalitlar yashirilgan, yozish faqat agent jildiga; bubblewrap (yoki konteyner tasviri)siz bu rejim saqlanmaydi. Har bir agent nimani ishga tushira olishi agentning o‘zida belgilanadi: «Agentlar → profil → Vositalar». | | `AIHUMMER_CODE_EXEC_INTERPRETERS` | Code-exec interpretatorlari (JSON) | `text` | — | darhol | JSON-obyekt {til: binar_faylga_yoʻl}, masalan {\\"python\\":\\"/usr/bin/python3\\"}. Boʻsh = avtoaniqlash. | | `AIHUMMER_CODE_EXEC_NET_PORTS` | Agent kodiga ochiq tarmoq portlari | `list` | `53,80,443` | darhol | OT qum qutisidagi agent kodi (kodni bajarish va jadval buyruqlari) ulanishi mumkin bo‘lgan TCP portlari, vergul bilan ajratilgan. Standart holatda 53, 80 va 443: DNS va saytlar. Ushbu server va uning mahalliy tarmog‘idagi boshqa xizmatlar (ma’lumotlar bazasi, boshqaruv paneli, brauzer, adb, mahalliy modellar, Home Assistant) agent kodi uchun yopiq qoladi. Ro‘yxatdagi port har qanday manzilda, jumladan ushbu serverda ham ochiq, shuning uchun faqat kodga keraklisini qo‘shing, masalan SSH uchun 22. Cheklovni olib tashlash uchun any deb yozing. «Cheklovsiz» rejimidagi agentlar cheklanmaydi. Linux 6.7 yoki yangisi kerak; usiz cheklov ishlamaydi va bu haqda Agentlar → Asboblar bo‘limida aytiladi. Darhol kuchga kiradi. | | `AIHUMMER_CODE_EXEC_READ_DIRS` | Agent kodiga o‘qish uchun ochiq papkalar | `list` | — | darhol | Agent kodi o‘qiy oladigan ushbu serverdagi papkalar: OT qum qutisida kodni bajarish va jadval buyruqlari. Vergul bilan yoki har bir qatorga bittadan, masalan ~/reports. Alohida faylni ham ko‘rsatish mumkin, masalan ~/scripts/report.py. Bu yerda ochilgan narsa barcha agentlarning kodiga ko‘rinadi, shuning uchun faqat kodga keraklisini oching. Standart holatda bo‘sh: qum qutisida kod faqat o‘z agentining papkasini va tizim papkalarini ko‘radi; shlyuz foydalanuvchisining uy papkasi, o‘rnatish ma’lumotlari, boshqa agentlarning papkalari, kalitlar va buyruqlar tarixi yashirin qoladi. Ildizni, butun uy papkasini, o‘rnatish ma’lumotlarini va kalitli joylarni ochib bo‘lmaydi. Kod bu papkalarga yoza olmaydi. Darhol kuchga kiradi. | | `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Code-exec qumtutgich obrazi | `text` | — | darhol | Ixtiyoriy, faqat «Faqat qumtutgichda» rejimi uchun: OT qumtutgichi o‘rniga Docker konteyner tasviri (tarmoqsiz, faqat o‘qiladigan ildiz, cheklovlar); serverda Docker kerak. Bo‘sh = OT qumtutgichi (bubblewrap). | | `AIHUMMER_CODE_EXEC_TIMEOUT_SECONDS` | Kodni bajarish vaqti chegarasi (soniya) | `int` | `1800` | darhol | Agentning bitta buyrug‘i, fondagilari bilan birga, qancha vaqt ishlashi mumkin: 10 soniyadan 24 soatgacha. 30 soniyada javob bermagan buyruq uzilmaydi, fonga o‘tadi va agent uni process vositasi bilan tekshiradi. Agent qisqaroq muddat so‘rashi mumkin, uzunrog‘ini emas. | | `AIHUMMER_DB_QUERY_DSN` | «Bazaga so‘rov» vositasi uchun bazaga ulanish | `text` | — | darhol | Agent o‘qiy oladigan (faqat o‘qish) ma’lumotlar bazasiga ulanish qatori, masalan postgres://reader:parol@host/db. Eng kam huquqli foydalanuvchini ko‘rsating — baza egasini emas. Bo‘sh — vosita o‘chirilgan. | | `AIHUMMER_FS_ROOT` | Fayl tizimi vositasi ildizi | `text` | — | darhol | Agent server fayllarini o‘qiydigan papka (filesystem_read; agent fayl yoza olmaydi). Bo‘sh = shlyuz foydalanuvchisi huquqlari bilan butun server, sirlardan tashqari: o‘rnatish sozlamalari (gateway.env), SSH/GPG kalitlari va jarayonlar muhiti. Kirishni toraytirish uchun papkani ko‘rsating. | | `AIHUMMER_HTTP_ALLOWLIST` | Agentning HTTP so‘rovlari uchun manzillar | `list` | — | darhol | http_request vositasi murojaat qila oladigan xostlarning vergul bilan ajratilgan roʻyxati. Boʻsh = ichki va shaxsiy manzillardan tashqari hammasiga ruxsat beriladi. | | `AIHUMMER_HTTP_AUTH_JSON` | http_request avtorizatsiyasi (JSON) | `text` | — | darhol | http_request vositasi uchun xostni avtorizatsiya sarlavhalariga moslashtiruvchi JSON xaritasi — tokenlar promptda saqlanmasligi uchun. Boʻsh = avtorizatsiyasiz. | | `AIHUMMER_MCP_SERVERS` | MCP serverlari (JSON) | `text` | — | darhol | Vositalari agentga ulanadigan tashqi MCP serverlarining JSON tavsifi. Boʻsh = tashqi MCP yoʻq. | | `AIHUMMER_PROJECT_STUDIOS_PUBLIC_NETWORK` | Loyiha studiyalari: ochiq tarmoq | `bool` | `false` | darhol | Tanlangan provayderlar va aniq so‘ralgan model yuklashlari uchun ochiq HTTP(S) ga ruxsat bering. Shaxsiy, mahalliy va metadata manzillari bloklangan holda qoladi. Oflayn rejim ustuvor. Darhol qo‘llanadi. | | `AIHUMMER_SIDECAR_CLOAKBROWSER` | Agent uchun brauzer (CloakBrowser) | `bool` | `0` | darhol | Anti-aniqlash brauzeri (CloakBrowser, browser/computer vositalari). Etkazib berish to'plamiga nimalar QO'SHMADI: inklyuziya imzolangan qo'shimchani yuklab oladi (~477 Mb, shundan Chromium ~ 207 MiB) va xizmatni xostga o'rnatadi. Vagonlarning eng og'irligi - agar agent veb-saytlarni ochishi kerak bo'lsa, uni yoqing. | | `AIHUMMER_SIDECAR_SEARXNG` | Veb-qidiruv (SearXNG) | `bool` | `0` | darhol | Veb-qidiruv (SearXNG, web_search asbobi). To'plamga EMAS: yoqilsa, imzolangan plagin (~154 MiB) yuklab olinadi va xizmatni xostga o'rnatadi, o'chirib qo'yish uni to'xtatadi va joy bo'shatadi. O'rnatish fonda amalga oshiriladi va bir necha daqiqa davom etadi; Bu erdagi holat serverda nima borligini ko'rsatadi. | | `AIHUMMER_WEBFETCH_ALLOWLIST` | Agent ocha oladigan saytlar | `list` | — | darhol | web_fetch vositasi murojaat qila oladigan domenlarning vergul bilan ajratilgan roʻyxati. Boʻsh = ichki va shaxsiy manzillardan tashqari hammasiga ruxsat beriladi. | | `AIHUMMER_WEB_SEARCH_LANGUAGE` | Veb-qidiruv: natijalarning standart tili | `text` | `auto` | darhol | Agent til ko‘rsatmaganda natijalar tili: ru, en yoki de kabi kod yoki so‘rovning o‘zidan aniqlash uchun auto (deyarli har doim mos keladi). Agent muayyan qidiruv uchun boshqa tilni tanlashi mumkin. | | `AIHUMMER_WEB_SEARCH_RESULTS` | Veb-qidiruv: bitta qidiruvdagi natijalar | `int` | `5` | darhol | Agent boshqa son so‘ramaganda qidiruv nechta natija qaytaradi: 1 dan 10 gacha. Ko‘proq natija — to‘liqroq javob, lekin uzunroq kontekst. | | `AIHUMMER_WEB_SEARCH_SOURCE` | Veb-qidiruv manbai | `enum: auto \\\| searxng \\\| provider` | `auto` | darhol | Agent internetda qayerdan qidiradi (web_search vositasi). auto — oʻrnatilgan boʻlsa SearXNG, aks holda model provayderining oʻrnatilgan qidiruvi. searxng — faqat SearXNG: usiz qidiruv yoʻq. provider — mavjud joyda provayderning oʻrnatilgan qidiruvi, boshqa modellar uchun SearXNG. Oʻrnatilgan qidiruv Codex (ChatGPT obunasi) va OpenAI (api.openai.com) da bor; GigaChat, YandexGPT va boshqa OpenAI bilan mos modellarda yoʻq — SearXNG boʻlmasa, bu modellardagi agentlar qidirmaydi. Claude (api.anthropic.com va Claude obunasi) Anthropic’ning ichki qidiruvidan foydalanadi; hisob uni rad etsa, shlyuz buni jurnalga yozadi va bundan keyin agentga faqat SearXNG taklif qiladi. Qaysi agentlarga qidirish mumkinligi avvalgidek agent kartasida belgilanadi. Keyingi navbatdan kuchga kiradi. | | `AIHUMMER_WEB_SEARCH_TIMEOUT_SECONDS` | Veb qidiruv muddati (soniya) | `int` | `30` | darhol | Har qidiruv uchun1–600 soniya. Vazifaning qisqaroq muddati amal qiladi. | ## Updates | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_RESTART_APPLY` | Qayta ishga tushirishni talab qiladigan sozlamalarni qo‘llash | `enum: quiet \\\| manual` | `quiet` | darhol | quiet (standart) — faqat shlyuz yangidan ishga tushganda kuchga kiradigan saqlangan sozlamalar o‘zi qo‘llanadi: agentlar hech narsa qilmayotganda va odamlar kamida sukunat oynasi davomida jim turganda shlyuz eng yaqin sokin paytda qayta ishga tushadi. manual — faqat «qayta ishga tushirishni kutmoqda» belgisi va tugma. Qayta ishga tushirish bir necha soniya davom etadi; suhbatlar va vazifalar yo‘qolmaydi. Darhol kuchga kiradi. | | `AIHUMMER_RESTART_QUIET_MINUTES` | Sokin payt: avtomatik qayta ishga tushirishdan oldingi sukunat daqiqalari | `int 0…1440` | `10` | darhol | Saqlangan sozlamalarni qo‘llash uchun shlyuz o‘zi qayta ishga tushishidan oldin odamlar necha daqiqa jim turishi (va agentlar bo‘sh bo‘lishi) kerak. 0 — agentlar joriy ishini tugatishi bilanoq. 0–1440. Darhol kuchga kiradi. | ## Web UI (separate port) | Kalit | Nomi | Turi | Standart | Kuchga kiradi | Nima qiladi | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_WEBUI_API_BASE` | Alohida joylashtirilgan panel uchun server manzili | `text` | — | qayta ishga tushirilgandan keyin | Faqat panel serverning o‘zidan boshqa manzildan ochilsa kerak. Brauzer serverga yetib boradigan manzilni ko‘rsating, masalan https://api.example.com. Bo‘sh — serverning ommaviy manzili, u bo‘lmasa mahalliy manzil ishlatiladi. | | `AIHUMMER_WEBUI_ENABLED` | Panel alohida portda | `bool` | `1` | qayta ishga tushirilgandan keyin | Yoqilgan — panel internetdan yopish mumkin bo‘lgan alohida ichki portda ochiladi, ommaviy port esa faqat ilovalar va kanallarga xizmat qiladi. Panelni butunlay mavjud bo‘lmasligi uchun o‘chiring. | | `AIHUMMER_WEBUI_ORIGIN` | Panel ochiladigan manzil | `text` | — | qayta ishga tushirilgandan keyin | Panel proksi orqali yoki porti manzilidan farqli nom bilan ochilsa, to‘ldiring, masalan https://admin.example.com. Server shu manzildagi brauzerga unga murojaat qilishga ruxsat beradi. Bo‘sh — panel porti manzili olinadi. | Operatorga ochiq sozlamalar: 237.