Parametrlər arayışı

Burada operatorun AiHummer serverində dəyişə biləcəyi bütün parametrlər sadalanır. Səhifə məhsulun öz kataloqundan yığılır, ona görə də sizin serverinizlə üst-üstə düşür. Dəyər veb-interfeysdə və ya `aihummer settings set KEY VALUE` əmri ilə verilir ([Əmr sətri](/az/v1.0/reference/cli)). Susmaya görə dəyər sütunu, öz dəyəriniz verilənədək serverin istifadə etdiyini göstərir. > [!NOTE] > Gizli dəyərlər burada çap olunmur, təchizatçının xidməti açarları isə ümumiyyətlə sadalanmır — məhsul onları bütün siyahılardan gizlədir. Tire boş dəyəri və ya yalnız veb-interfeysdə göstərilən izahı bildirir. ## API | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_PERSONAL_API_KEYS` | OpenAI-uyğun üçün şəxsi API açarları | bool | `1` | \\"off\\" OpenAI ilə uyğun endpoint-də şəxsi açarlarla autentifikasiyanı söndürür. İstənilən digər dəyər = aktiv. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | ## Agent | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_APPROVAL_TOOLS` | Təsdiq tələb edən alətlər | text | — | — | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | Subagentin maksimum dərinliyi | int | `2` | — | | `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | Subagent taymauti (saniyə) | int | `180` | Bir subagent işə salınmasının maksimum vaxtı, saniyə ilə. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_TOOL_SEARCH` | Alətlərin tənbəl yüklənməsi (tool_search) | bool | `false` | Yalnız əsas alətləri və axtarış meta-alətini göstər, qalanlarını tələb üzrə aç. Çoxlu alət quraşdırıldıqda gedişləri sürətləndirir və xərci azaldır; modelin nadir aləti gözdən qaçırması riski kiçikdir. | | `AIHUMMER_TOOL_SEARCH_CORE` | Tənbəl yükləmə: həmişə aktiv alətlər | text | — | Tənbəl rejimdə belə dərhal göstərilən alət adlarının vergüllə ayrılmış siyahısı. | | `AIHUMMER_TOOL_SEARCH_THRESHOLD` | Tənbəl yükləmə: təxirə salmaq üçün minimum alət sayı | int | `12` | Yalnız agentin profil filtrindən sonra bu saydan çox alət qaldıqda təxirə sal. | ## Agent · Reasoning | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_BEST_OF_N` | Best-of-N nümunə sayı (0/1=söndürülüb, ≥2=aktiv) | int | `0` | ≥2 olduqda N namizəd seçilir və ən yaxşısı hakim tərəfindən müəyyən edilir. N× generasiyaya başa gəlir. | | `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | Debat: hakim promptu (əvəzləmə) | text | — | Debat hakiminin promptunu əvəz edir (boş = daxili). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_AGENT_DEBATE_N` | Debat paneli ölçüsü (0/1=söndürülüb, ≥2=aktiv) | int | `0` | ≥2 olduqda N namizəddən ibarət debat paneli + hakim işə düşür. N× generasiyaya başa gəlir. | | `AIHUMMER_AGENT_DEBATE_PROMPT` | Debat: namizəd promptu (əvəzləmə) | text | — | Debat namizədinin promptunu əvəz edir (boş = daxili). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_AGENT_DEBATE_ROUNDS` | Debat: raundlar | int | `1` | Namizəd paneli üçün debat raundlarının sayı. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_AGENT_JUDGE_PROMPT` | Best-of-N hakim promptu (əvəzləmə) | text | — | best-of-N hakiminin promptunu əvəz edir (boş = daxili). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_AGENT_PLAN_PROMPT` | Planlayıcı promptu (əvəzləmə) | text | — | Planlaşdırıcının promptunu əvəz edir (boş = daxili). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_AGENT_PLAN_STEPS` | Planlayıcı-icraçı: maksimum plan addımı (0=söndürülüb) | int | `0` | ⟩0 ayrıca planlaşdırıcı→icraçı→sintez keçidini işə salır (mürəkkəb çoxaddımlı tapşırıqlar üçün faydalıdır). 0 = söndürülüb. Adətən 4–8. | | `AIHUMMER_AGENT_PLAN_STEP_ITERS` | Planlayıcı: addım başına alət iterasiyası (0=defolt) | int | `0` | Plan addımına düşən alət çağırışı iterasiyalarını məhdudlaşdırır. 0 = daxili standart dəyər (4). | | `AIHUMMER_AGENT_REFLECT` | Öz-özünü tənqid keçidi | bool | `0` | Yekun cavabdan əvvəl refleksiya/öz-özünə tənqid keçidi əlavə edir. | | `AIHUMMER_AGENT_REFLECT_PROMPT` | Refleksiya promptu (əvəzləmə) | text | — | Öz-özünə tənqid promptunu əvəz edir (boş = daxili). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_AGENT_SELF_HEAL` | Öz-özünü bərpa: alət xətalarında təkrar cəhdlər (0=söndürülüb) | int | `0` | ⟩0 olduqda uğursuz alət çağırışları düzəldici işarə ilə bu həddə qədər təkrarlanır. | ## Agent · System prompt | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_LOCALE` | Defolt lokal | text | `ru-RU` | Standart cavab dili/lokalı, məs. ru-RU. Persona/operator təlimatları üstünlük təşkil edir. | | `AIHUMMER_TIMEZONE` | Saat qurşağı | text | `UTC` | Tarixin əlavə olunması üçün IANA saat qurşağı, məs. Europe/Moscow. Standart UTC. | ## Channels | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_CONFIDENTIAL_PERSONA` | Konfidensial veb-persona | bool | `0` | Aktiv olduqda veb-çat agenti öz persona/şəxsiyyət detallarını açıqlamır və saxlamır, cavablarını isə yalnız cari tapşırıqla məhdudlaşdırır — anonim və ya məxfiliyə həssas veb yerləşdirmələr üçün. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_INBOUND_REQUIRE_BINDING` | Yalnız qeydiyyatdan keçmiş istifadəçilərə cavab ver | text | `true` | true = bot kanalda AiHummer istifadəçisi OLMAYAN (rol bağlantısı olan istifadəçi) hər hansı göndərəni nəzərə almır — təsadüfi çat iştirakçıları və qonaq çağırışları cavab almır. false (standart) = hamıya cavab ver. | ## Integrations | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_A2A_PUBLISH` | Agenti Agent2Agent (A2A) vasitəsilə dərc et | bool | `0` | Agenti A2A serveri kimi dərc et (Agent Card + POST /a2a/message). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_MCP_EXPORT_TOOLS` | — | text | — | — | | `AIHUMMER_MCP_PUBLISH` | Alətləri MCP vasitəsilə dərc et | bool | `0` | Alətləri POST /v1/mcp ünvanında MCP serveri kimi dərc et. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | ## Knowledge connectors | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_KB_SYNC_INTERVAL` | Planlaşdırılmış konnektor yenidən sinxronizasiya intervalı (0/boş = söndürülüb) | text | — | Bütün iş sahələrində qurulmuş hər bilik konnektorunun fonda avtomatik yenidən sinxronizasiyası üçün müddət (məs. 6h, 30m). Boş/0 = söndürülüb. Yenidən sinxronizasiya idempotentdir (mənbəyə görə əvəzləmə, dublikatsız). slack_export daxil deyil (onun zip faylı əl ilə yüklənir). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | ## LLM | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_CASCADE_MIN_CHARS` | Kaskad: eskalasiya üçün minimum simvol | int | `0` | Güclü kaskad modelinin qoşulduğu sorğu uzunluğu həddi (simvol). 0 = standart. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_CASCADE_STRONG_MODEL` | Kaskad: daha güclü ehtiyat model | text | — | Uzun/mürəkkəb sorğular üçün kaskadla keçilən model (boş = söndürülüb). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_CODEX_BASE_URL` | Codex baza URL-i | text | — | Codex (ChatGPT abunəliyi) nəqliyyatının bazası. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_CODEX_MAX_OUTPUT_TOKENS` | Maksimum çıxış tokenləri (0 = limit yoxdur) | int | `0` | Çat gedişi üçün max_output_tokens həddi. 0 = hədd yoxdur. Reasoning modellərində düşüncə tokenləri də bu büdcəyə daxildir, ona görə çox kiçik dəyər boş «incomplete: max_output_tokens» cavabı verir. Dərhal tətbiq olunur (yenidən başlatma tələb olunmur). | | `AIHUMMER_CODEX_MODEL` | Model id-si (Codex / gpt-5.5 nəqli) | text | `gpt-5.5` | Əsas Codex/ChatGPT nəqliyyatının model identifikatoru (məs. gpt-5.5, gpt-5.5-codex). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_CODEX_REASONING_EFFORT` | Mühakimə səyi | enum: none \\\| low \\\| medium \\\| high \\\| xhigh | `low` | Agentin parametrləri təyin etmədikdə çat gedişləri üçün modelin düşünmə dərinliyi. gpt-5.5 üçün etibarlı dəyərlər: none, low, medium, high, xhigh (minimal YOX — gpt-5.5 onu HTTP 400 ilə rədd edir). Yüksək = daha keyfiyyətli, lakin daha yavaş/bahalı. Yanlış dəyər təhlükəsiz şəkildə low-a çevrilir. Dərhal tətbiq olunur (yenidən başlatma tələb olunmur). | | `AIHUMMER_LLM_CALL_TIMEOUT_S` | Hər çağırış üçün taymaut (saniyə) | int | `120` | TƏK bir model çağırışı üçün vaxt büdcəsi (anti-stall: gpt-5.5 sonsuz «düşünə» və gedişi açıq saxlaya bilər). Vaxt bitdikdə çağırış təkrarsız ErrCallTimeout xətası ilə bitir. 0 = limitsiz. Dərhal tətbiq olunur (yenidən başlatma tələb olunmur). | | `AIHUMMER_LLM_GATEWAY_URL` | LLM şlüzünün URL-i | text | — | Agentin müraciət etdiyi OpenAI ilə uyğun model endpoint-inin baza URL-i (lokal llama.cpp/vLLM/Ollama serveriniz və ya hostinqdə olan şlüz). Provayderin standart endpoint-ini istifadə etmək üçün boş buraxın. | | `AIHUMMER_LLM_MODEL` | LLM modeli | text | — | Hər gedişdə provaydere göndərilən modelin adı/identifikatoru (endpoint-inizin verdiyi model). Endpoint-in real olaraq təqdim etdiyi modelə uyğun olmalıdır. | | `AIHUMMER_LLM_PROVIDER` | LLM provayderi | text | — | Hansı model backend-inin istifadə olunacağı (OpenAI ilə uyğun endpoint və ya Codex/ChatGPT abunəlik nəqliyyatı). Sorğuların necə göndərildiyini və autentifikasiya olunduğunu müəyyən edir. | | `AIHUMMER_LLM_RETRIES` | Müvəqqəti xətada LLM təkrar cəhdləri | int | `3` | Müvəqqəti xəta zamanı LLM sorğusunun təkrar sayı. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_LLM_TEMPERATURE` | Temperatur | text | — | Agentin parametrləri təyin etmədikdə seçmə temperaturu (0..2). Boş = göndərmə. QEYD: gpt-5.5 reasoning modelləri (Codex) temperature-u rədd edir — onlar üçün sahəni boş buraxın; yalnız reasoning olmayan backend istifadə edərkən təyin edin. Dərhal tətbiq olunur (yenidən başlatma tələb olunmur). | | `AIHUMMER_LLM_TOP_P` | Top-p (nüvə seçimi) | text | — | Agentin parametrləri təyin etmədikdə nucleus-sampling həddi (0..1). Boş = göndərmə. temperature kimi, gpt-5.5 reasoning bunu da rədd edir — yalnız reasoning olmayan backend-lər üçün təyin edin. Dərhal tətbiq olunur (yenidən başlatma tələb olunmur). | | `AIHUMMER_OPENAI_API` | OpenAI API stili (chat \| responses) | enum: \\\| chat \\\| responses | — | chat = /chat/completions, responses = /responses. Boş = avto/standart. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_OPENAI_API_KEY` | Nativ OpenAI API açarı (quraşdırma üçün defolt) | text | — | Nativ OpenAI dövrü üçün OpenAI hesabınızın açarı (OpenAI-ni standart provayder kimi istifadə edirsinizsə). «Modellər» səhifəsindəki iş sahəsi üzrə BYOK ilə qarışdırmayın. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_OPENAI_BASE_URL` | Nativ OpenAI baza URL-i | text | — | OpenAI ilə uyğun API-nin bazası (məs. https://api.openai.com/v1). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_OPENAI_MODEL` | Nativ OpenAI modeli | text | — | Nativ OpenAI dövrü üçün model (AIHUMMER_OPENAI_API_KEY təyin edildikdə). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_ROUTER_COMPLEX_MODEL` | Router: mürəkkəb sorğular üçün model | text | — | Mürəkkəb sorğular üçün model (boş = zolaq söndürülüb). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_ROUTER_SIMPLE_MODEL` | Router: sadə sorğular üçün model | text | — | Sadə sorğular üçün model (boş = zolaq söndürülüb). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_ROUTER_STANDARD_MODEL` | Router: standart sorğular üçün model | text | — | Adi sorğular üçün model (boş = zolaq söndürülüb). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | ## Media | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_DEEPGRAM_API_KEY` | Deepgram API açarı | text | — | Deepgram API açarı (STT mühərriki = deepgram). Buradan və ya AIHUMMER_STT_API_KEY-dən götürülür. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_DEEPGRAM_MODEL` | Deepgram modeli | text | `nova-2` | Deepgram modeli (məs. nova-2, nova-3, base). Açar üzrə layihənin girişindən asılıdır. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_DEEPGRAM_URL` | Deepgram baza URL-i | text | — | Deepgram API bazası. Boş = https://api.deepgram.com. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_IMAGE_BASE_URL` | Şəkil API baza URL-i (ehtiyat OpenAI) | text | — | OpenAI açarı ilə işlədikdə /images API-nin bazası (boş = https://api.openai.com/v1). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_IMAGE_MODEL` | Şəkil generasiyası modeli | text | — | image_generate üçün model (standart gpt-image-2). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_MEDIA_MAX_UPLOAD_MB` | Medianın maksimum yükləmə ölçüsü (MB) | int | `256` | Bir media yükləməsinin maksimum həcmi (PUT /v1/media/{id}/content), meqabaytla. Açıq port vasitəsilə diskə yazmanı məhdudlaşdırır (daşmadan qorunma). Standart 256. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_STT_API_KEY` | STT API açarı (istəyə bağlı) | text | — | STT sidecar-ı tələb edərsə, istəyə bağlı bearer (install.sh onu yarada bilər). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_STT_CODEX_URL` | STT codex-engine URL-i | text | — | codex mühərriki üçün OpenAI ilə uyğun /v1/audio/transcriptions bazası (ChatGPT abunəliyi ilə transkripsiya). Boş = Codex bazası. Bearer AIHUMMER_STT_API_KEY və ya AIHUMMER_CODEX_ACCESS_TOKEN-dən götürülür. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_STT_ENGINE` | STT mühərriki | enum: faster-whisper \\\| deepgram \\\| off | `faster-whisper` | Nitq tanıma mühərriki. faster-whisper = pulsuz lokal sidecar (standart, qutudan çıxan kimi işləyir, URL = AIHUMMER_STT_URL, üçüncü tərəf API-lərinə yük yoxdur). deepgram = bulud Deepgram (sürətli, açar AIHUMMER_DEEPGRAM_API_KEY, pulsuz həcmi olan ödənişli). off = tanıma söndürülüb. (Codex/ChatGPT abunəliyi audio transkripsiyanı DƏSTƏKLƏMİR.) Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_STT_LANGUAGE` | STT dili | text | — | Tanıma dili (BCP-47, məs. ru/en). deepgram mühərriki (nova-2 modeli) tərəfindən istifadə olunur. Boş = avtomatik aşkarlama / mühərrikin standartı. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_STT_MODEL` | STT modeli | text | `Systran/faster-whisper-small` | faster-whisper modeli (məs. small/medium/large-v3 və ya Systran/faster-whisper-⟨size⟩). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_STT_URL` | Nitqdən mətnə (faster-whisper) URL-i | text | — | Lokal faster-whisper sidecar-ının URL-i (OpenAI ilə uyğun /v1/audio/transcriptions). Boş = avtomatik standart http://127.0.0.1:8001, install.sh onu özü təyin edir. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_TTS_API_KEY` | TTS API açarı (edge-tts) | text | — | Şlüzlə edge-tts sidecar-ı arasındakı bearer (install.sh onu avtomatik yaradır). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_TTS_ENABLED` | Mətndən nitqə aktivdir | bool | `1` | Nitq sintezini aktivləşdirir (tts aləti + səs rejimi). edge-tts sidecar-ı qutudan çıxan kimi gəlir. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_TTS_MODEL` | TTS modeli | text | — | edge-tts xidməti üçün modelin adı. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_TTS_URL` | Mətndən nitqə (edge-tts) URL-i | text | — | Lokal edge-tts sidecar-ının URL-i (OpenAI ilə uyğun /v1/audio/speech). Boş = avtomatik standart http://127.0.0.1:8002, install.sh onu özü təyin edir. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_TTS_VOICE` | TTS səsi (defolt de-DE-FlorianMultilingualNeural) | text | `de-DE-FlorianMultilingualNeural` | Standart edge-tts səsi (çoxdilli, o cümlədən rus dili). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_VIDEO_API_KEY` | Video analizi API açarı | text | — | Video təhlili sidecar-ına giriş açarı (tələb olunarsa). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_VIDEO_URL` | Video analizi (ffmpeg) URL-i | text | — | Video təhlili sidecar-ının URL-i. Boş = söndürülüb. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | ## Media · Voice | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_VOICE_AEC` | Əks-səda ləğvi (AEC) | bool | `1` | Səs yazılışında echoCancellation tələb et (WebRTC). TTS-in mikrofona düşən əks-sədasını aradan qaldırır (Moltis #1129). | | `AIHUMMER_VOICE_AGC` | Avtomatik gücləndirmə tənzimləməsi | bool | `1` | — | | `AIHUMMER_VOICE_BARGEIN_FRAMES` | Kəsmə (barge-in) kadrları | int | `5` | Botun səsləndirməsini neçə ardıcıl səsli kadrın (≈20ms) kəsdiyi. | | `AIHUMMER_VOICE_DUPLEX` | Canlı tam-dupleks səs | bool | `0` | Canlı tam dupleks rejimini aktivləşdirir (strimləmə + VAD + barge-in). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_VOICE_NOISE_SUPPRESSION` | Küy azaldılması | bool | `1` | — | | `AIHUMMER_VOICE_VAD_THRESHOLD` | VAD enerji həddi (0..1) | text | `0.02` | Səs yazılışının VAD ilə idarəsi üçün nitq enerjisi həddi; aşağı = daha həssas. | ## Memory | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_EMBEDDER_DIM` | Embedder vektor ölçüsü | int | `768` | Vektorun ölçüsü — modelə uyğun olmalıdır (multilingual-e5-base=768, bge-m3=1024). | | `AIHUMMER_EMBEDDER_KEEPALIVE` | Embedder keep-alive | text | `5m` | Ollama embedder-i üçün keep_alive (yalnız AIHUMMER_MEMORY_RETRIEVAL=embedding olduqda). Standart 5m — boşdayan model yaddaşdan çıxarılır, ilişib qalmış boşdayan ollama runner-i özü təmizlənir. -1 (həmişə saxla) TÖVSİYƏ OLUNMUR: ollama-dakı səhv ucbatından ilişmiş runner günlərlə CPU nüvəsini yükləyə bilər. Boşdayandan sonrakı soyuq start şlüzün başlanğıcındakı qızdırma ilə kompensasiya olunur. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_EMBEDDER_MODEL` | Embedder modeli | text | `yxchia/multilingual-e5-base` | Ollama embedding modeli. Standart multilingual-e5-base — çoxdilli (o cümlədən rus dili), 768 ölçülü, CPU-da yüngül və sürətli (~1-2 san./embedding). e5 üçün query/passage prefiksləri avtomatik tətbiq olunur. GPU avadanlığında maksimum keyfiyyət üçün bge-m3 istifadə edin (DIM=1024 təyin edin). AIHUMMER_EMBEDDER_DIM ilə uyğun olmalıdır. | | `AIHUMMER_EMBEDDER_PASSAGE_PREFIX` | Embedder mətn prefiksi | text | — | Saxlanan sənədin prefiksini əvəz et (e5 modelləri avtomatik \\"passage: \\" istifadə edir). Model adına görə avtomatik aşkarlama üçün boş buraxın. | | `AIHUMMER_EMBEDDER_QUERY_PREFIX` | Embedder sorğu prefiksi | text | — | Axtarış sorğusunun prefiksini əvəz et (e5 modelləri avtomatik \\"query: \\" istifadə edir). Model adına görə avtomatik aşkarlama üçün boş buraxın. | | `AIHUMMER_EMBEDDER_URL` | Embedder URL-i (Ollama ilə uyğun) | text | — | Əsl semantik embedding-lər. Quraşdırıcı Ollama sidecar-ını yerləşdirir və bunu avtomatik təyin edir; TƏYİN EDİLMƏYİB = hash embedder (yalnız leksik, zəif tapılma). | | `AIHUMMER_MEMORY_CAPTURE` | Yaddaş toplama rejimi | enum: auto \\\| review \\\| off | `auto` | auto = avtomatik yadda saxla və xatırla; review = əl ilə təsdiq tələb edən namizədlər kimi saxla; off = toplama yoxdur. | | `AIHUMMER_MEMORY_CONTEXT_TIMEOUT` | Yaddaş hidratasiya taymauti | text | `3s` | Cavabın əvvəlində yaddaşın yüklənməsi üçün maksimum gözləmə (sorğunun embedding-i + axtarış). Embedder yüklüdürsə və vaxta çatmırsa, cavab asılı qalmaq əvəzinə yaddaş bloku OLMADAN davam edir. Go duration formatı (məs. 2s, 1500ms). 0 = limitsiz. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_MEMORY_DREAM_INTERVAL` | «Yuxu» keçidi intervalı | string | `1h` | Özünə xidmət edən dream keçidinin bütün sahələrdə yoxlanmış iddiaları ziddiyyətlərə görə nə qədər tez-tez skan etməsi (Go duration, məs. 30m/1h/6h). Söndürmək üçün 0 təyin edin. | | `AIHUMMER_MEMORY_EXTRACT` | LLM ilə fakt çıxarma | bool | `1` | Xam cümlə fraqmentlərini saxlamaq əvəzinə LLM vasitəsilə normallaşdırılmış subyekt/predikat/obyekt faktlarını çıxar (standart olaraq AÇIQ) — qraf/ziddiyyət/dream mexanizmlərinin işləməsi üçün vacibdir. Hər toplanan mesaja bir LLM çağırışı əlavə edir; çağırışa qənaət etmək üçün söndürün. | | `AIHUMMER_MEMORY_RETRIEVAL` | Yaddaş çıxarma rejimi | enum: fulltext \\\| embedding | `fulltext` | Yaddaşın necə axtarılması. fulltext (standart) = fakt mətni üzrə Postgres tammətnli axtarış — embedder modeli YOX, sidecar yox, CPU yükü yox (AiHummer-dəki köhnə einstein kimi). embedding = embedder (AIHUMMER_EMBEDDER_URL/ollama) vasitəsilə semantik vektor axtarışı — məna üzrə daha dəqiqdir, lakin CPU-nu yükləyir və sidecar tələb edir. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_MEMORY_TOKEN` | Uzaq yaddaş xidmət tokeni | text | — | Einstein Retrieval API-də avtorizasiya üçün xidmət tokeni (Authorization: Bearer … kimi göndərilir). Yalnız AIHUMMER_MEMORY_URL təyin edildikdə lazımdır. Boş = avtorizasiyasız (yalnız retrieval avtorizasiyası söndürülmüş dev quraşdırmaları üçün). | | `AIHUMMER_MEMORY_URL` | Uzaq yaddaş URL-i (Einstein plaqini) | text | — | Müstəqil Einstein yaddaş plagininin URL-i (kontrakt aihummer.memory.v1, məs. http://127.0.0.1:8820). BOŞ (standart) = prosesdaxili Go yaddaş modulu. Təyin edildikdə gediş kontekstinin yüklənməsi HTTP ilə plaginin /context + /retrieval ünvanlarına gedir; xəta/əlçatmazlıq halında yumşaq şəkildə daxili modula qayıdır (çökmə olmadan). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_QDRANT_API_KEY` | Qdrant API açarı | text | — | — | | `AIHUMMER_QDRANT_URL` | Qdrant URL-i (davamlı vektor anbarı) | text | — | TƏYİN EDİLMƏYİB = yaddaşdaxili anbar (vektorlar yenidən başladıldıqda İTİR). Produksiyada davamlı saxlama üçün təyin edin. | | `AIHUMMER_RERANKER_URL` | RAG yenidən sıralama sidecar URL-i | text | — | Hibrid axtarışın yenidən sıralanması üçün cross-encoder sidecar-ının HTTP URL-i. Boş = yenidən sıralama söndürülüb. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | ## Moderation | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_MODERATION` | Daxil olan moderasiya | bool | `1` | \\"off\\" jailbreak/prompt-injection-ə qarşı daxili qorumanı söndürür. İstənilən digər dəyər = aktiv. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_MODERATION_REFUSAL` | Moderasiya imtina mesajı | text | — | Moderator sorğunu blokladıqda qaytarılan imtina mətni (boş = daxili). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | ## Public access | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_PUBLIC_URL` | Şlüzün açıq URL-i (Web UI + klientlər) | text | — | Bu hostu şlüzün portuna → proksiləyin (AIHUMMER_GATEWAY_ADDR, standart :8780). Web UI və iOS/veb klientlər tərəfindən istifadə olunur. | | `POCKET_AGENT_GATEWAY_BASE_URL` | Pocket-agent şlüzünün açıq URL-i | text | — | pocket-agent şlüzünün portuna → proksiləyin (POCKET_AGENT_PORT, standart 8080). Uzaq agent bura birdəfəlik bilet ilə qoşulur. | | `TELEGRAM_PUBLIC_URL` | Telegram vebhuk açıq URL-i | text | — | Yalnız webhook rejimi üçün — telegram-connector portuna → proksiləyin (AIHUMMER_TELEGRAM_CONNECTOR_PORT, standart 8091). Polling rejimi üçün boş buraxın (açıq URL lazım deyil). | ## SSO (LDAP/AD) | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_LDAP_BASE_DN` | İstifadəçi axtarışı üçün baza DN | text | — | Search root, e.g. OU=Users,DC=corp,DC=example. | | `AIHUMMER_LDAP_BIND_DN` | Xidmət bind DN | text | — | İlkin axtarış bind-i üçün istifadə olunan hesab, məs. CN=svc-aihummer,OU=Service,DC=corp,DC=example. Boş = anonim axtarış. | | `AIHUMMER_LDAP_DEFAULT_ROLE` | LDAP: Defolt rol (qrup uyğunluğu yoxdur) | text | — | Heç bir qrup uyğunlaşmaya düşmədikdə verilən rol. Boş = rol yoxdur. | | `AIHUMMER_LDAP_ENABLED` | LDAP/AD ilə girişi aktivləşdir | bool | `0` | Aktiv olduqda admin girişləri kataloqa keçir. Bind parolu Secrets-də saxlanılır (scope ldap, ad bind_password). | | `AIHUMMER_LDAP_GROUP_ATTR` | Qrup atributu (defolt memberOf) | text | — | İstifadəçi yazısında qrup DN-lərini sadalayan atribut. Boş dəyər qrup→rol uyğunlaşdırmasını söndürür. | | `AIHUMMER_LDAP_ROLE_MAPPINGS` | LDAP: Qrup→rol uyğunlaşdırmaları (JSON) | text | — | Qrup DN-i (və ya sadə CN) → rol JSON obyekti, məs. {\\"CN=Admins,OU=Groups,DC=corp,DC=example\\":\\"admin\\",\\"Operators\\":\\"operator\\"}. | | `AIHUMMER_LDAP_SKIP_TLS_VERIFY` | TLS yoxlamasını ötür (yalnız laboratoriya üçün, 1/0) | bool | `0` | Kataloq sertifikatının yoxlanışını söndürür. Produksiyada heç vaxt aktivləşdirməyin. | | `AIHUMMER_LDAP_URL` | Kataloq URL-i | text | — | e.g. ldaps://ad.corp.example:636 (TLS) or ldap://dc1.corp.example:389. | | `AIHUMMER_LDAP_USER_ATTR` | Giriş atributu (defolt sAMAccountName) | text | — | İstifadəçinin daxil etdiyi loginlə tutuşdurulan LDAP/Active Directory atributu (standart sAMAccountName; OpenLDAP üçün uid, UPN tipli girişlər üçün userPrincipalName). | | `AIHUMMER_LDAP_USER_FILTER` | İstifadəçi axtarış filtri | text | — | Login üçün %s saxlamalıdır. AD: (sAMAccountName=%s); OpenLDAP: (uid=%s). | ## SSO (OIDC) | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_OIDC_AUDIENCE` | OIDC audience | text | — | Gözlənilən `aud` claim-i — başqa etibar edən tərəf üçün buraxılmış tokenləri rədd etmək üçün BU resursun audience-ini təyin edin. `aud` claim-i artıq standart olaraq hər tokendə MƏCBURİDİR (aud olmayan token rədd edilir); bu təyin edildikdə aud onu da saxlamalıdır. Produksiyada güclü şəkildə tövsiyə olunur. | | `AIHUMMER_OIDC_ISSUER` | OIDC issuer URL-i | text | — | IdP-nin issuer-i (məs. https://login.example.com). Təyin edildikdə OIDC JWT autentifikasiyasını aktivləşdirir. | | `AIHUMMER_OIDC_JWKS_URL` | OIDC JWKS URL-i | text | — | Token imzalarını yoxlamaq üçün istifadə olunan JSON Web Key Set endpoint-i. | | `AIHUMMER_OIDC_TENANT_CLAIM` | OIDC-də iş sahəsi claim-i | text | — | İş sahəsinin identifikatorunu daşıyan JWT claim-i (məs. tenant_id / org). | ## SSO (SAML) | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_SAML_DEFAULT_ROLE` | SAML: Defolt rol (qrup uyğunluğu yoxdur) | text | — | Heç bir təsdiq edilmiş dəyər uyğunlaşmadıqda verilən rol. Boş = rol yoxdur. | | `AIHUMMER_SAML_ENABLED` | SAML 2.0 SSO-nu aktivləşdir | bool | `0` | /saml/metadata, /saml/acs, /saml/login ünvanlarını açır. SP-nin şəxsi açarı Secrets-də saxlanılır (scope saml, ad sp_key). | | `AIHUMMER_SAML_ENTITY_ID` | SP entity ID | text | — | SP entity ID (boş olduqda standart olaraq ⟨root⟩/saml/metadata). | | `AIHUMMER_SAML_IDP_METADATA` | IdP metadata XML-i | text | — | IdP-nizin SAML metadata sənədini yapışdırın (Okta/Azure AD/ADFS). | | `AIHUMMER_SAML_ROLE_ATTRIBUTE` | Rol/qrup atributu (defolt groups) | text | — | Qrup/rol dəyərlərini daşıyan assertion atributu. | | `AIHUMMER_SAML_ROLE_MAPPINGS` | SAML: Qrup→rol uyğunlaşdırmaları (JSON) | text | — | Təsdiq edilmiş dəyər → rol JSON obyekti, məs. {\\"AdminGroup\\":\\"admin\\",\\"Ops\\":\\"operator\\"}. | | `AIHUMMER_SAML_ROOT_URL` | SP kök URL-i | text | — | Bu şlüzün xaricdən əlçatan baza URL-i, məs. https://app.example.com. ACS = ⟨root⟩/saml/acs. | | `AIHUMMER_SAML_SP_CERT` | SP sertifikatı (PEM) | text | — | SP-nin açıq imza sertifikatı (PEM). Ona uyğun şəxsi açar Secrets-ə yerləşdirilir (scope saml, ad sp_key). | ## Security | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_AIRGAPPED` | İzolyasiya edilmiş rejim (air-gapped, 1/0) | bool | `0` | Model tərəfindən idarə olunan çıxışı açıq internetə bloklayır (yalnız daxili/allowlist hostlar). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_AUDIT_RETENTION_DAYS` | Audit-jurnalının saxlanması (gün, 0=əbədi) | int | `0` | Audit logunun neçə gün saxlanacağı; daha köhnə yazılar hər gün silinir. 0/boş = həmişəlik saxla. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_CODE_EXEC_ALLOW_HOST` | code_exec-ə hostda icazə ver (sandbox OLMADAN) | bool | `0` | ⚠️ Kodun sandbox olmadan birbaşa hostda icrasına icazə ver. Yalnız etibarlı homelab üçün. AIHUMMER_CODE_EXEC_SANDBOX_IMAGE təyin etmək daha təhlükəsizdir. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_CORS_ORIGINS` | İcazəli CORS origin-lər (vergüllə) | text | — | İcazə verilən Origin-lərin vergüllə ayrılmış siyahısı. Boş = CORS qadağandır (yalnız same-origin). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_CSP` | Content-Security-Policy başlığı (əvəzləmə) | text | — | CSP başlığını əvəz edir. Boş = təhlükəsiz standart dəyər. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_INBOUND_SECRET` | Konnektor→şlüz ortaq sirri | text | — | Konnektor→şlüz keçidini autentifikasiya edən ümumi sirr (konnektor tərəfindəki dəyərlə üst-üstə düşməlidir). Boş = daxil olan endpoint AUTENTİFİKASİYASIZDIR. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_OPENAI_COMPAT_KEY` | OpenAI-uyğun daxil olan: statik API açarı | text | — | OpenAI ilə uyğun klientlərin şlüzün daxili /v1 endpoint-ində (P8 home gateway) autentifikasiya üçün istifadə etdiyi statik açar. Boş = statik autentifikasiya söndürülüb (şəxsi açarlar qalır). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_OPENAI_COMPAT_WORKSPACE` | OpenAI-uyğun daxil olan: iş sahəsi ID-si | text | — | Statik OpenAI-uyğun autentifikasiyanın uyğunlaşdırıldığı iş sahəsinin ID-si. Boş = AIHUMMER_DEFAULT_WORKSPACE_ID. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_REQUIRE_2FA` | Operatorlar üçün 2FA tələb et | bool | `0` | Operatorlar üçün ikinci faktor (TOTP/passkey) tələb et. Aktiv olduqda 2FA-sı olmayan operatorlara girişdə dərhal onu qurmaq təklif olunur (bloklamadan, sahibin bayırda qalmaması üçün). Dərhal tətbiq olunur. | | `AIHUMMER_REQUIRE_SECURE` | Yalnız təhlükəsiz (HTTPS/WSS) bağlantıları qəbul et | bool | `0` | Aktiv olduqda adi HTTP sorğuları HTTPS-ə yönləndirilir (GET/HEAD üçün) və ya rədd edilir (403); operatorun bayırda qalmaması üçün localhost girişi həmişə açıqdır. TLS-i sonlandıran reverse proksidən gələn X-Forwarded-Proto nəzərə alınır. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_TRUSTED_PROXIES` | Etibarlı reverse-proxy CIDR-ları (vergüllə) | text | — | Etibarlı reverse-proxy şəbəkələrinin vergüllə ayrılmış siyahısı (CIDR, məs. 10.0.0.0/8,192.168.0.0/16, və ya tək IP-lər). X-Forwarded-For başlığı klientin IP-sini müəyyən etmək üçün (audit, IP allowlist, brute-force-a qarşı müdafiə) yalnız BU ünvanlardan GƏLƏN sorğularda istifadə olunur. Boş = YALNIZ real peer ünvanına etibar et (XFF nəzərə alınmır, IP saxtakarlığı mümkün deyil). Dərhal tətbiq olunur. | ## Tools | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_CODE_EXEC` | code_exec-i aktivləşdir | bool | `0` | — | | `AIHUMMER_CODE_EXEC_INTERPRETERS` | Code-exec interpretatorları (JSON) | text | — | JSON obyekti {language: path_to_binary}, məs. {\\"python\\":\\"/usr/bin/python3\\"}. Boş = avtomatik aşkarlama. Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Code-exec sandbox obrazı | text | — | code_exec-i təcrid etmək üçün konteyner obrazı (şəbəkəsiz, yalnız oxunan rootfs, limitlər). Boş = hostda icra (etibarlı mühit). Başlanğıcda/yenidən başladıldıqdan sonra tətbiq olunur. | | `AIHUMMER_DB_QUERY_DSN` | db_query üçün DSN (minimal hüquqlu, sahib olmayan rol istifadə edin — sorğular aktiv iş sahəsi üzrə RLS ilə məhdudlaşdırılır) | text | — | — | | `AIHUMMER_FS_ROOT` | Fayl sistemi aləti üçün kök qovluq | text | — | — | | `AIHUMMER_HTTP_ALLOWLIST` | http_request icazə siyahısı | text | — | — | | `AIHUMMER_HTTP_AUTH_JSON` | http_request avtorizasiyası (JSON) | text | — | — | | `AIHUMMER_MCP_SERVERS` | MCP serverləri (JSON) | text | — | — | | `AIHUMMER_WEBFETCH_ALLOWLIST` | web_fetch icazə siyahısı | text | — | — | ## Web UI (separate port) | Açar | Ad | Tip | Susmaya görə | Nə edir | | --- | --- | --- | --- | --- | | `AIHUMMER_WEBUI_API_BASE` | Web UI-nin müraciət etdiyi API baza URL-i | text | — | Ayrıca yerləşdirilmiş SPA-nın /v1/admin/* çağırışları üçün müraciət etdiyi mütləq origin (məs. https://api.example.com). Boş = əvvəlcə şlüzün açıq URL-inə, sonra lokal şlüz ünvanına qayıdır. Adminin brauzerindən əlçatan olmalıdır; API bu Web UI-nin origin-inə CORS vasitəsilə icazə verməlidir (aşağıda avtomatik əlavə olunur). | | `AIHUMMER_WEBUI_ENABLED` | Admin Web UI-ni öz portunda təqdim et | bool | `1` | Standart olaraq aktivdir: admin SPA daxili interfeysə bağlana bilən ayrıca dinləyicinin (AIHUMMER_WEBUI_ADDR) KÖKÜNDƏ verilir. Əsas şlüz portu API + pairing + WS + SSE saxlayır və /admin/ vermir. Web UI dinləyicisini tamamilə söndürmək üçün 0 təyin edin. | | `AIHUMMER_WEBUI_ORIGIN` | Web UI brauzer origin-i (CORS) | text | — | Web UI-nin brauzer Origin-i (məs. https://admin.example.com), giriş məlumatları ilə API-nin CORS allowlist-inə avtomatik əlavə olunur. Boş = AIHUMMER_WEBUI_ADDR-dən çıxarılır (http://host:port). Brauzer Web UI-yə bağlanma ünvanından fərqli proksi/host adı ilə çıxdıqda bunu təyin edin. | Operatora əlçatan parametrlər: 138.