Կարգավորումների տեղեկատու

Այստեղ թվարկված են բոլոր կարգավորումները, որոնք օպերատորը կարող է փոխել AiHummer-ի սերվերում։ Էջը հավաքվում է հենց արտադրանքի կատալոգից, ուստի համընկնում է ձեր սերվերի հետ։ Արժեքը սահմանվում է վեբ-ինտերֆեյսում կամ `aihummer settings set KEY VALUE` հրամանով ([Հրամանային տող](/hy/v1.4/reference/cli/))։ Լռելյայն արժեքի սյունակը ցույց է տալիս, թե ինչ է օգտագործում սերվերը, քանի դեռ ձեր արժեքը սահմանված չէ։ > [!NOTE] > Գաղտնի արժեքներն այստեղ չեն տպվում, իսկ մատակարարի սպասարկման բանալիներն ընդհանրապես չեն թվարկվում՝ արտադրանքը թաքցնում է դրանք բոլոր ցուցակներից։ Գծիկը նշանակում է դատարկ արժեք կամ բացատրություն, որը ցուցադրվում է միայն վեբ-ինտերֆեյսում։ ## API | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PERSONAL_API_KEYS` | Անձնական API բանալիներ OpenAI-համատեղելիի համար | `bool` | `1` | վերագործարկումից հետո | \\"off\\"-ն անջատում է անձնական բանալիներով վավերացումը OpenAI-համատեղելի վերջնակետում։ Ցանկացած այլ արժեք = միացված։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | ## Agent | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_ANNOUNCE_SLOW_TOOLS` | Գործակալ՝ զգուշացնել երկար գործողություններից առաջ | `bool` | `1` | անմիջապես | Երկար գործողությունից առաջ (նկար, խորը որոնում, տեսանյութ, հանձնարարություն ենթագործակալին) գործակալը կարճ գրում է, թե ինչ է անում, որպեսզի սպասումը լուռ չլինի։ Անջատեք, եթե նման հաղորդագրությունները խանգարում են։ | | `AIHUMMER_AGENT_COMPACT_AT_PCT` | Գործակալ՝ սեղմել պատմությունը լրացման դեպքում, դրա բյուջեի % | `int 50…99` | `85` | անմիջապես | Երբ զրույցի պատմությունը լրացնում է մոդելի պատուհանում իր տեղի այս մասը, հին հաղորդագրությունները ամփոփվում են՝ ֆոնում, պատասխանից հետո․ քայլը չի սպասում։ Ցածր՝ սեղմումն ավելի հաճախ, բայց մոդելը բառացի ավելի քիչ է հիշում․ բարձր՝ ավելի հազվադեպ, բայց քայլերը ծանրանում են։ 50–99․ գործակալը կարող է սահմանել իր արժեքը։ | | `AIHUMMER_AGENT_COMPACT_TO_PCT` | Գործակալ՝ թողնել սեղմումից հետո, պատմության բյուջեի % | `int 10…90` | `50` | անմիջապես | Սեղմումից հետո պատմության տեղի որքան մասն է մնում բառացի․ ավելի հին ամեն ինչ անցնում է ամփոփման մեջ։ Պետք է ցածր լինի սեղմման շեմից․ դրանց միջև տարբերությունը որոշում է, թե քանի քայլ կանցնի մինչև հաջորդ սեղմումը։ 10–90․ գործակալը կարող է սահմանել իր արժեքը։ | | `AIHUMMER_AGENT_HISTORY_TURNS` | Գործակալ՝ բառացի պահվող զրույցի հերթերը | `int 1…1000` | `30` | անմիջապես | Զրույցի քանի վերջին հերթ է մոդելը տեսնում բառացի (սեղմումից առաջ մինչև 10-ով ավելի)։ Ավելի հին հաղորդագրություններն ամփոփվում են ֆոնում․ զրույցն ինքնին երբեք չի ջնջվում։ Մոդելի համատեքստի պատուհանը հաշվի է առնվում ավտոմատ։ 1–1000; գործակալի համար կարելի է սահմանել առանձին արժեք։ | | `AIHUMMER_AGENT_MAX_ITERATIONS` | Գործակալ՝ գործիքային քայլերի առավելագույն թիվը մեկ հերթում | `int 1…256` | `25` | անմիջապես | Քանի անգամ կարող է գործակալը մեկ հերթում կանչել գործիքներ՝ նախքան պատասխանելը։ Սահմանին հասնելիս հերթը չի ձախողվում․ գործակալը պատմում է, թե ինչ է արված և ինչ է մնացել, և կարող եք խնդրել շարունակել։ Նույն արդյունքով երեք նույնական կանչ անընդմեջ հերթը ավելի շուտ է դադարեցնում։ 1–256; գործակալի համար կարելի է սահմանել առանձին արժեք։ | | `AIHUMMER_AGENT_MEMORY_FLUSH` | Գործակալ՝ սեղմումից առաջ պահել հիշողության նշում | `bool` | `1` | անմիջապես | Նախքան ավելի հին հաղորդագրությունները ամփոփում դառնալը՝ գործակալը հիշողության մեջ պահում է կարճ նշում նպատակների, որոշումների և բաց գործերի մասին։ Անջատեք՝ մոդելի կանչը խնայելու համար։ | | `AIHUMMER_AGENT_MEMORY_FLUSH_PROMPT` | Գործակալ․ ինչ պահել սեղմելուց առաջ նշումում | `text` | — | անմիջապես | Սեղմելուց առաջ նշման ձեր սեփական առաջադրանքը՝ ինչ պահել ամփոփման մեջ գնացող հաղորդագրություններից (օրինակ՝ «գրիր միայն գնումները, ժամկետները և պայմանավորվածությունները»)։ Դատարկ՝ ներկառուցված․ նպատակներ, որոշումներ, բաց գործեր։ Պաշտպանությունը չի անջատվում․ զրույցի տեքստը մնում է տվյալ, ոչ թե ցուցում, գաղտնաբառերն ու բանալիները չեն պահվում։ Մինչև 4000 նիշ․ գործակալը կարող է ունենալ իր սեփականը։ | | `AIHUMMER_AGENT_NEW_REMINDERS_MEMORY` | Նոր գործակալներ՝ հիշեցումներ և գրառում հիշողության մեջ | `bool` | `1` | անմիջապես | Ձեռքով ստեղծված նոր գործակալը (առաջին գործարկման վարպետ, «Ստեղծել գործակալ», API) առաջին քայլից ինքն է սահմանում, փոխում և չեղարկում ԻՐ հիշեցումներն ու ժամանակացույցերը և փաստեր գրառում իր հիշողության մեջ՝ ինչպես անձնական օգնականի ձևանմուշը։ Առանձին գործակալի համար դա անջատվում է նրա քարտում («Հնարավորություններ»)։ Գրադարանի ձևանմուշներն իրենք են որոշում, պատճենը պահպանում է բնօրինակի իրավունքները, մեկ այլ գործակալի ստեղծած գործակալները սկսում են առանց դրանց. գոյություն ունեցող գործակալները չեն փոխվում։ Գործում է հաջորդ ստեղծվող գործակալի համար։ | | `AIHUMMER_AGENT_PROMPT_PART_MAX_CHARS` | Գործակալ՝ առավելագույն նիշեր հուշման մեկ մասի համար | `int 1000…1000000` | `20000` | անմիջապես | Քանի նիշ է մոդելը ստանում գործակալի անհատականության ՄԵԿ մասից՝ պրոֆիլի բաժնից, հուշման մասից կամ հիմնական հուշումից։ Ավելի երկար մասում պահպանվում են սկիզբը (3/4) և վերջը (1/4)՝ նշումով, թե որքան է կտրվել. դա երևում է զրույցի քարտում և գործակալի հուշման կազմում։ Անունը, դիմելաձևը և անհատականության սահմանափակումները երբեք չեն կտրվում։ 1000–1000000; գործակալի համար կարելի է սահմանել իր արժեքը։ | | `AIHUMMER_AGENT_PROMPT_TOTAL_MAX_CHARS` | Գործակալ՝ ամբողջ անհատականության առավելագույն նիշեր | `int 1000…2000000` | `60000` | անմիջապես | Գործակալի անհատականության ընդհանուր սահման՝ բոլոր մասերը միասին։ Երբ այն գերազանցվում է, առաջինը տեղ են զիջում ամենաերկար մասերը, կարճերը մնում են ամբողջական։ 1000–2000000; գործակալի համար կարելի է սահմանել իր արժեքը։ | | `AIHUMMER_AGENT_SELF_INTRO` | Գործակալ՝ ներկայանալ | `enum: first_contact \\\| each_dialog \\\| never` | `first_contact` | անմիջապես | «Մեկ անգամ՝ առաջին ծանոթության ժամանակ»․ գործակալը կարճ ներկայանում է մարդու հետ առաջին զրույցում, եթե նա չի խնդրում անմիջապես անցնել գործին․ ծանոթ մարդուն կրկին չի ներկայանում և բնականորեն պատասխանում է ողջույնին։ «Չներկայանալ»․ գործակալը երբեք ինքն իրեն չի անվանում։ «Յուրաքանչյուր նոր զրույցի սկզբում» — յուրաքանչյուր նոր զրույցի սկզբում և երկար դադարից հետո, կարճ և առանց անցյալ գործերի ամփոփման։ Գործակալը կարող է իր քարտում («Համատեքստ և վարքագիծ») այլ ընտրություն ունենալ։ | | `AIHUMMER_AGENT_SESSION_IDLE_RESET_MINUTES` | Գործակալ՝ լռությունից հետո զրույցը սկսել նորից (րոպե) | `int 0…525600` | `360` | անմիջապես | «Լռությունից հետո» և «ամեն օր և լռությունից հետո» ռեժիմների համար՝ եթե մարդը գրում է սրանից երկար լռությունից հետո, գործակալը զրույցը սկսում է նորից։ Գործում է այն գործակալների համար, որոնց քարտում սեփական արժեք նշված չէ։ 0՝ ոչ լռությամբ։ 0–525600; 360 = 6 ժամ, 1440 = մեկ օր։ | | `AIHUMMER_AGENT_SESSION_INDEX_MAX_ENTRIES` | Գործակալ: Ցանկում պահել առավելագույնը այսքան աշխատաշրջան | `int 0…100000` | `0` | անմիջապես | Առաջինը դուրս են գալիս ամենալուռները. ոչինչ չի ջնջվում։ 0՝ առանց սահմանի։ 0–100000։ Գործում է այն գործակալների համար, որոնց քարտում սեփական արժեք չկա։ | | `AIHUMMER_AGENT_SESSION_INDEX_PRUNE_DAYS` | Գործակալ: Հեռացնել աշխատաշրջանների ցանկից այսքան լուռ օրերից հետո | `int 0…3650` | `0` | անմիջապես | Ոչինչ չի ջնջվում. զրույցը դուրս է գալիս ցանկից և վերադառնում նոր հաղորդագրությամբ։ 0՝ պահել։ 0–3650։ Գործում է այն գործակալների համար, որոնց քարտում սեփական արժեք չկա։ | | `AIHUMMER_AGENT_SESSION_RESET_AT_HOUR` | Գործակալ՝ ամենօրյա նորից սկսելու ժամը | `int 0…23` | `4` | անմիջապես | «Ամեն օր» ռեժիմների համար․ այս ժամից առաջ սկսված զրույցը մարդու հաջորդ հաղորդագրությամբ սկսվում է նորից։ Ժամը սերվերի ժամային գոտով է («Համակարգ և կարգավորումներ» բաժնի «Ժամային գոտի» կարգավորումը)։ 0–23․ 4-ը գիշերն է, երբ գրեթե ոչ ոք չի գրում։ | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_IDLE_MINUTES` | Գործակալ՝ լռությունից հետո խմբային զրույցը սկսել նորից (րոպե) | `int 0…525600` | `0` | անմիջապես | «Լռությունից հետո» և «ամեն օր և լռությունից հետո» ռեժիմներում խմբային զրույցների համար՝ լռության րոպեները, որոնցից հետո խմբային զրույցը սկսվում է նորից։ 0՝ ինչպես անձնական զրույցներում։ 0–525600։ | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_MODE` | Գործակալ՝ երբ է խմբային զրույցը սկսվում նորից | `enum: inherit \\\| daily \\\| idle \\\| both \\\| none` | `inherit` | անմիջապես | Առանձին կանոն խմբային զրույցների համար (Telegram խմբեր, VK զրույցներ, MAX չաթեր և այլն)՝ ինչպես անձնականներում, ամեն օր վերակայման ժամին, լռությունից հետո, որն առաջինը վրա հասնի, կամ երբեք։ Վերակայման ժամը ընդհանուր է։ Գործում է այն գործակալների համար, որոնց քարտում սեփական կանոն չկա։ | | `AIHUMMER_AGENT_SESSION_RESET_MODE` | Գործակալ՝ երբ է զրույցը սկսվում նորից | `enum: idle \\\| daily \\\| both \\\| none` | `idle` | անմիջապես | Երբ է գործակալը զրույցը նորից սկսում՝ ամեն օր վերակայման ժամին (կարգավորումների ժամային գոտով), լռությունից հետո, որն ավելի շուտ, կամ երբեք։ Նորից սկսելիս գործակալն իր հիշողության մեջ գրում է նշում նախորդ զրույցի մասին, իսկ նրա առաջին քայլը ստանում է նախորդ ամփոփումը և վերջին հաղորդագրությունները. հաղորդագրություններն իրենք մնում են արխիվում և որոնման մեջ։ Գործում է այն գործակալների համար, որոնց քարտում սեփական կանոն չկա. այնտեղ ընդհանուր զրուցարանների համար կարելի է առանձին կանոն սահմանել։ | | `AIHUMMER_AGENT_SESSION_SCOPE` | Գործակալ: Ուր են գնում անձնական զրույցները | `enum: chat \\\| per-channel-peer \\\| per-peer` | `chat` | անմիջապես | «Մեկը մարդու համար» միավորում է նույն մարդու Telegram-ը, հավելվածը և այլ անձնական զրուցարանները մեկ զրույցում։ Խմբային զրուցարանները միշտ պահում են իրենցը։ Գործում է հաջորդ հաղորդագրությունից։ Գործում է այն գործակալների համար, որոնց քարտում սեփական արժեք չկա։ | | `AIHUMMER_AGENT_SILENT_REPLY` | Գործակալ․ կարող է լռել | `enum: groups \\\| all \\\| off` | `groups` | անմիջապես | Ընդհանուր զրուցարաններում գործակալը կարող է լռել, եթե հաղորդագրությունն իրեն ուղղված չէ կամ ավելացնելու բան չունի․ անձնական նամակագրության մեջ միշտ պատասխանում է։ Կարող եք լռությունը թույլատրել նաև անձնական նամակագրության մեջ կամ անջատել այն։ Լուռ քայլը ոչինչ չի ուղարկում, զրույցի քարտում նշվում է «գործակալը լռեց», և մոդելը այն չի տեսնում պատմության մեջ։ Գործում է հաջորդ քայլից։ | | `AIHUMMER_AGENT_SKILLS_PROMPT_MAX_CHARS` | Գործակալ՝ հուշման մեջ հմտությունների ցանկի առավելագույն նիշեր | `int 1000…200000` | `18000` | անմիջապես | Յուրաքանչյուր քայլում մոդելը տեսնում է ոչ թե հմտությունների տեքստերը, այլ դրանց ցանկը՝ նույնացուցիչ, անուն և երբ կիրառել. հմտության հրահանգը գործակալն ինքն է բեռնում, երբ առաջադրանքը համապատասխանում է։ Եթե ցանկն ավելի երկար է, նախ հանվում են նկարագրությունները, հետո ցանկի վերջը՝ մնացածը գործակալը կգտնի հարցումով։ 1000–200000։ | | `AIHUMMER_AGENT_STALE_GAP_HOURS` | Գործակալ՝ դադար, որից հետո նախորդ զրույցը պատմություն է (ժամ) | `int 0…8760` | `12` | անմիջապես | Եթե մարդը գրում է սրանից երկար դադարից հետո, գործակալը ստանում է նշում՝ նախկինում քննարկված ամեն ինչ պատմություն է․ այն առանց խնդրանքի չի վերապատմվում, և հին առաջադրանքները չեն շարունակվում։ Յուրաքանչյուր հաղորդագրություն արդեն կրում է իր ժամանակը և նախորդից անցած ժամանակը։ 0 = չնշել։ 0–8760։ | | `AIHUMMER_AGENT_TOOL_HISTORY_TURNS` | Գործակալ՝ գործիքների արդյունքները պահող հերթեր | `int 0…100` | `5` | անմիջապես | Քանի՞ վերջին հերթում է մոդելը տեսնում գործիքների կանչերը և դրանց արդյունքները ամբողջությամբ (արդյունքը պահվում է մինչև 16 ԿԲ)։ Ավելի հին հերթերում մնում են կանչը և արդյունքի սկիզբը։ Այսպես գործակալը հիշում է, թե ինչ է գտել և արել՝ գործիքները կրկին կանչելու փոխարեն։ 0 = արդյունքները չփոխանցել հաջորդ հերթերին։ 0–100; գործակալը կարող է սահմանել իր արժեքը։ | | `AIHUMMER_APPROVAL_TOOLS` | Հաստատում պահանջող գործիքներ | `multiselect` | — | անմիջապես | Ստորակետերով բաժանված գործիքների ցանկը, որոնց կանչը կատարումից առաջ պահանջում է օպերատորի ձեռքով հաստատում։ Դատարկ = հաստատում չի պահանջվում։ Գործում է անմիջապես, վերագործարկում պետք չէ։ | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | Ենթաագենտի առավելագույն խորություն | `int 0…10` | `2` | անմիջապես | Ենթագործակալների ներդրման առավելագույն խորությունը (գործակալ, որը գործարկում է գործակալ)։ Լռելյայն 2 — պաշտպանություն անվերջ ռեկուրսիայից։ | | `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | Ենթաագենտի ժամանակի սահման (վայրկյան) | `int 0…86400` | `180` | անմիջապես | Մեկ ենթագործակալի գործարկման առավելագույն ժամանակը՝ վայրկյաններով։ | | `AIHUMMER_TOOL_SEARCH` | Գործիքների ծույլ բեռնում | `bool` | `false` | անմիջապես | Գործիքների աշխատանքային միջուկը ցույց է տրվում մոդելին անմիջապես, իսկ մեծ կատալոգի մնացածը թաքցվում է որոնման գործիքի հետևում, որն անվանում է յուրաքանչյուր թաքցված գործիք։ Արդարացված է միայն մեծ կատալոգներում (տասնյակ պլագինների, MCP կամ OpenAPI գործիքներ). չափի շեմից ցածր բոլոր գործիքները ցույց են տրվում անմիջապես, քանի որ գործիք գտնելու համար մոդելին լրացուցիչ դիմումն ավելի թանկ է, քան սխեմաները։ Գործում է հաջորդ քայլից։ | | `AIHUMMER_TOOL_SEARCH_CORE` | Ծույլ բեռնում. մշտապես միացված գործիքներ | `multiselect` | `web_search,web_fetch,memory_search,memory_get,memory_store,search_history,search_knowledge,code_exec,process,filesystem_read,message,schedule_list,schedule_create,schedule_delete,generate_pairing_code` | անմիջապես | Գործիքներ, որոնք ծույլ ռեժիմում միշտ ցույց են տրվում անմիջապես։ Լռելյայն՝ աշխատանքային միջուկը. որոնում համացանցում, էջերի բեռնում, հիշողություն, զրույցի պատմություն, գիտելիքների բազա, կոդ, ֆայլեր, հաղորդագրություններ, ժամանակացույցեր և հավելվածի կապակցում։ Հիշողության և գիտելիքների բազայի որոնումը (memory_search, memory_get, search_knowledge) միշտ ցույց է տրվում՝ անկախ այս ցանկից։ Դատարկ ցանկը վերականգնում է այս միջուկը։ | | `AIHUMMER_TOOL_SEARCH_MIN_POOL_TOKENS` | Գործիքների ծույլ բեռնում՝ թաքցված գործիքների նվազագույն ծավալ (տոկեններ) | `int 0…1000000` | `4000` | անմիջապես | Թաքցնել գործիքները միայն այն դեպքում, երբ միջուկից դուրս սխեմաները միասին կշռում են առնվազն այսքան տոկեն (յուրաքանչյուրը մոտ 4 նիշ)։ Դրանից ցածր բոլոր գործիքները ցույց են տրվում անմիջապես. գործիք գտնելու համար մոդելին լրացուցիչ դիմումն ավելի թանկ է, քան սխեմաները ցույց տալը։ | | `AIHUMMER_TOOL_SEARCH_THRESHOLD` | Ծույլ բեռնում. հետաձգելու համար գործիքների նվազագույն քանակ | `int 0…1000` | `12` | անմիջապես | Հետաձգել միայն այն դեպքում, երբ գործակալի պրոֆիլի զտիչից հետո մնում է այս թվից ավելի գործիք։ | ## Agent · Reasoning | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_BEST_OF_N` | Լավագույնը N-ից՝ տարբերակների քանակ | `int 0…8` | `0` | անմիջապես | Գործակալը պատրաստում է այդքան պատասխանի տարբերակ և թողնում լավագույնը։ 0 կամ 1՝ անջատված, 2-ից՝ միացված։ Յուրաքանչյուր տարբերակ արժե առանձին պատասխանի չափ։ | | `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | Բանավեճ. դատավորի հուշում (վերասահմանում) | `text` | — | անմիջապես | Վերասահմանում է բանավեճի դատավորի պրոմպտը (դատարկ = ներկառուցված)։ | | `AIHUMMER_AGENT_DEBATE_N` | Բանավեճ՝ պատասխանի տարբերակների քանակ | `int 0…8` | `0` | անմիջապես | Գործակալը պատրաստում է այդքան պատասխանի տարբերակ, համեմատում դրանք և տալիս լավագույնը։ 0 կամ 1՝ անջատված, 2-ից՝ միացված։ Յուրաքանչյուր տարբերակ արժե առանձին պատասխանի չափ։ | | `AIHUMMER_AGENT_DEBATE_PROMPT` | Բանավեճ. թեկնածուի հուշում (վերասահմանում) | `text` | — | անմիջապես | Վերասահմանում է բանավեճի թեկնածուի պրոմպտը (դատարկ = ներկառուցված)։ | | `AIHUMMER_AGENT_DEBATE_ROUNDS` | Բանավեճ. փուլեր | `int 1…10` | `1` | անմիջապես | Թեկնածուների վահանակի բանավեճի փուլերի քանակը։ | | `AIHUMMER_AGENT_JUDGE_PROMPT` | Best-of-N դատավորի հուշում (վերասահմանում) | `text` | — | անմիջապես | Վերասահմանում է best-of-N դատավորի պրոմպտը (դատարկ = ներկառուցված)։ | | `AIHUMMER_AGENT_PLAN_PROMPT` | Պլանավորողի հուշում (վերասահմանում) | `text` | — | անմիջապես | Վերասահմանում է պլանավորողի պրոմպտը (դատարկ = ներկառուցված)։ | | `AIHUMMER_AGENT_PLAN_STEPS` | Պլանավորող-կատարող. պլանի առավելագույն քայլեր (0=անջատ) | `int 0…32` | `0` | անմիջապես | ⟩0 գործարկում է առանձին պլանավորող→կատարող→սինթեզ անցում (օգտակար է բարդ բազմաքայլ առաջադրանքների համար)։ 0 = անջատված։ Սովորաբար 4–8։ | | `AIHUMMER_AGENT_PLAN_STEP_ITERS` | Պլանավորող. գործիքների կրկնություններ մեկ քայլի համար (0=կանխադրված) | `int 0…64` | `0` | անմիջապես | Սահմանափակում է գործիքների կանչի կրկնությունների թիվը պլանի յուրաքանչյուր քայլում։ 0 = ներկառուցված լռելյայն արժեքը (4)։ | | `AIHUMMER_AGENT_REFLECT` | Ինքնաքննադատության անցում | `bool` | `0` | անմիջապես | Ավելացնում է ռեֆլեքսիայի/ինքնաքննադատության անցում վերջնական պատասխանից առաջ։ | | `AIHUMMER_AGENT_REFLECT_PROMPT` | Ռեֆլեքսիայի հուշում (վերասահմանում) | `text` | — | անմիջապես | Վերասահմանում է ինքնաքննադատության պրոմպտը (դատարկ = ներկառուցված)։ | | `AIHUMMER_AGENT_SELF_HEAL` | Ինքնավերականգնում. գործիքի սխալի կրկնություններ (0=անջատ) | `int 0…10` | `0` | անմիջապես | ⟩0 կրկնում է գործիքների ձախողված կանչերն ուղղող հուշումով՝ մինչև այս սահմանը։ | ## Agent · System prompt | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LOCALE` | Կանխադրված լոկալ | `enum: ru-RU \\\| en-US \\\| az-AZ \\\| hy-AM \\\| be-BY \\\| kk-KZ \\\| ky-KG \\\| tg-TJ \\\| tk-TM \\\| uz-UZ \\\| ka-GE \\\| ro-RO \\\| es-ES \\\| zh-CN \\\| fr-FR \\\| de-DE \\\| hi-IN \\\| pl-PL \\\| lt-LT \\\| lv-LV \\\| et-EE \\\| fi-FI \\\| sv-SE \\\| no-NO \\\| da-DK \\\| tr-TR \\\| mn-MN` | `ru-RU` | անմիջապես | Պատասխանի լռելյայն լեզուն/լոկալը, օր. ru-RU։ Անձի/օպերատորի հրահանգները գերակա են։ | | `AIHUMMER_TIMEZONE` | Ժամային գոտի | `text` | `UTC` | անմիջապես | IANA ժամային գոտի գործակալի ընթացիկ ամսաթվի և սեփական գոտի չունեցող ժամանակացույցերի համար, օր. Europe/Moscow։ Լռելյայն UTC։ | ## Channels | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_FAILURE_NOTICE` | Տեղեկացնել զրուցակցին պատասխանի ձախողման մասին | `enum: always \\\| once \\\| off` | `always` | անմիջապես | Ինչ է ստանում ալիքի (Telegram և այլն) զրուցակիցը, երբ գործակալը չի կարողացել պատասխանել. «Ամեն անգամ»՝ կարճ հաղորդագրություն իր լեզվով. «Ոչ ավելի հաճախ, քան 4 ժամը մեկ»՝ մեկ հաղորդագրություն զրույցի համար 4 ժամում. «Չհայտնել»՝ ոչինչ։ Հաղորդագրությունում սխալների կոդեր ու մատակարարների անուններ չկան. մանրամասները տեսնում եք «Սեանսներ»-ում և ծանուցումներում։ | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BLOCKED` | Ձախողման հաղորդագրություն՝ օրինակը կասեցված է | `text` | — | անմիջապես | Թողեք դատարկ՝ զրուցակցի լեզվով ներկառուցված հաղորդագրությունն ուղարկելու համար։ Ձեր տեքստն ուղարկվում է այնպես, ինչպես գրված է, այն լեզվով, որով գրել եք. {ref}-ը տեղադրում է պատասխանի կոդը, որով քայլը գտնում եք «Սեսիաներում»։ Կիրառվում է անմիջապես։ | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUDGET` | Ձախողման հաղորդագրություն՝ տիրոջ բյուջեն սպառված է | `text` | — | անմիջապես | Թողեք դատարկ՝ զրուցակցի լեզվով ներկառուցված հաղորդագրությունն ուղարկելու համար։ Ձեր տեքստն ուղարկվում է այնպես, ինչպես գրված է, այն լեզվով, որով գրել եք. {ref}-ը տեղադրում է պատասխանի կոդը, որով քայլը գտնում եք «Սեսիաներում»։ Կիրառվում է անմիջապես։ | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUSY` | Ձախողման հաղորդագրություն՝ դարպասը գերբեռնված է | `text` | — | անմիջապես | Թողեք դատարկ՝ զրուցակցի լեզվով ներկառուցված հաղորդագրությունն ուղարկելու համար։ Ձեր տեքստն ուղարկվում է այնպես, ինչպես գրված է, այն լեզվով, որով գրել եք. {ref}-ը տեղադրում է պատասխանի կոդը, որով քայլը գտնում եք «Սեսիաներում»։ Կիրառվում է անմիջապես։ | | `AIHUMMER_CHANNEL_FAILURE_TEXT_CONFIG` | Ձախողման հաղորդագրություն՝ մոդելի միացումը պահանջում է տիրոջը | `text` | — | անմիջապես | Թողեք դատարկ՝ զրուցակցի լեզվով ներկառուցված հաղորդագրությունն ուղարկելու համար։ Ձեր տեքստն ուղարկվում է այնպես, ինչպես գրված է, այն լեզվով, որով գրել եք. {ref}-ը տեղադրում է պատասխանի կոդը, որով քայլը գտնում եք «Սեսիաներում»։ Կիրառվում է անմիջապես։ | | `AIHUMMER_CHANNEL_FAILURE_TEXT_FAILED` | Ձախողման հաղորդագրություն՝ այլ ձախողում | `text` | — | անմիջապես | Թողեք դատարկ՝ զրուցակցի լեզվով ներկառուցված հաղորդագրությունն ուղարկելու համար։ Ձեր տեքստն ուղարկվում է այնպես, ինչպես գրված է, այն լեզվով, որով գրել եք. {ref}-ը տեղադրում է պատասխանի կոդը, որով քայլը գտնում եք «Սեսիաներում»։ Կիրառվում է անմիջապես։ | | `AIHUMMER_CHANNEL_FAILURE_TEXT_QUOTA` | Ձախողման հաղորդագրություն՝ մոդելի օգտագործման սահմանաչափը սպառված է | `text` | — | անմիջապես | Թողեք դատարկ՝ զրուցակցի լեզվով ներկառուցված հաղորդագրությունն ուղարկելու համար։ Ձեր տեքստն ուղարկվում է այնպես, ինչպես գրված է, այն լեզվով, որով գրել եք. {ref}-ը տեղադրում է պատասխանի կոդը, որով քայլը գտնում եք «Սեսիաներում»։ Կիրառվում է անմիջապես։ | | `AIHUMMER_CHANNEL_FAILURE_TEXT_STEP_LIMIT` | Ձախողման հաղորդագրություն՝ առաջադրանքը չտեղավորվեց մեկ պատասխանում | `text` | — | անմիջապես | Թողեք դատարկ՝ զրուցակցի լեզվով ներկառուցված հաղորդագրությունն ուղարկելու համար։ Ձեր տեքստն ուղարկվում է այնպես, ինչպես գրված է, այն լեզվով, որով գրել եք. {ref}-ը տեղադրում է պատասխանի կոդը, որով քայլը գտնում եք «Սեսիաներում»։ Կիրառվում է անմիջապես։ | | `AIHUMMER_CHANNEL_FAILURE_TEXT_TOO_LONG` | Ձախողման հաղորդագրություն՝ զրույցը չափազանց երկար է մոդելի համար | `text` | — | անմիջապես | Թողեք դատարկ՝ զրուցակցի լեզվով ներկառուցված հաղորդագրությունն ուղարկելու համար։ Ձեր տեքստն ուղարկվում է այնպես, ինչպես գրված է, այն լեզվով, որով գրել եք. {ref}-ը տեղադրում է պատասխանի կոդը, որով քայլը գտնում եք «Սեսիաներում»։ Կիրառվում է անմիջապես։ | | `AIHUMMER_CHANNEL_FAILURE_TEXT_UNAVAILABLE` | Ձախողման հաղորդագրություն՝ մոդելը ժամանակավորապես անհասանելի է | `text` | — | անմիջապես | Թողեք դատարկ՝ զրուցակցի լեզվով ներկառուցված հաղորդագրությունն ուղարկելու համար։ Ձեր տեքստն ուղարկվում է այնպես, ինչպես գրված է, այն լեզվով, որով գրել եք. {ref}-ը տեղադրում է պատասխանի կոդը, որով քայլը գտնում եք «Սեսիաներում»։ Կիրառվում է անմիջապես։ | | `AIHUMMER_CONFIDENTIAL_PERSONA` | Գաղտնի վեբ-պերսոնա | `bool` | `0` | անմիջապես | Միացված վիճակում վեբ-զրույցի գործակալը չի բացահայտում և չի պահում իր անձի/ինքնության տվյալները և պատասխանում է խստորեն ըստ առաջադրանքի — անանուն կամ գաղտնիության նկատմամբ զգայուն վեբ-տեղակայումների համար։ Գործում է անմիջապես, վերագործարկում պետք չէ։ | | `AIHUMMER_INBOUND_COALESCE_MS` | Հաղորդագրությունների միավորման պատուհան (մվ) | `int` | `500` | անմիջապես | Մի քանի հաղորդագրություն, որոնք մեկ մարդ իրար հետևից ուղարկում է նույն զրուցարան (կարճ հաղորդագրություններ, լուսանկարների ալբոմ, արագ ուղղում), ստանում են ՄԵԿ պատասխան, եթե նրանց միջև դադարը կարճ է այս պատուհանից։ Պատասխանի պատրաստման ընթացքում ստացված հաղորդագրություններին պատասխանում են անմիջապես դրանից հետո, երբեք զուգահեռ։ Լռելյայն 500 մվ; 0 = առանց սպասելու առանձին հաղորդագրությունների միջև․ լուսանկարների ալբոմը, այնուամենայնիվ, հավաքվում է (դադարներ մինչև 3 վ, առավելագույնը 20 վ), որպեսզի մեկ պատասխան ստանա։ Միավորումն աշխատում է Telegram-ում։ Slack-ը, WhatsApp-ը, VK-ն, էլ. փոստը և մյուս միակցիչները, որոնք սպասում են յուրաքանչյուր հաղորդագրության պատասխանին (և /v1/inbound/generic-ի միջոցով ինտեգրումները), պատասխան են ստանում յուրաքանչյուր հաղորդագրության համար՝ նախկինի պես մեկ առ մեկ և հերթականությամբ։ Կիրառվում է անմիջապես։ | | `AIHUMMER_INBOUND_EDIT_MODE` | Երբ մարդը խմբագրում է արդեն պատասխանված հաղորդագրությունը | `enum: correct \\\| history` | `correct` | անմիջապես | correct — բոտը կրկին պատասխանում է՝ իմանալով, որ սա ուղղում է («էր / է»). history — խմբագրումը միայն ուղղում է զրույցի պատմությունը, նոր պատասխան չկա (հարմար է տառասխալների համար)։ Այն հաղորդագրության խմբագրումը, որին բոտը դեռ չի պատասխանել, միշտ պարզապես փոխարինում է դրա տեքստը։ Աշխատում է այնտեղ, որտեղ ալիքը տեղեկացնում է խմբագրումների մասին (Telegram)։ Կիրառվում է անմիջապես։ | | `AIHUMMER_INBOUND_QUEUE_MODE` | Հաղորդագրություններ, որոնք գրվում են, երբ գործակալն աշխատում է | `enum: steer \\\| collect \\\| followup` | `steer` | անմիջապես | Ինչ է լինում հաղորդագրության հետ, որը նույն մարդը ուղարկում է, երբ գործակալը դեռ պատասխան է պատրաստում (որոնում է, գործարկում է գործիքներ)՝ steer (լռելյայն)՝ գործակալը տեսնում է այն հաջորդ քայլից առաջ և հաշվի է առնում նույն պատասխանում. collect՝ դրան պատասխանում է հաջորդ պատասխանը։ followup՝ յուրաքանչյուր նման հաղորդագրություն հերթով ստանում է իր առանձին պատասխանը։ Լուսանկարները, ֆայլերը, հաղորդագրության պատասխանները և վերահասցեավորումները միշտ սպասում են հաջորդ պատասխանին։ Կիրառվում է անմիջապես։ | | `AIHUMMER_INBOUND_REQUIRE_BINDING` | Պատասխանել միայն գրանցված օգտատերերին | `bool` | `true` | անմիջապես | true = բոտն անտեսում է ալիքի ցանկացած ուղարկողի, որը AiHummer-ի գրանցված օգտատեր ՉԷ (դերի կապում ունեցող օգտատեր) — զրույցի պատահական մասնակիցները և հյուրերի կանչերը պատասխան չեն ստանում։ false (լռելյայն) = պատասխանել բոլորին։ | ## Integrations | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_A2A_PUBLISH` | Հրապարակել ագենտը Agent2Agent-ի (A2A) միջոցով | `bool` | `0` | վերագործարկումից հետո | Հրապարակել գործակալը որպես A2A սերվեր (Agent Card + POST /a2a/message)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_MCP_EXPORT_TOOLS` | Արտաքին օգնականների համար բաց գործիքներ | `multiselect` | — | վերագործարկումից հետո | Արտաքին MCP հաճախորդների համար թույլատրված գործիքների անունների հստակ ցուցակ՝ բաժանված ստորակետերով: Դատարկ = ոչ մի գործիք մի հրապարակեք: Հոսթի մակարդակի վտանգավոր դասերը լրացուցիչ արգելված են ներկառուցված քաղաքականության կողմից, նույնիսկ եթե նշված են: Կիրառվում է սկզբում/վերագործարկումից հետո: | | `AIHUMMER_MCP_PUBLISH` | Հրապարակել գործիքները MCP-ի միջոցով | `bool` | `0` | վերագործարկումից հետո | Թույլ է տալիս արտաքին օգնականներին (օրինակ՝ Claude Desktop) օգտվել ձեր գործակալների գործիքներից։ Որ գործիքները բացել՝ ընտրվում է հարևան կարգավորումում. քանի դեռ ցանկը դատարկ է, ոչ մեկը չի բացվում։ | | `AIHUMMER_MODULE_CPU_QUOTA` | Պլագինի պրոցեսորի սահման (յուրաքանչյուրի համար) | `text` | `75%` | անմիջապես | Պրոցեսորի որ մասը կարող է զբաղեցնել յուրաքանչյուր պլագին (systemd CPUQuota)՝ 75%-ը մեկ միջուկի երեք քառորդն է, 150%-ը՝ մեկուկես միջուկ։ Նոր արժեքը պլագինը կստանա հաջորդ տեղադրման, թարմացման կամ իր կարգավորումները պահելու ժամանակ․ մինչ այդ աշխատող պլագինները մնում են նախկին սահմանով։ | | `AIHUMMER_MODULE_MEMORY_MAX` | Պլագինի հիշողության սահման (յուրաքանչյուրի համար) | `text` | `512M` | անմիջապես | Որքան հիշողություն կարող է զբաղեցնել յուրաքանչյուր պլագին (systemd MemoryMax)՝ չափ, օրինակ՝ 512M, 1G կամ 2048M (առնվազն 64M), կամ infinity՝ առանց սահմանի։ Սահմանը գերազանցած պլագինը համակարգը կկանգնեցնի։ Նոր արժեքը պլագինը կստանա հաջորդ տեղադրման, թարմացման կամ իր կարգավորումները պահելու ժամանակ․ մինչ այդ աշխատող պլագինները մնում են նախկին սահմանով։ | ## Knowledge connectors | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_KB_SYNC_INTERVAL` | Որքան հաճախ թարմացնել գիտելիքների բազան աղբյուրներից | `text` | — | անմիջապես | Որքան հաճախ է սերվերն ինքը վերցնում փոփոխությունները գիտելիքների բազայի միացված աղբյուրներից։ Օրինակ՝ 30m — ամեն 30 րոպեն մեկ, 6h — ամեն 6 ժամը մեկ։ Դատարկ կամ 0՝ միայն ձեռքով։ Կրկնակի բեռնումը կրկնօրինակներ չի ստեղծում։ Slack-ի արտահանումը վերբեռնում են ձեռքով։ | ## LLM | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AUX_FALLBACK_MODELS` | Սպասարկման առաջադրանքներ՝ պահուստային մոդելներ | `list` | — | անմիջապես | Ստորակետով բաժանված մոդելներ, որոնք հերթով փորձվում են, եթե սպասարկման մոդելը ձախողվել է (քվոտա, խափանում)։ Վերջում միշտ փորձվում է հիմնական մոդելը, որպեսզի ամփոփումը չկորչի։ Յուրաքանչյուր փոխարկում գրանցվում է մատյանում։ Գործում է անմիջապես։ | | `AIHUMMER_AUX_MODEL` | Սպասարկման առաջադրանքների մոդել (ամփոփումներ, նշումներ, վերնագրեր) | `text` | — | անմիջապես | Ֆոնային սպասարկման առաջադրանքների մոդել՝ հին պատմության ամփոփում, հիշողության նշում սեղմումից առաջ, զրույցների վերնագրեր, փաստերի արդյունահանում, որոնման հարցումների վերաձևակերպում և թարգմանություն։ Դատարկ = ավտոմատ՝ նույն մատակարարի ավելի էժան մոդել (Claude → claude-haiku-4-5, Codex → gpt-…-luna/mini), իսկ եթե այդպիսին չկա՝ հիմնական մոդելը։ «main»՝ միշտ հիմնական մոդելը։ Գործում է անմիջապես։ | | `AIHUMMER_CASCADE_MIN_CHARS` | Կասկադ. էսկալացիայի համար նվազագույն նիշեր | `int` | `0` | անմիջապես | Հարցման երկարության շեմը (նիշեր), որից միանում է կասկադի ավելի հզոր մոդելը։ 0 = լռելյայն։ | | `AIHUMMER_CASCADE_STRONG_MODEL` | Կասկադ. ավելի հզոր պահեստային մոդել | `text` | — | անմիջապես | Մոդելը, որին կասկադով անցնում ենք երկար/բարդ հարցումների համար (դատարկ = անջատված)։ | | `AIHUMMER_CLAUDE_AUTH_URL` | Claude բաժանորդագրություն՝ մուտքի էջի հասցե | `text` | — | անմիջապես | Էջը, որտեղ թույլ եք տալիս միացնել Claude բաժանորդագրությունը։ Դատարկ՝ ստանդարտ հասցե. փոխեք միայն աջակցության խնդրանքով։ | | `AIHUMMER_CLAUDE_CLIENT_ID` | Claude բաժանորդագրություն՝ OAuth հաճախորդի ID | `text` | — | անմիջապես | Claude բաժանորդագրությամբ մուտքի հավելվածի նույնացուցիչ։ Դատարկ՝ ստանդարտ. փոխեք միայն աջակցության խնդրանքով։ | | `AIHUMMER_CLAUDE_EFFORT` | Claude՝ մտածողության խորություն | `enum: low \\\| medium \\\| high \\\| xhigh \\\| max` | `medium` | անմիջապես | Որքան խորն են Claude մոդելները մտածում պատասխանելուց առաջ, երբ գործակալը դա չի սահմանում։ Ավելի բարձրը ավելի ճշգրիտ է բարդ առաջադրանքներում, բայց ավելի դանդաղ է և ավելի շատ քվոտա է ծախսում, ավելի ցածրը՝ ավելի արագ և էժան։ Ընտրված մակարդակը չճանաչող մոդելը ստանում է ամենամոտ ցածր մակարդակը, Haiku 4.5-ը և ավելի հին մոդելները մտածողություն չեն աջակցում։ Գործակալի մոտ սահմանված խորությունը գերակա է։ Գործում է հաջորդ քայլից։ | | `AIHUMMER_CLAUDE_MAX_TOKENS` | Claude՝ պատասխանի առավելագույն երկարություն (թոքեն) | `int` | `16000` | անմիջապես | Քանի թոքեն կարող է զբաղեցնել Claude-ի մեկ պատասխանը՝ և՛ բաժանորդագրությամբ, և՛ բանալիով։ Մոդելի մտորումները մտնում են նույն սահմանաչափի մեջ. չափազանց փոքր արժեքը կտրում է պատասխանը կիսատ կամ տալիս է դատարկ պատասխան։ Եթե գործակալն ունի իր պատասխանի երկարությունը, գործում է այն։ | | `AIHUMMER_CLAUDE_REDIRECT_URI` | Claude բաժանորդագրություն՝ վերահղման URI | `text` | — | անմիջապես | Մատակարարի մոտ գրանցված վերադարձի հասցեն: Պետք է համապատասխանի այն, ինչ կազմաձևված է իր կողմում, հակառակ դեպքում կոդերի փոխանակումը մերժվում է: | | `AIHUMMER_CLAUDE_TOKEN_URL` | Claude բաժանորդագրություն՝ մուտքի ստացման հասցե | `text` | — | անմիջապես | Հասցեն, որով սերվերը ստանում և երկարաձգում է Claude բաժանորդագրության մուտքը։ Դատարկ՝ ստանդարտ հասցե. փոխեք միայն աջակցության խնդրանքով։ | | `AIHUMMER_CODEX_BASE_URL` | Codex բազային URL | `text` | — | մասամբ վերագործարկումից հետո | Codex (ChatGPT-ի բաժանորդագրություն) տրանսպորտի բազան։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_CODEX_MAX_OUTPUT_TOKENS` | Առավելագույն ելքային թոքեններ (0 = առանց սահմանի) | `int` | `0` | անմիջապես | max_output_tokens սահմանաչափը զրույցի մեկ քայլի համար։ 0 = առանց սահմանի։ Reasoning մոդելներում դատողության թոքենները նույնպես հաշվվում են այս բյուջեում, ուստի չափազանց փոքր արժեքը տալիս է դատարկ «incomplete: max_output_tokens» պատասխան։ Կիրառվում է անմիջապես (առանց վերագործարկման)։ | | `AIHUMMER_CODEX_MODEL` | Մոդելի id (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` | — | անմիջապես | /images API-ի բազան OpenAI-ի բանալիով աշխատելիս (դատարկ = https://api.openai.com/v1)։ | | `AIHUMMER_IMAGE_MODEL` | Պատկեր-գեներացման մոդել | `text` | — | անմիջապես | Մոդել image_generate-ի համար (լռելյայն gpt-image-2)։ | | `AIHUMMER_MEDIA_MAX_UPLOAD_MB` | Մեդիայի բեռնման առավելագույն չափ (MB) | `int` | `256` | անմիջապես | Մեկ անգամից վերբեռնվող ամենամեծ ֆայլը (լուսանկար, ձայնային հաղորդագրություն, տեսանյութ)՝ մեգաբայթով։ Պաշտպանում է սերվերի սկավառակը լցվելուց։ Լռելյայն 256։ Գործում է անմիջապես։ | | `AIHUMMER_SIDECAR_STT` | Խոսքի ճանաչում այս սերվերում (faster-whisper) | `bool` | `0` | անմիջապես | Տեղական խոսքի ճանաչում (faster-whisper): Փաթեթում ներառված չէ. միացնել ներբեռնում է ստորագրված հավելումը (~620 ՄԲ Python-ի բոլոր տարբերակների համար) և տեղադրում է ծառայությունը հոսթում: 🔴 Հավելումը հրապարակվում է առանձին վաճառողի որոշմամբ (դրա փաթեթները կրում են ffmpeg GPL-ի ներքո); եթե այն չհրապարակվի ձեր թողարկման համար, ներառյալ այն ազնիվ կլինի և ոչինչ չի կոտրի: Ամպային պլան. ճանաչումը կազմաձևված է մատակարարի կողմից: | | `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` | անմիջապես | Արդյոք հիշողության մեջ գտնվածն ավտոմատ ավելացնել պատասխանին։ «Միայն ճշգրիտ համընկնումներ»՝ փաստը պետք է համընկնի հաղորդագրության հետ առնվազն երկու կարևոր բառով. ողջույնները և «ok»-ը հիշողություն չեն բերում։ «Ամեն նման բան»՝ այն ամենը, ինչ գոնե մի կերպ համընկավ, և կապված գրառումները. ավելի շատ ավելորդ։ «Չավելացնել»՝ գործակալն ինքն է որոնում հիշողության մեջ, երբ անհրաժեշտ համարի։ | | `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` | անմիջապես | Միայն հիշողության իմաստային որոնման համար (embedder)՝ որքան մոտ պետք է լինի փաստը հաղորդագրությանն իմաստով, որպեսզի ավտոմատ ավելացվի, նմանության տոկոսով։ Լռելյայն 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 վերադասավորման sidecar-ի 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` | — | վերագործարկումից հետո | Հոսթերների ցանկ՝ բաժանված ստորակետերով, որոնք թույլատրվում է ստուգել Ռուսաստանի թվային զարգացման նախարարության-ի արմատներով ՕՎԵՐ ռուսական տիրույթներում (.ru/.su/.рф - արդեն ներառված է): Անհրաժեշտ է, եթե ձեր հանգույցը Ռուսաստանի թվային զարգացման նախարարության վկայականով ապրում է այլ տիրույթում: Համընկնել ըստ անվանման կամ ենթադոմեյնի սահմանի. example.com-ը ծածկում է api.example.com-ը: Դատարկ = միայն ռուսական տիրույթներ: Կիրառվում է սկզբում/վերագործարկումից հետո: | ## Performance | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_TURN_QUEUE_WAIT_SEC` | Սպասում հերթում. ալիքի հաղորդագրություն (վայրկյան) | `int 10…1200` | `600` | անմիջապես | Որքան է ալիքի հաղորդագրությունը (Telegram և այլն) սպասում ազատ տեղի, երբ քայլերի բոլոր տեղերը զբաղված են։ Եթե ժամանակին տեղ չստանա, մարդուն տեղեկացնում են, որ սերվերը զբաղված է, և կարելի է նորից գրել։ Սպասումը մտնում է քայլի 30 րոպեանոց սահմանի մեջ։ 10–1200։ Գործում է անմիջապես։ | | `AIHUMMER_MAX_ACTIVE_TURNS` | Միաժամանակ ընթացող գործակալների քայլեր (ամբողջ սերվերը) | `int 1…512` | `32` | անմիջապես | Քանի գործակալի քայլ (պատասխաններ ալիքներում և վեբ-չաթում, ժամանակացույցեր) է սերվերը կատարում միաժամանակ։ Մնացածը հերթում սպասում են այնքան, որքան թույլ են տալիս ստորև «Սպասում հերթում» կարգավորումները, և մարդը տեսնում է «սերվերը զբաղված է, հերթում»։ Ավելի մեծ արժեքը նվազեցնում է սպասումը, բայց ավելացնում է հիշողությունը, տվյալների բազայի կապերը և մոդելին միաժամանակյա հարցումները։ Այս թվի կեսը սահմանափակում է մոդելի միաժամանակյա օժանդակ կանչերը (հիշողության արդյունահանում, ամփոփումներ)։ 1–512։ Գործում է անմիջապես։ | | `AIHUMMER_SYNC_INBOUND_QUEUE_WAIT_SEC` | Սպասում հերթում. ինտեգրման համաժամանակյա կանչ (վայրկյան) | `int 1…120` | `10` | անմիջապես | Որքան է նույն հարցման մեջ պատասխանի սպասող ինտեգրման կանչը սպասում ազատ տեղի, երբ քայլերի բոլոր տեղերը զբաղված են։ Եթե տեղ չստանա, ինտեգրումը ստանում է «սերվերը զբաղված է»՝ նույն քանակի վայրկյանից հետո կրկնելու խորհրդով. նույն հաղորդագրության համարով կրկնությունը այն երկրորդ անգամ չի գրանցում։ 1–120։ Գործում է անմիջապես։ | | `AIHUMMER_WEB_TURN_QUEUE_WAIT_SEC` | Սպասում հերթում. վեբ-չաթի հաղորդագրություն (վայրկյան) | `int 10…1200` | `180` | անմիջապես | Որքան է վեբ-չաթի հաղորդագրությունը սպասում ազատ տեղի, երբ քայլերի բոլոր տեղերը զբաղված են։ Այդ ընթացքում չաթում երևում է «սերվերը զբաղված է, հերթում»; եթե ժամանակին տեղ չստանա, պատասխանը մերժվում է «Կրկնել» կոճակով, որը պատմության մեջ մնում է նաև էջը վերաբեռնելուց հետո։ 10–1200։ Գործում է անմիջապես։ | ## Public access | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PUBLIC_URL` | Սերվերի հանրային հասցե | `text` | — | մասամբ վերագործարկումից հետո | Հասցե, որով վահանակը և հավելվածները բացվում են ինտերնետից, օրինակ https://ai.example.com։ Ուղղեք այն ձեր պրոքսիի (nginx, Caddy) միջոցով սերվերի պորտին՝ լռելյայն 8780։ | | `AIHUMMER_WIDGET_ALLOWED_ORIGINS` | Վեբ վիջեթ․ կայքերի թույլատրված origin-ներ | `list` | — | անմիջապես | Վեբ-չատի վիջեթը ներկառուցելու թույլտվություն ունեցող browser origin-ների ստորակետերով բաժանված ցանկ, օրինակ՝ https://example.com,https://www.example.com։ Սխեման և պորտը պետք է ճշգրիտ համընկնեն։ Դատարկ = ոչ մի արտաքին կայք չի կարող օգտագործել վիջեթը։ `*` գրառումը միտումնավոր անտեսվում է, քանի որ հակառակ դեպքում ինտերնետի ցանկացած էջ կարող էր ծախսել այս ինստանսի բյուջեն։ | | `POCKET_AGENT_GATEWAY_BASE_URL` | Pocket-agent դարպասի հանրային URL | `text` | — | անմիջապես | Պրոքսիավորեք → pocket-agent-ի դարպասի պորտին (POCKET_AGENT_PORT, լռելյայն 8080)։ Հեռավոր գործակալը միանում է այստեղ մեկանգամյա տոմսով։ | | `TELEGRAM_PUBLIC_URL` | Telegram վեբհուկի հանրային URL | `text` | — | անմիջապես | Միայն webhook ռեժիմի համար — պրոքսիավորեք → telegram-connector-ի պորտին (լռելյայն 8091)։ Թողեք դատարկ polling ռեժիմի համար (հանրային URL պետք չէ)։ | ## SSO (LDAP/AD) | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LDAP_BASE_DN` | Օգտատերերի որոնման բազային DN | `text` | — | վերագործարկումից հետո | Որոնել արմատ, օրինակ. OU=Օգտագործողներ,DC=corp,DC=օրինակ. | | `AIHUMMER_LDAP_BIND_DN` | Ծառայության bind DN | `text` | — | վերագործարկումից հետո | Հաշիվ, որն օգտագործվում է սկզբնական որոնման bind-ի համար, օր. CN=svc-aihummer,OU=Service,DC=corp,DC=example։ Դատարկ = անանուն որոնում։ | | `AIHUMMER_LDAP_DEFAULT_ROLE` | LDAP: Կանխադրված դեր (խմբի համընկնում չկա) | `text` | — | վերագործարկումից հետո | Դեր, որը տրվում է, երբ ոչ մի խումբ չի համընկնում քարտեզագրման հետ։ Դատարկ = առանց դերի։ | | `AIHUMMER_LDAP_ENABLED` | Միացնել LDAP/AD մուտքը | `bool` | `0` | վերագործարկումից հետո | Միացված վիճակում ադմինիստրատորների մուտքերը հետ են գլորվում դեպի կատալոգ։ Bind-ի գաղտնաբառը պահվում է Secrets-ում (շրջանակ ldap, անուն bind_password)։ | | `AIHUMMER_LDAP_GROUP_ATTR` | Խմբի ատրիբուտ (կանխադրված memberOf) | `text` | — | վերագործարկումից հետո | Օգտատիրոջ գրառման ատրիբուտը, որը թվարկում է խմբերի DN-երը։ Դատարկն անջատում է խումբ→դեր քարտեզագրումը։ | | `AIHUMMER_LDAP_ROLE_MAPPINGS` | LDAP: Խումբ→դեր համապատասխանեցումներ (JSON) | `text` | — | վերագործարկումից հետո | JSON օբյեկտ՝ խմբի DN (կամ պարզ CN) → դեր, օր. {\\"CN=Admins,OU=Groups,DC=corp,DC=example\\":\\"admin\\",\\"Operators\\":\\"operator\\"}։ | | `AIHUMMER_LDAP_SKIP_TLS_VERIFY` | Բաց թողնել TLS ստուգումը (միայն լաբորատորիայի համար, 1/0) | `bool` | `0` | վերագործարկումից հետո | Անջատում է կատալոգի վկայագրի ստուգումը։ Երբեք մի միացրեք արդյունաբերական միջավայրում։ | | `AIHUMMER_LDAP_URL` | Կատալոգի URL | `text` | — | վերագործարկումից հետո | օր. ldaps://ad.corp.example:636 (TLS) կամ ldap://dc1.corp.example:389: | | `AIHUMMER_LDAP_USER_ATTR` | Մուտքի ատրիբուտ (կանխադրված sAMAccountName) | `text` | — | վերագործարկումից հետո | LDAP/Active Directory ատրիբուտը, որը համեմատվում է օգտատիրոջ մուտքագրած լոգինի հետ (լռելյայն sAMAccountName; uid՝ OpenLDAP-ի համար, userPrincipalName՝ UPN ոճի մուտքերի համար)։ | | `AIHUMMER_LDAP_USER_FILTER` | Օգտատերերի որոնման զտիչ | `text` | — | վերագործարկումից հետո | Պետք է պարունակի %s լոգինի համար։ AD: (sAMAccountName=%s); OpenLDAP: (uid=%s)։ | ## SSO (OIDC) | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OIDC_AUDIENCE` | 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` | Աշխատանքային տարածքի claim OIDC-ում | `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-ում (շրջանակ saml, անուն 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-ում (շրջանակ saml, անուն sp_key)։ | ## Schedules | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SCHEDULE_AGENT_MAX_ACTIVE` | Ագենտ՝ ակտիվ ժամանակացույցերի սահմանաչափ | `int` | `20` | անմիջապես | Որքան ակտիվ ժամանակացույց կարող է ունենալ մեկ ագենտը, երբ ինքն է ստեղծում կամ միացնում ժամանակացույց (իր ժամանակացույցի գործիքներով)։ Վահանակում ստեղծված ժամանակացույցերը հաշվվում են, բայց վահանակին երբեք չի մերժվում։ Սահմանին ագենտին առաջարկվում է նախ դադարեցնել կամ ջնջել մեկը։ Գործում է անմիջապես։ | | `AIHUMMER_SCHEDULE_AGENT_MAX_FIRES_PER_DAY` | Ագենտ՝ ժամանակացույցերի գործարկումներ օրական | `int` | `288` | անմիջապես | Քանի անգամ օրական (UTC) կարող են գործարկվել մեկ ագենտի բոլոր ժամանակացույցերը միասին՝ ներառյալ վահանակում ստեղծվածները և ձեռքով գործարկումները։ Սահմանից ավել գործարկումները բաց են թողնվում և երևում են գործարկումների մատյանում։ Գործում է անմիջապես։ | | `AIHUMMER_SCHEDULE_AGENT_MIN_INTERVAL_MINUTES` | Ագենտ՝ ժամանակացույցի նվազագույն միջակայք, րոպե | `int` | `5` | անմիջապես | Ագենտի կողմից ինքնուրույն ստեղծված կամ փոփոխված կրկնվող ժամանակացույցի երկու գործարկումների միջև ամենակարճ ընդմիջումը։ Ավելի հաճախակի ժամանակացույցը մերժվում է։ Վահանակում ստեղծված ժամանակացույցերը դրանով չեն սահմանափակվում։ Գործում է անմիջապես։ | | `AIHUMMER_SCHEDULE_COMMANDS` | Սերվերի հրամաններ ժամանակացույցերում | `bool` | `0` | անմիջապես | Թույլ է տալիս ժամանակացույցին այս սերվերում գործարկել ծրագիր՝ հավաքիչ, հաշվետվություն, պահուստային պատճենի ստուգում։ Լռելյայն անջատված է։ Գործարկվում են միայն «Թույլատրված հրամաններ» ցանկի հրամանները՝ ճիշտ այնպես, ինչպես գրված են. shell չկա։ Ելքը գնում է գործակալին կամ ուղիղ զրուցարան, և յուրաքանչյուր գործարկում երևում է ժամանակացույցի գործարկումների մատյանում։ Գործում է անմիջապես։ | | `AIHUMMER_SCHEDULE_COMMANDS_ALLOWLIST` | Թույլատրված հրամաններ | `argvlist` | — | անմիջապես | Ճշգրիտ հրամանները, որոնք ժամանակացույցը կարող է գործարկել՝ ծրագիրը (df-ի նման անուն կամ լրիվ ուղի) և դրա արգումենտները։ Ժամանակացույցը գործարկում է միայն այն հրամանը, որը արգումենտներով հանդերձ լրիվ համընկնում է գրառմանը։ Հեռացված հրամանը կանգնեցնում է այն օգտագործող ժամանակացույցերը, և դրանց գործարկումները նշում են պատճառը։ Գործում է անմիջապես։ | | `AIHUMMER_SCHEDULE_COMMANDS_MAX_OUTPUT_KB` | Ժամանակացույցի հրամանի ելքի սահմանաչափ, ԿԲ | `int 1…1024` | `64` | անմիջապես | Հրամանի ելքի որքան մասն է (1–1024 ԿԲ) պահվում գործարկումների մատյանում և փոխանցվում գործակալին կամ զրուցարան. մնացածը կտրվում է, և մատյանը դա նշում է։ Գործում է անմիջապես։ | | `AIHUMMER_SCHEDULE_COMMANDS_SANDBOX` | Գործարկել ժամանակացույցի հրամանները ՕՀ-ի ավազարկղում | `bool` | `1` | անմիջապես | Միացված է՝ հրամանն աշխատում է ՕՀ-ի ավազարկղում, ինչպես կոդի կատարումը. տեղադրման գաղտնիքներն ու SSH բանալիները թաքցված են, և այն կարող է գրել միայն իր ժամանակավոր թղթապանակում։ Եթե սերվերում ավազարկղ (bubblewrap) չկա, հրամանը չի գործարկվում, և մատյանը նշում է պատճառը։ Անջատված է՝ այն աշխատում է դարպասի իրավունքներով։ Գործում է անմիջապես։ | | `AIHUMMER_SCHEDULE_FAILURE_ADMIN` | Ձախողված առաջադրանքների մասին տեղեկացնել ադմինիստրատորին | `bool` | `1` | անմիջապես | Երբ պլանավորված առաջադրանքը ձախողվում է կամ չի կարողանում սկսվել, վահանակի ծանուցումների զանգակում հայտնվում է ծանուցում՝ նրա անունով, պատճառով և թե որտեղ ուղղել, և նույնը ուղարկվում է սեփականատերերի անձնական ալիքային զրույցներին (առաջադրանքի համար 6 ժամում ոչ ավելի, քան մեկ անգամ)։ Սա առաջադրանքի ստացողին ուղարկվող հաղորդագրությունից բացի է։ Անջատված է՝ ադմինիստրատորը ձախողումների մասին իմանում է միայն գործարկումների մատյանից։ Կիրառվում է անմիջապես։ | | `AIHUMMER_SCHEDULE_FAILURE_NOTIFY` | Հայտնել ստացողին առաջադրանքի ձախողման մասին | `bool` | `1` | անմիջապես | Երբ ժամանակացույցով առաջադրանքը ձախողվում է, նույն ստացողին ուղարկվում է կարճ հաղորդագրություն (առաջին ձախողումից հետո, 6 ժամում ոչ ավելի, քան մեկ անգամ)։ Անջատված է՝ ձախողումները երևում են միայն գործարկումների մատյանում։ Առանձին առաջադրանքի համար դա կարելի է անջատել նրա ձևում։ Գործում է անմիջապես։ | ## Security | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AIRGAPPED` | Մեկուսացված ռեժիմ (առանց ինտերնետի) | `bool` | `0` | անմիջապես | Արգելում է գործակալներին մուտք գործել ինտերնետ. վեբ որոնումը, էջերի բացումը և հարցումները հասնում են միայն ներքին հասցեներին և թույլատրված ցանկերի հասցեներին։ Միացրեք փակ ցանցերի համար՝ առանց արտաքին ելքի։ | | `AIHUMMER_AUDIT_RETENTION_DAYS` | Քանի օր պահել գործողությունների մատյանը | `int` | `0` | վերագործարկումից հետո | Աուդիտի մատյանի և կարգավորումների փոփոխությունների պատմության՝ այս ժամկետից հին գրառումները ջնջվում են օրը մեկ անգամ։ 0 կամ դատարկ՝ պահել միշտ։ | | `AIHUMMER_CORS_ORIGINS` | Թույլատրված CORS origin-ներ | `list` | — | վերագործարկումից հետո | Թույլատրված Origin-ների ցանկը՝ ստորակետերով։ Դատարկ = CORS-ը թույլատրված չէ (միայն same-origin)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_CSP` | Content-Security-Policy վերնագիր (վերասահմանում) | `text` | — | վերագործարկումից հետո | Վերասահմանում է CSP վերնագիրը։ Դատարկ = անվտանգ լռելյայն։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_INBOUND_SECRET` | Ալիքների պլագինների կապի բանալին սերվերի հետ | `text` | — | վերագործարկումից հետո | Միացված ալիքները (Telegram, VK և այլն) դրանով հաստատում են, որ հաղորդագրություններն իսկապես իրենցից են։ Սահմանվում է ավտոմատ տեղադրման ժամանակ՝ փոխել պետք չէ։ Եթե այն դատարկ է, սերվերը մերժում է բոլոր ալիքները, մինչև բանալին սահմանվի։ | | `AIHUMMER_OPENAI_COMPAT_KEY` | OpenAI-համատեղելի մուտք. ստատիկ API բանալի | `text` | — | վերագործարկումից հետո | Ընդհանուր բանալի այն ծրագրերի համար, որոնք միանում են սերվերին որպես OpenAI-համատեղելի ծառայության։ Դատարկ՝ ընդհանուր բանալին անջատված է. կարելի է միանալ «API բանալիներ» էջի անձնական բանալիներով։ | | `AIHUMMER_OPENAI_COMPAT_WORKSPACE` | OpenAI-համատեղելի մուտք. workspace-ի id | `text` | — | վերագործարկումից հետո | Աշխատանքային տարածքի ID, որին քարտեզագրվում է ստատիկ OpenAI-համատեղելի վավերացումը։ Դատարկ = AIHUMMER_DEFAULT_WORKSPACE_ID։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_REQUIRE_2FA` | Պահանջել 2FA օպերատորների համար | `bool` | `0` | անմիջապես | Պահանջել երկրորդ գործոն (TOTP/passkey) օպերատորների համար։ Միացված լինելիս առանց 2FA օպերատորներին մուտքի ժամանակ առաջարկվում է անմիջապես կարգավորել այն (առանց արգելափակման, որպեսզի սեփականատերը երբեք դուրս չմնա)։ Կիրառվում է անմիջապես։ | | `AIHUMMER_REQUIRE_SECURE` | Ընդունել միայն ապահով (HTTPS/WSS) կապեր | `bool` | `0` | վերագործարկումից հետո | Միացված վիճակում սովորական HTTP հարցումները վերահղվում են HTTPS (GET/HEAD-ի համար) կամ մերժվում են (403). localhost-ից մուտքը միշտ թույլատրված է, որպեսզի օպերատորը դուրս չմնա։ Հաշվի է առնում X-Forwarded-Proto-ն TLS-ը դադարեցնող հակադարձ պրոքսիից։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_TRUSTED_PROXIES` | Վստահելի պրոքսիներ | `list` | — | անմիջապես | Եթե սերվերի դիմաց պրոքսի կա (nginx, Caddy, բալանսավորիչ), ստորակետով գրեք դրա հասցեն կամ ցանցը, օրինակ 10.0.0.0/8։ Այդ դեպքում գործողությունների մատյանում, թույլատրված IP-ների ցանկում և գաղտնաբառի գուշակումից պաշտպանությունում կերևա այցելուի իրական հասցեն։ Դատարկ՝ հաշվի է առնվում միայն ուղիղ միացման հասցեն, և այն կեղծել հնարավոր չէ։ | ## Tools | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ուժի մեջ է մտնում | Ինչ է անում | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_BROWSER_ALLOWED_HOSTNAMES` | Դիտարկիչ․ մասնավոր հանգույցների բացառություններ | `list` | — | անմիջապես | Ստորակետերով բաժանված ճշգրիտ անուններ՝ առանց ձևանմուշների, URL-ների կամ պորտերի։ Սեփական սերվերի տեղային CDP-ի լրացուցիչ մասնավոր բացառություններ՝ web_fetch-ից առանձին։ | | `AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK` | Դիտարկիչ․ թույլատրել մասնավոր ցանցը | `bool` | — | անմիջապես | Դատարկ արժեքը պահում է նախկին կանոնը․ true կամ false միացնում է ստուգվող տեղային CDP-ն։ Մասնավոր մուտքը միայն սեփական սերվերում է։ Loopback-ը, link-local-ը և metadata-ն մնում են արգելափակված։ | | `AIHUMMER_BROWSER_PROFILE_SOCKET` | Դիտարկիչի պրոֆիլների կառավարման սոկետ | `text` | — | անմիջապես | Ոչ պարտադիր։ Թողեք դատարկ. դարպասն ինքն է գտնում դիտարկչի ծառայության managed-profiles.sock կառավարման սոկետը տեղադրման ստանդարտ վայրում։ Կայքերում մուտք գործած պրոֆիլները ստեղծվում են «Միացումներ» → «Դիտարկչի պրոֆիլներ» էջում։ Սա URL չէ և ոչ էլ աղբյուր պրոֆիլի ուղի։ | | `AIHUMMER_CODE_EXEC` | Կոդի կատարում գործակալի կողմից | `enum: off \\\| host \\\| sandbox` | `off` | անմիջապես | Գործակալի կոդի կատարման գործիքը (code_exec)։ Լռելյայն՝ «Անջատված»։ «Այս սերվերում»՝ հրամանները կատարվում են դարպասի սերվերում. ՕՀ sandbox-ը (bubblewrap) թաքցնում է տեղադրման գաղտնիքները, բայց «Առանց սահմանափակումների» ռեժիմում գործակալը տեսնում է SSH բանալիները և կարող է գրել իր թղթապանակից դուրս՝ միայն վստահելի սերվերի համար։ «Միայն sandbox-ում»՝ միշտ ՕՀ sandbox-ում. գաղտնիքներն ու բանալիները թաքնված են, գրել կարելի է միայն գործակալի թղթապանակում. առանց bubblewrap-ի (կամ կոնտեյների պատկերի) այս ռեժիմը չի պահպանվում։ Թե ինչ կարող է գործարկել յուրաքանչյուր գործակալ, սահմանվում է գործակալի մոտ՝ Գործակալներ → պրոֆիլ → Գործիքներ։ | | `AIHUMMER_CODE_EXEC_INTERPRETERS` | Code-exec մեկնիչներ (JSON) | `text` | — | անմիջապես | JSON օբյեկտ {language: path_to_binary}, օր. {\\"python\\":\\"/usr/bin/python3\\"}։ Դատարկ = ավտոմատ հայտնաբերում։ | | `AIHUMMER_CODE_EXEC_NET_PORTS` | Գործակալի կոդի համար բաց ցանցային պորտեր | `list` | `53,80,443` | անմիջապես | TCP պորտերը, որոնց կարող է միանալ գործակալի կոդը ՕՀ ավազարկղում (կոդի կատարում և ժամանակացույցի հրամաններ), ստորակետով բաժանված։ Լռելյայն 53, 80 և 443՝ DNS և կայքեր։ Այս սերվերի և նրա տեղային ցանցի մյուս ծառայությունները (տվյալների բազա, կառավարման վահանակ, դիտարկիչ, adb, տեղային մոդելներ, Home Assistant) փակ են գործակալի կոդի համար։ Ցանկի պորտը բաց է ցանկացած հասցեում, այդ թվում այս սերվերում, ուստի ավելացրեք միայն այն, ինչ պետք է կոդին, օրինակ՝ 22 SSH-ի համար։ Սահմանափակումը հանելու համար գրեք any։ «Առանց սահմանափակումների» ռեժիմի գործակալները չեն սահմանափակվում։ Անհրաժեշտ է Linux 6.7 կամ ավելի նոր․ առանց դրա սահմանափակումը չի գործում, և Գործակալներ → Գործիքներ բաժինը նշում է այդ մասին։ Կիրառվում է անմիջապես։ | | `AIHUMMER_CODE_EXEC_READ_DIRS` | Գործակալի կոդի համար ընթերցման բաց թղթապանակներ | `list` | — | անմիջապես | Այս սերվերի թղթապանակները, որոնք գործակալի կոդը կարող է կարդալ՝ կոդի կատարում և ժամանակացույցի հրամաններ ՕՀ ավազարկղում։ Ստորակետով կամ յուրաքանչյուրը նոր տողում, օրինակ՝ ~/reports։ Կարող եք նշել նաև առանձին ֆայլ, օրինակ՝ ~/scripts/report.py։ Այստեղ բացվածը տեսանելի է բոլոր գործակալների կոդին, ուստի բացեք միայն այն, ինչ պետք է կոդին։ Լռելյայն դատարկ է․ ավազարկղում կոդը տեսնում է միայն իր գործակալի թղթապանակը և համակարգային թղթապանակները, իսկ դարպասի օգտատիրոջ տնային թղթապանակը, տեղադրման տվյալները, այլ գործակալների թղթապանակները, բանալիները և հրամանների պատմությունը թաքնված են։ Արմատը, ամբողջ տնային թղթապանակը, տեղադրման տվյալները և բանալիներով տեղերը հնարավոր չէ բացել։ Կոդը չի կարող գրել այս թղթապանակներում։ Կիրառվում է անմիջապես։ | | `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Code-exec sandbox-ի պատկեր | `text` | — | անմիջապես | Ըստ ցանկության, միայն «Միայն sandbox-ում» ռեժիմի համար՝ Docker կոնտեյների պատկեր ՕՀ sandbox-ի փոխարեն (առանց ցանցի, միայն կարդալու արմատ, սահմանաչափեր). սերվերում անհրաժեշտ է Docker։ Դատարկ = ՕՀ sandbox (bubblewrap)։ | | `AIHUMMER_CODE_EXEC_TIMEOUT_SECONDS` | Կոդի կատարման ժամանակի սահմանը (վայրկյան) | `int` | `1800` | անմիջապես | Որքան կարող է աշխատել գործակալի մեկ հրամանը՝ ներառյալ ֆոնայինները. 10 վայրկյանից մինչև 24 ժամ։ 30 վայրկյանում չպատասխանած հրամանը չի ընդհատվում, այլ անցնում է ֆոն, որտեղ գործակալը այն ստուգում է process գործիքով։ Գործակալը կարող է խնդրել ավելի կարճ սահման, բայց ոչ ավելի երկար։ | | `AIHUMMER_DB_QUERY_DSN` | Տվյալների բազայի միացում «Հարցում բազային» գործիքի համար | `text` | — | անմիջապես | Տվյալների բազայի միացման տող, որը գործակալը կարող է կարդալ (միայն ընթերցում), օրինակ postgres://reader:password@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` | անմիջապես | Anti-հայտնաբերման բրաուզեր (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։