AiHummer
Тоҷикӣ
ВоридшавӣКабинети шахсӣ
v1.2.x
{ }Swagger

Маълумотнома оид ба танзимот

v1.2.x · навсозӣ шуд 2026-08-06

Дар ин ҷо ҳамаи танзимоте оварда шудаанд, ки оператор дар сервери AiHummer тағйир дода метавонад. Саҳифа аз каталоги худи маҳсулот сохта мешавад, бинобар ин ба сервери шумо мувофиқ аст.

Қимат дар веб-интерфейс ё бо фармони aihummer settings set KEY VALUE дода мешавад (Сатри фармон). Сутуни қимати пешфарз он чизеро нишон медиҳад, ки сервер то додани қимати шумо истифода мебарад.

[!NOTE] Қиматҳои махфӣ дар ин ҷо чоп намешаванд, калидҳои хизматии таъминкунанда бошанд, тамоман оварда намешаванд — маҳсулот онҳоро аз ҳамаи рӯйхатҳо пинҳон мекунад. Тире қимати холӣ ё шарҳеро мефаҳмонад, ки танҳо дар веб-интерфейс нишон дода мешавад.

API

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_PERSONAL_API_KEYS Калидҳои шахсии API барои API-и мутобиқ бо OpenAI bool 1 \“off\” аутентификатсияро бо калидҳои шахсӣ дар эндпоинти мувофиқи OpenAI хомӯш мекунад. Ҳар қимати дигар = фаъол. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.

Agent

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_APPROVAL_TOOLS Абзорҳое, ки тасдиқ талаб мекунанд text
AIHUMMER_SUBAGENT_MAX_DEPTH Умқи ниҳоии зер-агентҳо int 2
AIHUMMER_SUBAGENT_TIMEOUT_SEC Вақти интизории зер-агент (сония) int 180 Вақти ҳадди аксари як иҷрои зерагент, бо сония. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_TOOL_SEARCH Боркунии танбали абзорҳо (tool_search) bool false Танҳо абзорҳои асосӣ ва мета-абзори ҷустуҷӯро нишон додан, боқимондаро бо дархост ошкор кардан. Ҳангоми зиёд будани абзорҳо навбатҳоро тезтар ва арзонтар мекунад, бо хатари хурди он ки модел абзори камистифодаро нодида монад.
AIHUMMER_TOOL_SEARCH_CORE Боркунии танбал: абзорҳои ҳамеша фаъол text Номҳои абзорҳо бо вергул, ки ҳатто дар реҷаи танбал дарҳол нишон дода мешаванд.
AIHUMMER_TOOL_SEARCH_THRESHOLD Боркунии танбал: ҳадди ақали абзорҳо барои ба таъхир андохтан int 12 Танҳо вақте ба таъхир гузоред, ки пас аз филтри профили агент аз ин шумора зиёдтар абзор монад.

Agent · Reasoning

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_AGENT_BEST_OF_N Намунаҳои best-of-N (0/1=хомӯш, ≥2=фаъол) int 0 ≥2 N номзад сэмпл мекунад ва довар беҳтаринро интихоб мекунад. Арзиши он N× генератсия аст.
AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT Баҳс: промпти довар (бознависӣ) text Промпти довари мубоҳисаро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_AGENT_DEBATE_N Андозаи панели баҳс (0/1=хомӯш, ≥2=фаъол) int 0 ≥2 панели мубоҳисаи N номзад + доварро оғоз мекунад. Арзиши он N× генератсия аст.
AIHUMMER_AGENT_DEBATE_PROMPT Баҳс: промпти номзад (бознависӣ) text Промпти номзади мубоҳисаро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_AGENT_DEBATE_ROUNDS Баҳс: даврҳо int 1 Шумораи даврҳои мубоҳисаи панели номзадҳо. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_AGENT_JUDGE_PROMPT Промпти довари best-of-N (бознависӣ) text Промпти довари best-of-N-ро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_AGENT_PLAN_PROMPT Промпти нақшакаш (бознависӣ) text Промпти нақшакашро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_AGENT_PLAN_STEPS Нақшакаш-иҷрокунанда: ҳадди ниҳоии қадамҳои нақша (0=хомӯш) int 0 ⟩0 гузариши алоҳидаи нақшакаш→иҷрокунанда→синтезро оғоз мекунад (барои вазифаҳои мураккаби бисёрқадама муфид). 0 = хомӯш. Одатан 4–8.
AIHUMMER_AGENT_PLAN_STEP_ITERS Нақшакаш: такрори абзорҳо дар ҳар қадам (0=пешфарз) int 0 Шумораи такрори даъвати абзорҳоро дар ҳар қадами нақша маҳдуд мекунад. 0 = қимати дарунсохти пешфарз (4).
AIHUMMER_AGENT_REFLECT Гузариши худтанқидӣ bool 0 Пеш аз ҷавоби ниҳоӣ гузариши таҳлил/худтанқидиро илова мекунад.
AIHUMMER_AGENT_REFLECT_PROMPT Промпти рефлексия (бознависӣ) text Промпти худтанқидиро бознависӣ мекунад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_AGENT_SELF_HEAL Худбарқароршавӣ: такрор ҳангоми хатогиҳои абзорҳо (0=хомӯш) int 0 ⟩0 даъватҳои нобарори абзорҳоро бо ишораи ислоҳкунанда то ҳамин ҳад такрор мекунад.

Agent · System prompt

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_LOCALE Локали пешфарз text ru-RU Забон/локали пешфарзи ҷавоб, мас. ru-RU. Дастурҳои персона/оператор афзалият доранд.
AIHUMMER_TIMEZONE Минтақаи вақт text UTC Минтақаи вақти IANA барои дохил кардани сана, мас. Europe/Moscow. Пешфарз UTC.

Channels

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_CONFIDENTIAL_PERSONA Персонаи махфии веб bool 0 Ҳангоми фаъол будан агенти веб-чат маълумоти персона/шахсияти худро ошкор ва нигоҳ намедорад ва танҳо аз рӯи вазифа ҷавоб медиҳад — барои ҷойгиркуниҳои веби беном ё ба махфият ҳассос. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_INBOUND_REQUIRE_BINDING Танҳо ба корбарони бақайдгирифташуда ҷавоб додан text true true = бот ҳар фиристандаро дар канал, ки корбари сабтшудаи AiHummer НЕСТ (корбар бо пайванди нақш), нодида мегирад — аъзои тасодуфии чат ва даъватҳои меҳмон ҷавоб намегиранд. false (пешфарз) = ба ҳама ҷавоб додан.

Integrations

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_A2A_PUBLISH Нашри агент тавассути Agent2Agent (A2A) bool 0 Агентро ҳамчун сервери A2A нашр кунед (Agent Card + POST /a2a/message). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_MCP_EXPORT_TOOLS text
AIHUMMER_MCP_PUBLISH Нашри абзорҳо тавассути MCP bool 0 Абзорҳоро ҳамчун сервери MCP дар POST /v1/mcp нашр кунед. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.

Knowledge connectors

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_KB_SYNC_INTERVAL Фосилаи азнавҳамоҳангсозии банақшагирифташудаи коннекторҳо (0/холӣ = хомӯш) text Мӯҳлат (мас. 6h, 30m) барои аз нав синхронкунии худкори фонии ҳамаи коннекторҳои дониши танзимшуда дар ҳамаи фазоҳои корӣ. Холӣ/0 = хомӯш. Синхронкунии такрорӣ идемпотентӣ аст (иваз аз рӯи source, бе такрор). slack_export дохил намешавад (zip-и он дастӣ бор карда мешавад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.

LLM

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_CASCADE_MIN_CHARS Каскад: ҳадди ақали аломатҳо барои эскалатсия int 0 Ҳадди дарозии дархост (аломатҳо), ки аз он модели қавитари каскад фаъол мешавад. 0 = пешфарз. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_CASCADE_STRONG_MODEL Каскад: модели захиравии қавитар text Модел, ки барои дархостҳои дароз/мураккаб каскадӣ истифода мешавад (холӣ = хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_CODEX_BASE_URL URL-и базавии Codex text Базаи транспорти Codex (обунаи ChatGPT). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_CODEX_MAX_OUTPUT_TOKENS Ҳадди ниҳоии токенҳои баромад (0 = бе маҳдудият) int 0 Маҳдудияти max_output_tokens барои як навбати чат. 0 = бе маҳдудият. Дар моделҳои reasoning токенҳои мулоҳиза низ ба ҳамин буҷет ҳисоб мешаванд, бинобар ин қимати хеле хурд ҷавоби холии «incomplete: max_output_tokens» медиҳад. Дарҳол татбиқ мешавад (бе бозоғозӣ).
AIHUMMER_CODEX_MODEL Идентификатори модел (транспорти Codex / gpt-5.5) text gpt-5.5 Идентификатори модели транспорти асосии Codex/ChatGPT (мас. gpt-5.5, gpt-5.5-codex). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_CODEX_REASONING_EFFORT Умқи мулоҳизаронӣ enum: none \| low \| medium \| high \| xhigh low Умқи мулоҳизаи модел барои навбатҳои чат, вақте параметрҳои агент онро таъин намекунанд. Қиматҳои дурусти gpt-5.5: none, low, medium, high, xhigh (НЕ minimal — gpt-5.5 онро бо HTTP 400 рад мекунад). Баландтар = сифати беҳтар, вале сусттар/гаронтар. Қимати нодуруст бехатар ба low табдил меёбад. Дарҳол татбиқ мешавад (бе бозоғозӣ).
AIHUMMER_LLM_CALL_TIMEOUT_S Вақти интизории як даъват (сония) int 120 Буҷети вақт барои ЯК даъвати модел (зидди дармондагӣ: gpt-5.5 метавонад беохир «фикр» кунад ва навбатро кушода нигоҳ дорад). Пас аз ба охир расидани мӯҳлат даъват бо хатогии ErrCallTimeout бе такрор қатъ мешавад. 0 = бе маҳдудият. Дарҳол татбиқ мешавад (бе бозоғозӣ).
AIHUMMER_LLM_GATEWAY_URL URL-и дарвозаи LLM text URL-и базавии эндпоинти модели мувофиқи OpenAI, ки агент ба он муроҷиат мекунад (сервери маҳаллии llama.cpp/vLLM/Ollama ё шлюзи ҷойгиршуда). Холӣ монед — эндпоинти пешфарзи провайдер истифода мешавад.
AIHUMMER_LLM_MODEL Модели LLM text Ном/идентификатори модел, ки дар ҳар навбат ба провайдер фиристода мешавад (модели эндпоинти шумо). Бояд бо моделе, ки эндпоинт воқеан пешниҳод мекунад, мувофиқ бошад.
AIHUMMER_LLM_PROVIDER Провайдери LLM text Кадом бэкенди модел истифода шавад (эндпоинти мувофиқи OpenAI ё транспорти Codex/обунаи ChatGPT). Муайян мекунад, ки дархостҳо чӣ тавр фиристода ва аутентификатсия мешаванд.
AIHUMMER_LLM_RETRIES Такрори LLM ҳангоми хатогии муваққатӣ int 3 Шумораи такрори дархост ба LLM ҳангоми хатогии муваққатӣ. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_LLM_TEMPERATURE Ҳарорат text Ҳарорати сэмплкунӣ (0..2), вақте параметрҳои агент онро таъин намекунанд. Холӣ = нафиристодан. ДИҚҚАТ: моделҳои мулоҳизакори gpt-5.5 (Codex) temperature-ро рад мекунанд — барои онҳо майдонро холӣ монед; онро танҳо ҳангоми истифодаи бэкенди ғайримулоҳизавӣ таъин кунед. Дарҳол татбиқ мешавад (бе бозоғозӣ).
AIHUMMER_LLM_TOP_P Top-p (nucleus-намунагирӣ) text Ҳадди сэмплкунии nucleus (0..1), вақте параметрҳои агент онро таъин намекунанд. Холӣ = нафиристодан. Мисли temperature, gpt-5.5 reasoning онро рад мекунад — танҳо барои бэкендҳои ғайримулоҳизавӣ таъин кунед. Дарҳол татбиқ мешавад (бе бозоғозӣ).
AIHUMMER_OPENAI_API Услуби API-и OpenAI (chat | responses) enum: \| chat \| responses chat = /chat/completions, responses = /responses. Холӣ = худкор/пешфарз. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_OPENAI_API_KEY Калиди API-и OpenAI-и нативӣ (пешфарз барои насб) text Калиди аккаунти OpenAI-и шумо барои сикли нативии OpenAI (агар OpenAI-ро ҳамчун провайдери пешфарз истифода баред). Бо BYOK-и фазои корӣ дар саҳифаи «Моделҳо» омехта накунед. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_OPENAI_BASE_URL URL-и базавии OpenAI-и нативӣ text Базаи API-и мувофиқи OpenAI (мас. https://api.openai.com/v1). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_OPENAI_MODEL Модели OpenAI-и нативӣ text Модел барои сикли нативии OpenAI (агар AIHUMMER_OPENAI_API_KEY таъин шуда бошад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_ROUTER_COMPLEX_MODEL Роутер: модел барои дархостҳои мураккаб text Модел барои дархостҳои мураккаб (холӣ = ин гурӯҳ хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_ROUTER_SIMPLE_MODEL Роутер: модел барои дархостҳои содда text Модел барои дархостҳои содда (холӣ = ин гурӯҳ хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_ROUTER_STANDARD_MODEL Роутер: модел барои дархостҳои муқаррарӣ text Модел барои дархостҳои муқаррарӣ (холӣ = ин гурӯҳ хомӯш). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.

Media

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_DEEPGRAM_API_KEY Калиди API-и Deepgram text API-калиди Deepgram (муҳаррики STT = deepgram). Аз ин ҷо ё аз AIHUMMER_STT_API_KEY гирифта мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_DEEPGRAM_MODEL Модели Deepgram text nova-2 Модели Deepgram (мас. nova-2, nova-3, base). Аз дастрасии лоиҳа барои ҳамин калид вобаста аст. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_DEEPGRAM_URL URL-и базавии Deepgram text Базаи Deepgram API. Холӣ = https://api.deepgram.com. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_IMAGE_BASE_URL URL-и базавии API-и тасвирҳо (захиравии OpenAI) text Базаи /images API ҳангоми кор тавассути калиди OpenAI (холӣ = https://api.openai.com/v1). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_IMAGE_MODEL Модели тавлиди тасвир text Модел барои image_generate (пешфарз gpt-image-2). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_MEDIA_MAX_UPLOAD_MB Ҳаҷми ниҳоии боркунии медиа (МБ) int 256 Ҳаҷми ҳадди аксари як боркунии медиа (PUT /v1/media/{id}/content), бо мегабайт. Навиштанро ба диск тавассути порти ҷамъиятӣ маҳдуд мекунад (ҳифз аз саршавӣ). Пешфарз 256. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_STT_API_KEY Калиди API-и STT (ихтиёрӣ) text Bearer-и ихтиёрӣ, агар сайдкари STT онро талаб кунад (install.sh метавонад онро созад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_STT_CODEX_URL URL-и муҳаррики STT барои Codex text Базаи /v1/audio/transcriptions-и мувофиқи OpenAI барои муҳаррики codex (табдили нутқ ба матн тавассути обунаи ChatGPT). Холӣ = базаи Codex. Bearer аз AIHUMMER_STT_API_KEY ё AIHUMMER_CODEX_ACCESS_TOKEN гирифта мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_STT_ENGINE Муҳаррики STT enum: faster-whisper \| deepgram \| off faster-whisper Муҳаррики шинохти нутқ. faster-whisper = сайдкари ройгони маҳаллӣ (пешфарз, аз қуттӣ насб мешавад, URL = AIHUMMER_STT_URL, бе бор ба API-ҳои беруна). deepgram = Deepgram-и абрӣ (тез, калиди AIHUMMER_DEEPGRAM_API_KEY, пулакӣ бо ҳудуди ройгон). off = шинохт хомӯш. (Обунаи Codex/ChatGPT табдили аудиоро ба матн дастгирӣ НАМЕКУНАД.) Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_STT_LANGUAGE Забони STT text Забони шинохт (BCP-47, мас. ru/en). Аз ҷониби муҳаррики deepgram истифода мешавад (модели nova-2). Холӣ = муайянкунии худкор/пешфарзи муҳаррик. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_STT_MODEL Модели STT text Systran/faster-whisper-small Модели faster-whisper (мас. small/medium/large-v3 ё Systran/faster-whisper-⟨size⟩). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_STT_URL URL-и табдили нутқ ба матн (faster-whisper) text URL-и сайдкари маҳаллии faster-whisper (мувофиқи OpenAI /v1/audio/transcriptions). Холӣ = пешфарзи худкори http://127.0.0.1:8001, ки install.sh худаш менависад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_TTS_API_KEY Калиди API-и TTS (edge-tts) text Bearer байни шлюз ва сайдкари edge-tts (install.sh онро худкор месозад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_TTS_ENABLED Синтези нутқ фаъол аст bool 1 Синтези нутқро фаъол мекунад (абзори tts + реҷаи овозӣ). Сайдкари edge-tts аз қуттӣ насб мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_TTS_MODEL Модели TTS text Номи модел барои хидмати edge-tts. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_TTS_URL URL-и синтези нутқ (edge-tts) text URL-и сайдкари маҳаллии edge-tts (мувофиқи OpenAI /v1/audio/speech). Холӣ = пешфарзи худкори http://127.0.0.1:8002, ки install.sh худаш менависад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_TTS_VOICE Овози TTS (пешфарз de-DE-FlorianMultilingualNeural) text de-DE-FlorianMultilingualNeural Овози пешфарзи edge-tts (бисёрзабона, аз ҷумла русӣ). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_VIDEO_API_KEY Калиди API-и таҳлили видео text Калиди дастрасӣ ба сайдкари таҳлили видео (агар лозим бошад). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_VIDEO_URL URL-и таҳлили видео (ffmpeg) text URL-и сайдкари таҳлили видео. Холӣ = хомӯш. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.

Media · Voice

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_VOICE_AEC Бартарафсозии акс-садо (AEC) bool 1 Талаб кардани echoCancellation ҳангоми сабт (WebRTC). Акси садои TTS-ро дар микрофон бартараф мекунад (Moltis #1129).
AIHUMMER_VOICE_AGC Танзими худкори баландӣ bool 1
AIHUMMER_VOICE_BARGEIN_FRAMES Кадрҳо барои қатъ кардан (barge-in) int 5 Чанд кадри пайдарпайи овоздор (≈20мс) пахши садои ботро қатъ мекунад.
AIHUMMER_VOICE_DUPLEX Овози зиндаи пурраи дуҷониба bool 0 Реҷаи зиндаи пурраи дутарафаро фаъол мекунад (стриминг + VAD + barge-in). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_VOICE_NOISE_SUPPRESSION Пахши садоҳои изофӣ bool 1
AIHUMMER_VOICE_VAD_THRESHOLD Ҳадди энергияи VAD (0..1) text 0.02 Ҳадди энергияи нутқ барои гейтинги VAD ҳангоми сабт; пасттар = ҳассостар.

Memory

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_EMBEDDER_DIM Андозаи вектори эмбеддер int 768 Ченаки вектор — бояд бо модел мувофиқ бошад (multilingual-e5-base=768, bge-m3=1024).
AIHUMMER_EMBEDDER_KEEPALIVE Keep-alive-и эмбеддер text 5m keep_alive барои эмбеддери Ollama (танҳо ҳангоми AIHUMMER_MEMORY_RETRIEVAL=embedding). Пешфарз 5m — модели бекор аз хотира бароварда мешавад ва раннери бекормондаи ollama худаш тоза мешавад. -1 (абадӣ нигоҳ доштан) ТАВСИЯ НАМЕШАВАД: аз сабаби хатогии ollama раннери бандшуда метавонад рӯзҳо як ядрои CPU-ро банд кунад. Оғози сард пас аз бекорӣ бо гармкунӣ ҳангоми оғози шлюз ҷуброн мешавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_EMBEDDER_MODEL Модели эмбеддер text yxchia/multilingual-e5-base Модели эмбеддинги Ollama. Пешфарз multilingual-e5-base — бисёрзабона (аз ҷумла русӣ), 768-ченака, сабук ва тез дар CPU (~1-2с ба ҳар эмбеддинг). Префиксҳои query/passage барои e5 худкор татбиқ мешаванд. Барои сифати ҳадди аксар дар GPU bge-m3-ро истифода баред (DIM=1024 таъин кунед). Бояд бо AIHUMMER_EMBEDDER_DIM мувофиқ бошад.
AIHUMMER_EMBEDDER_PASSAGE_PREFIX Префикси ҳуҷҷати эмбеддер text Префикси ҳуҷҷати нигоҳдошташавандаро бознависӣ кунед (моделҳои e5 худкор \“passage: \”-ро истифода мебаранд). Барои муайянкунии худкор аз рӯи номи модел холӣ монед.
AIHUMMER_EMBEDDER_QUERY_PREFIX Префикси дархости эмбеддер text Префикси дархости ҷустуҷӯро бознависӣ кунед (моделҳои e5 худкор \“query: \”-ро истифода мебаранд). Барои муайянкунии худкор аз рӯи номи модел холӣ монед.
AIHUMMER_EMBEDDER_URL URL-и эмбеддер (мутобиқ бо Ollama) text Эмбеддингҳои воқеии семантикӣ. Насбкунанда сайдкари Ollama-ро ҷойгир мекунад ва инро худкор таъин мекунад; ТАЪИН НАШУДА = эмбеддери hash (танҳо лексикӣ, ёдоварии заиф).
AIHUMMER_MEMORY_CAPTURE Реҷаи сабти хотира enum: auto \| review \| off auto auto = худкор дар хотир гирифтан ва ба ёд овардан; review = ҳамчун номзадҳое, ки тасдиқи дастӣ мехоҳанд, нигоҳ доштан; off = бе сабт.
AIHUMMER_MEMORY_CONTEXT_TIMEOUT Вақти интизории боркунии хотира text 3s Ҳадди интизорӣ барои боркунии хотира дар оғози ҷавоб (эмбеддинги дархост + ҷустуҷӯ). Агар эмбеддер бор бошад ва ба мӯҳлат нарасад, ҷавоб БЕ блоки хотира давом мекунад ва овезон намемонад. Формати Go duration (мас. 2s, 1500ms). 0 = бе маҳдудият. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_MEMORY_DREAM_INTERVAL Фосилаи гузариши «хоб» string 1h Чанд вақт як бор гузариши худнигаҳдорандаи dream даъвоҳои санҷидашударо дар ҳамаи доираҳо барои зиддият месанҷад (Go duration, мас. 30m/1h/6h). 0 = хомӯш кардан.
AIHUMMER_MEMORY_EXTRACT Истихроҷи фактҳо тавассути LLM bool 1 Ба ҷои нигоҳ доштани порчаҳои хоми ҷумла, далелҳои муназзами субъект/предикат/объектро тавассути LLM ҷудо кардан (пешфарз ФАЪОЛ) — барои кори механизмҳои граф/зиддият/dream зарур аст. Ба ҳар паёми сабтшуда як даъвати LLM илова мекунад; барои сарфаи он хомӯш кунед.
AIHUMMER_MEMORY_RETRIEVAL Реҷаи бозёбии хотира enum: fulltext \| embedding fulltext Хотира чӣ тавр ҷустуҷӯ мешавад. fulltext (пешфарз) = ҷустуҷӯи пурраматнии Postgres аз рӯи матни далелҳо — БЕ модели эмбеддер, бе сайдкар, бе бори CPU (мисли einstein-и кӯҳна дар AiHummer). embedding = ҷустуҷӯи семантикии векторӣ тавассути эмбеддер (AIHUMMER_EMBEDDER_URL/ollama) — аз рӯи маъно дақиқтар, вале CPU-ро бор мекунад ва сайдкар талаб мекунад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_MEMORY_TOKEN Токени хидматии хотираи дурдаст text Токени хидматӣ барои авторизатсия дар Einstein Retrieval API (ҳамчун Authorization: Bearer … фиристода мешавад). Танҳо ҳангоми таъин будани AIHUMMER_MEMORY_URL лозим аст. Холӣ = бе авторизатсия (танҳо барои насбҳои dev бо авторизатсияи retrieval хомӯш).
AIHUMMER_MEMORY_URL URL-и хотираи дурдаст (плагини Einstein) text URL-и плагини мустақили хотираи Einstein (қарордоди aihummer.memory.v1, мас. http://127.0.0.1:8820). ХОЛӢ (пешфарз) = модули дарунсохти хотираи Go. Ҳангоми таъин будан боркунии контексти навбат тавассути HTTP ба /context + /retrieval-и плагин меравад; ҳангоми хато/дастнорасӣ мулоим ба модули дарунсохт бармегардад (бе фурӯпошӣ). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_QDRANT_API_KEY Калиди API-и Qdrant text
AIHUMMER_QDRANT_URL URL-и Qdrant (анбори доимии векторӣ) text ТАЪИН НАШУДА = анбор дар хотира (векторҳо ҳангоми бозоғозӣ ГУМ мешаванд). Барои нигоҳдории боэътимод дар муҳити корӣ таъин кунед.
AIHUMMER_RERANKER_URL URL-и сайдкари азнавтартиббандии RAG text HTTP-URL-и сайдкари кросс-энкодер барои аз нав рутбабандии ҷустуҷӯи гибридӣ. Холӣ = аз нав рутбабандӣ хомӯш. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.

Moderation

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_MODERATION Модератсияи воридот bool 1 \“off\” ҳифзи дарунсохтро аз jailbreak/prompt-injection хомӯш мекунад. Ҳар қимати дигар = фаъол. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_MODERATION_REFUSAL Паёми радкунии модератсия text Матни рад, ки ҳангоми басташавии дархост аз ҷониби модератор бармегардад (холӣ = дарунсохт). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.

Public access

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_PUBLIC_URL URL-и оммавии дарвоза (Web UI + мизоҷон) text Ин хостро → ба порти шлюз прокси кунед (AIHUMMER_GATEWAY_ADDR, пешфарз :8780). Аз ҷониби Web UI ва мизоҷони iOS/веб истифода мешавад.
POCKET_AGENT_GATEWAY_BASE_URL URL-и оммавии дарвозаи pocket-agent text → ба порти шлюзи pocket-agent прокси кунед (POCKET_AGENT_PORT, пешфарз 8080). Агенти дурдаст тавассути тикети яквақта ба ин ҷо пайваст мешавад.
TELEGRAM_PUBLIC_URL URL-и оммавии вебхуки Telegram text Танҳо барои реҷаи webhook — → ба порти telegram-connector прокси кунед (AIHUMMER_TELEGRAM_CONNECTOR_PORT, пешфарз 8091). Барои реҷаи polling холӣ монед (URL-и ҷамъиятӣ лозим нест).

SSO (LDAP/AD)

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_LDAP_BASE_DN DN-и базавии ҷустуҷӯи корбарон text Search root, e.g. OU=Users,DC=corp,DC=example.
AIHUMMER_LDAP_BIND_DN DN-и хидматӣ барои пайвастшавӣ text Ҳисоб барои bind-и ҷустуҷӯи ибтидоӣ, мас. CN=svc-aihummer,OU=Service,DC=corp,DC=example. Холӣ = ҷустуҷӯи беном.
AIHUMMER_LDAP_DEFAULT_ROLE LDAP: Нақши пешфарз (мутобиқати гурӯҳ нест) text Нақше, ки ҳангоми ба ягон маппинг мувофиқ наомадани гурӯҳ дода мешавад. Холӣ = бе нақш.
AIHUMMER_LDAP_ENABLED Фаъол кардани вуруд тавассути LDAP/AD bool 0 Ҳангоми фаъол будан вуруди администраторон ба каталог рӯй меорад. Пароли bind дар Secrets нигоҳ дошта мешавад (доираи ldap, номи bind_password).
AIHUMMER_LDAP_GROUP_ATTR Атрибути гурӯҳ (пешфарз memberOf) text Атрибути сабти корбар, ки DN-ҳои гурӯҳҳоро номбар мекунад. Холӣ маппинги гурӯҳ→нақшро хомӯш мекунад.
AIHUMMER_LDAP_ROLE_MAPPINGS LDAP: Мутобиқати гурӯҳ→нақш (JSON) text Объекти JSON аз DN-и гурӯҳ (ё танҳо CN) → нақш, мас. {\“CN=Admins,OU=Groups,DC=corp,DC=example\”:\“admin\”,\“Operators\”:\“operator\”}.
AIHUMMER_LDAP_SKIP_TLS_VERIFY Гузаштан аз санҷиши TLS (танҳо барои лаборатория, 1/0) bool 0 Санҷиши сертификати каталогро хомӯш мекунад. Ҳеҷ гоҳ дар муҳити корӣ фаъол накунед.
AIHUMMER_LDAP_URL URL-и каталог text e.g. ldaps://ad.corp.example:636 (TLS) or ldap://dc1.corp.example:389.
AIHUMMER_LDAP_USER_ATTR Атрибути вуруд (пешфарз sAMAccountName) text Атрибути LDAP/Active Directory, ки бо логини воридкардаи корбар муқоиса мешавад (пешфарз sAMAccountName; uid барои OpenLDAP, userPrincipalName барои вуруди навъи UPN).
AIHUMMER_LDAP_USER_FILTER Филтри ҷустуҷӯи корбарон text Бояд барои логин %s дошта бошад. AD: (sAMAccountName=%s); OpenLDAP: (uid=%s).

SSO (OIDC)

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_OIDC_AUDIENCE Audience-и OIDC text Claim-и интизории aud — audience-и ҲАМИН ресурсро таъин кунед, то токенҳои барои тарафи дигар барорида радд шаванд. Claim-и aud акнун ба таври пешфарз дар ҳар токен ҲАТМӢ аст (токени бе aud рад мешавад); ҳангоми таъин будани ин, aud бояд онро низ дошта бошад. Дар муҳити корӣ сахт тавсия мешавад.
AIHUMMER_OIDC_ISSUER URL-и нашркунандаи OIDC text Барорандаи IdP (мас. https://login.example.com). Ҳангоми таъин будан аутентификатсияи OIDC JWT-ро фаъол мекунад.
AIHUMMER_OIDC_JWKS_URL URL-и JWKS-и OIDC text Эндпоинти JSON Web Key Set барои санҷиши имзои токенҳо.
AIHUMMER_OIDC_TENANT_CLAIM Claim-и фазои корӣ дар OIDC text Claim-и JWT, ки идентификатори фазои кориро дорад (мас. tenant_id / org).

SSO (SAML)

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_SAML_DEFAULT_ROLE SAML: Нақши пешфарз (мутобиқати гурӯҳ нест) text Нақше, ки ҳангоми ба ҳеҷ маппинг мувофиқ наомадани қимати тасдиқшуда дода мешавад. Холӣ = бе нақш.
AIHUMMER_SAML_ENABLED Фаъол кардани SSO-и SAML 2.0 bool 0 /saml/metadata, /saml/acs, /saml/login-ро мекушояд. Калиди хусусии SP дар Secrets нигоҳ дошта мешавад (доираи saml, номи sp_key).
AIHUMMER_SAML_ENTITY_ID Entity ID-и SP text Entity ID-и провайдери хидмат (агар холӣ бошад, пешфарз ⟨root⟩/saml/metadata).
AIHUMMER_SAML_IDP_METADATA XML-и метаиттилооти IdP text Ҳуҷҷати метамаълумоти SAML-и IdP-и худро гузоред (Okta/Azure AD/ADFS).
AIHUMMER_SAML_ROLE_ATTRIBUTE Атрибути нақш/гурӯҳ (пешфарз groups) text Атрибути assertion, ки қиматҳои гурӯҳ/нақшро дорад.
AIHUMMER_SAML_ROLE_MAPPINGS SAML: Мутобиқати гурӯҳ→нақш (JSON) text Объекти JSON аз қимати тасдиқшуда → нақш, мас. {\“AdminGroup\”:\“admin\”,\“Ops\”:\“operator\”}.
AIHUMMER_SAML_ROOT_URL URL-и решагии SP text URL-и базавии аз берун дастраси ин шлюз, мас. https://app.example.com. ACS = ⟨root⟩/saml/acs.
AIHUMMER_SAML_SP_CERT Сертификати SP (PEM) text Сертификати ҷамъиятии имзои SP (PEM). Калиди хусусии мувофиқ дар Secrets ҷойгир мешавад (доираи saml, номи sp_key).

Security

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_AIRGAPPED Реҷаи ҷудошуда (air-gapped, 1/0) bool 0 Баромади бо модел идорашавандаро ба интернети ҷамъиятӣ манъ мекунад (танҳо хостҳои дохилӣ/рӯйхати иҷозатдодашуда). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_AUDIT_RETENTION_DAYS Нигоҳдории аудит-лог (рӯз, 0=ҳамеша) int 0 Чанд рӯз нигоҳ доштани лоҷи аудит; сабтҳои кӯҳнатар ҳар рӯз нест мешаванд. 0/холӣ = абадӣ нигоҳ доштан. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_CODE_EXEC_ALLOW_HOST Иҷозати code_exec дар хост (БЕ песочка) bool 0 ⚠️ Иҷозат додани иҷрои код бевосита дар хост бе муҳити ҷудокардашуда. Танҳо барои homelab-и боэътимод. Бехатартар аст, ки AIHUMMER_CODE_EXEC_SANDBOX_IMAGE таъин карда шавад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_CORS_ORIGINS Origin-ҳои иҷозатдодашуда барои CORS (бо вергул) text Рӯйхати Origin-ҳои иҷозатдодашуда бо вергул. Холӣ = CORS иҷозат дода намешавад (танҳо same-origin). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_CSP Сарлавҳаи Content-Security-Policy (бознависӣ) text Сарлавҳаи CSP-ро бознависӣ мекунад. Холӣ = пешфарзи бехатар. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_INBOUND_SECRET Сирри муштараки коннектор → дарвоза text Сирри умумӣ, ки гузариши коннектор→шлюзро аутентификатсия мекунад (бояд бо қимати тарафи коннектор мувофиқ бошад). Холӣ = эндпоинти вурудӣ БЕ аутентификатсия аст. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_OPENAI_COMPAT_KEY Вуруди мутобиқ бо OpenAI: калиди статикии API text Калиди статикӣ, ки бо он мизоҷони мувофиқи OpenAI дар эндпоинти дарунсохти /v1-и шлюз аутентификатсия мешаванд (P8 home gateway). Холӣ = аутентификатсияи статикӣ хомӯш (калидҳои шахсӣ боқӣ мемонанд). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_OPENAI_COMPAT_WORKSPACE Вуруди мутобиқ бо OpenAI: ID-и фазои корӣ text ID-и фазои корӣ, ки аутентификатсияи статикии мувофиқи OpenAI ба он маппинг мешавад. Холӣ = AIHUMMER_DEFAULT_WORKSPACE_ID. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_REQUIRE_2FA Талаб кардани 2FA барои операторон bool 0 Барои операторон талаб кардани омили дуюм (TOTP/passkey). Ҳангоми фаъол будан ба операторони бе 2FA ҳангоми вуруд дарҳол пешниҳод мешавад, ки онро танзим кунанд (бе басташавӣ, то соҳиб дар берун намонад). Дарҳол татбиқ мешавад.
AIHUMMER_REQUIRE_SECURE Танҳо пайвастҳои ҳифзшуда (HTTPS/WSS) қабул кардан bool 0 Ҳангоми фаъол будан дархостҳои оддии HTTP ба HTTPS равона (барои GET/HEAD) ё рад (403) мешаванд; дастрасӣ аз localhost ҳамеша иҷозат аст, то оператор дар берун намонад. X-Forwarded-Proto-ро аз прокси-и баръакси хотимадиҳандаи TLS ба назар мегирад. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_TRUSTED_PROXIES CIDR-ҳои боэътимоди прокси-и баръакс (бо вергул) text Рӯйхати шабакаҳои боэътимоди прокси-и баръакс бо вергул (CIDR, мас. 10.0.0.0/8,192.168.0.0/16, ё IP-ҳои алоҳида). Танҳо барои дархостҳое, ки АЗ ин суроғаҳо меоянд, сарлавҳаи X-Forwarded-For барои муайян кардани IP-и мизоҷ истифода мешавад (аудит, рӯйхати иҷозати IP, ҳифз аз интихоби зӯроваронаи парол). Холӣ = танҳо ба суроғаи воқеии peer бовар кардан (XFF нодида гирифта мешавад, ҷаълкунии IP имконнопазир). Дарҳол татбиқ мешавад.

Tools

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_CODE_EXEC Фаъол кардани code_exec bool 0
AIHUMMER_CODE_EXEC_INTERPRETERS Интерпретаторҳои code-exec (JSON) text Объекти JSON {language: path_to_binary}, мас. {\“python\”:\“/usr/bin/python3\”}. Холӣ = муайянкунии худкор. Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_CODE_EXEC_SANDBOX_IMAGE Тасвири песочкаи code-exec text Образи контейнер барои ҷудокунии code_exec (бе шабака, rootfs танҳо барои хондан, маҳдудиятҳо). Холӣ = иҷро дар худи хост (муҳити боэътимод). Ҳангоми оғоз/пас аз бозоғозӣ татбиқ мешавад.
AIHUMMER_DB_QUERY_DSN DSN барои db_query (нақши бо ҳуқуқи ҳадди ақал, на соҳиб — дархостҳо бо маҳдудияти RLS аз рӯи фазои кории фаъол иҷро мешаванд) text
AIHUMMER_FS_ROOT Решаи абзори системаи файлӣ text
AIHUMMER_HTTP_ALLOWLIST Рӯйхати суроғаҳои иҷозатдодашудаи http_request text
AIHUMMER_HTTP_AUTH_JSON Авторизатсияи http_request (JSON) text
AIHUMMER_MCP_SERVERS Серверҳои MCP (JSON) text
AIHUMMER_WEBFETCH_ALLOWLIST Рӯйхати суроғаҳои иҷозатдодашудаи web_fetch text

Web UI (separate port)

Калид Ном Навъ Пешфарз Чӣ мекунад
AIHUMMER_WEBUI_API_BASE URL-и базавии API, ки Web UI муроҷиат мекунад text Origin-и мутлақ (мас. https://api.example.com), ки SPA-и алоҳида ҷойгиршуда барои даъватҳои /v1/admin/* ба он муроҷиат мекунад. Холӣ = баргашт ба URL-и ҷамъиятии шлюз, сипас ба суроғаи маҳаллии шлюз. Бояд аз браузери администратор дастрас бошад; API бояд origin-и ин Web UI-ро тавассути CORS иҷозат диҳад (дар поён худкор илова мешавад).
AIHUMMER_WEBUI_ENABLED Пешниҳоди Web UI-и админ дар порти хусусии он bool 1 Ба таври пешфарз фаъол: SPA-и админ дар РЕШАи шунавандаи алоҳида (AIHUMMER_WEBUI_ADDR) дода мешавад, ки онро ба интерфейси танҳо дохилӣ пайваст кардан мумкин аст. Порти асосии шлюз API + pairing + WS + SSE-ро нигоҳ медорад ва /admin/-ро НАМЕДИҲАД. Барои пурра хомӯш кардани шунавандаи Web UI 0 таъин кунед.
AIHUMMER_WEBUI_ORIGIN Origin-и браузери Web UI (CORS) text Origin-и браузерии Web UI (мас. https://admin.example.com), ки худкор бо маълумоти дастрасӣ ба рӯйхати иҷозати CORS-и API илова мешавад. Холӣ = аз AIHUMMER_WEBUI_ADDR бароварда мешавад (http://host:port). Инро вақте таъин кунед, ки браузер ба Web UI тавассути прокси/номи хосте меояд, ки аз суроғаи пайвастшавӣ фарқ мекунад.

Танзимоти барои оператор дастрас: 138.