Շրջակա միջավայրի փոփոխականներ

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

aihummer settings set AIHUMMER_LLM_PROVIDER openai

AiHummer-ի կոնֆիգուրացիան բաժանվում է **երկու խստորեն տարբեր խմբեր**: 1. **Bootstrap (`gateway.env`)** — ինչ պետք է գիտեն դարպասը **առաջ** այս կարող է կարդալ տվյալների զանգվածը՝ տվյալների զանգման DSN, լսելու հասցեներ, ստատիկ գրացուցակներ, հիմնական բանալի։ Միայն այս բանալիներն են կարդացվում միջավայրից։ 2. **Կարգավորումների կատալոգ (կարգավիճակների տվյալների բազա)** — ամեն երկրորդ շրջադարձում։ Դրանք պահվում են համակարգիչների բազա և տեղադրել վեբ ադմին UI-ում (**Կառավարում → Ներմուծումներ**) կամ հետ [`aihummer settings set <KEY> <VALUE>`](/hy/v1.0/reference/cli). Այս համար Ա կոճակները `gateway.env` արժեքը հավասար է **մտածվածորեն անտեսվում էր** — նույնիսկ եթե այն տեղադրված է, այն ունի առանց ազդեցության: ## Կոնֆիգուրացիայի մոդել `gateway.env` է **միայն bootstrap**. Ապահովման կարգը: - **Կարգավորումների կատալոգի բանալի**: `database value → built-in default` (բնագիտական միջավայրը անտեսվում է); - **բեռնի բանալի**: `environment variable only`. Այսպիսով, հարմարեցված պարամետրերի միակ ճշմարտության աղբյուրն է տվյալների բազան (վեբ կարգավորիչի ինտերֆեյսը / `aihummer settings`); միջավայրը պարունակում է միայն այն, ինչ պրոցեսին անհրաժեշտ է սկսելուն համար։ Կոնֆիգուրացիոն ֆայլը տեղական հոստին տեղադրման համար գտնվում է հետևյալ հասցեում: ```ini # /home/.aihummer/etc/gateway.env AIHUMMER_DATABASE_URL=postgres://... AIHUMMER_MASTER_KEY=base64-32-bytes ``` > [!TIP] > Չմիտեք կարգավորումների կատալոգի բռնակները `gateway.env` — սա ազդեցություն չունի։ Փոխել > նրանք կարելի է գտնել ադմինիստրատորի վեբ ինտերֆեյսում (կառավարում → Կարգավորումները, այնտեղ կա որոնում) կամ միջոցով > `aihummer settings set`. Որոշ փոփոխություններ (օրինակ՝ գործիքների անջատիչներ և ենթադրողներ) > խորը) կիրառել զանգվածաբար; մյուսներին անհրաժեշտ է ծառայությունը վերագործարկել։ ## Ներբեռնում (gateway.env) Միակ բանալիները, որոնք պատշաճ կերպով կարդում է անցակետը միջավայրից։ ### Միավորված կենտրոն և տվյալների պահոց | Փոփոխական | Նպատակ | |---|---| | `AIHUMMER_DATABASE_URL` | **Պայմանապե՛ս.** DSNը Postgres-ի համար։ Նրա բացակայության դեպքում գեյթվելը աշխատում է միայն վիճակի ստուգման ռեժիմում։ | | `AIHUMMER_DB_APP_URL` | DSN սահմանափակ դերով, որը ակտիվացնում է տողային մակարդակի անվտանգ մուտքը (ավտոմատ կերպով սահմանվում է տեղային տեղադրման համար): | | `AIHUMMER_GATEWAY_ADDR` | Հրապարակային լսման հասցե (ռումբին ըստ պատահման) `:8780`) — ողջ արտաքին տրաֆիկը` API (`/v1/*`), միացում, WS/SSE, նշված վեբքուկեր, ծրագրերի/ապկետների պրոքսի և վիճակի ստուգում։ | | `AIHUMMER_WEBUI_ADDR` | Անձնական ադմինիստրատորի Web UI լսման հասցե (նմանակարող) `:8781`), սպասարկվում է արմատային ուղիով `/`; ցանկալի է կապել միայն ներքին օգտագործման համար ինտերֆեյսին: Գտնվում է `0` անջատել։ | | `AIHUMMER_DEFAULT_WORKSPACE_ID` | Ընտրում է աշխատական տարածման նախնական կարգը կարգավորված նշված մուտքագրման ինտեգրացիաների համար։ | | `AIHUMMER_HOME_ROOT` | Տեղադրեք արմատը (սովորաբար որոշվում է ըստ բինար ֆայլի ուղու); ամրացնում է admin-ui/blob/installer թղթապանակները և հիմնական ֆայլերը։ | | `AIHUMMER_BLOB_DIR` | Անցկացնում է մեդիա/ֆայլերի ծառայություն (բլոկային պահոցի եկանակետ): Այն նույնպես պահում է **կարգը զանգվածային (ձեռքով սահմանված) հավելվածի արհեստանքներ** ցած `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 push**. AiHummer անում է **ոչ** բացահայտել Պրոմեթեոսին > `/metrics` վերջնակետ կամ `/debug/pprof`. կետ `AIHUMMER_OTEL_ENDPOINT` ձեր վրա > հարւածողի փոխարեն։ ## Կարգավորումների կատալոգ (տվյալների բազա — ադմինիստրատորային վեբ միջերես կամ `aihummer settings`) Յուրաքանչյուր ստորև բերված բանալի պահվում է տվյալների բազայում։ Սահմանեք այն ադմինիստրատորի վեբ ինտերֆեյսում (**Կառավարում → Ներմուծումներ**) կամ այսպես: ```bash 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) ադմինիստրատորը վստահում է մշակողի վերնագրերին — երբեք մի ծանուցեք նման օրինակ հրապարակայնորեն: | LDAP/AD և SAML կազմված են OIDC-ի հետ կորպորատիվ մուտքի համար; SCIM ապահովում է օգտագործողների ավտոմատ տրամադրումը: Տես՝ [Վեբհուքեր, SCIM և համակցում](/hy/v1.0/api/webhooks-scim-pairing). ### ՅԱԶՄ և մոդելներ | Բանալ | Նպատակ | |---|---| | `AIHUMMER_LLM_PROVIDER` | Մոդելի մատակարար օգտագործման համար։ | | `AIHUMMER_LLM_MODEL` | Մոդելի անվանումը | | `AIHUMMER_LLM_GATEWAY_URL` | LLM-ին OpenAI-ով համապատասխանող ցանցային/քարտուղարային վերջնspuntի հիմնական URL `AIHUMMER_LLM_*` ճանապարհ՝ տարբերվող հայրենիքից `AIHUMMER_OPENAI_BASE_URL`). Դիտել [BYOK-ն և մատակարարները](/hy/v1.0/access/byok-providers). | | `AIHUMMER_OPENAI_API_KEY` | API բանալի OpenAI-պետելի համատեղելի մատակարարի համար։ | | `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`-ով — դրանց համար օպերատորի կարգավորումներ չկան: Դիտել ամբողջությամբ [Պահարան գործիքների](/hy/v1.0/reference/tools-catalog) ուր է նախատեսված յուրաքանչյուր գործիքը։ ### Հոգին և սայդքարները | Բանալ | Նպատակ | |---|---| | `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`-ը բացում է արտաքին MCP սերվերը `POST /v1/mcp` հասցեում։ Ինքնին ոչ մի գործիք չի արտահանում։ | | `AIHUMMER_MCP_EXPORT_TOOLS` | Ստորակետերով բաժանված ճշգրիտ գործիքների անուններ, որոնք կտեսնի MCP հաճախորդը։ Դատարկ (լռելյայն) — արտահանվում է ԶՐՈ գործիք։ | | `AIHUMMER_A2A_PUBLISH` | `1` մատուցում է մակերեսը A2A (`/.well-known/agent.json`, `/a2a/message`). | ## Միայն մշակողների համար գծագրեր | Փոփոխական | Նպատակ | |---|---| | `AIHUMMER_PLUGIN_PUBKEY` | Լրացուցիչ վստահված բաց բանալի (base64 ed25519) ները ստուգելու համար հավելվածների ստորագրությունները։ **Միայն մշակողների համար հավաքածուները — անտեսվում են թողարկման հավաքածուներում** (հաճախորդի գրանցման բանալիին կցված է բինար ֆայլում)։ | | `AIHUMMER_PLUGIN_DEV_UNSIGNED` | `1` թույլ է տալիս տեղադրել **աննշան** պլագիններ. **Ուղղված է միայն ծրագրավորողի բաղադրություններին — անտեսվում է թողարկման բաղադրություններում։** Միտումնավոր ոչ մի դեպքում հասանելի զանգվածում։ | > [!WARNING] > Բեռների թողարկված զանգվածներում պլագինի վստահության արմատը հանդիսանում է **պատկերված բինար ֆայլում** և > կարող չէ փոփոխվել միջավայրի կամ կարգաբերումների միջոցով — սա պաշտպանություն է միջամտությունից > երաշխիք. Յուրիմի մոդել (առևտրային → հաստատվող բանալի, մասնավոր → վստահության պահոց, չստորագրված → փակված) նկարագրված է [Տեղադրում և թարմացումներ](/hy/v1.0/marketplace/install-updates#trust-model-and-the-pinned-key). ## Որտեղից հետո - Դիտեք, թե որ գործիքները բացում է յուրաքանչյուր բանալին։ [Պահարան գործիքների](/hy/v1.0/reference/tools-catalog). - Օգտագործեք օրինակ.daily [CLI-ի ուղեցույց](/hy/v1.0/reference/cli).