AiHummer
Lietuvių▾
PrisijungtiPaskyra
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Pradžia/Konfigūracija

Konfigūracija

v1.2.x · atnaujinta 2026-07-07

AiHummer yra sukonfigūruotas per nustatymų katalogas, o ne aplinkos kintamųjų krūva. gateway.env yra tik bootstrap: duomenų bazės DSN, klausymosi adresai/prievadai, pagrindinis raktas ir panašiai. Kiekvienas kitas raktas saugomas duomenų bazėje ir keičiams per žiniatinklio administratoriaus sąsają vykdymo metu arba su aihummer settings CLI. Pagrindinė taisyklė yra paprasta: viskas, ką galima sureguliuoti, galima konfigūruoti Web sąsajoje — ne tik aplinkos kintamiesiems, ir ne įkoduota.

Sprendimo tvarka

Kiekvienas katalogo nustatymas sprendžiamas taip pat, pirmasis atitikimas laimi:

  1. Duomenų bazė — reikšmė, nustatyta per administratoriaus sąsają arba aihummer settings set.
  2. Numatytoji — įdiegta pagal numatytuosius nustatymus, pristatyta su leidimu.

Aplinka yra tyčia nepriklauso šiai grandinei: katalogo raktams an AIHUMMER_* kintamasis į gateway.env yra ignoruotas, net jei nustatyta. Tai suteikia kiekvienam nustatymui tik vieną tiesos šaltinį — duomenų bazę — todėl vartotojo sąsajos reikšmė niekada negali būti tyliai užtemdyta pamirštoje aplinkos faile eilutėje.

[!NOTE] Norint pakeisti elgesį gamyboje, jūs nekoreguojate konfigūracijos failų — jūs keičiate nustatymas administratoriaus sąsajoje (Valdymas → Nustatymai, ieškomas puslapis) arba vykdyti aihummer settings set <KEY> <VALUE> (get / list skaityti), ir tai užtrunka efektas tai darbo vietai. Pats diegimo programa nustato pradinius katalogo vertes į duomenų bazę per aihummer settings set.

Karštas prieš reikia paleisti iš naujo

Kaip pakeistas nustatymas įsigalioja, priklauso nuo klavišo:

Elgesys Pavyzdžiai Kai tai taikoma
Karšta įrankio įgalinimas, pagalbinio agento maksimalus gylis Perskaityti vykdymo metu, be perkrovimo
Reikia perkrauti paklausyti adreso, tam tikrų paslaugų sujungimas Taikoma kitą kartą paleidus vartus iš naujo

Karštieji klavišai perskaitomi tiesiogiai, todėl įrankio perjungimas arba nustatymų keitimas subagent-depth įsigalioja kitame žingsnyje. Kai kurie struktūriniai raktai įsigalioja tik po perkrovimo; administratoriaus sąsaja rodo, kuris kuris.

„Bootstrap“ kintamieji lieka tik aplinkos

Kai kurie kintamieji turi būti nustatyti aplinkoje, nes jie reikalingi prieš sukuriant nustatymų katalogą (ir duomenų bazę, iš kurios jis skaito). Šie bootstrapas kintamieji yra tik aplinkos (env) ir nėra rodomi administravimo sąsajoje:

Kintamasis Kodėl tai bootstrap
AIHUMMER_DATABASE_URL Duomenų bazė turi egzistuoti prieš pradedant skaityti bet kokį su duomenų baze susijusį nustatymą.
AIHUMMER_DB_APP_URL Apribota DSN rolė, kuri aktyvina RLS.
AIHUMMER_MASTER_KEY base64-32 baitai; atrakina poilsio metu laikomus paslaptis / seifą / BYOK.
AIHUMMER_GATEWAY_ADDR Viešasis klausymosi adresas (numatytasis :8780) — API, poravimas, WS/SSE, įeinantis ir programėlės/kišenės tarpinis serveris.
AIHUMMER_WEBUI_ADDR Privataus administratoriaus interneto sąsajos klausymosi adresas (numatytasis :8781), patiekiama su šaknimi /; nustatyti į 0 išjungti.
AIHUMMER_BLOB_DIR Blob/medijos katalogo failų sistemos kelias — reikalingas paleidimo metu.
AIHUMMER_OIDC_ISSUER Apsaugo /v1/admin/* prieš patikintą vartotojo sąsają.

Ops laidai, tokie kaip telemetrijos OTLP galinis taškas, patenka į tą pačią paleidimo kategoriją. Viskas, kas nėra šiame trumpame sąraše, yra katalogo raktas: jis gyvena duomenų bazėje, o aplinka jam yra ignoruojama.

[!WARNING] Laikyti AIHUMMER_MASTER_KEY saugus ir atsarginis atskirai iš jūsų duomenų bazės atsarginė kopija. Jis dešifruoja kredencialų saugyklą; praraskite ją ir užšifruotos paslaptys negali būti atkurtas.

Konfigūracijos failas

Tinklo šeimininko vietinėms diegimams pradinė aplinka gyvena viename faile, kurį įkelia systemd vienetas:

~/.aihummer/etc/gateway.env

Redaguoti šį failą tik bootstrap reikšmėms, tada paleiskite iš naujo vartų paslaugą, kad pritaikytumėte pakeitimus:

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

Viskas, kas yra už šių „bootstrap“ raktų ribų — agentai, įrankiai, atminties režimas, samprotavimo strategijos, biudžetai, apsaugos priemonės ir visa kita — valdomi iš administratoriaus sąsajos nustatymų (arba per aihummer settings), ne iš šio failo: aplinka ignoruojama tiems raktams.

Papildomų funkcijų sujungimas

Dauguma funkcijų neveikia, kol jų neparodote palaikymo paslaugai. Visi šie raktai yra katalogo nustatymai (jie gyvena duomenų bazėje): nustatykite juos administratoriaus valdymo sąsajoje (Valdymas → Nustatymai) arba naudojant CLI; įdedant juos į gateway.env nieko nedaro — aplinka jiems nereikšminga. Šoniniams konteineriams, įdiegiamiems iš paketo (STT/TTS ir kt.), diegėjas pats įterpia reikšmes į duomenų bazę.

# 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] Tikras modelis niekada nėra reikalingas. Be AIHUMMER_LLM_* prijungtas, atsakymai ateina iš deterministinio maketo; AiHummer taip pat veikia nemokamoje/vietinėje OpenAI suderinamoje versijoje galiniai taškai ir Codex/ChatGPT prenumeratos transportas, su pasirinktu BYOK.

Pranešimai

Administratoriaus sąsajos Pranešimai puslapis (skilties „Valdymas“ po juo) yra įvykio (administratoriaus prisijungimas, atnaujinimas prieinamas/pritaikytas, pagalbinė programa neveikia arba atsigavimas ir taip toliau) gautųjų aplankas su filtrais pagal kategoriją, rimtumą ir neperskaitytus. Šalia jo yra kategorijos × pristatymo kanalo matrica: kiekvienai įvykio kategorijai, kurią įjungiate tinklapio sąsaja, elektroninis paštas, telegrama ir stumti kanalai. „Web UI“ pranešimai pristatomi vietoje; „Telegram“ sujungiama naudojant mygtuką „Susieti su Telegram“ (gilaus susiejimo nuoroda), el. paštas aktyvuojamas tik patvirtinus palaikymo adresą, o pranešimai paspaudus ateina į mobiliojoje programėlėje. Kritinių įvykių negalima nutildyti „webui“ kanale.

Kur toliau