Կարգավորում

/home/.aihummer/etc/gateway.env

# /home/.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_OIDC_ISSUER=https://idp.example/realms/main

systemctl restart aihummer-gateway

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

# Enable tools by pointing at their backends
SEARXNG_URL=http://localhost:8888
CLOAKBROWSER_CDP_URL=http://localhost:9222

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

# Real vector store + embedder (else in-memory + hash embedder)
AIHUMMER_QDRANT_URL=http://localhost:6333
AIHUMMER_EMBEDDER_URL=http://localhost:8080

AiHummer-ը կարգավորվում է **կարգավորումների կատալոգի** միջոցով, այլ ոչ թե միջավայրի փոփոխականների կույտով։ Յուրաքանչյուր կարգավորում ունի որոշված լուծման հերթականություն, ստեղների մեծ մասը կարելի է փոխել վեբ ադմին UI-ից գործարկման ընթացքում, և միայն փոքր խումբ bootstrap փոփոխականներ պետք է մնան միջավայրում։ Առաջնորդող կանոնը պարզ է. **ամեն կարգավորելի բան կարգավորելի է Web UI-ում** — ոչ միայն env-ում, և ոչ ապակոդավորված։ ## Լուծման հերթականությունը Կատալոգի յուրաքանչյուր կարգավորում լուծվում է նույն հերթականությամբ, առաջին համընկնումը հաղթում է. 1. **Տվյալների բազա** — արժեք, որը սահմանվել է ադմին UI-ի միջոցով (պահվում է ըստ workspace-ի)։ 2. **Միջավայր** — համապատասխան `AIHUMMER_*` փոփոխականը։ 3. **Լռելյայն** — թողարկման հետ առաքվող ներկառուցված լռելյայն արժեքը։ Սա նշանակում է, որ ադմին UI-ի արժեքը գործարկման ընթացքում **վերասահմանում է** միջավայրը, իսկ միջավայրը վերասահմանում է ներկառուցված լռելյայնը։ Դուք կարող եք միջավայրում առաքել ողջամիտ բազային գիծ, ապա կարգաբերել վարքը ուղիղ եթերում UI-ից՝ առանց վերատեղակայման։ > [!NOTE] > Քանի որ տվյալների բազայի շերտը գտնվում է միջավայրի վերևում, արտադրությունում վարքի > մեծ մասը փոխելու համար դուք չեք խմբագրում կարգավորման ֆայլերը — դուք փոխում եք այն > ադմին UI-ում, և այն ուժի մեջ է մտնում տվյալ workspace-ի համար։ ## Տաք vs վերագործարկում պահանջող Թե ինչպես է փոխված կարգավորումը ուժի մեջ մտնում, կախված է ստեղնից. | Վարք | Օրինակներ | Երբ է կիրառվում | |---|---|---| | **Տաք** | գործիքի միացում, ենթա-գործակալի առավելագույն խորություն | Վերընթերցվում է գործարկման ընթացքում, առանց վերագործարկման | | **Վերագործարկում պահանջող** | listen հասցե, որոշ ծառայությունների միացում | Կիրառվում է gateway-ի հաջորդ վերագործարկման ժամանակ | Տաք ստեղները վերընթերցվում են ուղիղ եթերում, ուստի գործիքի փոխարկումը կամ `subagent-depth`-ի կարգաբերումը ուժի մեջ է մտնում հաջորդ ընթացքում։ Որոշ կառուցվածքային ստեղներ ուժի մեջ են մտնում միայն վերագործարկումից հետո. ադմին UI-ը նշում է, թե որն է որը։ ## Bootstrap փոփոխականները մնում են միայն env-ում Մի քանի փոփոխական պետք է առկա լինեն միջավայրում, քանի որ դրանք անհրաժեշտ են, նախքան կարգավորումների կատալոգը (և տվյալների բազան, որից այն կարդում է) գոյություն ունենա։ Այս **bootstrap** փոփոխականները միայն env-ում են և չեն երևում ադմին UI-ում. | Փոփոխական | Ինչու է այն bootstrap | |---|---| | `AIHUMMER_DATABASE_URL` | DB-ն պետք է գոյություն ունենա, նախքան որևէ DB-ապահովված կարգավորում կարդալը հնարավոր լինի։ | | `AIHUMMER_DB_APP_URL` | Սահմանափակ դերի DSN, որն ակտիվացնում է RLS-ը։ | | `AIHUMMER_MASTER_KEY` | base64-32 բայթ. ապակողպում է գաղտնիքները-հանգստի վիճակում / vault / BYOK։ | | `AIHUMMER_GATEWAY_ADDR` | Listen հասցե (լռելյայն՝ `:8780`)։ | | `AIHUMMER_OIDC_ISSUER` | Պաշտպանում է `/v1/admin/*`-ը, նախքան UI-ին վստահելը։ | > [!WARNING] > Պահեք `AIHUMMER_MASTER_KEY`-ը անվտանգ և կրկնօրինակեք այն ձեր տվյալների բազայի > կրկնօրինակից **առանձին**։ Այն վերծանում է հավատարմագրերի vault-ը. կորցրեք այն, և > գաղտնագրված գաղտնիքները չեն կարող վերականգնվել։ ## Կարգավորման ֆայլը Host-native տեղադրումների համար bootstrap միջավայրը գտնվում է մեկ ֆայլում, որը բեռնում է systemd unit-ը. ```text /home/.aihummer/etc/gateway.env ``` Խմբագրեք այս ֆայլը bootstrap և բազային արժեքների համար, ապա վերագործարկեք gateway ծառայությունը՝ փոփոխությունները կիրառելու համար. ```ini # /home/.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_OIDC_ISSUER=https://idp.example/realms/main ``` ```bash systemctl restart aihummer-gateway ``` Այս bootstrap/բազային ստեղներից դուրս ամեն ինչ — գործակալներ, գործիքներ, հիշողության ռեժիմ, դատողության ռազմավարություններ, բյուջեներ, պաշտպանական մեխանիզմներ և մնացածը — նախատեսված է կառավարվել ադմին UI-ի կարգավորումներից, այլ ոչ թե այս ֆայլից։ ## Ընտրովի հնարավորությունների միացում Շատ ֆունկցիաներ անջատված են, քանի դեռ դուք դրանք չեք ուղղորդել դեպի ապահովող ծառայություն։ Դրանք սովորաբար մեկ անգամ սահմանվում են `gateway.env`-ում (կամ վերասահմանվում են UI-ում, որտեղ կիրառելի է). ```ini # Wire a real model (absent → deterministic mock) AIHUMMER_LLM_PROVIDER=openai AIHUMMER_LLM_MODEL=gpt-4o-mini AIHUMMER_LLM_GATEWAY_URL=https://api.openai.com/v1 # Enable tools by pointing at their backends SEARXNG_URL=http://localhost:8888 CLOAKBROWSER_CDP_URL=http://localhost:9222 # Voice sidecars (STT/TTS auto-set by the installer) AIHUMMER_STT_URL=http://localhost:8001 AIHUMMER_TTS_URL=http://localhost:8002 # Real vector store + embedder (else in-memory + hash embedder) AIHUMMER_QDRANT_URL=http://localhost:6333 AIHUMMER_EMBEDDER_URL=http://localhost:8080 ``` > [!TIP] > Իրական մոդելը երբեք պարտադիր չէ։ Առանց `AIHUMMER_LLM_*`-ի միացման՝ պատասխանները > գալիս են դետերմինիստական mock-ից. AiHummer-ը նաև աշխատում է անվճար/լոկալ > OpenAI-համատեղելի վերջնակետերի և Codex/ChatGPT-բաժանորդագրության փոխադրման վրա՝ > ընտրովի BYOK-ով։ ## Ծանուցումներ Ադմին UI-ի **«Ծանուցումներ»** էջը («Վերահսկում» խումբ) instance-ի իրադարձությունների մուտքային ժապավենն է (ադմինիստրատորի մուտք, հասանելի/կիրառված թարմացում, sidecar-ների անկում և վերականգնում և այլն)՝ կատեգորիայի, կարևորության և չկարդացվածների զտիչներով։ Կողքին՝ **կատեգորիա × առաքման ալիք** մատրիցան. իրադարձությունների յուրաքանչյուր կատեգորիայի համար միացվում են **webui**, **email**, **telegram** և **push** ալիքները։ Webui ծանուցումներն առաքվում են լոկալ; Telegram-ը կապվում է «Կապել Telegram-ը» կոճակով (deep-link), email-ն ակտիվանում է աջակցության հասցեի հաստատումից հետո, push-ը գալիս է բջջային հավելված։ Կրիտիկական իրադարձությունները webui ալիքում անջատել հնարավոր չէ։ ## Ուր հետո - Փակեք ադմին մուտքը. [Առաջին մուտք](/hy/v1.0/getting-started/first-login)։ - Տեսեք, թե որտեղ են գտնվում ֆայլերը. [Տեղադրում](/hy/v1.0/getting-started/installation)։ - Ստուգեք նախապայմանները. [Պահանջներ](/hy/v1.0/getting-started/requirements)։