Seadistus

~/.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 on konfigureeritud kaudu **seadistuste kataloog**, mitte hunnik keskkonnamuutujaid. `gateway.env` on **ainult bootstrap**: andmebaasi DSN, kuulamisaadressid/pordid, põhivõti ja selle sarnased. Iga teine võti elab andmebaasis ja seda muudetakse veebihalduse kasutajaliideses reaalajas või `aihummer settings` KLI. Juhtreegel on lihtne: **kõik reguleeritav on veebiliideses seadistatav** — mitte ainult keskkonnamuutujad, ja mitte kõvakodeeritud. ## Lahenduse järjekord Iga kataloogi seade lahendatakse samamoodi, esimene sobiv võidab: 1. **Andmebaas** — väärtus, mis on määratud administraatori kasutajaliidese kaudu või `aihummer settings set`. 2. **Vaikeväärtus** — vaikimisi sisseehitatud, mis tuleb koos väljaandega. Keskkond on **tahtlikult selle ahela osa mitte**: kataloogi võtmete jaoks `AIHUMMER_*` muutuja sees `gateway.env` on **ignoreeritud**, isegi kui see on seatud. See annab igale seadele täpselt ühe tõepõhjuse — andmebaasi — nii et kasutajaliidese väärtust ei saa kunagi vaikselt varjutada unustatud rida keskkonnafailis. > [!NOTE] > Et muuta käitumist tootmises, ei muuda sa konfiguratsioonifaile — sa muudad > seadistus administraatori kasutajaliideses (**Haldus → Seaded**, otsitav lehekülg) või käivitage > `aihummer settings set <KEY> <VALUE>` (`get` / `list` lugemiseks), ja see võtab > efekt selle tööruumi jaoks. Installer ise paneb paika algsed kataloogi väärtused > andmebaasi kaudu `aihummer settings set`. ## Kuuma lähtestamise vs taaskäivituse nõudmine Kuidas muudetud seade jõustub, sõltub võtmetest: | Käitumine | Näited | Kui see kehtib | |---|---|---| | **Kuum** | tööriista lubamine, abiagendi maksimaalne sügavus | Loetakse jooksvalt uuesti, taaskäivitust ei nõuta | | **Taaskäivitust nõutav** | kuulamisaadress, teatavate teenuste juhtmestik | Rakendatakse järgmisel värava taaskäivitamisel | Kiirklahve loetakse reaalajas uuesti, nii et tööriista sisse- või väljalülitamine või kohandamine `subagent-depth` Jõustub järgmise käigu ajal. Mõned struktuurilised võtmed jõustuvad alles pärast taaskäivitamist; administraatori liides näitab, milline on milline. ## Bootstrap muutujad jäävad ainult keskkonnamuutujateks Mõned muutujad peavad keskkonnas olema, sest neid on vaja enne, kui seadistuste kataloog (ja andmebaas, kust see loeb) eksisteerib. Need **bootstrap** muutujad on ainult keskkonna jaoks ja neid ei kuvata administraatori liideses: | Muutuja | Miks see on bootstrap | |---|---| | `AIHUMMER_DATABASE_URL` | Andmebaas peab olemas olema enne, kui saab lugeda mõnda andmebaasi tuginevat seadet. | | `AIHUMMER_DB_APP_URL` | Piiratud rolliga DSN, mis aktiveerib RLS-i. | | `AIHUMMER_MASTER_KEY` | base64-32 baiti; avab rahulolevad saladused / vahesein / BYOK. | | `AIHUMMER_GATEWAY_ADDR` | Avalik kuulamisadress (vaikimisi `:8780`) — API, sidumine, WS/SSE, sissetulev ja rakenduse/tasku proxy. | | `AIHUMMER_WEBUI_ADDR` | Privaatne administraatori veebiliidese kuulamisaadress (vaikimisi `:8781`), serveeritud juurel `/`; määratud `0` keelata. | | `AIHUMMER_BLOB_DIR` | Blob/meedia kataloogi failisüsteemi rada — vajalik käivitamisel. | | `AIHUMMER_OIDC_ISSUER` | Kaitseb `/v1/admin/*` enne kui UI-d usaldatakse. | Operatsioonide juhtmestik, näiteks telemeetria OTLP lõpp-punkt, kuulub samasse alglaadimise kategooriasse. Kõik, mis ei ole selles lühikeses nimekirjas, on kataloogi võti: see elab andmebaasis ja selle puhul jäetakse keskkond kõrvale. > [!WARNING] > Hoia `AIHUMMER_MASTER_KEY` turvaline ja varundatud **eraldi** teie andmebaasist > varukoopia. See dekrüpteerib mandaadivaramu; kaota see ja krüptitud saladused > ei ole võimalik taastada. ## Konfiguratsioonifail Hosti-sisemise paigalduse puhul elab bootstrap-keskkond ühes failis, mida systemd-ühik laadib: ```text ~/.aihummer/etc/gateway.env ``` Muuda seda faili **ainult lähtestamisväärtuste jaoks**, seejärel taaskäivitage väravteenuse teenus muudatuste rakendamiseks: ```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 ``` Kõik, mis jääb nende algvõtmete taha — agentid, tööriistad, mälurežiim, mõtlemisstrateegiad, eelarved, kaitsetavad ja muu — hallatakse administraatori kasutajaliidese seadistustest (või kaudu `aihummer settings`), mitte sellest failist: env jäetakse nende võtmete puhul tähelepanuta. ## Valikuliste funktsioonide juhtmestik Paljud funktsioonid on välja lülitatud, kuni suunate need tugiteenusele. Kõik need võtmed on kataloogi seaded (nad elavad andmebaasis): määrake need administraatori liideses (**Haldus → Seaded**) või CLI-ga; paigutades need `gateway.env` ei tee midagi — nende jaoks jäetakse env tähelepanuta. Sidecar-ide puhul, mis on paigaldatud paketist (STT/TTS jne.), sisestab paigaldaja väärtused otse andmebaasi. ```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] > Tõelist mudelit ei nõuta kunagi. Ilma `AIHUMMER_LLM_*` traadiga, vastused tulevad > deterministlikust võltsimist; AiHummer töötab ka tasuta/ lokaalse OpenAI-ga ühilduval > lõpp-punktid ja Codex/ChatGPT tellimusega transport, valikulise BYOK-iga. ## Teavitused Admini kasutajaliidesed **Teavitused** leht (jaotises "Juhtimine") on instantsi sündmuste postkast (admini sisselogimine, uuendus saadaval/kasutusele võetud, kõrvalteenus tõrkeolekus või taastumas jne) koos filtritega kategooria, tõsiduse ja lugemata oleku järgi. Selle kõrval asub **kategooria × tarnekanali maatriks**: iga sündmuse kategooria jaoks, mille te lubate **veebiliides**, **e-post**, **telegramm** ja **tõmba** kanalid. Veebi UI teated edastatakse kohapeal; Telegram on seotud nupuga "Link Telegram" (sügav link), e-post aktiveeritakse pärast tugiaadressi kinnitamist ja push-teated jõuavad mobiilirakendusse. Kriitilisi sündmusi ei saa veebiliidese kanalil vaigistada. ## Kuhu järgmine - Lukusta administraatori sisselogimine: [Esimene sisselogimine](/et/v1.0/getting-started/first-login). - Vaata, kus failid asuvad: [Paigaldus](/et/v1.0/getting-started/installation). - Kontrollige eeltingimusi: [Nõuded](/et/v1.0/getting-started/requirements).