Орта айнымалылары — AiHummer Құжаттама

AiHummer AIHUMMER_* орта айнымалылары арқылы бапталады (қосымша бірнеше құралға тән айнымалылар, мысалы SEARXNG_URL). Бұл бет — аумақтар бойынша топтастырылған каталог. Айнымалылардың көпшілігі веб әкімші интерфейсінде де өңделеді.

Баптау моделі

Әрбір параметр белгіленген ретпен шешіледі:

database value  →  environment variable  →  built-in default

Яғни, әкімші интерфейсінде сақталған мән (дерекқорда сақталған) ортаны басып озады, ал ол өз кезегінде кіріктірілген әдепкіні басып озады. Bootstrap айнымалылары — шлюзге дерекқорды оқу мүмкіндігі болғанға дейін қажет айнымалылар, мысалы AIHUMMER_DATABASE_URL және AIHUMMER_MASTER_KEY — тек орта арқылы қалады.

Хост-нативті орнатудың баптау файлы мына жерде орналасады:

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

[!TIP] Реттелетін, bootstrap емес тұтқаларды веб әкімші интерфейсінде өзгерткен дұрыс, сонда олар файлдарды өңдемей-ақ күшіне енеді. Кейбір өзгерістер (мысалы, құрал қосқыштары мен ішкі агент тереңдігі) жедел қолданылады; басқалары қызметті қайта іске қосуды талап етеді.

Негізгі және дерекқор

Айнымалы	Мақсаты
`AIHUMMER_DATABASE_URL`	Міндетті. Postgres DSN. Онсыз шлюз тек денсаулық режимінде жұмыс істейді.
`AIHUMMER_DB_APP_URL`	Жолдық деңгейдегі қауіпсіздікті (Row-Level Security) белсендіретін шектеулі рөлді DSN (жергілікті орнатулар үшін автоматты түрде орнатылады).
`AIHUMMER_GATEWAY_ADDR`	Тыңдау мекенжайы (әдепкі `:8780`; орнатушы бос портты таңдайды).
`AIHUMMER_DEFAULT_WORKSPACE_ID`	Кіріс диспетчерін және виджеттің әдепкі жұмыс кеңістігін қосады.
`AIHUMMER_BLOB_DIR`	Медиа/файл қызметін қосады (blob сақтау каталогы).
`AIHUMMER_ADMIN_UI_DIR`	Әкімші SPA-ны `/admin/` мекенжайында ұсынады.
`AIHUMMER_WIDGET_DIR`	Веб виджетті `/widget/` мекенжайында ұсынады.

Қауіпсіздік және қойма

Айнымалы	Мақсаты
`AIHUMMER_MASTER_KEY`	base64-пен кодталған 32 байт; құпияларды тыныштықта сақтауды, қойманы (vault) және BYOK-ты қосады.
`AIHUMMER_MEDIA_TOKEN_SECRET`	Қол қойылған жүктеу URL-дерін қайта іске қосулар арасында жарамды сақтайды.
`AIHUMMER_APPROVAL_TOOLS`	Орындалғанға дейін адамның қатысуымен мақұлдауды талап ететін құралдар.
`AIHUMMER_AIRGAPPED`	`1` модельмен басқарылатын жария шығысты бұғаттайды (air-gapped режим).
`AIHUMMER_AUDIT_RETENTION_DAYS`	Әкімші аудит журналының сақтау терезесі.

Аутентификация және SSO

Айнымалы	Мақсаты
`AIHUMMER_OIDC_ISSUER`	`/v1/admin/*` қорғайды. Онсыз (және LDAP/SAML-сыз) әкімші dev тақырыптарына сенеді — мұндай данаға ешқашан сыртқы қол жеткізуге болмайды.

LDAP/AD және SAML кәсіпорындық кіру үшін OIDC-пен қатар бапталады; SCIM пайдаланушыларды автоматты түрде беруді қамтамасыз етеді. Webhook-тар, SCIM және жұптастыру бөлімін қараңыз.

Арналар және кіріс

Айнымалы	Мақсаты
`AIHUMMER_INBOUND_SECRET`	Коннектор → шлюз `/v1/inbound/*` шақырулары үшін HMAC ортақ құпиясы.
`AIHUMMER_INBOUND_URL`	Коннектор жағы: коннектор жіберетін шлюздің кіріс URL-і.

LLM және модельдер

Айнымалы	Мақсаты
`AIHUMMER_LLM_PROVIDER`	Қолданылатын модель провайдері.
`AIHUMMER_LLM_MODEL`	Модель атауы.
`AIHUMMER_LLM_GATEWAY_URL`	OpenAI-үйлесімді LLM шлюзінің соңғы нүктесі.
`AIHUMMER_OPENAI_API_KEY`	OpenAI-үйлесімді провайдер үшін API кілті.
`AIHUMMER_SUBAGENT_MAX_DEPTH`	Пайда болған ішкі агенттердің ең үлкен тереңдігі.

[!NOTE] Егер ешбір модель жалғанбаса, шлюз жүйе жұмысын жалғастыру үшін детерминирленген макетке ауысады. Ешқашан ақылы модель API талап етілмейді — тегін/жергілікті модельдер мен Codex/ChatGPT-жазылым тасымалы бірінші дәрежелі.

Құралдар

Айнымалы	Мақсаты
`SEARXNG_URL`	`web_search` құралын қосады (SearXNG данасының URL-і).
`CLOAKBROWSER_CDP_URL`	`browser`/`computer` құралдарын қосады (Chrome DevTools Protocol URL).
`AIHUMMER_FS_ROOT`	Осы түбір астында құмжәшіктелген `filesystem_read` құралын қосады.
`AIHUMMER_DB_QUERY_DSN`	Осы DSN-ге қарсы `db_query` (тек оқу) құралын қосады.
`AIHUMMER_CODE_EXEC`	`code_exec` құралын ауыстырады (ортақ хосттарда әдепкі бойынша өшірулі).

Әрбір құралдың не істейтінін толық Құралдар каталогы бөлімінен қараңыз.

Дауыс және sidecar-лар

Айнымалы	Мақсаты
`AIHUMMER_STT_URL`	Сөзден мәтінге sidecar URL-і (орнатушы автоматты түрде орнатады).
`AIHUMMER_TTS_URL`	Мәтіннен сөзге sidecar URL-і (орнатушы автоматты түрде орнатады).
`AIHUMMER_DIARIZE_URL`	Сөйлеушіні диаризациялау sidecar URL-і.
`AIHUMMER_VOICECLONE_URL`	Дауыс клондау sidecar URL-і.
`AIHUMMER_VIDEO_URL`	Бейнені түсіну sidecar URL-і.

Sidecar-лар — бөлек HTTP қызметтер; шлюз оларға URL арқылы қол жеткізеді.

Векторлар және ендірмелер

Айнымалы	Мақсаты
`AIHUMMER_QDRANT_URL`	Нақты вектор қоймасы (Qdrant). Жоқ болса → жадтағы қойма.
`AIHUMMER_EMBEDDER_URL`	Нақты ендіруші қызмет. Жоқ болса → хеш ендіруші.

Шина және бақыланушылық

Айнымалы	Мақсаты
`AIHUMMER_NATS_URL`	Жеткізу үшін қосымша NATS шинасы.
`AIHUMMER_OTEL_ENDPOINT`	Із/метрика жіберу үшін OTLP соңғы нүктесі.

[!WARNING] Бақыланушылық — тек OTLP push. AiHummer Prometheus /metrics соңғы нүктесін немесе /debug/pprof ұсынбайды. Оның орнына AIHUMMER_OTEL_ENDPOINT айнымалысын өзіңіздің жинаушыңызға бағыттаңыз.

Жаңартулар

Айнымалы	Мақсаты
`AIHUMMER_DOWNLOAD_BASE_URL`	Шығарылым артефактілерінің базалық URL-і (өзін-өзі жаңарту көзі).
`AIHUMMER_UPDATE_CHANNEL`	Бақыланатын шығарылым арнасы.
`AIHUMMER_AUTO_UPDATE`	Жаңарту режимі: `off`, `check` немесе `apply`.

Кілтпен қорғалған орнату арналары (alfa/beta/dev) қосымша орнату кезінде AIHUMMER_CHANNEL_KEY / AIHUMMER_RELEASE_TOKEN оқиды.

Маркетплейс және плагиндер

Айнымалы	Мақсаты
`AIHUMMER_BLOB_DIR`	Blob-сақтау каталогы. Медиа/файлдардан басқа, ол жеке (бүйірден жүктелген) плагин артефактілерін `blob:` сілтемелері астында сақтайды, оларды деплойер шешеді.
`AIHUMMER_PLUGIN_PUBKEY`	Плагин қолтаңбаларын тексеру үшін қосымша сенімді ашық кілт (base64 ed25519) — өзекте бекітілген тізілім кілтіне қосымша.
`AIHUMMER_PLUGIN_DEV_UNSIGNED`	`1` қол қойылмаған плагиндерді орнатуға рұқсат береді. Тек жергілікті әзірлеуге — сырттан қол жеткізілетін данада ешқашан.

Сенім моделі (ресми → бекітілген кілт, жеке → сенім қоймасы, қол қойылмаған → бұғатталған) мына жерде сипатталған: Орнату және жаңартулар.

Протокол беттері (қосылуы таңдамалы)

Айнымалы	Мақсаты
`AIHUMMER_MCP_PUBLISH`	`1` `POST /v1/mcp` мекенжайында сыртқы MCP серверін қосады.
`AIHUMMER_A2A_PUBLISH`	`1` A2A бетін қосады (`/.well-known/agent.json`, `/a2a/message`).

Әрі қарай қайда

Әрбір айнымалы қандай құралдарды ашатынын қараңыз: Құралдар каталогы.
Дананы күн сайын басқарыңыз: CLI анықтамасы.