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

Այստեղ թվարկված են բոլոր կարգավորումները, որոնք օպերատորը կարող է փոխել AiHummer-ի սերվերում։ Էջը հավաքվում է հենց արտադրանքի կատալոգից, ուստի համընկնում է ձեր սերվերի հետ։ Արժեքը սահմանվում է վեբ-ինտերֆեյսում կամ `aihummer settings set KEY VALUE` հրամանով ([Հրամանային տող](/hy/v1.0/reference/cli))։ Լռելյայն արժեքի սյունակը ցույց է տալիս, թե ինչ է օգտագործում սերվերը, քանի դեռ ձեր արժեքը սահմանված չէ։ > [!NOTE] > Գաղտնի արժեքներն այստեղ չեն տպվում, իսկ մատակարարի սպասարկման բանալիներն ընդհանրապես չեն թվարկվում՝ արտադրանքը թաքցնում է դրանք բոլոր ցուցակներից։ Գծիկը նշանակում է դատարկ արժեք կամ բացատրություն, որը ցուցադրվում է միայն վեբ-ինտերֆեյսում։ ## API | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_PERSONAL_API_KEYS` | Անձնական API բանալիներ OpenAI-համատեղելիի համար | bool | `1` | \\"off\\"-ն անջատում է անձնական բանալիներով վավերացումը OpenAI-համատեղելի վերջնակետում։ Ցանկացած այլ արժեք = միացված։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | ## Agent | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_APPROVAL_TOOLS` | Հաստատում պահանջող գործիքներ | text | — | — | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | Ենթաագենտի առավելագույն խորություն | int | `2` | — | | `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | Ենթաագենտի ժամանակի սահման (վայրկյան) | int | `180` | Մեկ ենթագործակալի գործարկման առավելագույն ժամանակը՝ վայրկյաններով։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_TOOL_SEARCH` | Գործիքների ծույլ բեռնում (tool_search) | bool | `false` | Ցուցադրել միայն հիմնական գործիքները և որոնման մետա-գործիքը, մնացածը բացահայտել ըստ պահանջի։ Արագացնում է քայլերը և նվազեցնում ծախսը, երբ տեղադրված են շատ գործիքներ՝ փոքր ռիսկով, որ մոդելը բաց կթողնի հազվադեպ օգտագործվող գործիքը։ | | `AIHUMMER_TOOL_SEARCH_CORE` | Ծույլ բեռնում. մշտապես միացված գործիքներ | text | — | Գործիքների անունները՝ ստորակետերով, որոնք նույնիսկ ծույլ ռեժիմում ցուցադրվում են անմիջապես։ | | `AIHUMMER_TOOL_SEARCH_THRESHOLD` | Ծույլ բեռնում. հետաձգելու համար գործիքների նվազագույն քանակ | int | `12` | Հետաձգել միայն այն դեպքում, երբ գործակալի պրոֆիլի զտիչից հետո մնում է այս թվից ավելի գործիք։ | ## Agent · Reasoning | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_BEST_OF_N` | Best-of-N նմուշներ (0/1=անջատ, ≥2=միացված) | int | `0` | ≥2 նմուշառում է N թեկնածու, և դատավորն ընտրում է լավագույնը։ Արժե N× գեներացիա։ | | `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | Բանավեճ. դատավորի հուշում (վերասահմանում) | text | — | Վերասահմանում է բանավեճի դատավորի պրոմպտը (դատարկ = ներկառուցված)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_AGENT_DEBATE_N` | Բանավեճի վահանակի չափ (0/1=անջատ, ≥2=միացված) | int | `0` | ≥2 գործարկում է N թեկնածուից և դատավորից բաղկացած բանավեճի վահանակ։ Արժե N× գեներացիա։ | | `AIHUMMER_AGENT_DEBATE_PROMPT` | Բանավեճ. թեկնածուի հուշում (վերասահմանում) | text | — | Վերասահմանում է բանավեճի թեկնածուի պրոմպտը (դատարկ = ներկառուցված)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_AGENT_DEBATE_ROUNDS` | Բանավեճ. փուլեր | int | `1` | Թեկնածուների վահանակի բանավեճի փուլերի քանակը։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_AGENT_JUDGE_PROMPT` | Best-of-N դատավորի հուշում (վերասահմանում) | text | — | Վերասահմանում է best-of-N դատավորի պրոմպտը (դատարկ = ներկառուցված)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_AGENT_PLAN_PROMPT` | Պլանավորողի հուշում (վերասահմանում) | text | — | Վերասահմանում է պլանավորողի պրոմպտը (դատարկ = ներկառուցված)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_AGENT_PLAN_STEPS` | Պլանավորող-կատարող. պլանի առավելագույն քայլեր (0=անջատ) | int | `0` | ⟩0 գործարկում է առանձին պլանավորող→կատարող→սինթեզ անցում (օգտակար է բարդ բազմաքայլ առաջադրանքների համար)։ 0 = անջատված։ Սովորաբար 4–8։ | | `AIHUMMER_AGENT_PLAN_STEP_ITERS` | Պլանավորող. գործիքների կրկնություններ մեկ քայլի համար (0=կանխադրված) | int | `0` | Սահմանափակում է գործիքների կանչի կրկնությունների թիվը պլանի յուրաքանչյուր քայլում։ 0 = ներկառուցված լռելյայն արժեքը (4)։ | | `AIHUMMER_AGENT_REFLECT` | Ինքնաքննադատության անցում | bool | `0` | Ավելացնում է ռեֆլեքսիայի/ինքնաքննադատության անցում վերջնական պատասխանից առաջ։ | | `AIHUMMER_AGENT_REFLECT_PROMPT` | Ռեֆլեքսիայի հուշում (վերասահմանում) | text | — | Վերասահմանում է ինքնաքննադատության պրոմպտը (դատարկ = ներկառուցված)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_AGENT_SELF_HEAL` | Ինքնավերականգնում. գործիքի սխալի կրկնություններ (0=անջատ) | int | `0` | ⟩0 կրկնում է գործիքների ձախողված կանչերն ուղղող հուշումով՝ մինչև այս սահմանը։ | ## Agent · System prompt | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_LOCALE` | Կանխադրված լոկալ | text | `ru-RU` | Պատասխանի լռելյայն լեզուն/լոկալը, օր. ru-RU։ Անձի/օպերատորի հրահանգները գերակա են։ | | `AIHUMMER_TIMEZONE` | Ժամային գոտի | text | `UTC` | IANA ժամային գոտի՝ ամսաթվի ներդրման համար, օր. Europe/Moscow։ Լռելյայն UTC։ | ## Channels | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_CONFIDENTIAL_PERSONA` | Գաղտնի վեբ-պերսոնա | bool | `0` | Միացված վիճակում վեբ-զրույցի գործակալը չի բացահայտում և չի պահում իր անձի/ինքնության տվյալները և պատասխանում է խստորեն ըստ առաջադրանքի — անանուն կամ գաղտնիության նկատմամբ զգայուն վեբ-տեղակայումների համար։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_INBOUND_REQUIRE_BINDING` | Պատասխանել միայն գրանցված օգտատերերին | text | `true` | true = բոտն անտեսում է ալիքի ցանկացած ուղարկողի, որը AiHummer-ի գրանցված օգտատեր ՉԷ (դերի կապում ունեցող օգտատեր) — զրույցի պատահական մասնակիցները և հյուրերի կանչերը պատասխան չեն ստանում։ false (լռելյայն) = պատասխանել բոլորին։ | ## Integrations | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_A2A_PUBLISH` | Հրապարակել ագենտը Agent2Agent-ի (A2A) միջոցով | bool | `0` | Հրապարակել գործակալը որպես A2A սերվեր (Agent Card + POST /a2a/message)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_MCP_EXPORT_TOOLS` | — | text | — | — | | `AIHUMMER_MCP_PUBLISH` | Հրապարակել գործիքները MCP-ի միջոցով | bool | `0` | Հրապարակել գործիքները որպես MCP սերվեր POST /v1/mcp հասցեում։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | ## Knowledge connectors | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_KB_SYNC_INTERVAL` | Կոնեկտորների պլանավորված վերասինքի միջակայք (0/դատարկ = անջատ) | text | — | Տևողություն (օր. 6h, 30m) բոլոր աշխատանքային տարածքներում կարգավորված գիտելիքի կոնեկտորների ֆոնային ավտոմատ վերահամաժամեցման համար։ Դատարկ/0 = անջատված։ Վերահամաժամեցումն իդեմպոտենտ է (փոխարինում ըստ source-ի, առանց կրկնօրինակների)։ slack_export-ը ներառված չէ (նրա zip-ը վերբեռնվում է ձեռքով)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | ## LLM | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_CASCADE_MIN_CHARS` | Կասկադ. էսկալացիայի համար նվազագույն նիշեր | int | `0` | Հարցման երկարության շեմը (նիշեր), որից միանում է կասկադի ավելի հզոր մոդելը։ 0 = լռելյայն։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_CASCADE_STRONG_MODEL` | Կասկադ. ավելի հզոր պահեստային մոդել | text | — | Մոդելը, որին կասկադով անցնում ենք երկար/բարդ հարցումների համար (դատարկ = անջատված)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `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 | `low` | Մոդելի դատողության խորությունը զրույցի քայլերի համար, երբ գործակալի պարամետրերը դա չեն սահմանում։ gpt-5.5-ի թույլատրելի արժեքներն են՝ none, low, medium, high, xhigh (ՈՉ minimal — gpt-5.5-ը մերժում է այն HTTP 400-ով)։ Ավելի բարձր = ավելի լավ որակ, բայց ավելի դանդաղ/թանկ։ Սխալ արժեքն անվտանգ կերպով բերվում է low-ի։ Կիրառվում է անմիջապես (առանց վերագործարկման)։ | | `AIHUMMER_LLM_CALL_TIMEOUT_S` | Մեկ կանչի ժամանակի սահման (վայրկյան) | int | `120` | Ժամանակի բյուջե ՄԵԿ մոդելի կանչի համար (հակակախման միջոց. gpt-5.5-ը կարող է անվերջ «մտածել» և քայլը բաց պահել)։ Ժամկետը լրանալիս կանչն ավարտվում է ErrCallTimeout սխալով՝ առանց կրկնությունների։ 0 = առանց սահմանի։ Կիրառվում է անմիջապես (առանց վերագործարկման)։ | | `AIHUMMER_LLM_GATEWAY_URL` | LLM-դարպասի URL | text | — | OpenAI-համատեղելի մոդելի վերջնակետի բազային URL-ը, որին դիմում է գործակալը (ձեր տեղական llama.cpp/vLLM/Ollama սերվերը կամ տեղակայված դարպասը)։ Դատարկ թողեք՝ մատակարարի լռելյայն վերջնակետն օգտագործելու համար։ | | `AIHUMMER_LLM_MODEL` | LLM մոդել | text | — | Մոդելի անունը/իդենտիֆիկատորը, որն ուղարկվում է մատակարարին յուրաքանչյուր քայլում (ձեր վերջնակետի սպասարկած մոդելը)։ Պետք է համընկնի այն մոդելի հետ, որը վերջնակետն իրականում տրամադրում է։ | | `AIHUMMER_LLM_PROVIDER` | LLM մատակարար | text | — | Որ մոդելի բեկենդն օգտագործել (OpenAI-համատեղելի վերջնակետ կամ Codex/ChatGPT-բաժանորդագրության տրանսպորտ)։ Որոշում է, թե ինչպես են ուղարկվում և վավերացվում հարցումները։ | | `AIHUMMER_LLM_RETRIES` | LLM կրկնություններ ժամանակավոր սխալի դեպքում | int | `3` | LLM-ի հարցման կրկնությունների թիվը ժամանակավոր սխալի դեպքում։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_LLM_TEMPERATURE` | Ջերմաստիճան | text | — | Նմուշառման ջերմաստիճանը (0..2), երբ գործակալի պարամետրերը դա չեն սահմանում։ Դատարկ = չուղարկել։ ՈՒՇԱԴՐՈՒԹՅՈՒՆ. gpt-5.5 դատողական մոդելները (Codex) մերժում են temperature — դրանց համար դաշտը թողեք դատարկ. սահմանեք միայն ոչ դատողական բեկենդ օգտագործելիս։ Կիրառվում է անմիջապես (առանց վերագործարկման)։ | | `AIHUMMER_LLM_TOP_P` | Top-p (nucleus նմուշառում) | text | — | Nucleus-նմուշառման շեմը (0..1), երբ գործակալի պարամետրերը դա չեն սահմանում։ Դատարկ = չուղարկել։ Ինչպես temperature-ը, gpt-5.5 reasoning-ը մերժում է այն — սահմանեք միայն ոչ դատողական բեկենդների համար։ Կիրառվում է անմիջապես (առանց վերագործարկման)։ | | `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 | — | Մոդել սովորական հարցումների համար (դատարկ = այս խումբն անջատված է)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | ## Media | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_DEEPGRAM_API_KEY` | Deepgram API բանալի | text | — | Deepgram-ի API-բանալի (STT շարժիչ = deepgram)։ Վերցվում է այստեղից կամ AIHUMMER_STT_API_KEY-ից։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_DEEPGRAM_MODEL` | Deepgram մոդել | text | `nova-2` | Deepgram-ի մոդել (օր. nova-2, nova-3, base)։ Կախված է այդ բանալու համար նախագծի հասանելիությունից։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `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` | Մեկ մեդիա վերբեռնման առավելագույն չափը (PUT /v1/media/{id}/content), մեգաբայթերով։ Սահմանափակում է սկավառակի գրառումները հանրային պորտի միջոցով (գերբեռնումից պաշտպանություն)։ Լռելյայն 256։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_STT_API_KEY` | STT API բանալի (ընտրովի) | text | — | Ըստ ցանկության bearer, եթե STT սայդքարը պահանջում է այն (install.sh-ը կարող է գեներացնել այն)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_STT_CODEX_URL` | STT codex-engine URL | text | — | OpenAI-համատեղելի /v1/audio/transcriptions-ի բազան codex շարժիչի համար (տրանսկրիպցիա ChatGPT-ի բաժանորդագրությամբ)։ Դատարկ = Codex-ի բազան։ Bearer-ը վերցվում է AIHUMMER_STT_API_KEY-ից կամ AIHUMMER_CODEX_ACCESS_TOKEN-ից։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_STT_ENGINE` | STT շարժիչ | enum: faster-whisper \\\| deepgram \\\| off | `faster-whisper` | Խոսքի ճանաչման շարժիչ։ faster-whisper = անվճար տեղական սայդքար (լռելյայն, տեղադրվում է սկզբից, URL = AIHUMMER_STT_URL, առանց բեռի երրորդ կողմի API-ների վրա)։ deepgram = ամպային Deepgram (արագ, բանալի AIHUMMER_DEEPGRAM_API_KEY, վճարովի՝ անվճար շեմով)։ off = ճանաչումն անջատված է։ (Codex/ChatGPT բաժանորդագրությունը ՉԻ աջակցում աուդիոյի տրանսկրիպցիան։) Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `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_STT_URL` | Խոսքի ճանաչման (faster-whisper) URL | text | — | Տեղական faster-whisper սայդքարի URL-ը (OpenAI-համատեղելի /v1/audio/transcriptions)։ Դատարկ = ավտոմատ լռելյայն http://127.0.0.1:8001, որը install.sh-ն ինքն է գրում։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_TTS_API_KEY` | TTS API բանալի (edge-tts) | text | — | Bearer դարպասի և edge-tts սայդքարի միջև (install.sh-ն այն գեներացնում է ավտոմատ)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_TTS_ENABLED` | Խոսքի սինթեզը միացված է | bool | `1` | Միացնում է խոսքի սինթեզը (tts գործիք + ձայնային ռեժիմ)։ edge-tts սայդքարը տեղադրվում է սկզբից։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_TTS_MODEL` | TTS մոդել | text | — | Մոդելի անունը edge-tts ծառայության համար։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_TTS_URL` | Խոսքի սինթեզի (edge-tts) URL | text | — | Տեղական edge-tts սայդքարի URL-ը (OpenAI-համատեղելի /v1/audio/speech)։ Դատարկ = ավտոմատ լռելյայն http://127.0.0.1:8002, որը install.sh-ն ինքն է գրում։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_TTS_VOICE` | TTS ձայն (կանխադրված de-DE-FlorianMultilingualNeural) | text | `de-DE-FlorianMultilingualNeural` | edge-tts-ի լռելյայն ձայնը (բազմալեզու, այդ թվում՝ ռուսերեն)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_VIDEO_API_KEY` | Վիդեոյի վերլուծության API բանալի | text | — | Տեսանյութի վերլուծության սայդքարի հասանելիության բանալին (եթե պահանջվում է)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_VIDEO_URL` | Վիդեոյի վերլուծության (ffmpeg) URL | text | — | Տեսանյութի վերլուծության սայդքարի URL-ը։ Դատարկ = անջատված։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | ## Media · Voice | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_VOICE_AEC` | Արձագանքի վերացում (AEC) | bool | `1` | Պահանջել echoCancellation գրանցման ժամանակ (WebRTC)։ Վերացնում է TTS-ի արձագանքը խոսափողում (Moltis #1129)։ | | `AIHUMMER_VOICE_AGC` | Ինքնաշխատ ուժեղացման կարգավորում | bool | `1` | — | | `AIHUMMER_VOICE_BARGEIN_FRAMES` | Ընդհատման (barge-in) կադրեր | int | `5` | Քանի հաջորդական ձայնային կադր (≈20մվ) ընդհատում է բոտի նվագարկումը։ | | `AIHUMMER_VOICE_DUPLEX` | Կենդանի լիարժեք դուպլեքս ձայն | bool | `0` | Միացնում է կենդանի լիարժեք երկկողմանի ռեժիմը (հոսքային փոխանցում + VAD + barge-in)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_VOICE_NOISE_SUPPRESSION` | Աղմուկի ճնշում | bool | `1` | — | | `AIHUMMER_VOICE_VAD_THRESHOLD` | VAD էներգիայի շեմ (0..1) | text | `0.02` | Խոսքի էներգիայի շեմը գրանցման VAD-գեյթինգի համար. ցածր = ավելի զգայուն։ | ## Memory | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_EMBEDDER_DIM` | Էմբեդդերի վեկտորի չափողականություն | int | `768` | Վեկտորի չափողականությունը — պետք է համապատասխանի մոդելին (multilingual-e5-base=768, bge-m3=1024)։ | | `AIHUMMER_EMBEDDER_KEEPALIVE` | Էմբեդդերի keep-alive | text | `5m` | keep_alive Ollama-ի էմբեդերի համար (միայն երբ AIHUMMER_MEMORY_RETRIEVAL=embedding)։ Լռելյայն 5m — պարապ մոդելը բեռնաթափվում է, և ollama-ի կախված պարապ ռաննն ինքն իրեն մաքրվում է։ -1 (ընդմիշտ պահել) ՉԻ խորհուրդ տրվում. ollama-ի սխալի պատճառով կախված ռաննը կարող է օրերով զբաղեցնել CPU-ի մեկ միջուկ։ Պարապությունից հետո սառը մեկնարկը փոխհատուցվում է դարպասի մեկնարկի ժամանակ տաքացմամբ։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_EMBEDDER_MODEL` | Էմբեդդերի մոդել | text | `yxchia/multilingual-e5-base` | Ollama-ի էմբեդինգի մոդելը։ Լռելյայն multilingual-e5-base — բազմալեզու (այդ թվում՝ ռուսերեն), 768 չափողականությամբ, թեթև և արագ CPU-ի վրա (~1-2վ մեկ էմբեդինգի համար)։ e5-ի query/passage նախածանցները կիրառվում են ավտոմատ։ GPU-ի վրա առավելագույն որակի համար օգտագործեք bge-m3 (սահմանեք DIM=1024)։ Պետք է համապատասխանի AIHUMMER_EMBEDDER_DIM-ին։ | | `AIHUMMER_EMBEDDER_PASSAGE_PREFIX` | Էմբեդդերի փաստաթղթի նախածանց | text | — | Վերասահմանել պահվող փաստաթղթի նախածանցը (e5 մոդելներն ավտոմատ օգտագործում են \\"passage: \\")։ Դատարկ թողեք՝ մոդելի անվամբ ավտոմատ որոշելու համար։ | | `AIHUMMER_EMBEDDER_QUERY_PREFIX` | Էմբեդդերի հարցման նախածանց | text | — | Վերասահմանել որոնման հարցման նախածանցը (e5 մոդելներն ավտոմատ օգտագործում են \\"query: \\")։ Դատարկ թողեք՝ մոդելի անվամբ ավտոմատ որոշելու համար։ | | `AIHUMMER_EMBEDDER_URL` | Էմբեդդերի URL (Ollama-համատեղելի) | text | — | Իրական իմաստային էմբեդինգներ։ Տեղադրիչը տեղակայում է Ollama սայդքարը և սա սահմանում ավտոմատ. ՉՍԱՀՄԱՆՎԱԾ = hash-էմբեդեր (միայն բառային, թույլ վերհիշում)։ | | `AIHUMMER_MEMORY_CAPTURE` | Հիշողության գրանցման ռեժիմ | enum: auto \\\| review \\\| off | `auto` | auto = հիշել և վերհիշել ավտոմատ; review = հիշել որպես ձեռքով հաստատում պահանջող թեկնածուներ; off = առանց գրանցման։ | | `AIHUMMER_MEMORY_CONTEXT_TIMEOUT` | Հիշողության բեռնման ժամանակի սահման | text | `3s` | Հիշողության բեռնման առավելագույն սպասումը պատասխանի սկզբում (հարցման էմբեդինգ + որոնում)։ Եթե էմբեդերը գերբեռնված է և չի հասցնում, պատասխանը շարունակվում է ԱՌԱՆՑ հիշողության բլոկի՝ փոխանակ կախվելու։ Go duration ձևաչափ (օր. 2s, 1500ms)։ 0 = առանց սահմանի։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_MEMORY_DREAM_INTERVAL` | «Երազի» անցման միջակայք | string | `1h` | Որքան հաճախ ինքնասպասարկվող dream անցումը ստուգված պնդումները սկանավորում է հակասությունների համար՝ բոլոր շրջանակներում (Go duration, օր. 30m/1h/6h)։ 0 = անջատել։ | | `AIHUMMER_MEMORY_EXTRACT` | Փաստերի արդյունահանում LLM-ի միջոցով | bool | `1` | LLM-ի միջոցով դուրս բերել նորմալացված սուբյեկտ/պրեդիկատ/օբյեկտ փաստերը (լռելյայն ՄԻԱՑՎԱԾ)՝ հում նախադասության հատվածներ պահելու փոխարեն — անհրաժեշտ է գրաֆի/հակասությունների/dream մեխանիզմների աշխատանքի համար։ Ավելացնում է մեկ LLM կանչ յուրաքանչյուր գրանցված հաղորդագրության համար. անջատեք՝ այդ կանչը խնայելու համար։ | | `AIHUMMER_MEMORY_RETRIEVAL` | Հիշողության վերականգնման ռեժիմ | enum: fulltext \\\| embedding | `fulltext` | Ինչպես է որոնվում հիշողությունը։ fulltext (լռելյայն) = Postgres-ի լիատեքստ որոնում փաստերի տեքստով — ԱՌԱՆՑ էմբեդեր մոդելի, առանց սայդքարի, առանց CPU-ի բեռի (ինչպես հին einstein-ը AiHummer-ում)։ embedding = իմաստային վեկտորային որոնում էմբեդերի միջոցով (AIHUMMER_EMBEDDER_URL/ollama) — իմաստով ավելի ճշգրիտ, բայց բեռնում է CPU-ն և պահանջում սայդքար։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_MEMORY_TOKEN` | Հեռավոր հիշողության ծառայության թոքեն | text | — | Սպասարկման թոքեն՝ Einstein Retrieval API-ում լիազորվելու համար (ուղարկվում է որպես Authorization: Bearer …)։ Անհրաժեշտ է միայն երբ AIHUMMER_MEMORY_URL-ը սահմանված է։ Դատարկ = առանց լիազորման (միայն dev տեղադրումների համար, որտեղ retrieval-ի լիազորումն անջատված է)։ | | `AIHUMMER_MEMORY_URL` | Հեռավոր հիշողության URL (Einstein plugin) | text | — | Einstein հիշողության ինքնուրույն փլագինի URL-ը (պայմանագիր aihummer.memory.v1, օր. http://127.0.0.1:8820)։ ԴԱՏԱՐԿ (լռելյայն) = ներկառուցված Go հիշողության մոդուլը։ Սահմանված լինելիս քայլի կոնտեքստի բեռնումն անցնում է HTTP-ով փլագինի /context + /retrieval հասցեներին. սխալի/անհասանելիության դեպքում մեղմ վերադարձ ներկառուցված մոդուլին (առանց խափանումների)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_QDRANT_API_KEY` | Qdrant API բանալի | text | — | — | | `AIHUMMER_QDRANT_URL` | Qdrant URL (մշտական վեկտորային պահեստ) | text | — | ՉՍԱՀՄԱՆՎԱԾ = պահոց հիշողության մեջ (վեկտորները ԿՈՐՉՈՒՄ են վերագործարկման ժամանակ)։ Սահմանեք արդյունաբերական միջավայրում հուսալի պահպանման համար։ | | `AIHUMMER_RERANKER_URL` | RAG վերադասավորման sidecar-ի URL | text | — | Կրոս-էնկոդեր սայդքարի HTTP URL-ը՝ հիբրիդային որոնման վերադասավորման համար։ Դատարկ = վերադասավորումն անջատված է։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | ## Moderation | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_MODERATION` | Մուտքային մոդերացիա | bool | `1` | \\"off\\"-ն անջատում է jailbreak/prompt-injection-ի դեմ ներկառուցված պաշտպանությունը։ Ցանկացած այլ արժեք = միացված։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_MODERATION_REFUSAL` | Մոդերացիայի մերժման հաղորդագրություն | text | — | Մերժման տեքստ, որը վերադարձվում է, երբ մոդերատորն արգելափակում է հարցումը (դատարկ = ներկառուցված)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | ## Public access | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_PUBLIC_URL` | Դարպասի հանրային URL (Web UI + հաճախորդներ) | text | — | Պրոքսիավորեք այս հոսթը → դարպասի պորտին (AIHUMMER_GATEWAY_ADDR, լռելյայն :8780)։ Օգտագործվում է Web UI-ի և iOS/վեբ հաճախորդների կողմից։ | | `POCKET_AGENT_GATEWAY_BASE_URL` | Pocket-agent դարպասի հանրային URL | text | — | Պրոքսիավորեք → pocket-agent-ի դարպասի պորտին (POCKET_AGENT_PORT, լռելյայն 8080)։ Հեռավոր գործակալը միանում է այստեղ մեկանգամյա տոմսով։ | | `TELEGRAM_PUBLIC_URL` | Telegram վեբհուկի հանրային URL | text | — | Միայն webhook ռեժիմի համար — պրոքսիավորեք → telegram-connector-ի պորտին (AIHUMMER_TELEGRAM_CONNECTOR_PORT, լռելյայն 8091)։ Թողեք դատարկ polling ռեժիմի համար (հանրային URL պետք չէ)։ | ## SSO (LDAP/AD) | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_LDAP_BASE_DN` | Օգտատերերի որոնման բազային DN | text | — | Search root, e.g. OU=Users,DC=corp,DC=example. | | `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 | — | e.g. ldaps://ad.corp.example:636 (TLS) or 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 audience | 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)։ | ## Security | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_AIRGAPPED` | Մեկուսացված ռեժիմ (air-gapped, 1/0) | bool | `0` | Արգելափակում է մոդելի կողմից կառավարվող ելքը դեպի հանրային ինտերնետ (միայն ներքին/թույլատրված ցանկի հոսթեր)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_AUDIT_RETENTION_DAYS` | Աուդիտ-լոգի պահպանում (օրեր, 0=ընդմիշտ) | int | `0` | Քանի օր պահել աուդիտի մատյանը. ավելի հին գրառումներն ամեն օր ջնջվում են։ 0/դատարկ = պահել ընդմիշտ։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_CODE_EXEC_ALLOW_HOST` | Թույլատրել code_exec-ը host-ի վրա (ԱՌԱՆՑ sandbox-ի) | bool | `0` | ⚠️ Թույլ տալ կոդի կատարումն ուղղակի հոսթի վրա՝ առանց մեկուսացման։ Միայն վստահելի homelab-ի համար։ Ավելի ապահով է սահմանել AIHUMMER_CODE_EXEC_SANDBOX_IMAGE։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_CORS_ORIGINS` | Թույլատրված CORS origin-ներ (ստորակետերով) | text | — | Թույլատրված Origin-ների ցանկը՝ ստորակետերով։ Դատարկ = CORS-ը թույլատրված չէ (միայն same-origin)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_CSP` | Content-Security-Policy վերնագիր (վերասահմանում) | text | — | Վերասահմանում է CSP վերնագիրը։ Դատարկ = անվտանգ լռելյայն։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_INBOUND_SECRET` | Կոնեկտոր→դարպաս ընդհանուր գաղտնիք | text | — | Ընդհանուր գաղտնիք, որը վավերացնում է կոնեկտոր→դարպաս անցումը (պետք է համընկնի կոնեկտորի կողմի արժեքի հետ)։ Դատարկ = մուտքային վերջնակետն ԱՌԱՆՑ վավերացման է։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_OPENAI_COMPAT_KEY` | OpenAI-համատեղելի մուտք. ստատիկ API բանալի | text | — | Ստատիկ բանալի, որով OpenAI-համատեղելի հաճախորդները վավերացվում են դարպասի ներկառուցված /v1 վերջնակետում (P8 home gateway)։ Դատարկ = ստատիկ վավերացումն անջատված է (անձնական բանալիները մնում են)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `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` | Վստահելի հակադարձ-պրոքսի CIDR-եր (ստորակետերով) | text | — | Վստահելի հակադարձ պրոքսի ցանցերի ցանկը՝ ստորակետերով (CIDR, օր. 10.0.0.0/8,192.168.0.0/16, կամ առանձին IP-ներ)։ Միայն ԱՅՍ հասցեներից ԵԿՈՂ հարցումների համար է X-Forwarded-For վերնագիրն օգտագործվում հաճախորդի IP-ն որոշելու համար (աուդիտ, IP-ների թույլատրված ցանկ, գաղտնաբառի ուժային ընտրության դեմ պաշտպանություն)։ Դատարկ = վստահել ՄԻԱՅՆ իրական peer հասցեին (XFF-ն անտեսվում է, IP-ի կեղծումն անհնար է)։ Կիրառվում է անմիջապես։ | ## Tools | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_CODE_EXEC` | Միացնել code_exec | bool | `0` | — | | `AIHUMMER_CODE_EXEC_INTERPRETERS` | Code-exec մեկնիչներ (JSON) | text | — | JSON օբյեկտ {language: path_to_binary}, օր. {\\"python\\":\\"/usr/bin/python3\\"}։ Դատարկ = ավտոմատ հայտնաբերում։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Code-exec sandbox-ի պատկեր | text | — | Կոնտեյների պատկեր՝ code_exec-ը մեկուսացնելու համար (առանց ցանցի, միայն կարդալու rootfs, սահմանափակումներ)։ Դատարկ = կատարում հենց հոսթի վրա (վստահելի միջավայր)։ Կիրառվում է մեկնարկի/վերագործարկումից հետո։ | | `AIHUMMER_DB_QUERY_DSN` | DSN db_query-ի համար (օգտագործեք նվազագույն իրավունքներով, ոչ սեփականատեր դեր — հարցումները կատարվում են RLS-ով սահմանափակված ընթացիկ աշխատանքային տարածքով) | text | — | — | | `AIHUMMER_FS_ROOT` | Ֆայլային համակարգի գործիքի արմատ | text | — | — | | `AIHUMMER_HTTP_ALLOWLIST` | http_request թույլատրված ցուցակ | text | — | — | | `AIHUMMER_HTTP_AUTH_JSON` | http_request նույնականացում (JSON) | text | — | — | | `AIHUMMER_MCP_SERVERS` | MCP սերվերներ (JSON) | text | — | — | | `AIHUMMER_WEBFETCH_ALLOWLIST` | web_fetch թույլատրված ցուցակ | text | — | — | ## Web UI (separate port) | Բանալի | Անվանում | Տեսակ | Լռելյայն | Ինչ է անում | | --- | --- | --- | --- | --- | | `AIHUMMER_WEBUI_API_BASE` | API բազային URL, որին դիմում է Web UI-ն | text | — | Բացարձակ origin (օր. https://api.example.com), որին առանձին տեղակայված SPA-ն դիմում է /v1/admin/* կանչերի համար։ Դատարկ = վերադարձ դարպասի հանրային URL-ին, ապա դարպասի տեղական հասցեին։ Պետք է հասանելի լինի ադմինիստրատորի դիտարկիչից. API-ն պետք է թույլատրի այս Web UI-ի origin-ը CORS-ի միջոցով (ավտոմատ ավելացվում է ստորև)։ | | `AIHUMMER_WEBUI_ENABLED` | Մատուցել ադմին Web UI-ն սեփական պորտով | bool | `1` | Լռելյայն միացված է. ադմին SPA-ն մատուցվում է առանձին լսողի (AIHUMMER_WEBUI_ADDR) ԱՐՄԱՏՈՒՄ, որը կարելի է կապել միայն ներքին ինտերֆեյսին։ Դարպասի հիմնական պորտը պահում է API + pairing + WS + SSE և ՉԻ մատուցում /admin/։ Սահմանեք 0՝ Web UI-ի լսողն ամբողջովին անջատելու համար։ | | `AIHUMMER_WEBUI_ORIGIN` | Web UI բրաուզերի Origin (CORS) | text | — | Web UI-ի դիտարկիչային Origin-ը (օր. https://admin.example.com), ավտոմատ ավելացվում է API-ի CORS թույլատրված ցանկին՝ հավատարմագրերով։ Դատարկ = բխեցվում է AIHUMMER_WEBUI_ADDR-ից (http://host:port)։ Սահմանեք սա, երբ դիտարկիչը Web UI-ին հասնում է կապման հասցեից տարբեր պրոքսիի/հոսթանվան միջոցով։ | Օպերատորին հասանելի կարգավորումներ՝ 138։