Կոնֆիգուրացիա

~/.aihummer/etc/gateway.env

# ~/.aihummer/etc/gateway.env (excerpt)
AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer
AIHUMMER_MASTER_KEY=base64-32-bytes...
AIHUMMER_GATEWAY_ADDR=:8780
AIHUMMER_WEBUI_ADDR=:8781
AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main

systemctl restart aihummer-gateway

# Wire a real model (unset → deterministic mock)
aihummer settings set AIHUMMER_LLM_PROVIDER openai
aihummer settings set AIHUMMER_LLM_MODEL gpt-4o-mini
aihummer settings set AIHUMMER_LLM_GATEWAY_URL https://api.openai.com/v1

# Enable tools by pointing at their backends

# Voice sidecars (STT/TTS auto-configured by the installer)
aihummer settings set AIHUMMER_STT_URL http://localhost:8001
aihummer settings set AIHUMMER_TTS_URL http://localhost:8002

# Real vector store + embedder (example URLs; the embedder is installed with
# --with-embedder, otherwise memory uses the lexical fallback)
aihummer settings set AIHUMMER_QDRANT_URL http://localhost:6333
aihummer settings set AIHUMMER_EMBEDDER_URL http://localhost:8080

AiHummer կարգավորվում է միջոցով **Պարամետրերի կատալոգ**, այլ ոչ թե շրջակա միջավայրի փոփոխականների շատություն. `gateway.env` է **միայն bootstrap**: DSN տվյալների բազա, լսելու հասցեներ/փոթեր, գլխավոր բանալի և այլն: Ամբողջ մնացյալ բանալիները գտնվում են տվյալների բազայում և փոխվում են ադմինիստրատորի վեբ ինտերֆեյսի միջոցով գործարկման ժամանակ կամ օգնությամբ `aihummer settings` CLI. Հիմնական կանոնը պարզ է: **ամենը կարգավորելի կարելի է կարգավորել վեբ-միջերեսի միջոցով** — ոչ միայն միջավայրի փոփոխականներով և չի կոդավորված հարդկոդով։ ## Հրաման արձակելու կարգը Յուրաքանչյուր կատալոգային կարգավորում թույլատրվում է նույն կերպ՝ հաղթում է առաջին համընկնումը: 1. **Տվյալների բազա** — նշանակությունը, սահմանված ադմինիստրատորի ինտերֆեյսի միջոցով, կամ `aihummer settings set`. 2. **Ընդհանուր դասավորությամբ** — կանխորոշված ինտեգրված, մատակարարվում է թողարկման հետ։ Արևելիկ միջավայրը հանդիսանում է **հայտնաբերաբար չի մտնում այս շղթայում**: կատալոգի բանալիների համար `AIHUMMER_*` փոփոխականը մեջ `gateway.env` է **գերատեսված**, նույնիսկ եթե դա սահմանված է: Սա տալիս է յուրաքանչյուր կարգավորմանը մեկ ճշմարտության աղբյուր՝ տվյալների բազան, այնպես որ ինտերֆեյսի արժեքը երբեք չի կարող անշահորեն ստվերվել շրջապատի ֆայլում մոռացված տողի կողմից: > [!NOTE] > Փոխելու համար պրոդաքշնային վարքը, դուք չեք խմբագրում կոնֆիգուրացիոն ֆայլերը — դուք փոխում եք > կարգավորումներ վարչական ինտերֆեյսում (**Կառավարում → Ներմուծումներ**, որոնման էջ) կամ սկսել > `aihummer settings set <KEY> <VALUE>` (`get` / `list` կարդալ), և դա տևում է > արդյունք այդ աշխատանքային տարածքի համար: Տեղադրողը ինքնուրույն սերմանում է սկզբնական կատալոգի արժեքները > մուտք դեպի տվյալների բազա `aihummer settings set`. ## Տաք vs պահանջվում է վերագործարկում Թե ինչպես փոփոխումը զանգվածում գործող է դառնում, կախված է տողից՝ | Վարք | Օրինակներ | Երբ դա կիրառվում է | |---|---|---| | **Թեժ** | հսկողության գործիքի զանգվածում, մակսիմալ խորությունը Արգենտինայում | Կրկնակի կարդալը կատարման ժամանակ, առանց վերագործարկման | | **Պահանջվում է վերակենդանացում** | լսելու հասցե, որոշակի ծառայությունների անցկացում | Կիրառվում է գեյթվեյի հաջորդակի վերագործարկման ժամանակ | Տաք հղման բանալիները նորից կարդացվում են իրական ժամանակում, այդ պատճառով գործիքի կամ կարգավորման անցումը `subagent-depth` որոնք կդառնան ուժի մեջ հաջորդ հերթին: Որոշ կառուցվածքային բանալիներ ուժի մեջ են մտնում միայն վերագործարկումից հետո; ադմինիստրատորի ինտերֆեյսը ցույց է տալիս, թե որն ինչ է: ## Bootstrap փոփոխականները մնում են միայն շրջապատում Որոշ փոփոխականներ պետք է լինեն միջավայրում, քանի որ դրանք անհրաժեշտ են մինչ կարգաբերման կարգաբլիկը գոյություն ունի (և տվյալների բազան, որից այն կարդում է): Այս **բեռնման** պատճառվածները հասանելի են միայն միջավայրում և չեն ցուցադրվում կառավարչական ինտերֆեյսում: | Փոփոխական | Ինչու սա bootstrap-ն է | |---|---| | `AIHUMMER_DATABASE_URL` | Տվյալների բազան պետք է գոյություն ունենա այն միւսը, մինչ կարողանանք կարդալ տվյալների բազային կախյալ ցանկացած կարգավորում: | | `AIHUMMER_DB_APP_URL` | Սահմանափակվելը DSN-ի դերը, որը ակտիվացնում է RLS-ը։ | | `AIHUMMER_MASTER_KEY` | base64-32 բայթ; բացում է հանգստացած / պահոց / BYOK վիճակում գտնվող գաղտնիքները: | | `AIHUMMER_GATEWAY_ADDR` | Հրապարակային լսման հասցե (ռումբին ըստ պատահման) `:8780`) — API, միացում, WS/SSE, մուտքային և պրոքսի ծրագրի/ապարանի համար. | | `AIHUMMER_WEBUI_ADDR` | Անձնական ադմինիստրատորի Web UI լսման հասցե (նմանակարող) `:8781`), տեղադրվում է արմատային թղթապանակում `/`; տեղադրել վրա `0` անջատել։ | | `AIHUMMER_BLOB_DIR` | Blob/media գրացուցակի ֆայլային համակարգի ուղին անհրաժեշտ է ներբեռնում կատարելիս։ | | `AIHUMMER_OIDC_ISSUER` | Պաշտպանում է `/v1/admin/*` մինչ օգտատերային ինտերֆեյսը վստահելի կլինի: | Այսպիսի Ops ուղեցույցը, ինչպես OTLP հեռահաղորդման վերջնակետը, պատկանում է նույն բեռնման կատեգորիային: Բոլորը, ինչը չի մտնում այս կարճ ցուցակում, հանդիսանում է կատալոգի բանալին՝ այն պահվում է տվյալների բազայում, և դրա համար միջավայրի փոփոխականը անտեսվում է։ > [!WARNING] > Պահել `AIHUMMER_MASTER_KEY` անվտանգության մեջ և բեկափնօրպությամբ **տարբերաբար** ձեր տվյալների բազայից > պահուստային պատճեն։ Այն կդեկոդավորի հավատարմագրերի պահոցը; կորցրեք այն, և ծածկագրված գաղտնիքները > չի կարող վերականգնվել։ ## Կոնֆիգուրացիայի ֆայլ Հոսթին բնորոշ կազմաձեւումների համար bootstrap միջավայրը գտնվում է մեկ ֆայլի մեջ, որը բեռնում է systemd կարգավորիչը: ```text ~/.aihummer/etc/gateway.env ``` Խմբագրեք այս ֆայլը **միայն բուտստրապի արժեքների համար**, այնուհետև վերագործարկել զանգվածային մուտքի ծառայությունը, որպեսզի կիրառվեն փոփոխությունները: ```ini # ~/.aihummer/etc/gateway.env (excerpt) AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer AIHUMMER_MASTER_KEY=base64-32-bytes... AIHUMMER_GATEWAY_ADDR=:8780 AIHUMMER_WEBUI_ADDR=:8781 AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main ``` ```bash systemctl restart aihummer-gateway ``` Ամեն ինչ, ինչը դուրս է գալիս այս ինիչյալ բանալիների շրջանակներից՝ գործակալները, գործիքները, հիշողության ռեժիմը, բանավեճի ռազմավարությունները, բյուջեները, սահմանափակումները և մնացածը՝ կառավարվում է ադմինիստրատորի ինտերֆեյսի կարգավորումներով (կամ միջոցով `aihummer settings`), ոչ այս ֆայլից․ env-ը անտեսվում է այս ստեղների համար: ## Հավելյալ ֆունկցիաների միացում Շատ գործառույթներ անջատված են, մինչև դուք չնշեք նրանց աջակցության ծառայությունը։ Այս բոլոր բանալիները կատալոգի պարամետրեր են (նրանք պահվում են տվյալների բազայում)` սահմանեք դրանք վարչական ինտերֆեյսում (**Կառավարում → Ներմուծումներ**) կամ CLI-ի միջոցով; դնելով դրանք `gateway.env` ոչինչ չի անում — նրանց համար env-ը անտեսվում է: Սայդկարների համար, որոնք տեղադրվում են փաթեթից (STT/TTS և այլն), տեղադրիչը ինքն է վերհանում արժեքները տվյալների բազայում: ```bash # Wire a real model (unset → deterministic mock) aihummer settings set AIHUMMER_LLM_PROVIDER openai aihummer settings set AIHUMMER_LLM_MODEL gpt-4o-mini aihummer settings set AIHUMMER_LLM_GATEWAY_URL https://api.openai.com/v1 # Enable tools by pointing at their backends # Voice sidecars (STT/TTS auto-configured by the installer) aihummer settings set AIHUMMER_STT_URL http://localhost:8001 aihummer settings set AIHUMMER_TTS_URL http://localhost:8002 # Real vector store + embedder (example URLs; the embedder is installed with # --with-embedder, otherwise memory uses the lexical fallback) aihummer settings set AIHUMMER_QDRANT_URL http://localhost:6333 aihummer settings set AIHUMMER_EMBEDDER_URL http://localhost:8080 ``` > [!TIP] > Այս մոդելը երբեք պահանջված չէ։ Առանց `AIHUMMER_LLM_*` կապված է, պատասխանները գալիս են > նահանգման ձևավորված դասավորությունից; AiHummer-ը նույնպես աշխատում է անվճար/տեղական OpenAI համատեղելի ձևով > վերջնման կետեր և Codex/ChatGPT բաժանորդագրման տրանսպորտ, համեմատաբար BYOK ֆունկցիայով: ## Ծանուցումներ Վարչարարի ինտերֆեյս **Ծանուցումներ** էջը («Կառավարում» բաժնում) հանդիսանում է իրադարձությունների օրինակների փոստային արկղ (վարչական մուտք, հասանելի/ներբեռնված թարմացում, կողմնակի գործընթացի անկում կամ վերականգնում և այլն)՝ կատեգորիայի, ծանրության աստիճանի և չկարդացվածների ֆիլտրերով։ Ջերմակից կողքին գտնվում է **մատրիցա կատեգորիա × առաքման ալիք**: յուրաքանչյուր դեպքի կատեգորիայի համար, որը դուք ներառում եք **վեբ ինտերֆեյս**, **էլեկտրոնային փոստ**, **տելեգրամ** և **տալ հետագա քաշումով** չանելներ։ Վեբ ինտերֆեյսի ծանուցումները առաքվում են տեղական կերպով; Telegram-ը միացվում է «Կապել Telegram» կոճակի (սուզված հղում) միջոցով, էլեկտրոնային փոստը ակտիվանում է աջակցման հասցեն հաստատելուց հետո, իսկ push-ծանուցումները գալիս են բջջային հավելվածում։ Կրիտիկական իրադարձություններ Չի կարող զրոյացվել webui ալիքի վրա: ## Որտեղից հետո - Արգելափակել ադմինիստրատորի մուտքը: [Առաջին մուտք](/hy/v1.0/getting-started/first-login). - Դիտեք, որտեղ են գտնվում ֆայլերը․ [Տեղադրում](/hy/v1.0/getting-started/installation). - Ստուգեք նախնական պահանջները: [Պահանջներ](/hy/v1.0/getting-started/requirements).