Чөйрө өзгөрмөлөрү

database value  →  environment variable  →  built-in default

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

AiHummer `AIHUMMER_*` чөйрө өзгөрмөлөрү аркылуу конфигурацияланат (ошондой эле `SEARXNG_URL` сыяктуу бир нече аспапка-тиешелүү өзгөрмөлөр менен). Бул бет — аймактар боюнча топтоштурулган каталог. Көпчүлүк өзгөрмөлөр web админ UI'ден да түзөтүлө алат. ## Конфигурация модели Ар бир жөндөө белгиленген тартипте чечилет: ```text database value → environment variable → built-in default ``` Бул дегени админ UI'де сакталган маани (база ичинде сакталат) чөйрөнү басып озот, ал өз кезегинде орнотулган демейкини басып озот. **Bootstrap өзгөрмөлөрү** — gateway базаны окуудан мурда муктаж болгондору, мисалы `AIHUMMER_DATABASE_URL` жана `AIHUMMER_MASTER_KEY` — **environment-only** бойдон калат. Хост-нативдик орнотуу үчүн конфиг файл бул жерде жайгашат: ```ini # /home/.aihummer/etc/gateway.env AIHUMMER_DATABASE_URL=postgres://... AIHUMMER_MASTER_KEY=base64-32-bytes ``` > [!TIP] > Жөнгө салынуучу, bootstrap эмес кнопкаларды web админ UI'де өзгөрткөн жакшы, > ошондо алар файлдарды түзөтпөстөн күчүнө кирет. Кээ бир өзгөртүүлөр (мисалы, > аспаптарды күйгүзүп-өчүрүү жана суб-агенттин тереңдиги) тез колдонулат; > башкалары кызматты кайра иштетүүнү талап кылат. ## Өзөк жана база | Variable | Багыты | |---|---| | `AIHUMMER_DATABASE_URL` | **Милдеттүү.** Postgres DSN. Ансыз gateway health-only режиминде иштейт. | | `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` | Web виджетти `/widget/` дарегинде тейлейт. | ## Коопсуздук жана vault | Variable | Багыты | |---|---| | `AIHUMMER_MASTER_KEY` | base64-кодоштурулган 32 байт; жашыруундарды-эс-сакта, vault жана BYOK иштетет. | | `AIHUMMER_MEDIA_TOKEN_SECRET` | Кайра иштетүүлөр аралыгында кол коюлган жүктөп алуу URL'дерин жарактуу сактайт. | | `AIHUMMER_APPROVAL_TOOLS` | Иштеп баштоодон мурда адамдын-катышуусу менен бекитүүнү талап кылган аспаптар. | | `AIHUMMER_AIRGAPPED` | `1` модель башкарган коомдук egress'ти бөгөттөйт (air-gapped режим). | | `AIHUMMER_AUDIT_RETENTION_DAYS` | Админ аудит журналынын сактоо мөөнөтү. | ## Аутентификация жана SSO | Variable | Багыты | |---|---| | `AIHUMMER_OIDC_ISSUER` | `/v1/admin/*` коргойт. Ансыз (жана LDAP/SAML'сыз) админ dev баштарына ишенет — мындай инстансты эч качан ачыкка чыгарбагыла. | LDAP/AD жана SAML кесиптик кирүү үчүн OIDC менен бирге конфигурацияланат; SCIM автоматтык колдонуучу даярдоону камсыздайт. Караңыз: [Webhooks, SCIM жана жупташтыруу](/en/v1.0/api/webhooks-scim-pairing). ## Каналдар жана кируучу | Variable | Багыты | |---|---| | `AIHUMMER_INBOUND_SECRET` | Коннектор → gateway `/v1/inbound/*` чакырыктары үчүн HMAC бөлүшүлгөн жашыруун. | | `AIHUMMER_INBOUND_URL` | Коннектор тарабы: коннектор пост кылган gateway кируучу URL'и. | ## LLM жана моделдер | Variable | Багыты | |---|---| | `AIHUMMER_LLM_PROVIDER` | Колдонула турган модель провайдери. | | `AIHUMMER_LLM_MODEL` | Модель аты. | | `AIHUMMER_LLM_GATEWAY_URL` | OpenAI'га шайкеш LLM gateway үчүн чекит. | | `AIHUMMER_OPENAI_API_KEY` | OpenAI'га шайкеш провайдер үчүн API ачкычы. | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | Жаратылган суб-агенттердин эң чоң тереңдиги. | > [!NOTE] > Эгер эч модель туташтырылбаса, gateway **детерминисттик mock'ко** кайтат, > ошентип система иштей берет. Эч качан акы төлөнүүчү модель API талап кылынбайт — > бекер/жергиликтүү моделдер жана Codex/ChatGPT-жазылуу транспорту биринчи > класстуу. ## Аспаптар | Variable | Багыты | |---|---| | `SEARXNG_URL` | `web_search` аспабын иштетет (SearXNG инстансынын URL'и). | | `CLOAKBROWSER_CDP_URL` | `browser`/`computer` аспаптарын иштетет (Chrome DevTools Protocol URL'и). | | `AIHUMMER_FS_ROOT` | `filesystem_read` иштетет, бул тамыр алдында sandbox'толгон. | | `AIHUMMER_DB_QUERY_DSN` | Бул DSN'ге каршы `db_query` (окуу-гана) иштетет. | | `AIHUMMER_CODE_EXEC` | `code_exec` аспабын күйгүзөт-өчүрөт (бөлүшүлгөн хосттордо демейки боюнча өчүк). | Ар бир аспап эмне кыларын толук [Аспаптар каталогунан](/en/v1.0/reference/tools-catalog) караңыз. ## Үн жана sidecar'лар | Variable | Багыты | |---|---| | `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 кызматтары; gateway аларга URL аркылуу жетет. ## Векторлор жана embedding'дер | Variable | Багыты | |---|---| | `AIHUMMER_QDRANT_URL` | Чыныгы вектор сактагыч (Qdrant). Жок болсо → эстутумдук сактагыч. | | `AIHUMMER_EMBEDDER_URL` | Чыныгы embedder кызматы. Жок болсо → hash embedder. | ## Bus жана байкоо | Variable | Багыты | |---|---| | `AIHUMMER_NATS_URL` | Жеткирүү үчүн милдеттүү эмес NATS bus. | | `AIHUMMER_OTEL_ENDPOINT` | Trace/метрикаларды түртүү үчүн OTLP чекити. | > [!WARNING] > Байкоо **OTLP түртүү гана**. AiHummer Prometheus `/metrics` чекитин же > `/debug/pprof` **ачпайт**. Анын ордуна `AIHUMMER_OTEL_ENDPOINT`'ти өзүңүздүн > коллекторуңузга багыттаңыз. ## Жаңылоолор | Variable | Багыты | |---|---| | `AIHUMMER_DOWNLOAD_BASE_URL` | Релиз артефакттары үчүн базалык URL (өзүн-өзү жаңылоо булагы). | | `AIHUMMER_UPDATE_CHANNEL` | Көзөмөлдөнө турган релиз каналы. | | `AIHUMMER_AUTO_UPDATE` | Жаңылоо режими: `off`, `check` же `apply`. | Ачкыч менен корголгон орнотуу каналдары (alfa/beta/dev) кошумча `AIHUMMER_CHANNEL_KEY` / `AIHUMMER_RELEASE_TOKEN`'ди **орнотуу учурунда** окуйт. ## Marketplace жана плагиндер | Variable | Багыты | |---|---| | `AIHUMMER_BLOB_DIR` | Blob-сактоо каталогу. Медиа/файлдардан тышкары, ал deployer чечкен `blob:` шилтемелеринин астында **жеке (side-loaded) плагин артефакттарын** сактайт. | | `AIHUMMER_PLUGIN_PUBKEY` | Плагин кол тамгаларын текшерүү үчүн кошумча ишенилген коомдук ачкыч (base64 ed25519) — өзөктө бекитилген каттоо ачкычына **кошумча**. | | `AIHUMMER_PLUGIN_DEV_UNSIGNED` | `1` **кол коюлбаган** плагиндерди орнотууга уруксат берет. Жергиликтүү иштеп чыгуу үчүн гана — тышкы жетиле турган инстансда эч качан эмес. | Ишеним модели (расмий → бекитилген ачкыч, жеке → ишеним сактагычы, кол коюлбаган → бөгөттөлгөн) [Орнотуу жана жаңылоолор](/en/v1.0/marketplace/install-updates#trust-model-and-the-pinned-key) ичинде сүрөттөлгөн. ## Протокол беттери (opt-in) | Variable | Багыты | |---|---| | `AIHUMMER_MCP_PUBLISH` | `1` `POST /v1/mcp` дарегиндеги тышкы MCP серверин иштетет. | | `AIHUMMER_A2A_PUBLISH` | `1` A2A бетин иштетет (`/.well-known/agent.json`, `/a2a/message`). | ## Кийинки кадам - Ар бир өзгөрмө кайсы аспаптарды ачарын караңыз: [Аспаптар каталогу](/en/v1.0/reference/tools-catalog). - Инстансты күн сайын иштетиңиз: [CLI шилтемеси](/en/v1.0/reference/cli).