Burada operatörün bir AiHummer sunucusunda değiştirebileceği tüm ayarlar listelenir. Sayfa ürünün kendi kataloğundan üretilir, bu yüzden sunucunuzla birebir örtüşür.
Değer web arayüzünde ya da aihummer settings set KEY VALUE komutuyla verilir (Komut satırı). Varsayılan değer sütunu, kendi değeriniz verilene kadar sunucunun kullandığı değeri gösterir.
[!NOTE]
Gizli değerler burada asla yazdırılmaz, sağlayıcının hizmet anahtarları ise hiç listelenmez — ürün onları tüm listelerden gizler. Tire, boş değeri ya da yalnızca web arayüzünde gösterilen açıklamayı belirtir.
API
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_PERSONAL_API_KEYS
OpenAI uyumluluğu için kişisel API anahtarları
bool
1
“off”, OpenAI uyumlu uç noktada kişisel anahtar kimlik doğrulamasını devre dışı bırakır. Diğer tüm değerler = başlangıçta/yeniden başlatma sonrasında uygulanır.
Agent
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_APPROVAL_TOOLS
Onay gerektiren araçlar
text
—
—
AIHUMMER_SUBAGENT_MAX_DEPTH
Subagent maksimum derinliği
int
2
—
AIHUMMER_SUBAGENT_TIMEOUT_SEC
Subagent zaman aşımı (saniye)
int
180
Tek bir alt ajan çalıştırması için saniye cinsinden maksimum süre. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_TOOL_SEARCH
Geç araç yükleme (tool_search)
bool
false
Yalnızca temel araçların ve bir arama meta aracının reklamını yapın ve geri kalanını talep üzerine ortaya çıkarın. Çok sayıda araç yüklendiğinde, modelin nadiren kullanılan bir aracı gözden kaçırma riskiyle birlikte dönüşleri hızlandırır ve maliyeti düşürür.
AIHUMMER_TOOL_SEARCH_CORE
Geç araç yükleme: her zaman açık araçlar
text
—
Virgülle ayrılmış araç adları, tembel oturumlarda bile ön planda tutulur. modu.
AIHUMMER_TOOL_SEARCH_THRESHOLD
Geç araç yükleme: ertelenecek minimum araç
int
12
Yalnızca bu sayıdan fazla araç temsilcinin profil filtresinden sağ çıktığında erteleyin.
Agent · Reasoning
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_AGENT_BEST_OF_N
N’nin en iyisi örnekleri (0/1=kapalı, ≥2=açık)
int
0
≥2 N adayı örnek alır ve en iyiyi değerlendirir. Nx üretime mal olur.
IANA tarih ekleme için saat dilimi, ör. Avrupa/Moskova. Varsayılan UTC.
Channels
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_CONFIDENTIAL_PERSONA
Gizli web kişiliği
bool
0
Açık olduğunda, web sohbeti aracısı kişilik/kimlik ayrıntılarını ifşa etmez veya sürdürmez ve eldeki göreve verilen yanıtları tutar; bunu anonim veya gizliliğe duyarlı web dağıtımları için kullanın. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_INBOUND_REQUIRE_BINDING
Yalnızca temel hazırlığı yapılan kullanıcılara yanıt ver
text
true
true = bot, NOT temel hazırlığı yapılmış bir AiHummer kullanıcısı (rol bağlaması olan bir kullanıcı) olan herhangi bir kanal göndericisini yok sayar — rastgele sohbet üyeleri ve misafir çağrıları yanıt almaz false (varsayılan) = herkese yanıt verir.
Integrations
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_A2A_PUBLISH
Ajanı Agent2Agent üzerinden yayınla (A2A)
bool
0
Aracıyı A2A sunucusu olarak yayınlayın (Ajan Kartı + POST /a2a/mesaj). Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_MCP_EXPORT_TOOLS
—
text
—
—
AIHUMMER_MCP_PUBLISH
Araçları MCP üzerinden yayınlama
bool
0
Araçları POST /v1/mcp adresinde MCP sunucusu olarak yayınlayın. Başlangıçta/yeniden başlatma sonrasında uygulanır.
Knowledge connectors
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_KB_SYNC_INTERVAL
Zamanlanmış bağlayıcı yeniden senkronizasyon aralığı (0/empty = kapalı)
text
—
Tüm çalışma alanlarında yapılandırılmış her bilgi bağlayıcısının arka planda otomatik yeniden senkronizasyonu için süre (ör. 6 saat, 30 dakika). Boş/0 = kapalı. Yeniden senkronizasyon bağımsızdır (kaynağa göre değiştirin, kopya yok). slack_export hariç tutuldu (zip’i manuel olarak yüklenir). Başlangıçta/yeniden başlatmanın ardından uygulanır.
LLM
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_CASCADE_MIN_CHARS
Kademeli: yükseltilecek minimum karakter sayısı
int
0
Daha güçlü basamaklı modelin devreye girdiği istek uzunluğu eşiği (karakterler). 0 = varsayılan. Başlangıçta/yeniden başlatma sonrasında uygulanır.
AIHUMMER_CASCADE_STRONG_MODEL
Kademeli: daha güçlü geri dönüş modeli
text
—
Uzun/karmaşık istekler için basamaklandırılacak model (boş = kapalı). Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_CODEX_BASE_URL
Kodeks tabanı URL
text
—
Codex (ChatGPT aboneliği) aktarımının temeli. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_CODEX_MAX_OUTPUT_TOKENS
Maksimum çıkış jetonları (0 = sınır yok)
int
0
Sohbet dönüşü için max_output_tokens sınırı. 0 = sınır yok. Akıl yürütme modellerinde, akıl yürütme belirteçleri de bu bütçeye dahil edilir, bu nedenle çok küçük bir değer, boş bir ‘tamamlanmamış: max_output_tokens’ yanıtına neden olur. Anında uygulanır (yeniden başlatma yok).
AIHUMMER_CODEX_MODEL
Model kimliği (Codex / gpt-5.5 aktarımı)
text
gpt-5.5
Birincil Codex/ChatGPT aktarımının model kimliği (ör. gpt-5.5, gpt-5.5-codex). Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_CODEX_REASONING_EFFORT
Akıl yürütme çabası
enum: none \| low \| medium \| high \| xhigh
low
Modelin sohbete ilişkin muhakeme derinliği, aracının parametreleri bunu ayarlamadığında değişir. Geçerli gpt-5.5 değerleri: yok, düşük, orta, yüksek, xyüksek (NOT minimum — gpt-5.5 bunu HTTP 400 ile reddeder). Daha yüksek = daha kaliteli ancak daha yavaş/daha pahalı. Geçersiz bir değer güvenli bir şekilde düşük değere zorlanır. Anında uygulanır (yeniden başlatma yok).
AIHUMMER_LLM_CALL_TIMEOUT_S
Çağrı başına zaman aşımı (saniye)
int
120
Bir SINGLE model çağrısı için zaman bütçesi (anti-stall: gpt-5.5 süresiz olarak ‘düşünebilir’ ve dönüşü açık tutabilir). Süre dolduğunda çağrı, yeniden deneme yapılmadan ErrCallTimeout ile başarısız olur. 0 = sınır yok. Anında uygulandı (yeniden başlatma yok).
AIHUMMER_LLM_GATEWAY_URL
LLM ağ geçidi URL
text
—
Acentenin çağırdığı OpenAI uyumlu model uç noktasının URL tabanı (yerel llama.cpp/vLLM/Ollama sunucunuz veya barındırılan bir ağ geçidi). Sağlayıcının varsayılan uç noktasını kullanmak için boş bırakın.
AIHUMMER_LLM_MODEL
LLM modeli
text
—
Her fırsatta sağlayıcıya gönderilen model adı/kimliği (uç noktanızın hizmet verdiği model). Uç noktanın gerçekte ortaya çıkardığı bir modelle eşleşmelidir.
AIHUMMER_LLM_PROVIDER
LLM sağlayıcı
text
—
Hangi model arka ucunun kullanılacağı (OpenAI uyumlu bir uç nokta veya Codex/ChatGPT abonelik aktarımı). İsteklerin nasıl gönderilip doğrulanacağına karar verir.
AIHUMMER_LLM_RETRIES
LLM geçici hata durumunda yeniden denemeler
int
3
Geçici bir hata durumunda LLM isteğinin yeniden deneme sayısı. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_LLM_TEMPERATURE
Sıcaklık
text
—
Ajanın parametreleri bunu ayarlamadığında örnekleme sıcaklığı (0..2). Boş = göndermeyin. NOTE: gpt-5.5 akıl yürütme modelleri (Codex) sıcaklığı reddeder — alanı onlar için boş bırakın; bunu yalnızca mantık yürütmeyen bir arka uç kullanırken ayarlayın. Anında uygulandı (yeniden başlatma yok).
AIHUMMER_LLM_TOP_P
Top-p (çekirdek örneklemesi)
text
—
Aracın parametreleri bunu ayarlamadığında çekirdek örnekleme eşiği (0..1). Boş = göndermeyin. Sıcaklık gibi, gpt-5.5 akıl yürütme de bunu reddeder; bunu yalnızca akıl yürütme olmayan arka uçlar için ayarlayın. Anında uygulanır (yeniden başlatma gerekmez).
AIHUMMER_OPENAI_API
OpenAI API stili (sohbet | yanıtlar)
enum: \| chat \| responses
—
chat = /chat/completions, yanıtlar = /responses. Boş = otomatik/varsayılan. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_OPENAI_API_KEY
Yerel OpenAI API anahtarı (dağıtım varsayılanı)
text
—
Yerel OpenAI döngüsü için OpenAI hesap anahtarınız (varsayılan sağlayıcı olarak OpenAI kullanıyorsanız). Modeller sayfasındaki çalışma alanı başına BYOK ile karıştırılmamalıdır. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_OPENAI_BASE_URL
Yerel OpenAI tabanı URL
text
—
OpenAI uyumlu API tabanı (ör. https://api.openai.com/v1). Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_OPENAI_MODEL
Yerel OpenAI modeli
text
—
Yerel OpenAI döngüsü için model (AIHUMMER_OPENAI_API_KEY ayarlandığında).
AIHUMMER_ROUTER_COMPLEX_MODEL
Yönlendirici: karmaşık dönüşler için model
text
—
Karmaşık istekler için model (boş = bant devre dışı). Başlangıçta/yeniden başlatma sonrasında uygulanır.
AIHUMMER_ROUTER_SIMPLE_MODEL
Yönlendirici: basit dönüşler için model
text
—
Basit istekler için model (boş = bant devre dışı). Başlangıçta/yeniden başlatma sonrasında uygulanır.
AIHUMMER_ROUTER_STANDARD_MODEL
Yönlendirici: standart dönüşler için model
text
—
Standart istekler için model (boş = bant devre dışı). Başlangıçta/yeniden başlatmanın ardından uygulanır.
Media
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_DEEPGRAM_API_KEY
Deepgram API anahtarı
text
—
Deepgram API anahtarı (STT motor = deepgram). Buradan veya AIHUMMER_STT_API_KEY adresinden alınmıştır. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_DEEPGRAM_MODEL
Deepgram modeli
text
nova-2
Deepgram modeli (ör. nova-2, nova-3, base). Projenin anahtara erişimine bağlıdır. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_DEEPGRAM_URL
Deepgram tabanı URL
text
—
Deepgram API tabanı. Boş = https://api.deepgram.com. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_IMAGE_BASE_URL
Resim API temel URL (OpenAI yedek)
text
—
Bir OpenAI anahtarıyla çalışırken /images tabanı API (blank = https://api.openai.com/v1). Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_IMAGE_MODEL
Görüntü oluşturma model
text
—
Image_generate modeli (varsayılan gpt-image-2). Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_MEDIA_MAX_UPLOAD_MB
Medya maksimum yükleme boyutu (MB)
int
256
Tek bir medya yüklemesinin megabayt cinsinden maksimum boyutu (PUT /v1/media/{id}/content). Disk yazma işlemlerini genel bağlantı noktası aracılığıyla sınırlar (taşma koruması). Varsayılan 256. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_STT_API_KEY
STT API anahtar (isteğe bağlı)
text
—
STT sepeti gerektiriyorsa isteğe bağlı taşıyıcı (install.sh bunu oluşturabilir). Başlangıçta/yeniden başlatma sonrasında uygulanır.
AIHUMMER_STT_CODEX_URL
STT codex-engine URL
text
—
Kodeks motoru için OpenAI uyumlu /v1/audio/transcriptions tabanı (ChatGPT aboneliği aracılığıyla transkripsiyon). Boş = Kodeks tabanı. Taşıyıcı AIHUMMER_STT_API_KEY veya AIHUMMER_CODEX_ACCESS_TOKEN’den alınır. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_STT_ENGINE
STT motor
enum: faster-whisper \| deepgram \| off
faster-whisper
Konuşma tanıma motoru. fast-whisper = ücretsiz yerel sepet (varsayılan, kutudan çıktığı gibi gönderilir, URL = AIHUMMER_STT_URL, üçüncü taraf API’lerde yük yoktur). deepgram = bulut Deepgram (hızlı, anahtar AIHUMMER_DEEPGRAM_API_KEY, ücretsiz katmanla ödenir). kapalı = tanıma devre dışı. (Codex/ChatGPT aboneliği NOT ses transkripsiyonunu destekler.) Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_STT_LANGUAGE
STT dil
text
—
Tanıma dili (BCP-47, ör. ru/en). Deepgram motoru tarafından kullanılır (nova-2 modeli). Boş = otomatik algılama / motor varsayılanı. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_STT_MODEL
STT modeli
text
Systran/faster-whisper-small
daha hızlı fısıltı modeli (ör. küçük/orta/large-v3 veya Systran/faster-whisper-⟨size⟩). Başlangıçta/yeniden başlatma sonrasında uygulanır.
AIHUMMER_STT_URL
Konuşmadan metne geçiş (daha hızlı fısıltı) URL
text
—
URL yerel daha hızlı fısıltı sepetinin (OpenAI uyumlu /v1/audio/transcriptions). Boş = install.sh’nin kendisini ayarladığı otomatik varsayılan http://127.0.0.1:8001,. Başlangıçta/yeniden başlatma sonrasında uygulanır.
AIHUMMER_TTS_API_KEY
TTS API anahtar (edge-tts)
text
—
Ağ geçidi ile edge-tts sepeti arasındaki taşıyıcı (install.sh bunu otomatik olarak oluşturur). Başlangıçta/yeniden başlatma sonrasında uygulanır.
AIHUMMER_TTS_ENABLED
Metin-konuşma etkin
bool
1
Konuşma sentezini etkinleştirir (tts aracı + ses modu). Edge-tts sepeti kutudan çıkar. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_TTS_MODEL
TTS modeli
text
—
Edge-tts hizmetinin model adı. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_TTS_URL
Metin-konuşma (kenar-tts) URL
text
—
URL yerel edge-tts sepetinin (OpenAI uyumlu /v1/audio/speech). Boş = install.sh’nin kendisini ayarladığı otomatik varsayılan http://127.0.0.1:8002,. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_TTS_VOICE
TTS ses (varsayılan de-DE-FlorianMultilingualNeural)
text
de-DE-FlorianMultilingualNeural
Varsayılan edge-tts sesi (çok dilli, Rusça dahil). Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_VIDEO_API_KEY
Video analizi API tuşu
text
—
Video analiz sepeti için erişim anahtarı (gerekiyorsa). Başlangıçta/yeniden başlatma sonrasında uygulanır.
AIHUMMER_VIDEO_URL
Video analizi (ffmpeg) URL
text
—
URL video analiz sepetinin. Boş = kapalı. Başlangıçta/yeniden başlatmanın ardından uygulanır.
keep_alive (yalnızca AIHUMMER_MEMORY_RETRIEVAL=yerleştirme sırasında). Varsayılan 5m — boşta kalan bir modelin yükü kaldırılır ve takılı kalan boşta kalma koşucusu kendini temizler. -1 (sonsuza kadar sakla) NOT önerilir: bir ollama hatası nedeniyle takılıp kalan bir koşucu günlerce CPU çekirdeğini sabitleyebilir. Rölantiden sonraki soğuk başlatma, ağ geçidi başlangıcındaki ısınmayla dengelenir. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_EMBEDDER_MODEL
Yerleştirme modeli
text
yxchia/multilingual-e5-base
Ollama yerleştirme modeli. Varsayılan multilingual-e5-base — çok dilli (Rusça dahil), 768-dim, hafif + hızlı, CPU (~1-2s/embed). e5 sorgu/geçiş önekleri otomatik olarak uygulanır. GPU donanımında maksimum kalite için bge-m3 kullanın (set DIM=1024). AIHUMMER_EMBEDDER_DIM ile eşleşmelidir.
AIHUMMER_EMBEDDER_PASSAGE_PREFIX
Geçit ekleme öneki
text
—
Saklanan belge önekini geçersiz kılın (e5 modelleri otomatik olarak “passage: “ kullanır). Model adına göre otomatik algılama için boş bırakın.
AIHUMMER_EMBEDDER_QUERY_PREFIX
Yerleştirme sorgusu öneki
text
—
Geri alma sorgusu önekini geçersiz kılın (e5 modelleri otomatik olarak “sorgu: “ kullanır). Model adına göre otomatik algılama için boş bırakın.
AIHUMMER_EMBEDDER_URL
Gömücü URL (Ollama uyumlu)
text
—
Gerçek anlamsal yerleştirmeler. Kurulumcu bir Ollama sepeti hazırlar ve bunu otomatik olarak ayarlar; UNSET = karma yerleştirici (yalnızca sözcüksel, zayıf hatırlama).
AIHUMMER_MEMORY_CAPTURE
Bellek yakalama modu
enum: auto \| review \| off
auto
auto = hatırla + otomatik olarak hatırla; inceleme = manuel onaya ihtiyaç duyan adaylar olarak hatırlayın; off = yakalama yok.
AIHUMMER_MEMORY_CONTEXT_TIMEOUT
Bellek doldurma zaman aşımı
text
3s
Yanıtın başlangıcında belleğin doldurulması için maksimum bekleme süresi (sorgu yerleştirme + arama). Yerleştirici aşırı yüklenmişse ve son tarihi kaçırırsa yanıt, askıda kalmak yerine WITHOUT bellek bloğuna devam eder. Devam süresi formatı (ör. 2s, 1500ms). 0 = sınır yok. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_MEMORY_DREAM_INTERVAL
Rüya geçiş aralığı
string
1h
Kendi kendini idame ettiren dream pass’ın tüm kapsamlardaki çelişkiler için incelenen iddiaları ne sıklıkta taradığı (Gitme süresi, örneğin 30 dk/1 sa/6 sa). Devre dışı bırakmak için 0’ı ayarlayın.
AIHUMMER_MEMORY_EXTRACT
LLM bilgi çıkarma
bool
1
Grafik/çelişki/rüya makinesinin çalışması için gerekli olan ham cümle parçalarını depolamak yerine normalleştirilmiş konu/yüklem/nesne gerçeklerini LLM (varsayılan AÇIK) aracılığıyla çıkarın. Yakalanan mesaj başına bir LLM çağrı ekler; Aramayı kaydetmek için yola çıktık.
AIHUMMER_MEMORY_RETRIEVAL
Bellek alma modu
enum: fulltext \| embedding
fulltext
Hafıza nasıl aranır. tam metin (varsayılan) = Gerçek metin üzerinde Postgres tam metin araması — Yerleştirme modeli YOK, sepet yok, CPU yükü yok (AiHummer’daki eski einstein gibi). gömme = yerleştirme aracı aracılığıyla semantik vektör araması (AIHUMMER_EMBEDDER_URL/ollama) — anlam olarak daha doğrudur, ancak CPU dosyasını yükler ve bir sepet gerektirir. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_MEMORY_TOKEN
Uzak bellek hizmeti belirteci
text
—
Einstein Alma ile yetkilendirilecek hizmet belirteci API (Yetkilendirme: Taşıyıcı … olarak gönderilir). Yalnızca AIHUMMER_MEMORY_URL ayarlandığında gereklidir. Boş = yetkilendirme yok (yalnızca kimlik doğrulama almanın devre dışı olduğu geliştirici yüklemeleri için).
AIHUMMER_MEMORY_URL
Uzaktan bellek URL (Einstein eklentisi)
text
—
URL bağımsız Einstein bellek eklentisinin (sözleşme aihummer.memory.v1, örneğin http://127.0.0.1:8820). BLANK (varsayılan) = işlem içi Go bellek modülü. Ayarlandığında, bağlam hidrasyonu HTTP üzerinden eklentinin /context + /retrival;’ına gider) hata/kullanılamama durumunda, yerleşik modüle geri döner (çökme olmaz). Başlangıçta/yeniden başlatma sonrasında uygulanır.
AIHUMMER_QDRANT_API_KEY
Qdrant API anahtarı
text
—
—
AIHUMMER_QDRANT_URL
Qdrant URL (dayanıklı vektör deposu)
text
—
UNSET = bellek içi depo (yeniden başlatıldığında LOST vektörleri). Üretim dayanıklılığı için ayarlandı.
AIHUMMER_RERANKER_URL
RAG yeniden sıralama sepeti URL
text
—
HTTP URL karma aramayı yeniden sıralamak için çapraz kodlayıcı sepetinin. Boş = yeniden sıralama kapalı. Başlangıçta/yeniden başlatma sonrasında uygulanır.
Moderation
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_MODERATION
Giriş denetimi
bool
1
“off”, jailbreak/istem eklemeye karşı yerleşik korumayı devre dışı bırakır. Başlangıçta/yeniden başlatma sonrasında uygulanır.
AIHUMMER_MODERATION_REFUSAL
Denetleme reddi mesajı
text
—
Moderatör bir isteği engellediğinde döndürülen ret metni (boş = yerleşik). Başlangıçta/yeniden başlatma sonrasında uygulanır.
Public access
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_PUBLIC_URL
Genel ağ geçidi URL (Web kullanıcı arayüzü + istemciler)
text
—
Bu ana bilgisayarın proxy sunucusu → ağ geçidi bağlantı noktası (AIHUMMER_GATEWAY_ADDR, varsayılan :8780). Web kullanıcı arayüzü ve iOS/web istemcileri tarafından kullanılır.
POCKET_AGENT_GATEWAY_BASE_URL
Cep-agent ağ geçidi genel URL
text
—
Proxy → cep aracısı ağ geçidi bağlantı noktası (POCKET_AGENT_PORT, varsayılan 8080). Uzak aracı bunu tek seferlik bir bilet aracılığıyla çevirir.
TELEGRAM_PUBLIC_URL
Telegram webhook genel URL
text
—
Yalnızca web kancası modu — proxy → telgraf bağlayıcı bağlantı noktası (AIHUMMER_TELEGRAM_CONNECTOR_PORT, varsayılan 8091). herkese açık URL gerekli).
SSO (LDAP/AD)
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_LDAP_BASE_DN
Kullanıcı arama tabanı DN’si
text
—
Kökte ara, ör. OU=Users,DC=corp,DC=example.
AIHUMMER_LDAP_BIND_DN
Hizmet bağlama DN’si
text
—
İlk arama bağlantısı için kullanılan hesap, ör. CN=svc-aihummer,OU=Hizmet,DC=corp,DC=örnek. Boş = anonim arama.
AIHUMMER_LDAP_DEFAULT_ROLE
LDAP: Varsayılan rol (grup eşleşmesi yok)
text
—
Hiçbir grup bir eşlemeyle eşleşmediğinde verilen rol. Boş = rol yok.
AIHUMMER_LDAP_ENABLED
LDAP/AD girişini etkinleştir
bool
0
Açık olduğunda, yönetici oturum açma işlemleri dizine geri döner. Bağlama parolası, Gizliler’de bulunur (kapsam ldap, adbind_password).
AIHUMMER_LDAP_GROUP_ATTR
Grup özelliği (varsayılan memberOf)
text
—
Grup DN’lerini listeleyen kullanıcı girişindeki öznitelik. Boş, grup→rol eşlemeyi devre dışı bırakır.
AIHUMMER_LDAP_ROLE_MAPPINGS
LDAP: Grup→rol eşlemeleri (JSON)
text
—
JSON grup DN nesnesi (veya çıplak CN) → rol, ör. {“CN=Admins,OU=Groups,DC=corp,DC=example”:“admin”,“Operators”:“operator”}.
AIHUMMER_LDAP_SKIP_TLS_VERIFY
Atla TLS doğrulama (yalnızca laboratuvar, 1/0)
bool
0
Dizin sertifikası doğrulamasını devre dışı bırakır. Üretimde asla etkinleştirmeyin.
AIHUMMER_LDAP_URL
Dizin URL
text
—
ör. ldaps://ad.corp.example:636 (TLS) veya ldap://dc1.corp.example:389.
AIHUMMER_LDAP_USER_ATTR
Giriş özelliği (varsayılan sAMAccountName)
text
—
Kullanıcının yazdığı oturum açma bilgilerine göre eşleşen LDAP/Active Directory özelliği (varsayılan sAMAccountName; OpenLDAP için kullanıcı kimliği, UPN tarzı oturum açma işlemleri için userPrincipalName).
AIHUMMER_LDAP_USER_FILTER
Kullanıcı arama filtresi
text
—
Giriş için %s içermelidir. AD: (sAMAccountName=%s); LDAP’yi açın: (uid=%s).
SSO (OIDC)
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_OIDC_AUDIENCE
OIDC kitle
text
—
Beklenen aud talebi — başka bir bağlı taraf için basılan jetonları reddetmek için bunu THIS kaynağın hedef kitlesine ayarlayın. aud talebi artık varsayılan olarak her jetonda REQUIRED’dir (aud olmayan bir jeton reddedilir); bu ayarlandığında, aud’un da bunu içermesi gerekir. Üretimde kesinlikle önerilir.
AIHUMMER_OIDC_ISSUER
OIDC veren URL
text
—
IdP veren kuruluş (ör. https://login.example.com). Ayarlandığında OIDC JWT kimlik doğrulamasını etkinleştirir.
AIHUMMER_OIDC_JWKS_URL
OIDC JWKS URL adresi
text
—
JSON Web Anahtarı Seti uç noktası, belirteç imzalarını doğrulamak için kullanılır.
AIHUMMER_OIDC_TENANT_CLAIM
OIDC çalışma alanı talebi
text
—
JWT çalışma alanı kimliğini taşıyan iddia (ör. tenant_id / org).
SSO (SAML)
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_SAML_DEFAULT_ROLE
SAML: Varsayılan rol (grup yok) eşleşme)
text
—
Belirtilen değer eşlemeleri olmadığında verilen rol. Boş = rol yok.
AIHUMMER_SAML_ENABLED
SAML 2.0’ı etkinleştirin SSO
bool
0
/saml/metadata, /saml/acs, /saml/login’i açığa çıkarır. SP özel anahtarı Gizliler’de bulunur (kapsam saml, sp_key adı).
AIHUMMER_SAML_ENTITY_ID
SP varlık kimliği
text
—
SP varlık kimliği (boşsa varsayılan olarak ⟨root⟩/saml/metadata şeklindedir).
AIHUMMER_SAML_IDP_METADATA
IdP meta veriler XML
text
—
IdP’nin SAML meta veri belgesini yapıştırın (Okta/Azure AD/ADFS).
AIHUMMER_SAML_ROLE_ATTRIBUTE
Rol/grup özelliği (varsayılan gruplar)
text
—
Grup/rol değerlerini taşıyan onaylama özelliği.
AIHUMMER_SAML_ROLE_MAPPINGS
SAML: Grup→rol eşlemeleri (JSON)
text
—
JSON iddia edilen değerin nesnesi → rol, ör. {“AdminGroup”:“admin”,“Ops”:“operator”}.
AIHUMMER_SAML_ROOT_URL
SP kökü URL
text
—
Bu ağ geçidinin dışarıdan erişilebilen tabanı URL, ör. https://app.example.com. ACS = ⟨root⟩/saml/acs.
AIHUMMER_SAML_SP_CERT
SP sertifikası (PEM)
text
—
Genel SP imzalama sertifikası (PEM). Eşleşen özel anahtar Secrets’a (scope saml, name sp_key) gider.
Security
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_AIRGAPPED
Hava boşluklu mod
bool
0
Genel internete (yalnızca dahili/izin verilenler listesi ana bilgisayarlarına) model odaklı çıkışı engeller. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_AUDIT_RETENTION_DAYS
Denetim günlüğü tutma (gün, 0=sonsuza kadar)
int
0
Denetim günlüğünün kaç gün saklanacağı; eski girişler günlük olarak silinir. 0/boş = sonsuza kadar sakla. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_CODE_EXEC_ALLOW_HOST
Ana makinede code_exec’e izin ver (sanal alan YOK)
bool
0
⚠️ Korumalı alan olmadan doğrudan ana makinede kod yürütülmesine izin verin. Yalnızca güvenilir bir ev laboratuvarı için. AIHUMMER_CODE_EXEC_SANDBOX_IMAGE ayarlamak daha güvenlidir. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_CORS_ORIGINS
İzin verilen CORS kökenler (virgül)
text
—
İzin verilen Kaynakların virgülle ayrılmış listesi. Boş = CORS’ye izin verilmiyor (yalnızca aynı kökenli). Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_CSP
Content-Security-Policy üst bilgisi (geçersiz kıl)
text
—
CSP üstbilgisini geçersiz kılar. Boş = güvenli bir varsayılan. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_INBOUND_SECRET
Bağlayıcı→ağ geçidi paylaşıldı secret
text
—
Bağlayıcının kimliğini doğrulayan paylaşılan sır→ağ geçidi atlama noktası (bağlayıcı tarafındaki değerle eşleşmelidir). Boş = gelen uç nokta UNAUTHENTICATED. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_OPENAI_COMPAT_KEY
OpenAI uyumlu gelen: statik API anahtar
text
—
OpenAI uyumlu istemcilerin, ağ geçidinin yerleşik /v1 uç noktasına (P8 ana ağ geçidi) karşı kimlik doğrulaması yapmak için kullandığı statik anahtar. Boş = statik kimlik doğrulama devre dışı (kişisel anahtarlar kalır). Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_OPENAI_COMPAT_WORKSPACE
OpenAI uyumlu gelen: çalışma alanı kimliği
text
—
Statik OpenAI uyumlu kimlik doğrulamanın eşleştiği çalışma alanı kimliği. Boş = AIHUMMER_DEFAULT_WORKSPACE_ID. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_REQUIRE_2FA
Şunlar için 2FA gerektirir: operatörler
bool
0
Operatörler için ikinci bir faktör (TOTP/passkey) gerektirir. Açık olduğunda, 2FA’sız operatörlerden, oturum açarken hemen bunu ayarlamaları istenir (engelleme olmadan, böylece sahibin hiçbir zaman kilitlenmemesi sağlanır). Hemen uygulandı.
AIHUMMER_REQUIRE_SECURE
Yalnızca güvenli (HTTPS/WSS) bağlantıları kabul et
bool
0
Açıkken, düz HTTP istekleri HTTPS’ye yönlendirilir (GET/HEAD için) veya reddedilir (403); localhost erişimine her zaman izin verilir, böylece operatör asla dışlanmaz. TLS sonlandırıcı ters proxy’den X-Forwarded-Proto’yu onurlandırır. Başlangıçta/yeniden başlatma sonrasında uygulanır.
AIHUMMER_TRUSTED_PROXIES
Güvenilen ters proxy CIDR’ler (virgül)
text
—
Güvenilir ters proxy ağlarının virgülle ayrılmış listesi (CIDR, ör. 10.0.0.0/8,192.168.0.0/16 veya tek IP’ler). Yalnızca bu adreslerden gelen COMING istekleri için, istemci IP’sini (denetim, IP izin verilenler listesi, kaba kuvvet önleme) belirlemek için kullanılan X-Forwarded-For başlığı kullanılır. Boş = ONLY gerçek eş adresine güvenin (XFF yoksayıldı, IP sahtekarlığı imkansız). Anında uygulanır.
Tools
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_CODE_EXEC
code_exec’i etkinleştirin
bool
0
—
AIHUMMER_CODE_EXEC_INTERPRETERS
Code-exec yorumlayıcıları (JSON)
text
—
JSON nesnesi {language: path_to_binary}, ör. {“python”:“/usr/bin/python3”}. Boş = otomatik algılama. Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_CODE_EXEC_SANDBOX_IMAGE
Code-exec korumalı alan görüntüsü
text
—
code_exec’yi yalıtmak için kapsayıcı görüntüsü (ağ yok, salt okunur rootf’ler, sınırlar). Boş = host-exec (güvenilir ortam). Başlangıçta/yeniden başlatmanın ardından uygulanır.
AIHUMMER_DB_QUERY_DSN
db_query DSN (en az ayrıcalıklı, sahip olmayan bir rol kullanın — sorgular RLS-etkili çalışma alanı kapsamına alınarak çalıştırılır)
text
—
—
AIHUMMER_FS_ROOT
Dosya sistemi aracı kökü
text
—
—
AIHUMMER_HTTP_ALLOWLIST
http_request izin verilenler listesi
text
—
—
AIHUMMER_HTTP_AUTH_JSON
http_request auth (JSON)
text
—
—
AIHUMMER_MCP_SERVERS
MCP sunucular (JSON)
text
—
—
AIHUMMER_WEBFETCH_ALLOWLIST
web_fetch izin verilenler listesi
text
—
—
Web UI (separate port)
Anahtar
Ad
Tür
Varsayılan
Ne yapar
AIHUMMER_WEBUI_API_BASE
API temel URL Web kullanıcı arayüzü çağrıları
text
—
Mutlak kaynak (örneğin, /v1/admin/* çağrıları için https://api.example.com) ayrı olarak barındırılan SPA hedefleri. Boş = genel ağ geçidine URL, ardından yerel ağ geçidi adresine geri dönün. Yöneticinin tarayıcısından erişilebilir olmalıdır; API bu Web kullanıcı arayüzünün kaynağına izin vermelidir CORS aracılığıyla (aşağıya otomatik olarak eklenmiştir).
AIHUMMER_WEBUI_ENABLED
Yönetici Web kullanıcı arayüzüne hizmet etme kendi limanında
bool
1
Varsayılan olarak etkindir: SPA yöneticisine, yalnızca dahili bir arayüze bağlanabilen ayrı bir dinleyicinin (AIHUMMER_WEBUI_ADDR) ROOT’sinde sunulur. Ana ağ geçidi bağlantı noktası API + eşleştirme + WS + SSE tutar ve NOT /admin/ hizmetini verir. Web Kullanıcı Arayüzü dinleyicisini tamamen devre dışı bırakmak için 0’a ayarlayın.
AIHUMMER_WEBUI_ORIGIN
Web kullanıcı arayüzü tarayıcı kaynağı (CORS)
text
—
Web Kullanıcı Arayüzü’nün Tarayıcı Kaynağı (ör. https://admin.example.com),, kimlik bilgileriyle API CORS izin verilenler listesine otomatik olarak eklenir. Boş = AIHUMMER_WEBUI_ADDR’den türetilmiştir (http://host:port). Tarayıcı Web Kullanıcı Arayüzüne bir web sitesi üzerinden ulaştığında bunu ayarlayın) proxy/ana bilgisayar adı bağlama adresinden farklıdır.
Operatöre açık ayarlar: 138.
Burada operatörün bir AiHummer sunucusunda değiştirebileceği tüm ayarlar listelenir. Sayfa ürünün kendi kataloğundan üretilir, bu yüzden sunucunuzla birebir örtüşür.
Değer web arayüzünde ya da `aihummer settings set KEY VALUE` komutuyla verilir ([Komut satırı](/tr/v1.0/reference/cli)). Varsayılan değer sütunu, kendi değeriniz verilene kadar sunucunun kullandığı değeri gösterir.
> [!NOTE]
> Gizli değerler burada asla yazdırılmaz, sağlayıcının hizmet anahtarları ise hiç listelenmez — ürün onları tüm listelerden gizler. Tire, boş değeri ya da yalnızca web arayüzünde gösterilen açıklamayı belirtir.
## API
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_PERSONAL_API_KEYS` | OpenAI uyumluluğu için kişisel API anahtarları | bool | `1` | "off", OpenAI uyumlu uç noktada kişisel anahtar kimlik doğrulamasını devre dışı bırakır. Diğer tüm değerler = başlangıçta/yeniden başlatma sonrasında uygulanır. |
## Agent
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_APPROVAL_TOOLS` | Onay gerektiren araçlar | text | — | — |
| `AIHUMMER_SUBAGENT_MAX_DEPTH` | Subagent maksimum derinliği | int | `2` | — |
| `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | Subagent zaman aşımı (saniye) | int | `180` | Tek bir alt ajan çalıştırması için saniye cinsinden maksimum süre. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_TOOL_SEARCH` | Geç araç yükleme (tool_search) | bool | `false` | Yalnızca temel araçların ve bir arama meta aracının reklamını yapın ve geri kalanını talep üzerine ortaya çıkarın. Çok sayıda araç yüklendiğinde, modelin nadiren kullanılan bir aracı gözden kaçırma riskiyle birlikte dönüşleri hızlandırır ve maliyeti düşürür. |
| `AIHUMMER_TOOL_SEARCH_CORE` | Geç araç yükleme: her zaman açık araçlar | text | — | Virgülle ayrılmış araç adları, tembel oturumlarda bile ön planda tutulur. modu. |
| `AIHUMMER_TOOL_SEARCH_THRESHOLD` | Geç araç yükleme: ertelenecek minimum araç | int | `12` | Yalnızca bu sayıdan fazla araç temsilcinin profil filtresinden sağ çıktığında erteleyin. |
## Agent · Reasoning
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_AGENT_BEST_OF_N` | N'nin en iyisi örnekleri (0/1=kapalı, ≥2=açık) | int | `0` | ≥2 N adayı örnek alır ve en iyiyi değerlendirir. Nx üretime mal olur. |
| `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | Tartışma: yargıç istemi (geçersiz kıl) | text | — | Tartışma jürisi istemini geçersiz kılar (boş = yerleşik). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_AGENT_DEBATE_N` | Tartışma paneli boyutu (0/1=kapalı, ≥2=açık) | int | `0` | ≥2, N aday + yargıçtan oluşan bir tartışma panelini yönetir. Nx üretim maliyeti. |
| `AIHUMMER_AGENT_DEBATE_PROMPT` | Tartışma: aday istemi (geçersiz kıl) | text | — | Tartışma adayı istemini geçersiz kılar (boş = yerleşik). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_AGENT_DEBATE_ROUNDS` | Tartışma: turlar | int | `1` | Aday paneli için tartışma turlarının sayısı. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_AGENT_JUDGE_PROMPT` | N'nin en iyisi jüri istemi (geçersiz kıl) | text | — | N'nin en iyisi değerlendirme istemini geçersiz kılar (boş = yerleşik). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_AGENT_PLAN_PROMPT` | Planlayıcı istemi (geçersiz kıl) | text | — | Planlayıcı istemini geçersiz kılar (boş = yerleşik). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_AGENT_PLAN_STEPS` | Planlayıcı-yürütücü: maksimum plan adımları (0=kapalı) | int | `0` | ⟩0 ayrı bir planlayıcı→yürütücü→sentez geçişini çalıştırır (karmaşık çok adımlı görevler için iyidir). 0 devre dışı bırakır. Tipik 4–8. |
| `AIHUMMER_AGENT_PLAN_STEP_ITERS` | Planlayıcı: adım başına araç yinelemeleri (0=default) | int | `0` | Plan adımı başına araç çağırma yinelemelerini sınırlar. 0 = yerleşik varsayılan (4). |
| `AIHUMMER_AGENT_REFLECT` | Öz eleştiri geçişi | bool | `0` | Son yanıttan önce bir yansıma/öz eleştiri geçişi ekler. |
| `AIHUMMER_AGENT_REFLECT_PROMPT` | Yansıma istemi (geçersiz kıl) | text | — | Öz eleştiri istemini geçersiz kılar (boş = yerleşik). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_AGENT_SELF_HEAL` | Kendi kendini iyileştirme aracı hatası yeniden denemeleri (0=kapalı) | int | `0` | ⟩0, bu sınıra kadar, düzeltici bir ipucuyla başarısız araç çağrılarını yeniden dener. |
## Agent · System prompt
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_LOCALE` | Varsayılan yerel ayar | text | `ru-RU` | Varsayılan yanıt dili/yerel ayar ipucu, ör. ru-RU. Kişi/operatör talimatları geçersiz kılınır. |
| `AIHUMMER_TIMEZONE` | Saat dilimi | text | `UTC` | IANA tarih ekleme için saat dilimi, ör. Avrupa/Moskova. Varsayılan UTC. |
## Channels
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_CONFIDENTIAL_PERSONA` | Gizli web kişiliği | bool | `0` | Açık olduğunda, web sohbeti aracısı kişilik/kimlik ayrıntılarını ifşa etmez veya sürdürmez ve eldeki göreve verilen yanıtları tutar; bunu anonim veya gizliliğe duyarlı web dağıtımları için kullanın. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_INBOUND_REQUIRE_BINDING` | Yalnızca temel hazırlığı yapılan kullanıcılara yanıt ver | text | `true` | true = bot, NOT temel hazırlığı yapılmış bir AiHummer kullanıcısı (rol bağlaması olan bir kullanıcı) olan herhangi bir kanal göndericisini yok sayar — rastgele sohbet üyeleri ve misafir çağrıları yanıt almaz false (varsayılan) = herkese yanıt verir. |
## Integrations
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_A2A_PUBLISH` | Ajanı Agent2Agent üzerinden yayınla (A2A) | bool | `0` | Aracıyı A2A sunucusu olarak yayınlayın (Ajan Kartı + POST /a2a/mesaj). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_MCP_EXPORT_TOOLS` | — | text | — | — |
| `AIHUMMER_MCP_PUBLISH` | Araçları MCP üzerinden yayınlama | bool | `0` | Araçları POST /v1/mcp adresinde MCP sunucusu olarak yayınlayın. Başlangıçta/yeniden başlatma sonrasında uygulanır. |
## Knowledge connectors
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_KB_SYNC_INTERVAL` | Zamanlanmış bağlayıcı yeniden senkronizasyon aralığı (0/empty = kapalı) | text | — | Tüm çalışma alanlarında yapılandırılmış her bilgi bağlayıcısının arka planda otomatik yeniden senkronizasyonu için süre (ör. 6 saat, 30 dakika). Boş/0 = kapalı. Yeniden senkronizasyon bağımsızdır (kaynağa göre değiştirin, kopya yok). slack_export hariç tutuldu (zip'i manuel olarak yüklenir). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
## LLM
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_CASCADE_MIN_CHARS` | Kademeli: yükseltilecek minimum karakter sayısı | int | `0` | Daha güçlü basamaklı modelin devreye girdiği istek uzunluğu eşiği (karakterler). 0 = varsayılan. Başlangıçta/yeniden başlatma sonrasında uygulanır. |
| `AIHUMMER_CASCADE_STRONG_MODEL` | Kademeli: daha güçlü geri dönüş modeli | text | — | Uzun/karmaşık istekler için basamaklandırılacak model (boş = kapalı). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_CODEX_BASE_URL` | Kodeks tabanı URL | text | — | Codex (ChatGPT aboneliği) aktarımının temeli. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_CODEX_MAX_OUTPUT_TOKENS` | Maksimum çıkış jetonları (0 = sınır yok) | int | `0` | Sohbet dönüşü için max_output_tokens sınırı. 0 = sınır yok. Akıl yürütme modellerinde, akıl yürütme belirteçleri de bu bütçeye dahil edilir, bu nedenle çok küçük bir değer, boş bir 'tamamlanmamış: max_output_tokens' yanıtına neden olur. Anında uygulanır (yeniden başlatma yok). |
| `AIHUMMER_CODEX_MODEL` | Model kimliği (Codex / gpt-5.5 aktarımı) | text | `gpt-5.5` | Birincil Codex/ChatGPT aktarımının model kimliği (ör. gpt-5.5, gpt-5.5-codex). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_CODEX_REASONING_EFFORT` | Akıl yürütme çabası | enum: none \\\| low \\\| medium \\\| high \\\| xhigh | `low` | Modelin sohbete ilişkin muhakeme derinliği, aracının parametreleri bunu ayarlamadığında değişir. Geçerli gpt-5.5 değerleri: yok, düşük, orta, yüksek, xyüksek (NOT minimum — gpt-5.5 bunu HTTP 400 ile reddeder). Daha yüksek = daha kaliteli ancak daha yavaş/daha pahalı. Geçersiz bir değer güvenli bir şekilde düşük değere zorlanır. Anında uygulanır (yeniden başlatma yok). |
| `AIHUMMER_LLM_CALL_TIMEOUT_S` | Çağrı başına zaman aşımı (saniye) | int | `120` | Bir SINGLE model çağrısı için zaman bütçesi (anti-stall: gpt-5.5 süresiz olarak 'düşünebilir' ve dönüşü açık tutabilir). Süre dolduğunda çağrı, yeniden deneme yapılmadan ErrCallTimeout ile başarısız olur. 0 = sınır yok. Anında uygulandı (yeniden başlatma yok). |
| `AIHUMMER_LLM_GATEWAY_URL` | LLM ağ geçidi URL | text | — | Acentenin çağırdığı OpenAI uyumlu model uç noktasının URL tabanı (yerel llama.cpp/vLLM/Ollama sunucunuz veya barındırılan bir ağ geçidi). Sağlayıcının varsayılan uç noktasını kullanmak için boş bırakın. |
| `AIHUMMER_LLM_MODEL` | LLM modeli | text | — | Her fırsatta sağlayıcıya gönderilen model adı/kimliği (uç noktanızın hizmet verdiği model). Uç noktanın gerçekte ortaya çıkardığı bir modelle eşleşmelidir. |
| `AIHUMMER_LLM_PROVIDER` | LLM sağlayıcı | text | — | Hangi model arka ucunun kullanılacağı (OpenAI uyumlu bir uç nokta veya Codex/ChatGPT abonelik aktarımı). İsteklerin nasıl gönderilip doğrulanacağına karar verir. |
| `AIHUMMER_LLM_RETRIES` | LLM geçici hata durumunda yeniden denemeler | int | `3` | Geçici bir hata durumunda LLM isteğinin yeniden deneme sayısı. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_LLM_TEMPERATURE` | Sıcaklık | text | — | Ajanın parametreleri bunu ayarlamadığında örnekleme sıcaklığı (0..2). Boş = göndermeyin. NOTE: gpt-5.5 akıl yürütme modelleri (Codex) sıcaklığı reddeder — alanı onlar için boş bırakın; bunu yalnızca mantık yürütmeyen bir arka uç kullanırken ayarlayın. Anında uygulandı (yeniden başlatma yok). |
| `AIHUMMER_LLM_TOP_P` | Top-p (çekirdek örneklemesi) | text | — | Aracın parametreleri bunu ayarlamadığında çekirdek örnekleme eşiği (0..1). Boş = göndermeyin. Sıcaklık gibi, gpt-5.5 akıl yürütme de bunu reddeder; bunu yalnızca akıl yürütme olmayan arka uçlar için ayarlayın. Anında uygulanır (yeniden başlatma gerekmez). |
| `AIHUMMER_OPENAI_API` | OpenAI API stili (sohbet \| yanıtlar) | enum: \\\| chat \\\| responses | — | chat = /chat/completions, yanıtlar = /responses. Boş = otomatik/varsayılan. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_OPENAI_API_KEY` | Yerel OpenAI API anahtarı (dağıtım varsayılanı) | text | — | Yerel OpenAI döngüsü için OpenAI hesap anahtarınız (varsayılan sağlayıcı olarak OpenAI kullanıyorsanız). Modeller sayfasındaki çalışma alanı başına BYOK ile karıştırılmamalıdır. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_OPENAI_BASE_URL` | Yerel OpenAI tabanı URL | text | — | OpenAI uyumlu API tabanı (ör. https://api.openai.com/v1). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_OPENAI_MODEL` | Yerel OpenAI modeli | text | — | Yerel OpenAI döngüsü için model (AIHUMMER_OPENAI_API_KEY ayarlandığında). |
| `AIHUMMER_ROUTER_COMPLEX_MODEL` | Yönlendirici: karmaşık dönüşler için model | text | — | Karmaşık istekler için model (boş = bant devre dışı). Başlangıçta/yeniden başlatma sonrasında uygulanır. |
| `AIHUMMER_ROUTER_SIMPLE_MODEL` | Yönlendirici: basit dönüşler için model | text | — | Basit istekler için model (boş = bant devre dışı). Başlangıçta/yeniden başlatma sonrasında uygulanır. |
| `AIHUMMER_ROUTER_STANDARD_MODEL` | Yönlendirici: standart dönüşler için model | text | — | Standart istekler için model (boş = bant devre dışı). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
## Media
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_DEEPGRAM_API_KEY` | Deepgram API anahtarı | text | — | Deepgram API anahtarı (STT motor = deepgram). Buradan veya AIHUMMER_STT_API_KEY adresinden alınmıştır. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_DEEPGRAM_MODEL` | Deepgram modeli | text | `nova-2` | Deepgram modeli (ör. nova-2, nova-3, base). Projenin anahtara erişimine bağlıdır. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_DEEPGRAM_URL` | Deepgram tabanı URL | text | — | Deepgram API tabanı. Boş = https://api.deepgram.com. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_IMAGE_BASE_URL` | Resim API temel URL (OpenAI yedek) | text | — | Bir OpenAI anahtarıyla çalışırken /images tabanı API (blank = https://api.openai.com/v1). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_IMAGE_MODEL` | Görüntü oluşturma model | text | — | Image_generate modeli (varsayılan gpt-image-2). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_MEDIA_MAX_UPLOAD_MB` | Medya maksimum yükleme boyutu (MB) | int | `256` | Tek bir medya yüklemesinin megabayt cinsinden maksimum boyutu (PUT /v1/media/{id}/content). Disk yazma işlemlerini genel bağlantı noktası aracılığıyla sınırlar (taşma koruması). Varsayılan 256. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_STT_API_KEY` | STT API anahtar (isteğe bağlı) | text | — | STT sepeti gerektiriyorsa isteğe bağlı taşıyıcı (install.sh bunu oluşturabilir). Başlangıçta/yeniden başlatma sonrasında uygulanır. |
| `AIHUMMER_STT_CODEX_URL` | STT codex-engine URL | text | — | Kodeks motoru için OpenAI uyumlu /v1/audio/transcriptions tabanı (ChatGPT aboneliği aracılığıyla transkripsiyon). Boş = Kodeks tabanı. Taşıyıcı AIHUMMER_STT_API_KEY veya AIHUMMER_CODEX_ACCESS_TOKEN'den alınır. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_STT_ENGINE` | STT motor | enum: faster-whisper \\\| deepgram \\\| off | `faster-whisper` | Konuşma tanıma motoru. fast-whisper = ücretsiz yerel sepet (varsayılan, kutudan çıktığı gibi gönderilir, URL = AIHUMMER_STT_URL, üçüncü taraf API'lerde yük yoktur). deepgram = bulut Deepgram (hızlı, anahtar AIHUMMER_DEEPGRAM_API_KEY, ücretsiz katmanla ödenir). kapalı = tanıma devre dışı. (Codex/ChatGPT aboneliği NOT ses transkripsiyonunu destekler.) Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_STT_LANGUAGE` | STT dil | text | — | Tanıma dili (BCP-47, ör. ru/en). Deepgram motoru tarafından kullanılır (nova-2 modeli). Boş = otomatik algılama / motor varsayılanı. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_STT_MODEL` | STT modeli | text | `Systran/faster-whisper-small` | daha hızlı fısıltı modeli (ör. küçük/orta/large-v3 veya Systran/faster-whisper-⟨size⟩). Başlangıçta/yeniden başlatma sonrasında uygulanır. |
| `AIHUMMER_STT_URL` | Konuşmadan metne geçiş (daha hızlı fısıltı) URL | text | — | URL yerel daha hızlı fısıltı sepetinin (OpenAI uyumlu /v1/audio/transcriptions). Boş = install.sh'nin kendisini ayarladığı otomatik varsayılan http://127.0.0.1:8001,. Başlangıçta/yeniden başlatma sonrasında uygulanır. |
| `AIHUMMER_TTS_API_KEY` | TTS API anahtar (edge-tts) | text | — | Ağ geçidi ile edge-tts sepeti arasındaki taşıyıcı (install.sh bunu otomatik olarak oluşturur). Başlangıçta/yeniden başlatma sonrasında uygulanır. |
| `AIHUMMER_TTS_ENABLED` | Metin-konuşma etkin | bool | `1` | Konuşma sentezini etkinleştirir (tts aracı + ses modu). Edge-tts sepeti kutudan çıkar. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_TTS_MODEL` | TTS modeli | text | — | Edge-tts hizmetinin model adı. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_TTS_URL` | Metin-konuşma (kenar-tts) URL | text | — | URL yerel edge-tts sepetinin (OpenAI uyumlu /v1/audio/speech). Boş = install.sh'nin kendisini ayarladığı otomatik varsayılan http://127.0.0.1:8002,. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_TTS_VOICE` | TTS ses (varsayılan de-DE-FlorianMultilingualNeural) | text | `de-DE-FlorianMultilingualNeural` | Varsayılan edge-tts sesi (çok dilli, Rusça dahil). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_VIDEO_API_KEY` | Video analizi API tuşu | text | — | Video analiz sepeti için erişim anahtarı (gerekiyorsa). Başlangıçta/yeniden başlatma sonrasında uygulanır. |
| `AIHUMMER_VIDEO_URL` | Video analizi (ffmpeg) URL | text | — | URL video analiz sepetinin. Boş = kapalı. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
## Media · Voice
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_VOICE_AEC` | Yankı iptali (AEC) | bool | `1` | Yakalamada echoCancellation'ı zorunlu kılın (WebRTC). Mikrofondaki TTS echo'yu kaldırır (Moltis #1129). |
| `AIHUMMER_VOICE_AGC` | Otomatik kazanç kontrolü | bool | `1` | — |
| `AIHUMMER_VOICE_BARGEIN_FRAMES` | İçerilen çerçeveler | int | `5` | Bot'un oynatmasını ardışık olarak kaç sesli karenin (≈20ms) kesintiye uğrattığı. |
| `AIHUMMER_VOICE_DUPLEX` | Canlı tam çift yönlü ses | bool | `0` | Canlı tam çift yönlü modu etkinleştirir (akış + VAD + katılma). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_VOICE_NOISE_SUPPRESSION` | Gürültü bastırma | bool | `1` | — |
| `AIHUMMER_VOICE_VAD_THRESHOLD` | VAD enerji eşiği (0..1) | text | `0.02` | Yakalamanın VAD geçişi için konuşma enerjisi eşiği; less = daha hassas. |
## Memory
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_EMBEDDER_DIM` | Yerleştirme vektörü dim | int | `768` | Vektör boyutu — modelle eşleşmelidir (multilingual-e5-base=768, bge-m3=1024). |
| `AIHUMMER_EMBEDDER_KEEPALIVE` | Yerleştirici canlı tutma | text | `5m` | keep_alive (yalnızca AIHUMMER_MEMORY_RETRIEVAL=yerleştirme sırasında). Varsayılan 5m — boşta kalan bir modelin yükü kaldırılır ve takılı kalan boşta kalma koşucusu kendini temizler. -1 (sonsuza kadar sakla) NOT önerilir: bir ollama hatası nedeniyle takılıp kalan bir koşucu günlerce CPU çekirdeğini sabitleyebilir. Rölantiden sonraki soğuk başlatma, ağ geçidi başlangıcındaki ısınmayla dengelenir. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_EMBEDDER_MODEL` | Yerleştirme modeli | text | `yxchia/multilingual-e5-base` | Ollama yerleştirme modeli. Varsayılan multilingual-e5-base — çok dilli (Rusça dahil), 768-dim, hafif + hızlı, CPU (~1-2s/embed). e5 sorgu/geçiş önekleri otomatik olarak uygulanır. GPU donanımında maksimum kalite için bge-m3 kullanın (set DIM=1024). AIHUMMER_EMBEDDER_DIM ile eşleşmelidir. |
| `AIHUMMER_EMBEDDER_PASSAGE_PREFIX` | Geçit ekleme öneki | text | — | Saklanan belge önekini geçersiz kılın (e5 modelleri otomatik olarak "passage: " kullanır). Model adına göre otomatik algılama için boş bırakın. |
| `AIHUMMER_EMBEDDER_QUERY_PREFIX` | Yerleştirme sorgusu öneki | text | — | Geri alma sorgusu önekini geçersiz kılın (e5 modelleri otomatik olarak "sorgu: " kullanır). Model adına göre otomatik algılama için boş bırakın. |
| `AIHUMMER_EMBEDDER_URL` | Gömücü URL (Ollama uyumlu) | text | — | Gerçek anlamsal yerleştirmeler. Kurulumcu bir Ollama sepeti hazırlar ve bunu otomatik olarak ayarlar; UNSET = karma yerleştirici (yalnızca sözcüksel, zayıf hatırlama). |
| `AIHUMMER_MEMORY_CAPTURE` | Bellek yakalama modu | enum: auto \\\| review \\\| off | `auto` | auto = hatırla + otomatik olarak hatırla; inceleme = manuel onaya ihtiyaç duyan adaylar olarak hatırlayın; off = yakalama yok. |
| `AIHUMMER_MEMORY_CONTEXT_TIMEOUT` | Bellek doldurma zaman aşımı | text | `3s` | Yanıtın başlangıcında belleğin doldurulması için maksimum bekleme süresi (sorgu yerleştirme + arama). Yerleştirici aşırı yüklenmişse ve son tarihi kaçırırsa yanıt, askıda kalmak yerine WITHOUT bellek bloğuna devam eder. Devam süresi formatı (ör. 2s, 1500ms). 0 = sınır yok. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_MEMORY_DREAM_INTERVAL` | Rüya geçiş aralığı | string | `1h` | Kendi kendini idame ettiren dream pass'ın tüm kapsamlardaki çelişkiler için incelenen iddiaları ne sıklıkta taradığı (Gitme süresi, örneğin 30 dk/1 sa/6 sa). Devre dışı bırakmak için 0'ı ayarlayın. |
| `AIHUMMER_MEMORY_EXTRACT` | LLM bilgi çıkarma | bool | `1` | Grafik/çelişki/rüya makinesinin çalışması için gerekli olan ham cümle parçalarını depolamak yerine normalleştirilmiş konu/yüklem/nesne gerçeklerini LLM (varsayılan AÇIK) aracılığıyla çıkarın. Yakalanan mesaj başına bir LLM çağrı ekler; Aramayı kaydetmek için yola çıktık. |
| `AIHUMMER_MEMORY_RETRIEVAL` | Bellek alma modu | enum: fulltext \\\| embedding | `fulltext` | Hafıza nasıl aranır. tam metin (varsayılan) = Gerçek metin üzerinde Postgres tam metin araması — Yerleştirme modeli YOK, sepet yok, CPU yükü yok (AiHummer'daki eski einstein gibi). gömme = yerleştirme aracı aracılığıyla semantik vektör araması (AIHUMMER_EMBEDDER_URL/ollama) — anlam olarak daha doğrudur, ancak CPU dosyasını yükler ve bir sepet gerektirir. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_MEMORY_TOKEN` | Uzak bellek hizmeti belirteci | text | — | Einstein Alma ile yetkilendirilecek hizmet belirteci API (Yetkilendirme: Taşıyıcı … olarak gönderilir). Yalnızca AIHUMMER_MEMORY_URL ayarlandığında gereklidir. Boş = yetkilendirme yok (yalnızca kimlik doğrulama almanın devre dışı olduğu geliştirici yüklemeleri için). |
| `AIHUMMER_MEMORY_URL` | Uzaktan bellek URL (Einstein eklentisi) | text | — | URL bağımsız Einstein bellek eklentisinin (sözleşme aihummer.memory.v1, örneğin http://127.0.0.1:8820). BLANK (varsayılan) = işlem içi Go bellek modülü. Ayarlandığında, bağlam hidrasyonu HTTP üzerinden eklentinin /context + /retrival;'ına gider) hata/kullanılamama durumunda, yerleşik modüle geri döner (çökme olmaz). Başlangıçta/yeniden başlatma sonrasında uygulanır. |
| `AIHUMMER_QDRANT_API_KEY` | Qdrant API anahtarı | text | — | — |
| `AIHUMMER_QDRANT_URL` | Qdrant URL (dayanıklı vektör deposu) | text | — | UNSET = bellek içi depo (yeniden başlatıldığında LOST vektörleri). Üretim dayanıklılığı için ayarlandı. |
| `AIHUMMER_RERANKER_URL` | RAG yeniden sıralama sepeti URL | text | — | HTTP URL karma aramayı yeniden sıralamak için çapraz kodlayıcı sepetinin. Boş = yeniden sıralama kapalı. Başlangıçta/yeniden başlatma sonrasında uygulanır. |
## Moderation
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_MODERATION` | Giriş denetimi | bool | `1` | "off", jailbreak/istem eklemeye karşı yerleşik korumayı devre dışı bırakır. Başlangıçta/yeniden başlatma sonrasında uygulanır. |
| `AIHUMMER_MODERATION_REFUSAL` | Denetleme reddi mesajı | text | — | Moderatör bir isteği engellediğinde döndürülen ret metni (boş = yerleşik). Başlangıçta/yeniden başlatma sonrasında uygulanır. |
## Public access
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_PUBLIC_URL` | Genel ağ geçidi URL (Web kullanıcı arayüzü + istemciler) | text | — | Bu ana bilgisayarın proxy sunucusu → ağ geçidi bağlantı noktası (AIHUMMER_GATEWAY_ADDR, varsayılan :8780). Web kullanıcı arayüzü ve iOS/web istemcileri tarafından kullanılır. |
| `POCKET_AGENT_GATEWAY_BASE_URL` | Cep-agent ağ geçidi genel URL | text | — | Proxy → cep aracısı ağ geçidi bağlantı noktası (POCKET_AGENT_PORT, varsayılan 8080). Uzak aracı bunu tek seferlik bir bilet aracılığıyla çevirir. |
| `TELEGRAM_PUBLIC_URL` | Telegram webhook genel URL | text | — | Yalnızca web kancası modu — proxy → telgraf bağlayıcı bağlantı noktası (AIHUMMER_TELEGRAM_CONNECTOR_PORT, varsayılan 8091). herkese açık URL gerekli). |
## SSO (LDAP/AD)
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_LDAP_BASE_DN` | Kullanıcı arama tabanı DN'si | text | — | Kökte ara, ör. OU=Users,DC=corp,DC=example. |
| `AIHUMMER_LDAP_BIND_DN` | Hizmet bağlama DN'si | text | — | İlk arama bağlantısı için kullanılan hesap, ör. CN=svc-aihummer,OU=Hizmet,DC=corp,DC=örnek. Boş = anonim arama. |
| `AIHUMMER_LDAP_DEFAULT_ROLE` | LDAP: Varsayılan rol (grup eşleşmesi yok) | text | — | Hiçbir grup bir eşlemeyle eşleşmediğinde verilen rol. Boş = rol yok. |
| `AIHUMMER_LDAP_ENABLED` | LDAP/AD girişini etkinleştir | bool | `0` | Açık olduğunda, yönetici oturum açma işlemleri dizine geri döner. Bağlama parolası, Gizliler'de bulunur (kapsam ldap, adbind_password). |
| `AIHUMMER_LDAP_GROUP_ATTR` | Grup özelliği (varsayılan memberOf) | text | — | Grup DN'lerini listeleyen kullanıcı girişindeki öznitelik. Boş, grup→rol eşlemeyi devre dışı bırakır. |
| `AIHUMMER_LDAP_ROLE_MAPPINGS` | LDAP: Grup→rol eşlemeleri (JSON) | text | — | JSON grup DN nesnesi (veya çıplak CN) → rol, ör. {"CN=Admins,OU=Groups,DC=corp,DC=example":"admin","Operators":"operator"}. |
| `AIHUMMER_LDAP_SKIP_TLS_VERIFY` | Atla TLS doğrulama (yalnızca laboratuvar, 1/0) | bool | `0` | Dizin sertifikası doğrulamasını devre dışı bırakır. Üretimde asla etkinleştirmeyin. |
| `AIHUMMER_LDAP_URL` | Dizin URL | text | — | ör. ldaps://ad.corp.example:636 (TLS) veya ldap://dc1.corp.example:389. |
| `AIHUMMER_LDAP_USER_ATTR` | Giriş özelliği (varsayılan sAMAccountName) | text | — | Kullanıcının yazdığı oturum açma bilgilerine göre eşleşen LDAP/Active Directory özelliği (varsayılan sAMAccountName; OpenLDAP için kullanıcı kimliği, UPN tarzı oturum açma işlemleri için userPrincipalName). |
| `AIHUMMER_LDAP_USER_FILTER` | Kullanıcı arama filtresi | text | — | Giriş için %s içermelidir. AD: (sAMAccountName=%s); LDAP'yi açın: (uid=%s). |
## SSO (OIDC)
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_OIDC_AUDIENCE` | OIDC kitle | text | — | Beklenen `aud` talebi — başka bir bağlı taraf için basılan jetonları reddetmek için bunu THIS kaynağın hedef kitlesine ayarlayın. `aud` talebi artık varsayılan olarak her jetonda REQUIRED'dir (aud olmayan bir jeton reddedilir); bu ayarlandığında, aud'un da bunu içermesi gerekir. Üretimde kesinlikle önerilir. |
| `AIHUMMER_OIDC_ISSUER` | OIDC veren URL | text | — | IdP veren kuruluş (ör. https://login.example.com). Ayarlandığında OIDC JWT kimlik doğrulamasını etkinleştirir. |
| `AIHUMMER_OIDC_JWKS_URL` | OIDC JWKS URL adresi | text | — | JSON Web Anahtarı Seti uç noktası, belirteç imzalarını doğrulamak için kullanılır. |
| `AIHUMMER_OIDC_TENANT_CLAIM` | OIDC çalışma alanı talebi | text | — | JWT çalışma alanı kimliğini taşıyan iddia (ör. tenant_id / org). |
## SSO (SAML)
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_SAML_DEFAULT_ROLE` | SAML: Varsayılan rol (grup yok) eşleşme) | text | — | Belirtilen değer eşlemeleri olmadığında verilen rol. Boş = rol yok. |
| `AIHUMMER_SAML_ENABLED` | SAML 2.0'ı etkinleştirin SSO | bool | `0` | /saml/metadata, /saml/acs, /saml/login'i açığa çıkarır. SP özel anahtarı Gizliler'de bulunur (kapsam saml, sp_key adı). |
| `AIHUMMER_SAML_ENTITY_ID` | SP varlık kimliği | text | — | SP varlık kimliği (boşsa varsayılan olarak ⟨root⟩/saml/metadata şeklindedir). |
| `AIHUMMER_SAML_IDP_METADATA` | IdP meta veriler XML | text | — | IdP'nin SAML meta veri belgesini yapıştırın (Okta/Azure AD/ADFS). |
| `AIHUMMER_SAML_ROLE_ATTRIBUTE` | Rol/grup özelliği (varsayılan gruplar) | text | — | Grup/rol değerlerini taşıyan onaylama özelliği. |
| `AIHUMMER_SAML_ROLE_MAPPINGS` | SAML: Grup→rol eşlemeleri (JSON) | text | — | JSON iddia edilen değerin nesnesi → rol, ör. {"AdminGroup":"admin","Ops":"operator"}. |
| `AIHUMMER_SAML_ROOT_URL` | SP kökü URL | text | — | Bu ağ geçidinin dışarıdan erişilebilen tabanı URL, ör. https://app.example.com. ACS = ⟨root⟩/saml/acs. |
| `AIHUMMER_SAML_SP_CERT` | SP sertifikası (PEM) | text | — | Genel SP imzalama sertifikası (PEM). Eşleşen özel anahtar Secrets'a (scope saml, name sp_key) gider. |
## Security
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_AIRGAPPED` | Hava boşluklu mod | bool | `0` | Genel internete (yalnızca dahili/izin verilenler listesi ana bilgisayarlarına) model odaklı çıkışı engeller. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_AUDIT_RETENTION_DAYS` | Denetim günlüğü tutma (gün, 0=sonsuza kadar) | int | `0` | Denetim günlüğünün kaç gün saklanacağı; eski girişler günlük olarak silinir. 0/boş = sonsuza kadar sakla. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_CODE_EXEC_ALLOW_HOST` | Ana makinede code_exec'e izin ver (sanal alan YOK) | bool | `0` | ⚠️ Korumalı alan olmadan doğrudan ana makinede kod yürütülmesine izin verin. Yalnızca güvenilir bir ev laboratuvarı için. AIHUMMER_CODE_EXEC_SANDBOX_IMAGE ayarlamak daha güvenlidir. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_CORS_ORIGINS` | İzin verilen CORS kökenler (virgül) | text | — | İzin verilen Kaynakların virgülle ayrılmış listesi. Boş = CORS'ye izin verilmiyor (yalnızca aynı kökenli). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_CSP` | Content-Security-Policy üst bilgisi (geçersiz kıl) | text | — | CSP üstbilgisini geçersiz kılar. Boş = güvenli bir varsayılan. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_INBOUND_SECRET` | Bağlayıcı→ağ geçidi paylaşıldı secret | text | — | Bağlayıcının kimliğini doğrulayan paylaşılan sır→ağ geçidi atlama noktası (bağlayıcı tarafındaki değerle eşleşmelidir). Boş = gelen uç nokta UNAUTHENTICATED. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_OPENAI_COMPAT_KEY` | OpenAI uyumlu gelen: statik API anahtar | text | — | OpenAI uyumlu istemcilerin, ağ geçidinin yerleşik /v1 uç noktasına (P8 ana ağ geçidi) karşı kimlik doğrulaması yapmak için kullandığı statik anahtar. Boş = statik kimlik doğrulama devre dışı (kişisel anahtarlar kalır). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_OPENAI_COMPAT_WORKSPACE` | OpenAI uyumlu gelen: çalışma alanı kimliği | text | — | Statik OpenAI uyumlu kimlik doğrulamanın eşleştiği çalışma alanı kimliği. Boş = AIHUMMER_DEFAULT_WORKSPACE_ID. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_REQUIRE_2FA` | Şunlar için 2FA gerektirir: operatörler | bool | `0` | Operatörler için ikinci bir faktör (TOTP/passkey) gerektirir. Açık olduğunda, 2FA'sız operatörlerden, oturum açarken hemen bunu ayarlamaları istenir (engelleme olmadan, böylece sahibin hiçbir zaman kilitlenmemesi sağlanır). Hemen uygulandı. |
| `AIHUMMER_REQUIRE_SECURE` | Yalnızca güvenli (HTTPS/WSS) bağlantıları kabul et | bool | `0` | Açıkken, düz HTTP istekleri HTTPS'ye yönlendirilir (GET/HEAD için) veya reddedilir (403); localhost erişimine her zaman izin verilir, böylece operatör asla dışlanmaz. TLS sonlandırıcı ters proxy'den X-Forwarded-Proto'yu onurlandırır. Başlangıçta/yeniden başlatma sonrasında uygulanır. |
| `AIHUMMER_TRUSTED_PROXIES` | Güvenilen ters proxy CIDR'ler (virgül) | text | — | Güvenilir ters proxy ağlarının virgülle ayrılmış listesi (CIDR, ör. 10.0.0.0/8,192.168.0.0/16 veya tek IP'ler). Yalnızca bu adreslerden gelen COMING istekleri için, istemci IP'sini (denetim, IP izin verilenler listesi, kaba kuvvet önleme) belirlemek için kullanılan X-Forwarded-For başlığı kullanılır. Boş = ONLY gerçek eş adresine güvenin (XFF yoksayıldı, IP sahtekarlığı imkansız). Anında uygulanır. |
## Tools
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_CODE_EXEC` | code_exec'i etkinleştirin | bool | `0` | — |
| `AIHUMMER_CODE_EXEC_INTERPRETERS` | Code-exec yorumlayıcıları (JSON) | text | — | JSON nesnesi {language: path_to_binary}, ör. {"python":"/usr/bin/python3"}. Boş = otomatik algılama. Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Code-exec korumalı alan görüntüsü | text | — | code_exec'yi yalıtmak için kapsayıcı görüntüsü (ağ yok, salt okunur rootf'ler, sınırlar). Boş = host-exec (güvenilir ortam). Başlangıçta/yeniden başlatmanın ardından uygulanır. |
| `AIHUMMER_DB_QUERY_DSN` | db_query DSN (en az ayrıcalıklı, sahip olmayan bir rol kullanın — sorgular RLS-etkili çalışma alanı kapsamına alınarak çalıştırılır) | text | — | — |
| `AIHUMMER_FS_ROOT` | Dosya sistemi aracı kökü | text | — | — |
| `AIHUMMER_HTTP_ALLOWLIST` | http_request izin verilenler listesi | text | — | — |
| `AIHUMMER_HTTP_AUTH_JSON` | http_request auth (JSON) | text | — | — |
| `AIHUMMER_MCP_SERVERS` | MCP sunucular (JSON) | text | — | — |
| `AIHUMMER_WEBFETCH_ALLOWLIST` | web_fetch izin verilenler listesi | text | — | — |
## Web UI (separate port)
| Anahtar | Ad | Tür | Varsayılan | Ne yapar |
| --- | --- | --- | --- | --- |
| `AIHUMMER_WEBUI_API_BASE` | API temel URL Web kullanıcı arayüzü çağrıları | text | — | Mutlak kaynak (örneğin, /v1/admin/* çağrıları için https://api.example.com) ayrı olarak barındırılan SPA hedefleri. Boş = genel ağ geçidine URL, ardından yerel ağ geçidi adresine geri dönün. Yöneticinin tarayıcısından erişilebilir olmalıdır; API bu Web kullanıcı arayüzünün kaynağına izin vermelidir CORS aracılığıyla (aşağıya otomatik olarak eklenmiştir). |
| `AIHUMMER_WEBUI_ENABLED` | Yönetici Web kullanıcı arayüzüne hizmet etme kendi limanında | bool | `1` | Varsayılan olarak etkindir: SPA yöneticisine, yalnızca dahili bir arayüze bağlanabilen ayrı bir dinleyicinin (AIHUMMER_WEBUI_ADDR) ROOT'sinde sunulur. Ana ağ geçidi bağlantı noktası API + eşleştirme + WS + SSE tutar ve NOT /admin/ hizmetini verir. Web Kullanıcı Arayüzü dinleyicisini tamamen devre dışı bırakmak için 0'a ayarlayın. |
| `AIHUMMER_WEBUI_ORIGIN` | Web kullanıcı arayüzü tarayıcı kaynağı (CORS) | text | — | Web Kullanıcı Arayüzü'nün Tarayıcı Kaynağı (ör. https://admin.example.com),, kimlik bilgileriyle API CORS izin verilenler listesine otomatik olarak eklenir. Boş = AIHUMMER_WEBUI_ADDR'den türetilmiştir (http://host:port). Tarayıcı Web Kullanıcı Arayüzüne bir web sitesi üzerinden ulaştığında bunu ayarlayın) proxy/ana bilgisayar adı bağlama adresinden farklıdır. |
Operatöre açık ayarlar: 138.