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

Муҳити тағйирёбанда

v1.6.x · навсозӣ шуд 2026-11-15

AIHUMMER_PUBLIC_TLS_CERT_FILE + AIHUMMER_PUBLIC_TLS_KEY_FILE: HTTPS-ро худи шлюз бо ҷуфти сертификат/калиди хусусӣ ё проксии баръакс таъмин карда метавонад. Ҷуфти нодуруст бо HTTP-и одӣ иваз намешавад. Пеш аз тасдиқи сертификати хусусӣ дар барнома, изи SHA-256-ро бо терминали боэътимоди насб муқоиса кунед.

Танзимоти AiHummer ба қисмҳо тақсим мешавад ду гурӯҳи пурра мухталиф:

  1. Bootstrap (gateway.env) — чизе ки дарвозаро бояд бидонад пеш метавонад донед пойгоҳи додаҳоро: DSN пойгоҳи додаҳо, суроғаҳои гӯш кардани, каталогҳои статикӣ, калиди асосӣ. Танҳо ин килиҳо аз муҳит хонда мешаванд.
  2. Феҳристи танзимот (банақшагирӣ) — ҳар як тугмаи дигар. Инҳоро дар дохили қайдгирӣ ва танзим дар интерфейси идоракунии веб (Идоракунӣ → Танзимот) ё бо aihummer settings set <KEY> <VALUE>Барои ин калидҳо а gateway.env арзиш аст бо қабули огоҳона нодида гирифт — ҳатто агар танзим шуда бошад, он дорад бе таъсир.

Намунаи конфигуратсия

gateway.env меўбошад фаъолкунӣ-танҳоФармони қарори:

  • Мефтаҳи танзимоти феҳрист: database value → built-in default (муҳит нодида гирифта мешавад)
  • калиди оғозёбӣ: environment variable only.

Бинобар ин, манбаи ягонаи ҳақиқати барои тугмаҳои танзимшаванда базаи додаҳо мебошад (интерфейси идоракунии веб) aihummer settingsМуҳит танҳо он чизеро мебарад, ки раванд барои оғоз кардани он зарур аст.

Файли конфигуратсияи насби соҳиби мизбон дар ҷойи зерин қарор дорад:

# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes

[!TIP] Дастгоҳҳои феҳристи Танзимотро нагузоред gateway.env — он таъсир намекунад. Тағир онҳоро дар интерфейси идоракунии веб (Management → Settings, он дорои ҷустуҷӯ мебошад) ё тавассути aihummer settings setБаъзе тағйиротҳо (масалан, гузаришҳои асбоб ва зер-агент) чуқурӣ) гарм истифода баред; дигарон талаб мекунанд, ки хидмат аз нав оғоз шавад.

Bootstrap (gateway.env)

Ягона калидҳое, ки дарвозаро воқеан аз муҳит мехонанд.

Ҳарф ва пойгоҳи дода

Тағирёбанда Мақсад
AIHUMMER_DATABASE_URL Лозим. Postgres DSN. Бе он дарвоза танҳо дар режими саломатӣ кор мекунад.
AIHUMMER_DB_APP_URL DSN бо нақши маҳдуд, ки Амнияти сатҳи қаторро фаъол мекунад (барои насбҳои маҳаллӣ ба таври худкор танзим мешавад).
AIHUMMER_GATEWAY_ADDR Панели веб, барномаҳо ва каналҳо як нишонии умумии серверро истифода мебаранд. Нишонии умумии нишон додаи насбкунандаро кушоед; нишонии маҳаллии пешфарз http://localhost:8780/ аст. Порти ҳангоми насб интихобшуда метавонад фарқ кунад.
AIHUMMER_WEBUI_ADDR AIHUMMER_WEBUI_ADDR шунавандаи ёрирасони оператор танҳо дар loopback барои мутобиқати танзими ибтидоӣ аст; пешфарз 127.0.0.1:8781. Ин нишонии алоҳидаи берунии панел нест; 0 беэътибор аст. AIHUMMER_WEBUI_ENABLED=false панелро дар ҳар ду шунаванда хомӯш мекунад.
AIHUMMER_DEFAULT_WORKSPACE_ID Ҳуҷраи корӣ пешфарзро барои ҳамгироӣҳои воридшудаи конфигуратсияшуда интихоб мекунад.
AIHUMMER_HOME_ROOT Рутро насб кунед (одатан аз роҳи бинарӣ гирифта мешавад); директорияҳои admin-ui/blob/installer ва файлҳои калидиро мустаҳкам мекунад.
AIHUMMER_BLOB_DIR Хизматрасонии воситаҳои ахбор/файлро (директорияи захираи блоб) фаъол мекунад. Он инчунин нигоҳ медорад артефактҳои плагини хусусӣ (пардохти паҳншуда) зери blob: манбаъҳое, ки насбкунанда ҳалл мекунад.
AIHUMMER_ADMIN_UI_DIR Панели веб, барномаҳо ва каналҳо як нишонии умумии серверро истифода мебаранд. /

Рамзҳо ва инфрасохтор

Тағирёбанда Мақсад
AIHUMMER_MASTER_KEY base64-кодшуда 32 байт; махфиятҳо дар ҳолати истироҳат, анбор ва BYOK-ро имкон медиҳад.
AIHUMMER_MEDIA_TOKEN_SECRET URLҳои зеркаши дастнависшударо дар тӯли оғозҳои дубора боқӣ мегузорад.
AIHUMMER_OTEL_ENDPOINT Нуқтаи охирини OTLP барои фиристодани изҳо/метрикҳо.
AIHUMMER_DOWNLOAD_BASE_URL URL-и асосӣ барои артефактҳои нашр (манбаи худнавсозӣ).

[!WARNING] Намояндагӣ Фармони танҳо OTLP. AiHummer ин кор мекунад не пинҳон кардани Прометей /metrics ниҳоӣ ё /debug/pprof. Нуқта AIHUMMER_OTEL_ENDPOINT дар шум ба ҷои он ҷамъкунанда.

Феҳристи танзимот (базаи додаҳо — интерфейси идоракунии веб) aihummer settings)

Ҳар калиди зер дар пойгоҳи додаҳо мавҷуд аст. Онро дар интерфейси идоракунӣ дар веб насб кунед (Идоракунӣ → Танзимот) ё монанди ин:

aihummer settings set AIHUMMER_LLM_PROVIDER openai

А gateway.env нархи чунин калид ин аст нирў накарда шуд.

Амният

Калид Мақсад
AIHUMMER_APPROVAL_TOOLS Асбобҳое, ки пеш аз иҷро талаб менамоянд, то шахс тасдиқ кунад.
AIHUMMER_AIRGAPPED 1 пайдарҳамии баромади умумиро, ки бо модел назорат мешавад (режими ҷудо аз ҳаво), монеъ мешавад.
AIHUMMER_AUDIT_RETENTION_DAYS Муддати нигоҳдории сабти назорати маъмурӣ.
AIHUMMER_INBOUND_SECRET Маҳфияти муштарак HMAC барои пайвасткунанда → дарвоза /v1/inbound/* занги телефонӣ.

Санҷиши ҳувият ва ҳамоҳангсозии ягона

Калид Мақсад
AIHUMMER_OIDC_ISSUER Ҳифз мекунад /v1/admin/*Бе он (ва беба LDAP/SAML) маъмур ба сарлавҳаҳои dev эътимод мекунад — ҳеҷ гоҳ чунин ҳолатро ошкор накунед.

LDAP/AD ва SAML ҳамзамон бо OIDC барои воридшавӣ ба ташкилот танзим карда шудаанд; SCIM пешниҳоди корбарро ба таври автоматӣ таъмин мекунад. Нигаред Вебқутбҳо, SCIM ва ҷуфтсозӣ.

LLM ва моделҳо

Калид Мақсад
AIHUMMER_LLM_PROVIDER Фурӯшандаи модел барои истифода.
AIHUMMER_LLM_MODEL Номи модел.
AIHUMMER_LLM_GATEWAY_URL URL асосии дарвозаи/нигори LLM, ки бо OpenAI мувофиқ аст AIHUMMER_LLM_* масир; аз маҳаллӣ ҷудо AIHUMMER_OPENAI_BASE_URL). Бубинед BYOK ва таъминкунандагон.
AIHUMMER_OPENAI_API_KEY Калиди API барои провайдери мувофиқи OpenAI.
AIHUMMER_SUBAGENT_MAX_DEPTH Ҳадди зиёди амиқии агенти зерсохташуда.

[!NOTE] Барои ҷавобҳои корӣ провайдери воқеии моделро пайваст кунед. Калиди пулакии API ҳатмӣ нест: модели маҳаллии бо OpenAI мувофиқ, обунаи дастгиришаванда ё калиди API-и худро истифода бурдан мумкин аст. Агар провайдер танзим нашуда бошад, ин хато пайдо мешавад: Провайдери модели AI ҳанӯз танзим нашудааст — онро дар бахши «Моделҳо» илова кунед

Асбобҳо

Калид Мақсад
AIHUMMER_FS_ROOT Решаи иҷозатшудаи файлҳоро боз ҳам маҳдуд мекунад; қимати холӣ дастрасӣ ба ҳост намедиҳад.
AIHUMMER_DB_QUERY_DSN Имкон медиҳад db_query (танҳо хондан) бар зидди ин DSN.
AIHUMMER_CODE_EXEC code_exec бо нобаёнӣ хомӯш аст
AIHUMMER_BROWSER_PROFILE_SOCKET Роҳ ба сокети хусусии managed-profiles.sock-и хидмати браузер; холӣ — профилҳои доимии computer хомӯшанд.
AIHUMMER_BROWSER_PROFILE_BINDINGS Массиви JSON-и пайвастҳои возеҳи профилҳои доимии браузер (profile_id, tenant_id, user_id, agent_ids, conversation_ids).

Ҷустуҷӯи веб ва браузер аз ҷониби насбкунанда идора мешаванд: онҳо аз қуттӣ насб мешаванд, бо флагҳои --no-search / --no-browser хомӯш карда мешаванд, ва нусхаи мавҷуда бо флагҳои --external-search=URL / --external-browser=URL пайваст карда мешавад — танзимоти алоҳидаи операторӣ барои онҳо нест.

Бӯсаи пурраро бинед Феҳристи асбобҳо барои он ки ҳар як асбоб чӣ кор мекунад.

Овоз ва сайдқар

Калид Мақсад
AIHUMMER_STT_URL URL-и дастгирии нутқ ба матн (аз тарафи насбкунанда пешбинишуда).
AIHUMMER_TTS_URL URL-и паҳлӯи матн ба садо (аз тарафи насбкунанда сохташуда).
AIHUMMER_VIDEO_URL URL-и паҳлӯии фаҳмиши видео.
AIHUMMER_TTS_AUTO_REPLY Кай ҷавоби тайёр садо дода мешавад: off, always, inbound (пешфарз), tagged.
AIHUMMER_TTS_MAX_CHARS Ҳадди матни садододашаванда: 0 — ҷавоби пурра, вагарна 100–10000 аломат.
AIHUMMER_TTS_SUMMARIZE Кӯтоҳ кардани ҷавоби дароз барои садодиҳӣ (аз рӯи пешфарз фаъол).

Сайдкартҳо хадамоти ҷудогонаи HTTP мебошанд; гузаргоҳ тавассути URL ба онҳо мерасад.

Векторҳо ва ҷойгиркуниҳо

Калид Мақсад
AIHUMMER_QDRANT_URL Ҷойгоҳи воқеии векторӣ (Qdrant). Ҳузур надорад → дар хотираи дохилӣ нигоҳ дошта мешавад.
AIHUMMER_EMBEDDER_URL Хизматрасонии воқеии дохилсозӣ. Набудани → дохилсозии хеш.

Сатҳҳои протокол (ихтиёрӣ)

Калид Мақсад
AIHUMMER_MCP_PUBLISH Маҳз 1 сервери берунии MCP-ро дар POST /v1/mcp мекушояд. Худ аз худ ягон абзорро содир намекунад.
AIHUMMER_MCP_EXPORT_TOOLS Номҳои дақиқи абзорҳо бо вергул, ки муштарии MCP мебинад. Холӣ (пешфарз) — СИФР абзор содир мешавад.
AIHUMMER_A2A_PUBLISH 1 имконият медиҳад, ки сатҳи A2A/.well-known/agent.json, /a2a/message).

Танҳо Dev месозад

Тағирёбанда Мақсад
AIHUMMER_PLUGIN_PUBKEY Як калиди ҷамъиятии иловагӣ, боэътимод (base64 ed25519) барои тасдиқи имзоҳои плагин. Танҳо барои сохтани Dev — дар сохторҳои нашршуда нодида гирифта шудааст (калиди режистри ба файли биноӣ часпонида шудааст).
AIHUMMER_PLUGIN_DEV_UNSIGNED 1 имкон медиҳад насб кардан дисавторӣшуда плагинҳо. Фақат барои сохтани Dev — дар сохтани нашршуда нодида гирифта шудааст. Ҳеҷ гоҳ дар як намунаи берун аз дастрасӣ нест.

[!WARNING] Дар нашри баровардашуда решаи эътимоди плагин чунин аст дар бинарӣ ҳалқадоршуда ва инро на муҳит ва на танзимот метавонад тағйир диҳад — ин як системаи зидди дасткорӣ аст капалат

Намунаи эътимод (расмӣ → калиди часпондашуда, хусусӣ → анбори эътимод, бимиёндошта → баста) тавсиф шудааст дар Насб ва навсозӣ.

Баъд ба куҷо