Konfigurācija

~/.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 ir konfigurēts caur **iestatījumu katalogs**, nevis videi mainīgo krāvums. `gateway.env` ir **tikai bootstrap**: datubāzes DSN, klausīšanās adreses/porti, galvenais atslēga un tamlīdzīgi. Katra cita atslēga dzīvo datubāzē un tiek mainīta no tīmekļa admin UI izpildlaikā vai ar `aihummer settings` CLI. Vadlīnija ir vienkārša: **viss regulējamais ir konfigurējams tīmekļa lietotāja saskarnē** — ne tikai vidē, un ne fiksēti. ## Izšķiršanas kārtība Katrs kataloga iestatījums tiek atrisināts vienādi, pirmais atbilstība uzvar: 1. **Datu bāze** — vērtība, kas iestatīta caur admina lietotāja interfeisu vai `aihummer settings set`. 2. **Noklusējums** — iebūvētais noklusējuma, kas piegādāts ar laidienu. Vide ir **apzināti nav šīs ķēdes daļa**: katalogu atslēgām un `AIHUMMER_*` mainīgais in `gateway.env` ir **ignorēts**, pat ja tas ir iestatīts. Tas dod katram iestatījumam tieši vienu patiesības avotu — datu bāzi — tādējādi UI vērtību nekad nevar nemanāmi aizēnot aizmirsta rindiņa vides failā. > [!NOTE] > Lai mainītu uzvedību ražošanā, jūs nerediģējat konfigurācijas failus — jūs maināt > iestatījums administrēšanas lietotāja saskarnē (**Pārvaldība → Iestatījumi**, meklējama lapa) vai palaist > `aihummer settings set <KEY> <VALUE>` (`get` / `list` lasīt), un tas aizņem > efekts šim darba vietai. Instalētājs pats iestāda sākotnējās kataloga vērtības > datubāzē caur `aihummer settings set`. ## Karsti pret nepieciešams restartēt Kā mainītās iestatījums stājas spēkā, ir atkarīgs no taustiņa: | Uzvedība | Piemēri | Kad piemērojams | |---|---|---| | **Karsts** | rīka aktivizēšana, apakšaģenta maksimālais dziļums | Pārlasīt izpildes laikā, bez restartēšanas | | **Nepieciešama pārstartēšana** | uztveršanas adrese, noteiktu pakalpojumu vadu savienojums | Tiks piemērots nākamajā vārtejas restartā | Karstie taustiņi tiek pārlasīti tiešraidē, tāpēc rīka pārslēgšana vai pielāgošana `subagent-depth` stājas spēkā nākamajā gājienā. Daži struktūras taustiņi stājas spēkā tikai pēc restartēšanas; administrēšanas lietotāja saskarne norāda, kurš ir kurš. ## Bootstrap mainīgie paliek tikai vidē Dažiem mainīgajiem jābūt klāt vidē, jo tie ir nepieciešami pirms iestatījumu kataloga (un datubāzes, no kuras tas lasa) pastāvēšanas. **atslēgas zābaks** mainīgie ir tikai vides un netiek rādīti administrēšanas lietotāja saskarnē: | Mainīgais | Kāpēc tas ir bootstrap | |---|---| | `AIHUMMER_DATABASE_URL` | Datu bāzei jāeksistē, pirms var nolasīt jebkuru ar datu bāzi saistītu iestatījumu. | | `AIHUMMER_DB_APP_URL` | Ierobežota loma DSN, kas aktivizē RLS. | | `AIHUMMER_MASTER_KEY` | base64-32 baiti; atslēdz noslēpumus-atpūtā / seifs / BYOK. | | `AIHUMMER_GATEWAY_ADDR` | Publiskā klausīšanās adrese (noklusējums `:8780`) — API, savienošana, WS/SSE, ienākošie dati un lietotnes/somas starpniekserveris. | | `AIHUMMER_WEBUI_ADDR` | Privātā administratora tīmekļa saskarnes klausīšanās adrese (noklusējums `:8781`), pasniegts saknē `/`; iestatīt uz `0` atspējot. | | `AIHUMMER_BLOB_DIR` | Blob/mediju direktorijas failu sistēmas ceļš — nepieciešams palaišanas laikā. | | `AIHUMMER_OIDC_ISSUER` | Aizsargā `/v1/admin/*` pirms lietotāja saskarne tiek uzticēta. | Ops kabeļvedība, piemēram, telemetrijas OTLP galapunkts, ietilpst tajā pašā startēšanas kategorijā. Viss, kas nav šajā īsajā sarakstā, ir katalogu atslēga: tas dzīvo datu bāzē, un vidēja vide (env) tam netiek ņemta vērā. > [!WARNING] > Turēt `AIHUMMER_MASTER_KEY` drošs un dublēts **atsevišķi** no jūsu datubāzes > dublējums. Tas atšifrē akreditācijas glabātuvi; ja to pazaudē, zaudē šifrētās noslēpumus > to nevar atgūt. ## Konfigurācijas fails Hosta dzimtajām instalācijām bootstrap vide atrodas vienā failā, ko ielādē systemd vienība: ```text ~/.aihummer/etc/gateway.env ``` Rediģēt šo failu **tikai par bootstrap vērtībām**, pēc tam restartējiet vārtejas pakalpojumu, lai piemērotu izmaiņas: ```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 ``` Viss, kas pārsniedz šos sākotnējās palaišanas atslēgas — aģenti, rīki, atmiņas režīms, spriešanas stratēģijas, budžeti, drošības ierobežojumi un pārējais — tiek pārvaldīts no administratora lietotāja saskarnes iestatījumiem (vai caur `aihummer settings`), ne no šī faila: vides mainīgie šiem atslēgu nosaukumiem netiek ņemti vērā. ## Vadu iespēju izvēle Daudzas funkcijas ir izslēgtas, līdz tās norādāt uz atbalsta pakalpojumu. Visi šie taustiņi ir kataloga iestatījumi (tie atrodas datubāzē): iestatiet tos administrācijas lietotāja saskarnē (**Pārvaldība → Iestatījumi**) vai ar CLI; ievietojot tos `gateway.env` nedara neko — viņiem 'env' tiek ignorēts. Blakusprogrammām, kas instalētas no pakotnes (STT/TTS utt.), instalētājs pats ievada vērtības datu bāzē. ```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] > Reālam modelim nekad nav nepieciešams. Bez `AIHUMMER_LLM_*` savienots, atbildes nāk > no deterministiska maketa; AiHummer arī darbojas uz bezmaksas/lokāla OpenAI saderīga > galapunkti un Codex/ChatGPT abonementa transports, ar izvēles BYOK. ## Paziņojumi Administratora lietotāja saskarnes **Paziņojumi** lapa (zem “Kontrole”) ir instanču notikumu iesūtne (administratora pieslēgšanās, pieejamas/pielietotas atjaunināšanas, palīgprogrammas izslēgšanās vai atjaunošanās utt.) ar filtriem pēc kategorijas, smaguma un nelasītiem. Blakus tai atrodas **kategorijas × piegādes kanāla matrica**: katrai notikumu kategorijai, kuru jūs iespējot **tīmekļa saskarne**, **epasts**, **telegramma** un **stumt** kanāli. Tīmekļa lietotāja interfeisa paziņojumi tiek piegādāti lokāli; Telegrams ir saistīts ar pogu „Saite uz Telegramu” (dziļā saite), e-pasts aktivizējas, tiklīdz tiek pārbaudīta atbalsta adrese, un push ziņojumi tiek saņemti mobilajā lietotnē. Kritiskos notikumus nevar izslēgt tīmekļa lietotāja interfeisa kanālā. ## Kur uz nākamo - Bloķēt administratora pieslēgšanos: [Pirmais pieteikšanās](/lv/v1.0/getting-started/first-login). - Skatīt, kur atrodas faili: [Uzstādīšana](/lv/v1.0/getting-started/installation). - Pārbaudiet priekšnosacījumus: [Prasības](/lv/v1.0/getting-started/requirements).