პარამეტრების ცნობარი

აქ ჩამოთვლილია ყველა პარამეტრი, რომელიც ოპერატორს შეუძლია შეცვალოს AiHummer-ის სერვერზე. გვერდი თავად პროდუქტის კატალოგიდან იქმნება, ამიტომ ემთხვევა თქვენს სერვერს. მნიშვნელობა დგება ვებ-ინტერფეისში ან ბრძანებით `aihummer settings set KEY VALUE` ([ბრძანების სტრიქონი](/ka/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) ყველა სამუშაო სივრცის ყველა გამართული knowledge-კონექტორის ფონური ავტომატური განმეორებითი სინქრონიზაციისთვის. ცარიელი/0 = გამორთულია. განმეორებითი სინქრონიზაცია იდემპოტენტურია (ჩანაცვლება წყაროს მიხედვით, დუბლების გარეშე). 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-ის reasoning-მოდელები (Codex) temperature-ს უარყოფენ — მათთვის ველი ცარიელი დატოვეთ; მიუთითეთ მხოლოდ არა-reasoning ბექენდის გამოყენებისას. მოქმედებს მაშინვე (გადატვირთვის გარეშე). | | `AIHUMMER_LLM_TOP_P` | Top-p (nucleus sampling) | text | — | nucleus-სემპლირების ზღვარი (0..1), როცა აგენტის პარამეტრები მას არ განსაზღვრავს. ცარიელი = არ გაიგზავნოს. temperature-ის მსგავსად, gpt-5.5-ის reasoning მას უარყოფს — მიუთითეთ მხოლოდ არა-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-ძრავის 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-ს runner თავად სუფთავდება. -1 (სამუდამოდ შენარჩუნება) რეკომენდებული არ არის: ollama-ს ხარვეზის გამო გაჭედილმა runner-მა შეიძლება 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-ის დანამატი) | 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 რერანკერის საიდქარის 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-ში (scope ldap, name 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-ში (scope saml, name sp_key). | | `AIHUMMER_SAML_ENTITY_ID` | SP-ის entity ID | text | — | სერვის-პროვაიდერის entity ID (ცარიელის შემთხვევაში ნაგულისხმევად ⟨root⟩/saml/metadata). | | `AIHUMMER_SAML_IDP_METADATA` | IdP მეტამონაცემების XML | text | — | ჩასვით თქვენი IdP-ის SAML-მეტამონაცემების დოკუმენტი (Okta/Azure AD/ADFS). | | `AIHUMMER_SAML_ROLE_ATTRIBUTE` | როლის/ჯგუფის ატრიბუტი (ნაგულისხმევი groups) | text | — | assertion-ის ატრიბუტი, რომელიც ჯგუფის/როლის მნიშვნელობებს ატარებს. | | `AIHUMMER_SAML_ROLE_MAPPINGS` | SAML: ჯგუფი→როლი შესაბამისობები (JSON) | text | — | JSON-ობიექტი მიწოდებული მნიშვნელობა → როლი, მაგ. {\\"AdminGroup\\":\\"admin\\",\\"Ops\\":\\"operator\\"}. | | `AIHUMMER_SAML_ROOT_URL` | SP ძირეული URL | text | — | ამ გეითვეის გარედან ხელმისაწვდომი საბაზისო URL, მაგ. https://app.example.com. ACS = ⟨root⟩/saml/acs. | | `AIHUMMER_SAML_SP_CERT` | SP სერტიფიკატი (PEM) | text | — | SP-ის ხელმოწერის საჯარო სერტიფიკატი (PEM). შესაბამისი პრივატული გასაღები ინახება Secrets-ში (scope saml, name sp_key). | ## Security | გასაღები | სახელი | ტიპი | ნაგულისხმევი | რას აკეთებს | | --- | --- | --- | --- | --- | | `AIHUMMER_AIRGAPPED` | იზოლირებული რეჟიმი (air-gapped, 1/0) | bool | `0` | ბლოკავს მოდელის მიერ ინიცირებულ გამავალ ტრაფიკს საჯარო ინტერნეტში (მხოლოდ შიდა/ნებადართული ჰოსტები). მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_AUDIT_RETENTION_DAYS` | აუდიტ-ჟურნალის შენახვა (დღეები, 0=სამუდამოდ) | int | `0` | რამდენ დღეს ინახებოდეს აუდიტის ჟურნალი; უფრო ძველი ჩანაწერები ყოველდღიურად იშლება. 0/ცარიელი = სამუდამოდ შენახვა. მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_CODE_EXEC_ALLOW_HOST` | code_exec-ის დაშვება ჰოსტზე (ქვიშის ყუთის გარეშე) | 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-თავსებადი შემომავალი: სამუშაო სივრცის 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` | სანდო reverse-proxy 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-ის ქვიშის ყუთის იმიჯი | 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.