Konfiguraatio — AiHummer Asiakirjat

AiHummer on määritetty kautta asetusten luettelo, ei kasa ympäristömuuttujia. gateway.env on vain bootstrap: tietokannan DSN, kuunteluosoitteet/portit, pääavain ja sen kaltaiset. Kaikki muut avaimet sijaitsevat tietokannassa ja niitä muutetaan web-hallintaliittymästä suorituksen aikana tai aihummer settings Komentorivi. Ohjaava sääntö on yksinkertainen: kaikki säädettävä on konfiguroitavissa Web-käyttöliittymässä — ei pelkästään ympäristömuuttujille, eikä kovakoodattu.

Ratkaisujärjestys

Jokainen luettelon asetus ratkaistaan samalla tavalla, ensimmäinen osuma voittaa:

Tietokanta — arvo, joka asetetaan hallintakäyttöliittymän kautta tai aihummer settings set.
Oletus — sisäänrakennettu oletusarvo, joka toimitetaan julkaisun mukana.

Ympäristö on tahallisesti tämän ketjun ulkopuolella: luettelon avaimille AIHUMMER_* muuttuja sisällä gateway.env on ohitettu, vaikka se olisi asetettu. Tämä antaa jokaiselle asetukselle täsmälleen yhden totuudenlähteen — tietokannan — joten käyttöliittymän arvoa ei voi koskaan hiljaisesti varjostaa unohdetulla rivillä ympäristötiedostossa.

[!NOTE] Muuttaaksesi käyttäytymistä tuotannossa et muokkaa kokoonpanotiedostoja — sinä muutat asetus hallinnon käyttöliittymässä (Hallinta → Asetukset, haettava sivu) tai suorita aihummer settings set <KEY> <VALUE> (get / list lukea), ja se vie vaikutus siihen työtilaan. Asennusohjelma itse asettaa alkuperäiset luetteloarvot tietokantaan kautta aihummer settings set.

Kuuma vs uudelleenkäynnistystä vaativa

Miten muutettu asetus astuu voimaan, riippuu näppäimestä:

Käyttäytyminen	Esimerkkejä	Kun se koskee
Kuuma	työkalun käyttömahdollisuus, ali-agentin suurin syvyys	Lue uudelleen ajon aikana, ei uudelleenkäynnistystä
Uudelleenkäynnistys vaaditaan	kuunteluosoite, tiettyjen palveluiden kytkeminen	Sovellettu seuraavan portin uudelleenkäynnistyksen yhteydessä

Pikanäppäimiä luetaan uudelleen reaaliajassa, joten työkalun vaihtaminen tai säätäminen subagent-depth astuu voimaan seuraavalla kierroksella. Jotkut rakenteelliset avaimet astuvat voimaan vasta uudelleenkäynnistyksen jälkeen; hallintaliittymä merkitsee, mikä on mikä.

Bootstrap-muuttujat pysyvät vain ympäristössä

Muutamien muuttujien on oltava läsnä ympäristössä, koska niitä tarvitaan ennen asetuskatalogin (ja tietokannan, josta se lukee) olemassaoloa. Nämä aloittaa muuttujat ovat vain ympäristömuuttujia eivätkä näy hallintakäyttöliittymässä:

Muuttuja	Miksi se on bootstrap
`AIHUMMER_DATABASE_URL`	Tietokannan on oltava olemassa ennen kuin mitään tietokantaan perustuvaa asetusta voidaan lukea.
`AIHUMMER_DB_APP_URL`	Rajoitettu rooli DSN, joka aktivoi RLS:n.
`AIHUMMER_MASTER_KEY`	base64-32 tavua; avaa levossa olevia salaisuuksia / holvi / BYOK.
`AIHUMMER_GATEWAY_ADDR`	Julkinen kuunteluosoite (oletus `:8780`) — API, paritus, WS/SSE, sisään tuleva sekä sovellus/tasku-välityspalvelin.
`AIHUMMER_WEBUI_ADDR`	Yksityisen hallinnan verkkokäyttöliittymän kuunteluosoite (oletus `:8781`), tarjoillaan juurella `/`; asetettu `0` poistaa käytöstä.
`AIHUMMER_BLOB_DIR`	Tiedostojärjestelmän polku blob-/media-hakemistoon — tarvitaan käynnistyksen yhteydessä.
`AIHUMMER_OIDC_ISSUER`	Suojaa `/v1/admin/*` ennen kuin käyttöliittymää pidetään luotettavana.

Ops-kaapelointi, kuten telemetrian OTLP-päätepiste, kuuluu samaan bootstrap-kategoriaan. Kaikki muu, mikä ei ole tällä lyhyellä listalla, on luettelon avain: se sijaitsee tietokannassa, ja sen kohdalla ympäristöä ei oteta huomioon.

[!WARNING] Pidä AIHUMMER_MASTER_KEY turvallinen ja varmuuskopioitu erikseen tietokannastasi varmuuskopio. Se salakirjottaa tunnistetietovaraston; menetä se ja salatut salaisuudet ei voida palauttaa.

Asetustiedosto

Isäntäkäyttöjärjestelmään asennuksissa alustusympäristö sijaitsee yksittäisessä tiedostossa, jonka systemd-yksikkö lataa:

~/.aihummer/etc/gateway.env

Muokkaa tätä tiedostoa vain bootstrap-arvoille, käynnistä sitten portaalipalvelu uudelleen muutosten soveltamiseksi:

# ~/.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

Kaikki näiden bootstrap-avainten ulkopuolella — agentit, työkalut, muistitila, päättelystrategiat, budjetit, turvaohjeet ja muu — hallitaan ylläpitäjän käyttöliittymän asetuksista (tai kautta aihummer settings), ei tästä tiedostosta: env ohitetaan näiden avainten osalta.

Verkkoyhteyksien valinnaiset ominaisuudet

Monet ominaisuudet ovat poissa päältä, kunnes kohdistat ne taustapalveluun. Kaikki nämä avaimet ovat luettelon asetuksia (ne sijaitsevat tietokannassa): aseta ne hallintakäyttöliittymässä (Hallinta → Asetukset) tai komentoriviltä; laittamalla ne gateway.env ei tee mitään — env ohitetaan heiltä. Sivuvaunuille, jotka on asennettu paketista (STT/TTS jne.), asentaja syöttää arvot itse tietokantaan.

# 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] Todellista mallia ei koskaan vaadita. Ilman AIHUMMER_LLM_* kytketty, vastaukset tulevat deterministisestä mockista; AiHummer toimii myös ilmaisella/paikallisella OpenAI-yhteensopivalla päätepisteitä ja Codex/ChatGPT-tilaustransportti, valinnaisella BYOK:lla.

Ilmoitukset

Hallinnan käyttöliittymät Ilmoitukset sivu (kohdassa “Ohjaus”) on instanssin tapahtumainboksi (järjestelmänvalvojan kirjautuminen, päivitys saatavilla/sovellettu, sivuvaunu sammumassa tai palautumassa jne.) suodatettuna kategorian, vakavuuden ja lukemattomien mukaan. Sen vieressä on kategoria × toimituskanava matriisi: jokaiselle tapahtumakategorialle, jonka otat käyttöön verkkokäyttöliittymä, sähköposti, telegrammi ja työntää kanavat. Web-käyttöliittymän ilmoitukset toimitetaan paikallisesti; Telegram liitetään “Linkitä Telegram” -painikkeella (syvälinkki), sähköposti aktivoituu, kun tukiosoite on vahvistettu, ja push-ilmoitukset saapuvat mobiilisovellukseen. Kriittisiä tapahtumia ei voi mykistää web-käyttöliittymäkanavassa.

Minne seuraavaksi

Lukitse ylläpitäjän kirjautuminen: Ensimmäinen kirjautuminen.
Katso, missä tiedostot sijaitsevat: Asennus.
Tarkista edellytykset: Vaatimukset.