Орчны хувьсагчид

AiHummer тохиргоо нь дараах хэсгүүдэд хуваагддаг хоёр бүрэн ялгаатай бүлэг:

Bootstrap (gateway.env) — хаалга мэдэх ёстой зүйл өмнө тэр чадна мэдээллийн сантай унш: мэдээллийн сангийн DSN, сонсох хаягууд, статик сангууд, гол түлхүүр. Зөвхөн эдгээр түлхүүрүүд орчноос уншигдана.
Тохиргооны каталог (үр дүнгийн сан) — нэг бүрийн бусад товчлуурууд. Эдгээрийг хадгалдаг өгөгдлийн сан ба вэб админ UI-д тохируулах (Менежмент → Тохиргоо) эсвэл үүнтэй хамт aihummer settings set <KEY> <VALUE>. Эдгээрийн хувьд түлхүүрүүд нэг gateway.env үнэ нь занаснаар үл тоомсорлож — тохируулагдсан ч гэсэн, энэ нь байна нөхцөлд нөлөөлөлгүй.

Тохиргооны загвар

gateway.env Энэ зөвхөн bootstrap. Шийдвэрийн дараалал:

Тохиргоо-каталог түлхүүр: database value → built-in default (орчныг үл тоомсорлож байна);
бутстрап түлхүүр: environment variable only.

Тиймээс тохируулж болох товчлууруудын ганц итгэлтэй эх сурвалж нь өгөгдлийн сан (вэб админ UI / aihummer settings); орчин нь процесс эхлэхэд хэрэгтэй зүйлсийг л агуулдаг.

Сэрвэр-д суулгах тохиргооны файл оршин байдаг байрлал:

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

[!TIP] Тохиргооны каталогийн эргүүлэх товчуурыг битгий байрлуул gateway.env — энэ нь ямар ч нөлөөгүй. Солих тэднийг вэб админ UI-д (Удирдлага → Тохиргоо, хайлттай) эсвэл дамжуулан aihummer settings set. Зарим өөрчлөлтүүд (жишээ нь багажийн асаалт, туслах агентууд) гүн) халуун хэрэглэх; бусад нь сервисийг дахин эхлүүлэх шаардлагатай.

Bootstrap (gateway.env)

Гэрэлтэх дөрвөн түлхүүр нь үнэндээ орчныг уншдаг.

Үндсэн ба өгөгдлийн сан

Хувьсах	Зорилго
`AIHUMMER_DATABASE_URL`	Шаардлагатай. Postgres DSN. Үүнгүйгээр гарц зөвхөн эрүүл мэндийн горимд ажиллана.
`AIHUMMER_DB_APP_URL`	Эрх хязгаарлагдсан DSN нь Мөрийн түвшний Аюулгүй байдлыг идэвхжүүлдэг (орчинд суулгасан тохиолдолд автоматаар тохируулагдана).
`AIHUMMER_GATEWAY_ADDR`	Олон нийтийн сонсох хаяг (урьдчилсан тохиргоо) `:8780`) — бүх гадаад хөдөлгөөнийг: API (`/v1/*`), хослуулалт, WS/SSE, inbound вебхүүк, апп/покет прокси болон эрүүл мэндийн пробууд.
`AIHUMMER_WEBUI_ADDR`	Хувийн захиргаа Web UI сонсох хаяг (анхдагч) `:8781`), үндсэн зам дээр үйлчилж байна `/`; хамгийн тохиромжтой нь зөвхөн дотоод интерфэйстэй холбогдсон байх. Тохируулсан `0` унтраах
`AIHUMMER_DEFAULT_WORKSPACE_ID`	Тохируулагдсан орж ирсэн интеграцуудад зориулж үндсэн ажлын орчныг сонгоно.
`AIHUMMER_HOME_ROOT`	Үүслийг суулгана (ихэвчлэн хоёртын файлын замаас гаргаж авсан); admin-ui/blob/installer хавтас болон гол файлуудыг бэхэлнэ.
`AIHUMMER_BLOB_DIR`	Медиа/файл үйлчилгээг (blob хадгалах директорууд) идэвхжүүлдэг. Мөн хадгална хууль бус (тал талаас суулгасан) нэмэлт модульын бүтээлүүд доор `blob:` түгээх төхөөрөмж нь шийддэг лавлагаанууд.
`AIHUMMER_ADMIN_UI_DIR`	Админ SPA-г дараах хаягаар үйлчилнэ `/admin/`.

Нууц ба дэд бүтэц

Хувьсах	Зорилго
`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 таны дээр оролцогчийн оронд.

Тохиргооны каталог (мэдээллийн сан — вэб удирдлагын UI эсвэл `aihummer settings`)

Доорх бүх түлхүүр нь өгөгдлийн санд хадгалагддаг. Үүнийг вэб админ UI дээр тохируулна уу (Менежмент → Тохиргоо) эсвэл үүнийг ийм байдлаар:

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/*` дуудлага

Нэвтрэлт болон Нэг удаагийн нэвтрэлт (SSO)

Түлхүүр	Зорилго
`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`	OpenAI-тэй нийцсэн LLM гарц/цэгийн үндсэн URL (энэ `AIHUMMER_LLM_*` зам; нутгийнхнаас ялгаатай `AIHUMMER_OPENAI_BASE_URL`). Харах BYOK ба үйлчилгээ үзүүлэгчид.
`AIHUMMER_OPENAI_API_KEY`	OpenAI-тэй нийцсэн үйлчилгээ үзүүлэгчийн API түлхүүр.
`AIHUMMER_SUBAGENT_MAX_DEPTH`	Үүсгэгдсэн дэд агентуудын хамгийн их гүн.

[!NOTE] Хэрэв ямар ч загвар холбогдоогүй бол гарц нь буцаад нэгэнд шилждэг тогтмол дууриамал тэгэхээр систем хэвээр ажиллана. Төлбөртэй загварын API шаардлага огт гарахгүй — үнэгүй/орон нутгийн загварууд болон Codex/ChatGPT-ийн захиалгын тээвэр нь анхны зэрэглэлийн үйлчилгээтэй.

Хэрэгсэл

Түлхүүр	Зорилго
`AIHUMMER_FS_ROOT`	Идэвхжүүлдэг `filesystem_read`, энэ уг үндсийн дор тусгаарлагдсан орчинд.
`AIHUMMER_DB_QUERY_DSN`	Идэвхжүүлдэг `db_query` (зөвхөн унших) энэ DSN-ий эсрэг.
`AIHUMMER_CODE_EXEC`	Үйлдлийг сэлгэх `code_exec` хэрэгсэл (хувьцаанд суурилагдсан хостуудад анхнаасаа унтсан байвал).

Веб хайлт болон хөтчийг суулгагч удирддаг: тэдгээр нь хайрцагнаасаа шууд суулгагдаж, --no-search / --no-browser-оор унтардаг бөгөөд --external-search=URL / --external-browser=URL-ээр байгаа жишээ рүү чиглэгддэг — тэдгээрт зориулсан операторын тохиргоо байхгүй.

Бүрэн үзэх Багаж хэрэгслийн каталог тус бүрийн хэрэгсэл юу хийдэг талаар.

Дуу хоолой ба сайдкарууд

Түлхүүр	Зорилго
`AIHUMMER_STT_URL`	Дуу хоолойг текст рүү хөрвүүлэгч талын URL (суурилуулагчийн өгсөн үрээр).
`AIHUMMER_TTS_URL`	Текстээс хоолой руу шилжүүлэх сайдкар URL (суулгагчийн өгсөн үрээр).
`AIHUMMER_VIDEO_URL`	Видео ойлголт сайдкар URL.

Сайдвууд нь тусдаа HTTP үйлчилгээ юм; гарц нь тэдгээрт URL-аар холддог.

Векторууд ба оруулгууд

Түлхүүр	Зорилго
`AIHUMMER_QDRANT_URL`	Бодит вектор хадгалах газар (Qdrant). Байхгүй → ой санамжийн хадгалах газар.
`AIHUMMER_EMBEDDER_URL`	Бодит оруулах үйлчилгээ. Байхгүй → хэш оруулагч.

Протоколын гадаргуу (сонгон оролцох)

Түлхүүр	Зорилго
`AIHUMMER_MCP_PUBLISH`	Яг `1` бол `POST /v1/mcp` хаяг дээр гадаад MCP серверийг нээнэ. Дангаараа ямар ч хэрэгсэл экспортлохгүй.
`AIHUMMER_MCP_EXPORT_TOOLS`	MCP клиентийн харах, таслалаар тусгаарласан яг хэрэгслийн нэрс. Хоосон (анхдагч) — ТЭГ хэрэгсэл экспортлогдоно.
`AIHUMMER_A2A_PUBLISH`	`1` A2A гадаргууг идэвхжүүлнэ (`/.well-known/agent.json`, `/a2a/message`).

Зөвхөн Dev баримт

Хувьсах	Зорилго
`AIHUMMER_PLUGIN_PUBKEY`	Плагин гарын үсгийг шалгах нэмэлт найдвартай олон нийтийн түлхүүр (base64 ed25519). Зөвхөн хөгжүүлэгчийн бүтээлүүд — гаргасан хувилбарт үүнийг үл тоомсорлодог (бүртгэлийн түлхүүр нь хоёртын файлд наалттай байна).
`AIHUMMER_PLUGIN_DEV_UNSIGNED`	`1` суулгахыг зөвшөөрдөг гарын үсэггүй плагинүүд. Зөвхөн хөгжүүлэлтийн бүтээлд тавигдана — гаргах хувилбаруудад үл тоомсорлогдоно. Гаднаас хандаж болох ямар ч систем дээр хэзээ ч биш.

[!WARNING] Гаргасан хувилбаруудад нэмэлт программын итгэл үзүүлж буй үндэс нь дутуу болон нэгдсэн хэлбэрт оруулсан болон орчин болон тохиргоогоор давж бичигдэж болохгүй — энэ нь алдаа засах эсэргүүцэгч юм бараа баталгаа.

Итгэлцлийн загвар (албан ёсны → тогтсон түлхүүр, хувийн → итгэлцлийн сан, гарын үсэггүй → хаалттай) тайлбарлагдсан байна Суурилуулах болон шинэчлэх.

Дараа хаашаа явах вэ

Түлхүүр тус бүр ямар багажийг нээж болохыг үзээрэй: Багаж хэрэгслийн каталог.
Жишээг өдөр тутам ажиллуулна: CLI лавлагаа.