Sazlamalar gollanmasy

Bu ýerde operatoryň AiHummer serwerinde üýtgedip biljek ähli sazlamalary sanalýar. Sahypa önümiň öz katalogyndan ýygnalýar, şonuň üçin siziň serweriňiz bilen gabat gelýär. Baha web-interfeýsde ýa-da `aihummer settings set KEY VALUE` buýrugy bilen berilýär ([Buýruk setiri](/tk/v1.0/reference/cli)). Başlangyç baha sütüni öz bahaňyz berilýänçä serweriň ulanýan bahasyny görkezýär. > [!NOTE] > Gizlin bahalar bu ýerde çap edilmeýär, üpjün edijiniň hyzmat açarlary bolsa asla sanalmaýar — önüm olary ähli sanawlardan gizleýär. Çyzyk boş bahany ýa-da diňe web-interfeýsde görkezilýän düşündirişi aňladýar. ## API | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_PERSONAL_API_KEYS` | OpenAI bilen laýyk üçin şahsy API açarlary | bool | `1` | \\"off\\" OpenAI bilen laýyk endpoint-de şahsy açarlar bilen tassyklamany öçürýär. Islendik başga baha = açyk. Başlananda/täzeden işe goýberlenden soň ulanylýar. | ## Agent | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_APPROVAL_TOOLS` | Tassyklama talap edýän gurallar | text | — | — | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | Subagentiň iň ýokary çuňlugy | int | `2` | — | | `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | Subagentiň garaşma wagty (sekunt) | int | `180` | Bir subagentiň işledilişiniň iň köp wagty, sekuntda. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_TOOL_SEARCH` | Gurallary ýaltalyk bilen ýüklemek (tool_search) | bool | `false` | Diňe esasy gurallary we gözleg meta-guralyny görkez, galanlaryny talap boýunça aç. Köp gural gurnalanda ädimleri çaltlandyrýar we çykdajyny azaldýar; modeliň seýrek ulanylýan guraly gözden salmak howpy az. | | `AIHUMMER_TOOL_SEARCH_CORE` | Ýaltalyk bilen ýüklemek: hemişe açyk gurallar | text | — | Ýalta tertipde-de derrew görkezilýän gural atlarynyň otur bilen aýrylan sanawy. | | `AIHUMMER_TOOL_SEARCH_THRESHOLD` | Ýaltalyk bilen ýüklemek: yza goýmak üçin iň az gural sany | int | `12` | Diňe agentiň profil süzgüçinden soň şu sandan köp gural galanda yza süýşür. | ## Agent · Reasoning | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_BEST_OF_N` | Best-of-N nusgalary (0/1=öçük, ≥2=açyk) | int | `0` | ≥2 bolanda N dalaşgär saýlanýar we iň gowusy emin tarapyndan kesgitlenýär. N× generasiýa çykdajy edýär. | | `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | Jedel: eminiň prompty (üýtgetmek) | text | — | Jedeliň emininiň promptyny çalyşýar (boş = içerki). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_AGENT_DEBATE_N` | Jedel panelniň ululygy (0/1=öçük, ≥2=açyk) | int | `0` | ≥2 bolanda N dalaşgärden ybarat jedel topary + emin işleýär. N× generasiýa çykdajy edýär. | | `AIHUMMER_AGENT_DEBATE_PROMPT` | Jedel: dalaşgär prompty (üýtgetmek) | text | — | Jedel dalaşgäriniň promptyny çalyşýar (boş = içerki). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_AGENT_DEBATE_ROUNDS` | Jedel: raundlar | int | `1` | Dalaşgärler topary üçin jedel tapgyrlarynyň sany. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_AGENT_JUDGE_PROMPT` | Best-of-N eminiň prompty (üýtgetmek) | text | — | best-of-N emininiň promptyny çalyşýar (boş = içerki). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_AGENT_PLAN_PROMPT` | Meýilleşdiriji prompty (üýtgetmek) | text | — | Meýilleşdirijiniň promptyny çalyşýar (boş = içerki). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_AGENT_PLAN_STEPS` | Meýilleşdiriji-ýerine ýetiriji: iň köp meýil ädimleri (0=öçük) | int | `0` | ⟩0 aýratyn meýilleşdiriji→ýerine ýetiriji→sintez geçişini işledýär (çylşyrymly köp ädimli işler üçin peýdaly). 0 = öçük. Adatça 4–8. | | `AIHUMMER_AGENT_PLAN_STEP_ITERS` | Meýilleşdiriji: her ädim üçin gural gaýtalamalary (0=başlangyç) | int | `0` | Meýilnamanyň her ädimine düşýän gural çagyryş gaýtalanmalaryny çäklendirýär. 0 = içerki adaty baha (4). | | `AIHUMMER_AGENT_REFLECT` | Öz-özüňi tankytlama geçişi | bool | `0` | Jemleýji jogapdan öň pikirlenme/öz-özüňi tankytlama geçişini goşýar. | | `AIHUMMER_AGENT_REFLECT_PROMPT` | Refleksiýa prompty (üýtgetmek) | text | — | Öz-özüňi tankytlama promptyny çalyşýar (boş = içerki). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_AGENT_SELF_HEAL` | Öz-özüňi bejermek: gural ýalňyşlyklarynda gaýtalamalar (0=öçük) | int | `0` | ⟩0 bolanda şowsuz gural çagyryşlary düzediş görkezmesi bilen şu çäge çenli gaýtalanýar. | ## Agent · System prompt | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_LOCALE` | Başlangyç lokal | text | `ru-RU` | Adaty jogap dili/lokaly, mysal üçin ru-RU. Personanyň/operatoryň görkezmeleri ileri tutulýar. | | `AIHUMMER_TIMEZONE` | Sagat guşaklygy | text | `UTC` | Senäni goşmak üçin IANA sagat guşagy, mysal üçin Europe/Moscow. Adaty UTC. | ## Channels | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_CONFIDENTIAL_PERSONA` | Gizlin web persona | bool | `0` | Açyk bolanda web-çat agenti öz personasy/şahsyýeti baradaky maglumatlary açmaýar we saklamaýar hem-de jogaplaryny diňe şu iş bilen çäklendirýär — anonim ýa-da gizlinlige duýgur web ýerleşdirmeleri üçin. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_INBOUND_REQUIRE_BINDING` | Diňe hasaba alnan ulanyjylara jogap bermek | text | `true` | true = bot kanalda AiHummer ulanyjysy BOLMADYK (rol baglanyşygy bolan ulanyjy) islendik iberijini äsgermeýär — tötänleýin çat agzalary we myhman çagyryşlary jogap almaýar. false (adaty) = hemmelere jogap ber. | ## Integrations | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_A2A_PUBLISH` | Agenti Agent2Agent (A2A) arkaly çap etmek | bool | `0` | Agenti A2A serweri hökmünde çap et (Agent Card + POST /a2a/message). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_MCP_EXPORT_TOOLS` | — | text | — | — | | `AIHUMMER_MCP_PUBLISH` | Gurallary MCP arkaly çap etmek | bool | `0` | Gurallary POST /v1/mcp salgysynda MCP serweri hökmünde çap et. Başlananda/täzeden işe goýberlenden soň ulanylýar. | ## Knowledge connectors | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_KB_SYNC_INTERVAL` | Meýilleşdirilen konnektor gaýtadan sinhronlamak aralygy (0/boş = öçük) | text | — | Ähli iş meýdanlaryndaky sazlanan her bilim konnektorynyň arka fonda awtomatik gaýtadan sinhronlanmagy üçin dowamlylyk (mysal üçin 6h, 30m). Boş/0 = öçük. Gaýtadan sinhronlama idempotent (çeşme boýunça çalyşma, gaýtalanmasyz). slack_export girmeýär (onuň zip faýly el bilen ýüklenýär). Başlananda/täzeden işe goýberlenden soň ulanylýar. | ## LLM | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_CASCADE_MIN_CHARS` | Kaskad: eskalasiýa üçin iň az simwol | int | `0` | Güýçli kaskad modeliniň işe girýän sorag uzynlygy çägi (belgi). 0 = adaty. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_CASCADE_STRONG_MODEL` | Kaskad: has güýçli ätiýaç model | text | — | Uzyn/çylşyrymly soraglar üçin kaskad bilen geçilýän model (boş = öçük). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_CODEX_BASE_URL` | Codex esasy URL-i | text | — | Codex (ChatGPT abunalygy) transportynyň binýady. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_CODEX_MAX_OUTPUT_TOKENS` | Iň köp çykyş tokeni (0 = çäk ýok) | int | `0` | Çat ädimi üçin max_output_tokens çägi. 0 = çäk ýok. Reasoning modellerinde pikirlenme tokenleri hem şu býujete girýär, şonuň üçin gaty kiçi baha boş «incomplete: max_output_tokens» jogabyny berýär. Şobada ulanylýar (täzeden işletmek gerek däl). | | `AIHUMMER_CODEX_MODEL` | Model ID-si (Codex / gpt-5.5 transporty) | text | `gpt-5.5` | Esasy Codex/ChatGPT transportynyň model belgisi (mysal üçin gpt-5.5, gpt-5.5-codex). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_CODEX_REASONING_EFFORT` | Pikirlenme tagallasy | enum: none \\\| low \\\| medium \\\| high \\\| xhigh | `low` | Agentiň parametrleri belläp bermedik ýagdaýynda çat ädimleri üçin modeliň pikirlenme çuňlugy. gpt-5.5 üçin dogry bahalar: none, low, medium, high, xhigh (minimal DÄL — gpt-5.5 ony HTTP 400 bilen ret edýär). Ýokary = has hilli, emma has haýal/gymmat. Nädogry baha howpsuz görnüşde low-a öwrülýär. Şobada ulanylýar (täzeden işletmek gerek däl). | | `AIHUMMER_LLM_CALL_TIMEOUT_S` | Her çagyryş üçin garaşma wagty (sekunt) | int | `120` | ÝEKE bir model çagyryşy üçin wagt býujeti (anti-stall: gpt-5.5 çäksiz «pikirlenip» we ädimi açyk saklap biler). Wagt gutaranda çagyryş gaýtalanmasyz ErrCallTimeout ýalňyşlygy bilen tamamlanýar. 0 = çäk ýok. Şobada ulanylýar (täzeden işletmek gerek däl). | | `AIHUMMER_LLM_GATEWAY_URL` | LLM derwezesiniň URL-i | text | — | Agentiň ýüz tutýan OpenAI bilen laýyk model endpoint-iniň esasy URL-i (ýerli llama.cpp/vLLM/Ollama serweriňiz ýa-da hostingdäki derweze). Üpjün edijiniň adaty endpoint-ini ulanmak üçin boş goýuň. | | `AIHUMMER_LLM_MODEL` | LLM modeli | text | — | Her ädimde üpjün edijä ugradylýan modeliň ady/belgisi (endpoint-iňiziň berýän modeli). Endpoint-iň hakykatda hödürleýän modeli bilen gabat gelmeli. | | `AIHUMMER_LLM_PROVIDER` | LLM üpjün ediji | text | — | Haýsy model backend-iniň ulanyljakdygy (OpenAI bilen laýyk endpoint ýa-da Codex/ChatGPT abunalyk transporty). Soraglaryň nähili ugradylýandygyny we tassyklanýandygyny kesgitleýär. | | `AIHUMMER_LLM_RETRIES` | Wagtlaýyn ýalňyşlykda LLM gaýtalamalary | int | `3` | Wagtlaýyn ýalňyşlykda LLM soragynyň gaýtalanma sany. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_LLM_TEMPERATURE` | Temperatura | text | — | Agentiň parametrleri belläp bermedik ýagdaýynda saýlaw temperaturasy (0..2). Boş = ugratma. BELLIK: gpt-5.5 reasoning modelleri (Codex) temperature-y ret edýär — olar üçin meýdany boş goýuň; diňe reasoning däl backend ulananyňyzda belläň. Şobada ulanylýar (täzeden işletmek gerek däl). | | `AIHUMMER_LLM_TOP_P` | Top-p (nucleus nusgalama) | text | — | Agentiň parametrleri belläp bermedik ýagdaýynda nucleus-sampling çägi (0..1). Boş = ugratma. temperature ýaly, gpt-5.5 reasoning muny hem ret edýär — diňe reasoning däl backend-ler üçin belläň. Şobada ulanylýar (täzeden işletmek gerek däl). | | `AIHUMMER_OPENAI_API` | OpenAI API stili (chat \| responses) | enum: \\\| chat \\\| responses | — | chat = /chat/completions, responses = /responses. Boş = awto/adaty. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_OPENAI_API_KEY` | Öz-özi OpenAI API açary (gurnama üçin başlangyç) | text | — | OpenAI-niň öz aýlawy üçin OpenAI hasabyňyzyň açary (OpenAI-ni adaty üpjün ediji hökmünde ulanýan bolsaňyz). «Modeller» sahypasyndaky iş meýdany boýunça BYOK bilen bulaşdyrmaň. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_OPENAI_BASE_URL` | Öz-özi OpenAI esasy URL-i | text | — | OpenAI bilen laýyk API-niň binýady (mysal üçin https://api.openai.com/v1). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_OPENAI_MODEL` | Öz-özi OpenAI modeli | text | — | OpenAI-niň öz aýlawy üçin model (AIHUMMER_OPENAI_API_KEY bellenende). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_ROUTER_COMPLEX_MODEL` | Marşrutlaýjy: çylşyrymly sowallar üçin model | text | — | Çylşyrymly soraglar üçin model (boş = zolak öçük). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_ROUTER_SIMPLE_MODEL` | Marşrutlaýjy: ýönekeý sowallar üçin model | text | — | Ýönekeý soraglar üçin model (boş = zolak öçük). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_ROUTER_STANDARD_MODEL` | Marşrutlaýjy: adaty sowallar üçin model | text | — | Adaty soraglar üçin model (boş = zolak öçük). Başlananda/täzeden işe goýberlenden soň ulanylýar. | ## Media | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_DEEPGRAM_API_KEY` | Deepgram API açary | text | — | Deepgram API açary (STT hereketlendirijisi = deepgram). Şu ýerden ýa-da AIHUMMER_STT_API_KEY-den alynýar. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_DEEPGRAM_MODEL` | Deepgram modeli | text | `nova-2` | Deepgram modeli (mysal üçin nova-2, nova-3, base). Açar boýunça taslamanyň girişine bagly. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_DEEPGRAM_URL` | Deepgram esasy URL-i | text | — | Deepgram API binýady. Boş = https://api.deepgram.com. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_IMAGE_BASE_URL` | Surat API esasy URL-i (ätiýaç OpenAI) | text | — | OpenAI açary bilen işlenende /images API-niň binýady (boş = https://api.openai.com/v1). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_IMAGE_MODEL` | Surat döretmek modeli | text | — | image_generate üçin model (adaty gpt-image-2). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_MEDIA_MAX_UPLOAD_MB` | Medianyň iň ýokary ýükleme göwrümi (MB) | int | `256` | Bir media ýüklemesiniň iň uly göwrümi (PUT /v1/media/{id}/content), megabaýtda. Açyk port arkaly diske ýazmagy çäklendirýär (dolup daşmakdan goranmak). Adaty 256. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_STT_API_KEY` | STT API açary (islege bagly) | text | — | STT sidecar-y talap edýän bolsa, hökmany däl bearer (install.sh ony döredip biler). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_STT_CODEX_URL` | STT codex-engine URL-i | text | — | codex hereketlendirijisi üçin OpenAI bilen laýyk /v1/audio/transcriptions binýady (ChatGPT abunalygy arkaly transkripsiýa). Boş = Codex binýady. Bearer AIHUMMER_STT_API_KEY ýa-da AIHUMMER_CODEX_ACCESS_TOKEN-den alynýar. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_STT_ENGINE` | STT hereketlendirijisi | enum: faster-whisper \\\| deepgram \\\| off | `faster-whisper` | Ses tanamak hereketlendirijisi. faster-whisper = mugt ýerli sidecar (adaty, gutudan çykan badyna işleýär, URL = AIHUMMER_STT_URL, üçünji tarap API-lerine ýük ýok). deepgram = bulut Deepgram (çalt, açar AIHUMMER_DEEPGRAM_API_KEY, mugt möçberi bolan tölegli). off = tanamak öçük. (Codex/ChatGPT abunalygy ses transkripsiýasyny GOLDAMAÝAR.) Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_STT_LANGUAGE` | STT dili | text | — | Tanamak dili (BCP-47, mysal üçin ru/en). deepgram hereketlendirijisi (nova-2 modeli) tarapyndan ulanylýar. Boş = awtomatik kesgitleme / hereketlendirijiniň adatysy. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_STT_MODEL` | STT modeli | text | `Systran/faster-whisper-small` | faster-whisper modeli (mysal üçin small/medium/large-v3 ýa-da Systran/faster-whisper-⟨size⟩). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_STT_URL` | Sesi tekste öwürmegiň (faster-whisper) URL-i | text | — | Ýerli faster-whisper sidecar-ynyň URL-i (OpenAI bilen laýyk /v1/audio/transcriptions). Boş = awtomatik adaty http://127.0.0.1:8001, ony install.sh özi belleýär. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_TTS_API_KEY` | TTS API açary (edge-tts) | text | — | Derweze bilen edge-tts sidecar-ynyň arasyndaky bearer (install.sh ony awtomatik döredýär). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_TTS_ENABLED` | Tekstden sese öwürmek işjeňleşdirildi | bool | `1` | Ses sintezini işjeňleşdirýär (tts guraly + ses tertibi). edge-tts sidecar-y gutudan çykan badyna gelýär. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_TTS_MODEL` | TTS modeli | text | — | edge-tts hyzmaty üçin modeliň ady. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_TTS_URL` | Tekstden sese öwürmegiň (edge-tts) URL-i | text | — | Ýerli edge-tts sidecar-ynyň URL-i (OpenAI bilen laýyk /v1/audio/speech). Boş = awtomatik adaty http://127.0.0.1:8002, ony install.sh özi belleýär. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_TTS_VOICE` | TTS sesi (başlangyç de-DE-FlorianMultilingualNeural) | text | `de-DE-FlorianMultilingualNeural` | Adaty edge-tts sesi (köpdilli, şol sanda rus dili). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_VIDEO_API_KEY` | Wideo derňewiniň API açary | text | — | Wideo seljeriş sidecar-yna giriş açary (talap edilse). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_VIDEO_URL` | Wideo derňewiniň (ffmpeg) URL-i | text | — | Wideo seljeriş sidecar-ynyň URL-i. Boş = öçük. Başlananda/täzeden işe goýberlenden soň ulanylýar. | ## Media · Voice | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_VOICE_AEC` | Eho ýatyryş (AEC) | bool | `1` | Ses ýazgysynda echoCancellation talap et (WebRTC). TTS-iň mikrofona düşýän ýaňyny aýyrýar (Moltis #1129). | | `AIHUMMER_VOICE_AGC` | Awtomatiki güýçlendirmegi sazlamak | bool | `1` | — | | `AIHUMMER_VOICE_BARGEIN_FRAMES` | Bölme (barge-in) üçin kadrlar | int | `5` | Botuň sesli oýnadylyşyny näçe yzygiderli sesli kadryň (≈20ms) kesýändigi. | | `AIHUMMER_VOICE_DUPLEX` | Janly doly-dupleks ses | bool | `0` | Janly doly dupleks tertibini işjeňleşdirýär (strimleme + VAD + barge-in). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_VOICE_NOISE_SUPPRESSION` | Şowhun ýatyryş | bool | `1` | — | | `AIHUMMER_VOICE_VAD_THRESHOLD` | VAD energiýa bosagasy (0..1) | text | `0.02` | Ses ýazgysyny VAD bilen dolandyrmak üçin gepleýiş energiýasynyň çägi; pes = has duýgur. | ## Memory | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_EMBEDDER_DIM` | Embedderiň wektor ölçegi | int | `768` | Wektoryň ölçegi — model bilen gabat gelmeli (multilingual-e5-base=768, bge-m3=1024). | | `AIHUMMER_EMBEDDER_KEEPALIVE` | Embedderiň keep-alive | text | `5m` | Ollama embedderi üçin keep_alive (diňe AIHUMMER_MEMORY_RETRIEVAL=embedding bolanda). Adaty 5m — boş duran model ýatdan aýrylýar, doňup galan boş ollama runneri özi arassalanýar. -1 (hemişe sakla) MASLAHAT BERILMEÝÄR: ollama-daky ýalňyşlyk sebäpli doňan runner günlerläp CPU ýadrosyny doly ýükläp biler. Boş durandan soňky sowuk başlangyç derweze başlananda gyzdyrmak arkaly öwezini dolýar. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_EMBEDDER_MODEL` | Embedder modeli | text | `yxchia/multilingual-e5-base` | Ollama embedding modeli. Adaty multilingual-e5-base — köpdilli (şol sanda rus dili), 768 ölçegli, CPU-da ýeňil we çalt (~1-2 sek./embedding). e5 üçin query/passage prefiksleri awtomatik ulanylýar. GPU enjamynda iň ýokary hil üçin bge-m3 ulanyň (DIM=1024 belläň). AIHUMMER_EMBEDDER_DIM bilen gabat gelmeli. | | `AIHUMMER_EMBEDDER_PASSAGE_PREFIX` | Embedderiň resminama prefiksi | text | — | Saklanýan resminamanyň prefiksini çalyş (e5 modelleri awtomatik \\"passage: \\" ulanýar). Model adyna görä awtomatik kesgitlemek üçin boş goýuň. | | `AIHUMMER_EMBEDDER_QUERY_PREFIX` | Embedderiň sorag prefiksi | text | — | Gözleg soragynyň prefiksini çalyş (e5 modelleri awtomatik \\"query: \\" ulanýar). Model adyna görä awtomatik kesgitlemek üçin boş goýuň. | | `AIHUMMER_EMBEDDER_URL` | Embedderiň URL-i (Ollama bilen laýyk) | text | — | Hakyky semantik embeddingler. Gurnaýjy Ollama sidecar-yny ýerleşdirýär we muny awtomatik belleýär; BELLENMEDIK = hash embedder (diňe leksiki, gowşak tapyş). | | `AIHUMMER_MEMORY_CAPTURE` | Ýat ýazgy alyş tertibi | enum: auto \\\| review \\\| off | `auto` | auto = awtomatik ýatda sakla we ýada sal; review = el bilen tassyklanmagy talap edýän dalaşgärler hökmünde sakla; off = ýazgy alynmaýar. | | `AIHUMMER_MEMORY_CONTEXT_TIMEOUT` | Ýat ýükleme garaşma wagty | text | `3s` | Jogabyň başynda ýadyň ýüklenmegi üçin iň köp garaşma (soragyň embeddingi + gözleg). Embedder aşa ýüklenen bolsa we möhlete ýetişmese, jogap doňup galman, ýat blogy BOLMAZDAN dowam edýär. Go duration formaty (mysal üçin 2s, 1500ms). 0 = çäk ýok. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_MEMORY_DREAM_INTERVAL` | «Düýş» geçişiniň aralygy | string | `1h` | Öz-özüne hyzmat edýän dream geçişiniň ähli giňişliklerde barlanan tassyklamalary garşylyklara görä näçe ýygy skanirleýändigi (Go duration, mysal üçin 30m/1h/6h). Öçürmek üçin 0 belläň. | | `AIHUMMER_MEMORY_EXTRACT` | LLM arkaly fakt çykaryş | bool | `1` | Çig sözlem böleklerini saklamagyň ýerine LLM arkaly kadalaşdyrylan subýekt/predikat/obýekt faktlaryny çykar (adaty ýagdaýda AÇYK) — graf/garşylyk/dream mehanizmleriniň işlemegi üçin zerur. Her alnan habara bir LLM çagyryşyny goşýar; çagyryşy tygşytlamak üçin öçüriň. | | `AIHUMMER_MEMORY_RETRIEVAL` | Ýatdan çykaryş tertibi | enum: fulltext \\\| embedding | `fulltext` | Ýadyň nähili gözlenýändigi. fulltext (adaty) = fakt teksti boýunça Postgres doly tekst gözlegi — embedder modeli ÝOK, sidecar ýok, CPU ýüki ýok (AiHummer-däki köne einstein ýaly). embedding = embedder (AIHUMMER_EMBEDDER_URL/ollama) arkaly semantik wektor gözlegi — many boýunça has takyk, emma CPU-ny ýükleýär we sidecar talap edýär. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_MEMORY_TOKEN` | Uzakdaky ýat hyzmatynyň tokeny | text | — | Einstein Retrieval API-de awtorizasiýa üçin hyzmat tokeni (Authorization: Bearer … hökmünde ugradylýar). Diňe AIHUMMER_MEMORY_URL bellenende gerek. Boş = awtorizasiýasyz (diňe retrieval awtorizasiýasy öçürilen dev gurnamalary üçin). | | `AIHUMMER_MEMORY_URL` | Uzakdaky ýadyň URL-i (Einstein plugini) | text | — | Özbaşdak Einstein ýat plagininiň URL-i (kontrakt aihummer.memory.v1, mysal üçin http://127.0.0.1:8820). BOŞ (adaty) = prosesiň içindäki Go ýat moduly. Bellenende ädim kontekstiniň ýüklenmegi HTTP arkaly plagininiň /context + /retrieval salgylaryna gidýär; ýalňyşlyk/elýeterli däl ýagdaýynda ýumşak görnüşde içerki modula gaýdýar (ýykylmazdan). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_QDRANT_API_KEY` | Qdrant API açary | text | — | — | | `AIHUMMER_QDRANT_URL` | Qdrant URL-i (hemişelik wektor ammary) | text | — | BELLENMEDIK = ýatdaky ammar (wektorlar täzeden işledilende ÝITÝÄR). Önümçilikde ygtybarly saklamak üçin belläň. | | `AIHUMMER_RERANKER_URL` | RAG gaýtadan tertipleýji sidecar URL-i | text | — | Gibrid gözlegi täzeden tertipleşdirmek üçin cross-encoder sidecar-ynyň HTTP URL-i. Boş = täzeden tertipleşdirme öçük. Başlananda/täzeden işe goýberlenden soň ulanylýar. | ## Moderation | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_MODERATION` | Girýän moderasiýa | bool | `1` | \\"off\\" jailbreak/prompt-injection garşy içerki goragy öçürýär. Islendik başga baha = açyk. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_MODERATION_REFUSAL` | Moderasiýa ret ediş habary | text | — | Moderator soragy böwetlände gaýtarylýan ret ediş teksti (boş = içerki). Başlananda/täzeden işe goýberlenden soň ulanylýar. | ## Public access | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_PUBLIC_URL` | Derwezäniň açyk URL-i (Web UI + müşderiler) | text | — | Bu hosty derweze portuna → proksileň (AIHUMMER_GATEWAY_ADDR, adaty :8780). Web UI we iOS/web klientler tarapyndan ulanylýar. | | `POCKET_AGENT_GATEWAY_BASE_URL` | Pocket-agent derwezesiniň açyk URL-i | text | — | pocket-agent derwezesiniň portuna → proksileň (POCKET_AGENT_PORT, adaty 8080). Uzakdaky agent bu ýere bir gezeklik bilet bilen birigýär. | | `TELEGRAM_PUBLIC_URL` | Telegram webhookyň açyk URL-i | text | — | Diňe webhook tertibi üçin — telegram-connector portuna → proksileň (AIHUMMER_TELEGRAM_CONNECTOR_PORT, adaty 8091). Polling tertibi üçin boş goýuň (açyk URL gerek däl). | ## SSO (LDAP/AD) | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_LDAP_BASE_DN` | Ulanyjy gözleg esasy DN-i | text | — | Search root, e.g. OU=Users,DC=corp,DC=example. | | `AIHUMMER_LDAP_BIND_DN` | Hyzmat baglanyş DN-i | text | — | Başlangyç gözleg bind-i üçin ulanylýan hasap, mysal üçin CN=svc-aihummer,OU=Service,DC=corp,DC=example. Boş = anonim gözleg. | | `AIHUMMER_LDAP_DEFAULT_ROLE` | LDAP: Başlangyç rol (topar gabat gelmedi) | text | — | Hiç bir topar laýyklyga düşmedik ýagdaýynda berilýän rol. Boş = rol ýok. | | `AIHUMMER_LDAP_ENABLED` | LDAP/AD arkaly girişi işjeňleşdirmek | bool | `0` | Açyk bolanda admin girişleri katalog arkaly barlanýar. Bind paroly Secrets-de saklanýar (scope ldap, ady bind_password). | | `AIHUMMER_LDAP_GROUP_ATTR` | Topar atributy (başlangyç memberOf) | text | — | Ulanyjy ýazgysynda topar DN-lerini sanaýan atribut. Boş baha topar→rol laýyklygyny öçürýär. | | `AIHUMMER_LDAP_ROLE_MAPPINGS` | LDAP: Topar→rol laýyklyklary (JSON) | text | — | Topar DN-i (ýa-da ýönekeý CN) → rol JSON obýekti, mysal üçin {\\"CN=Admins,OU=Groups,DC=corp,DC=example\\":\\"admin\\",\\"Operators\\":\\"operator\\"}. | | `AIHUMMER_LDAP_SKIP_TLS_VERIFY` | TLS barlagyny geçmek (diňe laboratoriýa üçin, 1/0) | bool | `0` | Katalogyň şahadatnamasyny barlamagy öçürýär. Önümçilikde hiç haçan açmaň. | | `AIHUMMER_LDAP_URL` | Katalog URL-i | text | — | e.g. ldaps://ad.corp.example:636 (TLS) or ldap://dc1.corp.example:389. | | `AIHUMMER_LDAP_USER_ATTR` | Giriş atributy (başlangyç sAMAccountName) | text | — | Ulanyjynyň girizýän login-i bilen deňeşdirilýän LDAP/Active Directory atributy (adaty sAMAccountName; OpenLDAP üçin uid, UPN görnüşli girişler üçin userPrincipalName). | | `AIHUMMER_LDAP_USER_FILTER` | Ulanyjy gözleg süzgüji | text | — | Login üçin %s saklamaly. AD: (sAMAccountName=%s); OpenLDAP: (uid=%s). | ## SSO (OIDC) | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_OIDC_AUDIENCE` | OIDC audience | text | — | Garaşylýan `aud` claim-i — başga ynanýan tarap üçin çykarylan tokenleri ret etmek üçin ŞU serişdäniň audience-ini belläň. `aud` claim-i indi adaty ýagdaýda her tokende HÖKMANY (aud-syz token ret edilýär); bu bellenende aud ony hem saklamaly. Önümçilikde berk maslahat berilýär. | | `AIHUMMER_OIDC_ISSUER` | OIDC berijiniň URL-i | text | — | IdP-niň issuer-i (mysal üçin https://login.example.com). Bellenende OIDC JWT tassyklamasyny işjeňleşdirýär. | | `AIHUMMER_OIDC_JWKS_URL` | OIDC JWKS URL-i | text | — | Token gollaryny barlamak üçin ulanylýan JSON Web Key Set endpoint-i. | | `AIHUMMER_OIDC_TENANT_CLAIM` | OIDC-däki iş meýdany claim-i | text | — | Iş meýdanynyň belgisini göterýän JWT claim-i (mysal üçin tenant_id / org). | ## SSO (SAML) | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_SAML_DEFAULT_ROLE` | SAML: Başlangyç rol (topar gabat gelmedi) | text | — | Hiç bir tassyklanan baha laýyk gelmedik ýagdaýynda berilýän rol. Boş = rol ýok. | | `AIHUMMER_SAML_ENABLED` | SAML 2.0 SSO işjeňleşdirmek | bool | `0` | /saml/metadata, /saml/acs, /saml/login salgylaryny açýar. SP-niň hususy açary Secrets-de saklanýar (scope saml, ady sp_key). | | `AIHUMMER_SAML_ENTITY_ID` | SP entity ID | text | — | SP entity ID (boş bolsa adaty ýagdaýda ⟨root⟩/saml/metadata). | | `AIHUMMER_SAML_IDP_METADATA` | IdP metadata XML-i | text | — | IdP-ňiziň SAML metadata resminamasyny goýuň (Okta/Azure AD/ADFS). | | `AIHUMMER_SAML_ROLE_ATTRIBUTE` | Rol/topar atributy (başlangyç groups) | text | — | Topar/rol bahalaryny göterýän assertion atributy. | | `AIHUMMER_SAML_ROLE_MAPPINGS` | SAML: Topar→rol laýyklyklary (JSON) | text | — | Tassyklanan baha → rol JSON obýekti, mysal üçin {\\"AdminGroup\\":\\"admin\\",\\"Ops\\":\\"operator\\"}. | | `AIHUMMER_SAML_ROOT_URL` | SP kök URL-i | text | — | Bu derwezäniň daşyndan elýeterli esasy URL-i, mysal üçin https://app.example.com. ACS = ⟨root⟩/saml/acs. | | `AIHUMMER_SAML_SP_CERT` | SP şahadatnamasy (PEM) | text | — | SP-niň açyk gol şahadatnamasy (PEM). Oňa laýyk hususy açar Secrets-e ýerleşdirilýär (scope saml, ady sp_key). | ## Security | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_AIRGAPPED` | Izolirlenen tertip (air-gapped, 1/0) | bool | `0` | Modeliň dolandyrýan daşary çykyşyny açyk internete böwetleýär (diňe içerki/allowlist hostlar). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_AUDIT_RETENTION_DAYS` | Audit-žurnal saklaýyş (gün, 0=hemişelik) | int | `0` | Audit logunyň näçe gün saklanjakdygy; has könesi her gün pozulýar. 0/boş = hemişelik sakla. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_CODE_EXEC_ALLOW_HOST` | Hostda code_exec-e rugsat bermek (gum gutusy ÝOK) | bool | `0` | ⚠️ Kody sandbox-syz göni hostda ýerine ýetirmäge rugsat ber. Diňe ynamdar homelab üçin. AIHUMMER_CODE_EXEC_SANDBOX_IMAGE bellemek has howpsuzdyr. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_CORS_ORIGINS` | Rugsat berlen CORS originleri (otur bilen) | text | — | Rugsat berlen Origin-leriň otur bilen aýrylan sanawy. Boş = CORS gadagan (diňe same-origin). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_CSP` | Content-Security-Policy sözbaşysy (üýtgetmek) | text | — | CSP sözbaşysyny çalyşýar. Boş = howpsuz adaty baha. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_INBOUND_SECRET` | Konnektor→derweze umumy syry | text | — | Konnektor→derweze geçişini tassyklaýan umumy syr (konnektor tarapdaky baha bilen gabat gelmeli). Boş = gelýän endpoint TASSYKLAMASYZ. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_OPENAI_COMPAT_KEY` | OpenAI bilen laýyk giriş: statiki API açary | text | — | OpenAI bilen laýyk klientleriň derwezäniň içerki /v1 endpoint-inde (P8 home gateway) tassyklanmak üçin ulanýan durnukly açary. Boş = durnukly tassyklama öçük (şahsy açarlar galýar). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_OPENAI_COMPAT_WORKSPACE` | OpenAI bilen laýyk giriş: iş meýdançasynyň ID-si | text | — | Durnukly OpenAI-laýyk tassyklamanyň laýyk gelýän iş meýdanynyň ID-si. Boş = AIHUMMER_DEFAULT_WORKSPACE_ID. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_REQUIRE_2FA` | Operatorlar üçin 2FA talap etmek | bool | `0` | Operatorlar üçin ikinji faktory (TOTP/passkey) talap et. Açyk bolanda 2FA-sy ýok operatorlara girişde ony derrew sazlamak teklip edilýär (böwetlemezden, eýesiniň daşarda galmazlygy üçin). Şobada ulanylýar. | | `AIHUMMER_REQUIRE_SECURE` | Diňe howpsuz (HTTPS/WSS) birikmeleri kabul etmek | bool | `0` | Açyk bolanda adaty HTTP soraglary HTTPS-e gönükdirilýär (GET/HEAD üçin) ýa-da ret edilýär (403); operatoryň daşarda galmazlygy üçin localhost girişi hemişe açyk. TLS-i tamamlaýan ters proksiden gelýän X-Forwarded-Proto hasaba alynýar. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_TRUSTED_PROXIES` | Ynamdar ters proksi CIDR-leri (otur bilen) | text | — | Ynamdar ters proksi torlarynyň otur bilen aýrylan sanawy (CIDR, mysal üçin 10.0.0.0/8,192.168.0.0/16, ýa-da ýeke IP-ler). X-Forwarded-For sözbaşysy klientiň IP-sini kesgitlemek üçin (audit, IP allowlist, brute-force garşy goranyş) diňe ŞU salgylardan GELÝÄN soraglarda ulanylýar. Boş = DIŇE hakyky peer salgysyna ynan (XFF äsgerilmeýär, IP galplaşdyrmak mümkin däl). Şobada ulanylýar. | ## Tools | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_CODE_EXEC` | code_exec işjeňleşdirmek | bool | `0` | — | | `AIHUMMER_CODE_EXEC_INTERPRETERS` | Code-exec interpretatorlary (JSON) | text | — | JSON obýekti {language: path_to_binary}, mysal üçin {\\"python\\":\\"/usr/bin/python3\\"}. Boş = awtomatik kesgitleme. Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Code-exec gum gutusynyň şekili | text | — | code_exec-i üzňeleşdirmek üçin konteýner şekili (torsuz, diňe okalýan rootfs, çäkler). Boş = hostda ýerine ýetiriş (ynamdar gurşaw). Başlananda/täzeden işe goýberlenden soň ulanylýar. | | `AIHUMMER_DB_QUERY_DSN` | db_query üçin DSN (iň az hukukly, eýesi bolmadyk roly ulanyň — soraglar işjeň iş meýdany boýunça RLS bilen çäklendirilýär) | text | — | — | | `AIHUMMER_FS_ROOT` | Faýl ulgamy guralynyň köki | text | — | — | | `AIHUMMER_HTTP_ALLOWLIST` | http_request rugsat berlen salgylar sanawy | text | — | — | | `AIHUMMER_HTTP_AUTH_JSON` | http_request awtorizasiýasy (JSON) | text | — | — | | `AIHUMMER_MCP_SERVERS` | MCP serwerleri (JSON) | text | — | — | | `AIHUMMER_WEBFETCH_ALLOWLIST` | web_fetch rugsat berlen salgylar sanawy | text | — | — | ## Web UI (separate port) | Açar | Ady | Görnüşi | Başlangyç | Näme edýär | | --- | --- | --- | --- | --- | | `AIHUMMER_WEBUI_API_BASE` | Web UI ýüz tutýan API esasy URL-i | text | — | Aýratyn ýerleşdirilen SPA-nyň /v1/admin/* çagyryşlary üçin ýüz tutýan doly origin-i (mysal üçin https://api.example.com). Boş = ilki derwezäniň açyk URL-ine, soňra ýerli derweze salgysyna gaýdýar. Adminiň brauzerinden elýeterli bolmaly; API bu Web UI-niň origin-ine CORS arkaly rugsat bermeli (aşakda awtomatik goşulýar). | | `AIHUMMER_WEBUI_ENABLED` | Admin Web UI-ny öz portunda hödürlemek | bool | `1` | Adaty ýagdaýda açyk: admin SPA içerki interfeýse baglanyp bilýän aýratyn diňleýjiniň (AIHUMMER_WEBUI_ADDR) KÖKÜNDE berilýär. Esasy derweze porty API + pairing + WS + SSE saklaýar we /admin/ bermeýär. Web UI diňleýjisini bütinleý öçürmek üçin 0 belläň. | | `AIHUMMER_WEBUI_ORIGIN` | Web UI brauzer origini (CORS) | text | — | Web UI-niň brauzer Origin-i (mysal üçin https://admin.example.com), giriş maglumatlary bilen API-niň CORS allowlist-ine awtomatik goşulýar. Boş = AIHUMMER_WEBUI_ADDR-den çykarylýar (http://host:port). Brauzer Web UI-ä baglanyş salgysyndan başga proksi/host ady arkaly ýüz tutanda muny belläň. | Operatora elýeterli sazlamalar: 138.