Innstillingsreferanse

Her er alle innstillingene operatøren kan endre på en AiHummer-server. Siden genereres fra produktets egen katalog og stemmer derfor med serveren din. Verdien settes i webgrensesnittet eller med kommandoen `aihummer settings set KEY VALUE` ([Kommandolinjen](/no/v1.4/reference/cli/)). Kolonnen med standardverdien viser hva serveren bruker inntil en egen verdi er satt. > [!NOTE] > Hemmelige verdier skrives aldri ut her, og leverandørens tjenestenøkler listes ikke i det hele tatt — produktet skjuler dem i alle lister. En tankestrek betyr tom verdi eller en forklaring som bare vises i webgrensesnittet. ## API | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PERSONAL_API_KEYS` | Personlige API-nøkler for OpenAI-compat | `bool` | `1` | etter omstart | "av" deaktiverer personlig nøkkelautentisering på det OpenAI-kompatible endepunktet. Enhver annen verdi = aktivert. Brukes ved oppstart/etter omstart. | ## Agent | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_ANNOUNCE_SLOW_TOOLS` | Agent: si hva den gjør før lange handlinger | `bool` | `1` | umiddelbart | Før en lang handling (et bilde, grundig søk, en video, et oppdrag til en underagent) skriver agenten kort hva den gjør, så ventetiden ikke er taus. Slå av hvis slike meldinger er i veien. | | `AIHUMMER_AGENT_COMPACT_AT_PCT` | Agent: komprimer historikken fra, % av budsjettet | `int 50…99` | `85` | umiddelbart | Når en samtales historikk fyller denne andelen av plassen sin i modellens vindu, oppsummeres eldre meldinger — i bakgrunnen, etter svaret; turen venter ikke. Lavere — komprimering oftere, men modellen husker mindre ordrett; høyere — sjeldnere, men turene blir tyngre. 50–99; en agent kan angi egen verdi. | | `AIHUMMER_AGENT_COMPACT_TO_PCT` | Agent: behold etter komprimering, % av historikkbudsjettet | `int 10…90` | `50` | umiddelbart | Hvor mye av historikkens plass som blir stående ordrett etter komprimering; alt eldre går inn i oppsummeringen. Må være lavere enn komprimeringsterskelen: avstanden mellom dem avgjør hvor mange turer det går til neste komprimering. 10–90; en agent kan angi egen verdi. | | `AIHUMMER_AGENT_HISTORY_TURNS` | Agent: samtaleturer som beholdes ordrett | `int 1…1000` | `30` | umiddelbart | Hvor mange av de siste turene i en samtale modellen ser ordrett (opptil 10 flere før komprimering). Eldre meldinger oppsummeres i bakgrunnen; selve samtalen slettes aldri. Modellens kontekstvindu tas hensyn til automatisk. 1–1000; en agent kan ha sin egen verdi. | | `AIHUMMER_AGENT_MAX_ITERATIONS` | Agent: maks verktøysteg per tur | `int 1…256` | `25` | umiddelbart | Hvor mange ganger per tur en agent kan kalle verktøy før den svarer. Ved grensen feiler ikke turen: agenten rapporterer hva som er gjort og hva som gjenstår, og du kan be den fortsette. Tre like kall på rad med samme resultat stopper turen tidligere. 1–256; en agent kan ha sin egen verdi. | | `AIHUMMER_AGENT_MEMORY_FLUSH` | Agent: lagre et minnenotat før komprimering | `bool` | `1` | umiddelbart | Før eldre meldinger slås sammen til et sammendrag, lagrer agenten et kort notat om mål, beslutninger og åpne oppgaver i minnet. Slå av for å spare modellkallet. | | `AIHUMMER_AGENT_MEMORY_FLUSH_PROMPT` | Agent: hva notatet før komprimering tar vare på | `text` | — | umiddelbart | Din egen oppgave for notatet før komprimering: hva som skal tas vare på fra meldingene som går inn i sammendraget (for eksempel «noter bare innkjøp, frister og avtaler»). Tom — innebygd: mål, beslutninger, åpne oppgaver. Beskyttelsen kan ikke slås av: samtaleteksten forblir data, ikke instrukser, og passord og nøkler lagres aldri. Opptil 4000 tegn; en agent kan ha sin egen. | | `AIHUMMER_AGENT_NEW_REMINDERS_MEMORY` | Nye agenter: påminnelser og skriving til minnet | `bool` | `1` | umiddelbart | En ny agent opprettet for hånd (oppsettveiviseren, «Opprett agent», API) oppretter, endrer og avbryter fra første tur sine EGNE påminnelser og tidsplaner og skriver fakta til sitt eget minne – som malen for den personlige assistenten. Slå det av for én agent i kortet dens (Evner). Bibliotekmaler bestemmer selv, en kopi beholder originalens rettigheter, agenter opprettet av en annen agent starter uten dem; eksisterende agenter endres ikke. Gjelder for neste agent som opprettes. | | `AIHUMMER_AGENT_PROMPT_PART_MAX_CHARS` | Agent: maks. tegn per promptdel | `int 1000…1000000` | `20000` | umiddelbart | Hvor mange tegn modellen får fra ÉN del av agentens persona: en profilseksjon, en promptdel eller hovedprompten. En lengre del beholder begynnelsen (3/4) og slutten (1/4) med en merknad om hvor mye som ble kuttet; dette vises i samtalekortet og i agentens promptsammensetning. Navn, tiltaleform og personabegrensninger kuttes aldri. 1000–1000000; en agent kan ha sin egen verdi. | | `AIHUMMER_AGENT_PROMPT_TOTAL_MAX_CHARS` | Agent: maks. tegn for hele personaen | `int 1000…2000000` | `60000` | umiddelbart | Samlet tak for agentens persona: alle deler sammen. Når det overskrides, gir de lengste delene fra seg plass først, og korte deler forblir hele. 1000–2000000; en agent kan ha sin egen verdi. | | `AIHUMMER_AGENT_SELF_INTRO` | Agent: presentere seg | `enum: first_contact \\\| each_dialog \\\| never` | `first_contact` | umiddelbart | «Én gang, ved første møte»: agenten presenterer seg kort i den aller første samtalen med en person, med mindre personen vil rett på sak; for noen den allerede kjenner, presenterer den seg ikke på nytt og svarer naturlig på en hilsen. «Aldri presentere seg»: agenten sier aldri navnet sitt av seg selv. «I starten av hver ny samtale» — i starten av hver ny samtale og etter en lang pause, kort og uten et sammendrag av tidligere saker. En agent kan velge annerledes på sitt kort («Kontekst og oppførsel»). | | `AIHUMMER_AGENT_SESSION_IDLE_RESET_MINUTES` | Agent: start samtalen på nytt etter stillhet (minutter) | `int 0…525600` | `360` | umiddelbart | For «etter stillhet» og «hver dag og etter stillhet»: skriver en person etter lengre stillhet enn dette, starter agenten samtalen på nytt. Gjelder agenter uten egen verdi på kortet sitt. 0 — ikke etter stillhet. 0–525600; 360 = 6 timer, 1440 = ett døgn. | | `AIHUMMER_AGENT_SESSION_INDEX_MAX_ENTRIES` | Agent: behold høyst så mange økter i listen | `int 0…100000` | `0` | umiddelbart | De mest stille forlater listen først; ingenting slettes. 0 — ingen grense. 0–100000. Gjelder agenter uten egen verdi på kortet sitt. | | `AIHUMMER_AGENT_SESSION_INDEX_PRUNE_DAYS` | Agent: fjern fra øktlisten etter så mange dager med stillhet | `int 0…3650` | `0` | umiddelbart | Ingenting slettes: samtalen forlater listen og kommer tilbake med en ny melding. 0 — behold. 0–3650. Gjelder agenter uten egen verdi på kortet sitt. | | `AIHUMMER_AGENT_SESSION_RESET_AT_HOUR` | Agent: time for daglig ny start | `int 0…23` | `4` | umiddelbart | For modusene «hver dag»: en samtale som startet før denne timen, begynner på nytt ved personens neste melding. Timen følger serverens tidssone (innstillingen «Tidssone» under System og innstillinger). 0–23; 4 er om natten, når nesten ingen skriver. | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_IDLE_MINUTES` | Agent: start en gruppechat på nytt etter stillhet (minutter) | `int 0…525600` | `0` | umiddelbart | For gruppechatter i modusene «etter stillhet» og «hver dag og etter stillhet»: minuttene med stillhet før en gruppechat starter på nytt. 0 betyr som for personlige chatter. 0–525600. | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_MODE` | Agent: når en gruppechat starter på nytt | `enum: inherit \\\| daily \\\| idle \\\| both \\\| none` | `inherit` | umiddelbart | En egen regel for gruppechatter (Telegram-grupper, VK-samtaler, MAX-chatter og andre): som for personlige chatter, hver dag ved tilbakestillingstimen, etter stillhet, det som kommer først, eller aldri. Tilbakestillingstimen er felles. Gjelder agenter uten egen regel på kortet sitt. | | `AIHUMMER_AGENT_SESSION_RESET_MODE` | Agent: når en samtale starter på nytt | `enum: idle \\\| daily \\\| both \\\| none` | `idle` | umiddelbart | Når agenten starter en samtale på nytt: hver dag ved tilbakestillingstimen (i instansens tidssone), etter en stillhet, det som kommer først, eller aldri. Ved ny start skriver agenten et notat om den forrige samtalen i minnet sitt, og den første turen får det forrige sammendraget og de siste meldingene; meldingene blir værende i arkivet og i søket. Gjelder agenter uten egen regel på kortet sitt; der kan gruppechatter få en egen regel. | | `AIHUMMER_AGENT_SESSION_SCOPE` | Agent: hvor personlige samtaler havner | `enum: chat \\\| per-channel-peer \\\| per-peer` | `chat` | umiddelbart | «Én per person» samler Telegram, appen og andre personlige chatter med samme person i én samtale. Gruppechatter beholder alltid sin egen. Gjelder fra neste melding. Gjelder agenter uten egen verdi på kortet sitt. | | `AIHUMMER_AGENT_SILENT_REPLY` | Agent: kan tie | `enum: groups \\\| all \\\| off` | `groups` | umiddelbart | I gruppechatter kan agenten tie når en melding ikke er rettet til den eller den ikke har noe å legge til; i private chatter svarer den alltid. Du kan også tillate stillhet i private chatter eller slå det av. En stille runde sender ingenting, samtalekortet markerer den som «agenten tiet», og modellen ser den ikke i historikken. Gjelder fra neste runde. | | `AIHUMMER_AGENT_SKILLS_PROMPT_MAX_CHARS` | Agent: maks. tegn for ferdighetslisten i prompten | `int 1000…200000` | `18000` | umiddelbart | I hver runde ser modellen ikke ferdighetenes tekster, men listen over dem: id, navn og når de skal brukes; agenten henter selv en ferdighets instruksjon når oppgaven passer. Er listen lengre, fjernes først beskrivelsene, deretter slutten av listen — resten finner agenten ved forespørsel. 1000–200000. | | `AIHUMMER_AGENT_STALE_GAP_HOURS` | Agent: pause etter at tidligere samtale er historikk (timer) | `int 0…8760` | `12` | umiddelbart | Skriver en person etter en pause lengre enn denne, får agenten et notat: alt som ble diskutert før, er historikk — det gjenfortelles ikke, og gamle oppgaver gjenopptas ikke uten at noen ber om det. Hver melding har allerede sitt tidspunkt og hvor lang tid det er siden forrige. 0 = ikke noe notat. 0–8760. | | `AIHUMMER_AGENT_TOOL_HISTORY_TURNS` | Agent: turer som beholder verktøyresultater | `int 0…100` | `5` | umiddelbart | Hvor mange av de siste turene modellen ser verktøykall og resultatene i sin helhet (et resultat lagres opptil 16 KB). Eldre turer beholder kallet og begynnelsen av resultatet. Slik husker agenten hva den fant og gjorde, i stedet for å kalle verktøyene på nytt. 0 = ikke ta med resultater til senere turer. 0–100; en agent kan overstyre det. | | `AIHUMMER_APPROVAL_TOOLS` | Verktøy som trenger godkjenning | `multiselect` | — | umiddelbart | Kommaseparert liste over verktøy hvis kall krever manuell godkjenning fra operatøren før de kjøres. Tomt = ingen godkjenning kreves. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | Subagent maks. dybde | `int 0…10` | `2` | umiddelbart | Maksimal nestingsdybde for subagenter (en agent som starter en agent). Standard 2 — vern mot uendelig rekursjon. | | `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | Subagent timeout (sekunder) | `int 0…86400` | `180` | umiddelbart | Maksimal tid for en enkelt subagentkjøring, i sekunder. | | `AIHUMMER_TOOL_SEARCH` | Lat innlasting av verktøy | `bool` | `false` | umiddelbart | Viser arbeidskjernen av verktøy direkte og skjuler resten av en stor katalog bak et søkeverktøy som navngir hvert skjulte verktøy. Lønner seg bare for store kataloger (dusinvis av plugin-, MCP- eller OpenAPI-verktøy): under størrelsesgrensen vises alle verktøy direkte, fordi et ekstra modellkall for å finne et verktøy koster mer enn skjemaene. Gjelder fra neste tur. | | `AIHUMMER_TOOL_SEARCH_CORE` | Lazy verktøyinnlasting: alltid-på-verktøy | `multiselect` | `web_search,web_fetch,memory_search,memory_get,memory_store,search_history,search_knowledge,code_exec,process,filesystem_read,message,schedule_list,schedule_create,schedule_delete,generate_pairing_code` | umiddelbart | Verktøy som alltid vises direkte i lat modus. Standard er arbeidskjernen: nettsøk, sidehenting, minne, samtalehistorikk, kunnskapsbase, kode, filer, meldinger, tidsplaner og paring av appen. Søk i minne og kunnskapsbase (memory_search, memory_get, search_knowledge) vises alltid, uansett hva listen inneholder. En tom liste gjenoppretter kjernen. | | `AIHUMMER_TOOL_SEARCH_MIN_POOL_TOKENS` | Lat innlasting av verktøy: minste størrelse på skjulte verktøy (token) | `int 0…1000000` | `4000` | umiddelbart | Skjul verktøy bare når skjemaene utenfor kjernen til sammen veier minst så mange token (omtrent 4 tegn hver). Under grensen vises alle verktøy direkte: et ekstra modellkall for å finne et verktøy koster mer enn å vise skjemaene. | | `AIHUMMER_TOOL_SEARCH_THRESHOLD` | Lazy verktøyinnlasting: min verktøy å utsette | `int 0…1000` | `12` | umiddelbart | Utsett bare når mer enn dette mange verktøyene overlever agentens profilfilter. | ## Agent · Reasoning | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_BEST_OF_N` | Beste av N: antall forslag | `int 0…8` | `0` | umiddelbart | Agenten lager så mange svarforslag og beholder det beste. 0 eller 1 — av, 2 eller flere — på. Hvert forslag koster som et eget svar. | | `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | Debatt: dommerspørring (overstyre) | `text` | — | umiddelbart | Overstyrer dommerprompten i debatten (tomt = innebygd). | | `AIHUMMER_AGENT_DEBATE_N` | Debatt: antall svarforslag | `int 0…8` | `0` | umiddelbart | Agenten lager så mange svarforslag, sammenligner dem og gir det beste. 0 eller 1 — av, 2 eller flere — på. Hvert forslag koster som et eget svar. | | `AIHUMMER_AGENT_DEBATE_PROMPT` | Debatt: kandidatmelding (overstyre) | `text` | — | umiddelbart | Overstyrer kandidatprompten i debatten (tomt = innebygd). | | `AIHUMMER_AGENT_DEBATE_ROUNDS` | Debatt: runder | `int 1…10` | `1` | umiddelbart | Antall debattrunder for kandidatpanelet. | | `AIHUMMER_AGENT_JUDGE_PROMPT` | Best-of-N-dommerforespørsel (overstyre) | `text` | — | umiddelbart | Overstyrer dommerforespørselen for best-of-N (blank = innebygd). | | `AIHUMMER_AGENT_PLAN_PROMPT` | Planner-prompt) | `text` | — | umiddelbart | Overstyrer planleggingsmeldingen (tom = innebygd). | | `AIHUMMER_AGENT_PLAN_STEPS` | Planlegger-utfører: maks plantrinn (0=av) | `int 0…32` | `0` | umiddelbart | ⟩0 kjører en separat planlegger→utfører→syntesepass (bra for komplekse flertrinnsoppgaver). 0 deaktiverer. Typisk 4–8. | | `AIHUMMER_AGENT_PLAN_STEP_ITERS` | Planlegger: verktøygjentakelser per trinn (0=standard) | `int 0…64` | `0` | umiddelbart | Begrenser gjentakelser av verktøykall per plantrinn. 0 = innebygd standard (4). | | `AIHUMMER_AGENT_REFLECT` | Selvkritikkpass | `bool` | `0` | umiddelbart | Legger til et refleksjons-/selvkritikkbeløp før det endelige svaret. | | `AIHUMMER_AGENT_REFLECT_PROMPT` | Refleksjonsspørsmål (overstyre) | `text` | — | umiddelbart | Overstyrer selvkritikk-forespørselen (tom = innebygd). | | `AIHUMMER_AGENT_SELF_HEAL` | Selvhelbredende verktøy-feil på nytt (0=av) | `int 0…10` | `0` | umiddelbart | ⟩0 prøver på nytt mislykkede verktøykall med et korrigerende hint, opp til denne grensen. | ## Agent · System prompt | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LOCALE` | Standardlokale | `enum: ru-RU \\\| en-US \\\| az-AZ \\\| hy-AM \\\| be-BY \\\| kk-KZ \\\| ky-KG \\\| tg-TJ \\\| tk-TM \\\| uz-UZ \\\| ka-GE \\\| ro-RO \\\| es-ES \\\| zh-CN \\\| fr-FR \\\| de-DE \\\| hi-IN \\\| pl-PL \\\| lt-LT \\\| lv-LV \\\| et-EE \\\| fi-FI \\\| sv-SE \\\| no-NO \\\| da-DK \\\| tr-TR \\\| mn-MN` | `ru-RU` | umiddelbart | Standard svarspråk/lokale hint, f.eks. ru-RU. Persona/operatørinstruksjoner overstyrer. | | `AIHUMMER_TIMEZONE` | Tidssone | `text` | `UTC` | umiddelbart | IANA-tidssone for agentens gjeldende dato og for tidsplaner uten egen tidssone, f.eks. Europe/Moscow. Standard UTC. | ## Channels | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_FAILURE_NOTICE` | Si fra til personen når et svar mislykkes | `enum: always \\\| once \\\| off` | `always` | umiddelbart | Hva en person i en kanal (Telegram og andre) får når agenten ikke kunne svare: «Hver gang» — en kort melding på vedkommendes språk; «Høyst én gang hver 4. time» — én melding per samtale innen 4 timer; «Ikke si fra» — ingenting. Meldingen har ingen feilkoder eller leverandørnavn; detaljene ser du under Økter og i varsler. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BLOCKED` | Feilmelding: instansen er suspendert | `text` | — | umiddelbart | La feltet stå tomt for å sende den innebygde meldingen på personens eget språk. Teksten din sendes slik den er skrevet, på språket du skriver den på; {ref} setter inn svarets kode, som du finner turen med under Økter. Trer i kraft umiddelbart. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUDGET` | Feilmelding: eierens budsjett er brukt opp | `text` | — | umiddelbart | La feltet stå tomt for å sende den innebygde meldingen på personens eget språk. Teksten din sendes slik den er skrevet, på språket du skriver den på; {ref} setter inn svarets kode, som du finner turen med under Økter. Trer i kraft umiddelbart. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUSY` | Feilmelding: gatewayen er overbelastet | `text` | — | umiddelbart | La feltet stå tomt for å sende den innebygde meldingen på personens eget språk. Teksten din sendes slik den er skrevet, på språket du skriver den på; {ref} setter inn svarets kode, som du finner turen med under Økter. Trer i kraft umiddelbart. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_CONFIG` | Feilmelding: modelltilkoblingen trenger eieren | `text` | — | umiddelbart | La feltet stå tomt for å sende den innebygde meldingen på personens eget språk. Teksten din sendes slik den er skrevet, på språket du skriver den på; {ref} setter inn svarets kode, som du finner turen med under Økter. Trer i kraft umiddelbart. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_FAILED` | Feilmelding: annen feil | `text` | — | umiddelbart | La feltet stå tomt for å sende den innebygde meldingen på personens eget språk. Teksten din sendes slik den er skrevet, på språket du skriver den på; {ref} setter inn svarets kode, som du finner turen med under Økter. Trer i kraft umiddelbart. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_QUOTA` | Feilmelding: modellens bruksgrense er brukt opp | `text` | — | umiddelbart | La feltet stå tomt for å sende den innebygde meldingen på personens eget språk. Teksten din sendes slik den er skrevet, på språket du skriver den på; {ref} setter inn svarets kode, som du finner turen med under Økter. Trer i kraft umiddelbart. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_STEP_LIMIT` | Feilmelding: oppgaven fikk ikke plass i ett svar | `text` | — | umiddelbart | La feltet stå tomt for å sende den innebygde meldingen på personens eget språk. Teksten din sendes slik den er skrevet, på språket du skriver den på; {ref} setter inn svarets kode, som du finner turen med under Økter. Trer i kraft umiddelbart. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_TOO_LONG` | Feilmelding: samtalen er for lang for modellen | `text` | — | umiddelbart | La feltet stå tomt for å sende den innebygde meldingen på personens eget språk. Teksten din sendes slik den er skrevet, på språket du skriver den på; {ref} setter inn svarets kode, som du finner turen med under Økter. Trer i kraft umiddelbart. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_UNAVAILABLE` | Feilmelding: modellen er midlertidig utilgjengelig | `text` | — | umiddelbart | La feltet stå tomt for å sende den innebygde meldingen på personens eget språk. Teksten din sendes slik den er skrevet, på språket du skriver den på; {ref} setter inn svarets kode, som du finner turen med under Økter. Trer i kraft umiddelbart. | | `AIHUMMER_CONFIDENTIAL_PERSONA` | Konfidensiell nettpersona | `bool` | `0` | umiddelbart | Når den er på, vil ikke nettchat-agenten avsløre eller vedvare sine person-/identitetsdetaljer og beholder svar på oppgaven – bruk den for anonyme eller personvernsensitive nettimplementeringer. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_INBOUND_COALESCE_MS` | Vindu for samling av meldinger (ms) | `int` | `500` | umiddelbart | Flere meldinger som en person sender etter hverandre til samme chat (korte meldinger, et fotoalbum, en rask retting), får ETT svar hvis pausen mellom dem er kortere enn dette vinduet. Meldinger som kommer mens et svar forberedes, besvares rett etterpå, aldri parallelt. Standard 500 ms; 0 = ingen venting mellom enkeltmeldinger; et fotoalbum samles likevel (pauser opptil 3 s, høyst 20 s) slik at det får ett svar. Samling virker i Telegram; Slack, WhatsApp, VK, e-post og andre koblinger som venter på svar på hver melding (og integrasjoner via /v1/inbound/generic), får svar på hver melding — fortsatt én om gangen og i rekkefølge. Trer i kraft umiddelbart. | | `AIHUMMER_INBOUND_EDIT_MODE` | Når en person redigerer en besvart melding | `enum: correct \\\| history` | `correct` | umiddelbart | correct — boten svarer på nytt og vet at det er en rettelse («før / nå»); history — redigeringen retter bare samtalehistorikken, ingen nytt svar (praktisk ved skrivefeil). En redigering av en melding boten ennå ikke har svart på, erstatter alltid bare teksten. Virker der kanalen melder redigeringer (Telegram). Trer i kraft umiddelbart. | | `AIHUMMER_INBOUND_QUEUE_MODE` | Meldinger skrevet mens agenten jobber | `enum: steer \\\| collect \\\| followup` | `steer` | umiddelbart | Hva som skjer med en melding samme person sender mens agenten fortsatt jobber med et svar (søker, kjører verktøy): steer (standard) — agenten ser den før neste steg og tar hensyn til den i samme svar; collect — den besvares med neste svar. followup — hver slik melding får sitt eget svar, én om gangen. Bilder, filer, svar på en melding og videresendinger venter alltid på neste svar. Gjelder umiddelbart. | | `AIHUMMER_INBOUND_REQUIRE_BINDING` | Svar bare til klargjorte brukere | `bool` | `true` | umiddelbart | true = boten ignorerer enhver kanalavsender som er NOT en klargjort AiHummer-bruker (en bruker med en rollebinding) — tilfeldige chattemedlemmer og gjesteanrop får ingen svar. false (standard) = svar til alle. | ## Integrations | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_A2A_PUBLISH` | Publiser agent over Agent2Agent (A2A) | `bool` | `0` | etter omstart | Publiser agenten som en A2A-server (agentkort + POST /a2a/melding). Applied at startup/after restart. | | `AIHUMMER_MCP_EXPORT_TOOLS` | Verktøy åpnet for eksterne assistenter | `multiselect` | — | etter omstart | En eksplisitt liste over verktøynavn som er tillatt for eksterne MCP-klienter, atskilt med komma. Tom = ikke publiser noen verktøy. Klasser på vertsnivå er i tillegg forbudt av den innebygde policyen, selv om de er oppført. Gjelder ved start/etter omstart. | | `AIHUMMER_MCP_PUBLISH` | Publiserverktøy over MCP | `bool` | `0` | etter omstart | Lar eksterne assistenter (f.eks. Claude Desktop) bruke agentenes verktøy. Hvilke verktøy som åpnes, velges i innstillingen ved siden av: så lenge listen er tom, åpnes ingen. | | `AIHUMMER_MODULE_CPU_QUOTA` | CPU-grense per tillegg | `text` | `75%` | umiddelbart | Hvor stor del av prosessoren hvert tillegg kan bruke (systemd CPUQuota): 75 % er tre fjerdedeler av én kjerne, 150 % er halvannen kjerne. Et tillegg får den nye verdien ved neste installasjon, oppdatering eller når innstillingene lagres; til da beholder kjørende tillegg den forrige grensen. | | `AIHUMMER_MODULE_MEMORY_MAX` | Minnegrense per tillegg | `text` | `512M` | umiddelbart | Hvor mye minne hvert tillegg kan bruke (systemd MemoryMax): en størrelse som 512M, 1G eller 2048M (minst 64M), eller infinity for ingen grense. Systemet stopper et tillegg som overskrider den. Et tillegg får den nye verdien ved neste installasjon, oppdatering eller når innstillingene lagres; til da beholder kjørende tillegg den forrige grensen. | ## Knowledge connectors | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_KB_SYNC_INTERVAL` | Hvor ofte kunnskapsbasen oppdateres fra kilder | `text` | — | umiddelbart | Hvor ofte serveren selv henter endringer fra tilkoblede kilder til kunnskapsbasen. For eksempel: 30m — hvert 30. minutt, 6h — hver 6. time. Tomt eller 0 — bare manuelt. Ny innlasting lager aldri duplikater. En Slack-eksport lastes opp manuelt. | ## LLM | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AUX_FALLBACK_MODELS` | Serviceoppgaver: reservemodeller | `list` | — | umiddelbart | Kommaseparerte modeller som prøves i rekkefølge når servicemodellen feiler (kvote, driftsavbrudd). Hovedmodellen prøves alltid sist, slik at et sammendrag ikke går tapt. Hvert bytte logges. Gjelder umiddelbart. | | `AIHUMMER_AUX_MODEL` | Modell for serviceoppgaver (sammendrag, notater, titler) | `text` | — | umiddelbart | Modell for bakgrunnsoppgaver: komprimering av gammel historikk til et sammendrag, minnenotatet før komprimering, samtaletitler, uttrekk av fakta, omformulering av søk og oversettelse. Tom = automatisk: en billigere modell fra samme leverandør (Claude → claude-haiku-4-5, Codex → gpt-…-luna/mini); finnes ingen, hovedmodellen. "main" = alltid hovedmodellen. Gjelder umiddelbart. | | `AIHUMMER_CASCADE_MIN_CHARS` | Kaskade til | `int` | `0` | umiddelbart | Terskel for forespørselslengde (tegn) der den sterkere kaskademodellen starter. 0 = standard. | | `AIHUMMER_CASCADE_STRONG_MODEL` | Kaskade: sterkere reservemodell | `text` | — | umiddelbart | Modell for lange/komplekse forespørsler (tom = av). | | `AIHUMMER_CLAUDE_AUTH_URL` | Claude-abonnement: adressen til påloggingssiden | `text` | — | umiddelbart | Siden der du tillater at Claude-abonnementet kobles til. Tomt — standardadressen; endre den bare hvis support ber om det. | | `AIHUMMER_CLAUDE_CLIENT_ID` | Claude-abonnement: OAuth klient-ID | `text` | — | umiddelbart | App-ID for pålogging med Claude-abonnement. Tomt — standard; endre bare hvis support ber om det. | | `AIHUMMER_CLAUDE_EFFORT` | Claude: tenkedybde | `enum: low \\\| medium \\\| high \\\| xhigh \\\| max` | `medium` | umiddelbart | Hvor dypt Claude-modeller tenker før de svarer når agenten ikke angir det. Høyere er mer presist på vanskelige oppgaver, men tregere og bruker mer kvote; lavere er raskere og billigere. En modell som ikke kjenner det valgte nivået, får nærmeste lavere; Haiku 4.5 og eldre modeller støtter ikke tenkning. Dybden som er angitt på agenten, går foran. Gjelder fra neste tur. | | `AIHUMMER_CLAUDE_MAX_TOKENS` | Claude: maksimal svarlengde (tokens) | `int` | `16000` | umiddelbart | Hvor mange tokens ett Claude-svar kan bruke — både via abonnement og nøkkel. Modellens tenking teller i samme grense: for lav verdi kutter svaret midt i en setning eller gir et tomt svar. Har en agent sin egen svarlengde, gjelder den. | | `AIHUMMER_CLAUDE_REDIRECT_URI` | Claude-abonnement: omdirigerings-URI | `text` | — | umiddelbart | Returadresse registrert hos leverandøren. Må samsvare med det som er konfigurert på siden, ellers blir kodeutvekslingen avvist. | | `AIHUMMER_CLAUDE_TOKEN_URL` | Claude-abonnement: tilgangsadresse | `text` | — | umiddelbart | Adressen der serveren henter og fornyer tilgang til Claude-abonnementet. Tomt — standardadressen; endre den bare hvis support ber om det. | | `AIHUMMER_CODEX_BASE_URL` | Basis-URL for Codex | `text` | — | delvis etter omstart | Basis for Codex (ChatGPT-abonnement) transport. Brukes ved oppstart/etter omstart. | | `AIHUMMER_CODEX_MAX_OUTPUT_TOKENS` | Maks. utdatatokens (0 = ingen tak) | `int` | `0` | umiddelbart | Max_output_tokens-grensen for en chattur. 0 = ingen topp. På resonneringsmodeller teller resonnement-tokens også mot dette budsjettet, så for liten verdi gir et tomt 'ufullstendig: max_output_tokens'-svar. Brukes umiddelbart (ingen omstart). | | `AIHUMMER_CODEX_MODEL` | Modell-ID (Codex / gpt-5.5 transport) | `text` | `gpt-5.5` | delvis etter omstart | Modell-ID for den primære Codex/ChatGPT-transporten (f.eks. gpt-5.5, gpt-5.5-codex). Brukes ved oppstart/etter omstart. | | `AIHUMMER_CODEX_REASONING_EFFORT` | Resonneringsinnsats | `enum: none \\\| low \\\| medium \\\| high \\\| xhigh` | `medium` | umiddelbart | Hvor grundig ChatGPT-modellen (Codex) tenker før svaret når agenten ikke angir det. Standard — «Middels». Høyere er mer presist, men tregere og dyrere. | | `AIHUMMER_LLM_CALL_TIMEOUT_S` | Tidsavbrudd per samtale (sekunder) | `int` | `120` | umiddelbart | Hvor mange sekunder man venter på modellens svar på én forespørsel. Tier modellen lenger, avbrytes forespørselen og svaret går videre til neste modell på listen. For Claude telles pausen i svarstrømmen, ikke hele svaret: et langt svar som fortsetter å komme, kuttes ikke. 0 — ingen grense. | | `AIHUMMER_LLM_FALLBACK_MODELS` | Reservemodeller (alle agenter) | `text` | `auto` | umiddelbart | Hvem svarer når hovedmodellen og de andre leverandørene svikter (bruksgrensen er nådd, driftsfeil, for mange forespørsler). auto — hver leverandørs billigere modell som siste utvei (Claude: claude-haiku-4-5, Codex: gpt-…-luna/mini); en kommaseparert liste — din egen rekkefølge, hver modell går til leverandører fra sin produsent; off — ingen reservemodeller. En agents egen reservemodell går foran. Trer i kraft umiddelbart. | | `AIHUMMER_LLM_GATEWAY_URL` | URL til LLM-gateway | `text` | — | delvis etter omstart | Base URL av det OpenAI-kompatible modellens endepunkt agenten kaller (din lokale llama.cpp/vLLM/Ollama-server eller en vertsserver). La stå tomt for å bruke leverandørens standard endepunkt. | | `AIHUMMER_LLM_MODEL` | LLM modell | `text` | — | delvis etter omstart | modellnavnet/-ID-en som sendes til leverandøren hver gang (modellen endepunktet ditt betjener). Må samsvare med en modell endepunktet faktisk viser. | | `AIHUMMER_LLM_PAUSE_AUTH_MIN` | Pause etter avviste påloggingsopplysninger, min | `int` | `10` | umiddelbart | Hvor mange minutter en leverandør som avviste påloggingsopplysningene ikke spørres. Hver gjentakelse dobler pausen, høyst til seks ganger den første. En vellykket tilkoblingstest eller knappen «Gjenoppta nå» henter leverandøren tilbake med en gang. Gjelder fra neste feil. | | `AIHUMMER_LLM_PAUSE_MODEL_MIN` | Pause for en modell leverandøren ikke betjener, min | `int` | `60` | umiddelbart | Hvor mange minutter en leverandør ikke tilbys en modell den har sagt at den ikke betjener; de andre modellene dens spørres som vanlig. Gjelder fra neste feil. | | `AIHUMMER_LLM_PAUSE_QUOTA_MIN` | Pause etter brukt opp grense, min | `int` | `300` | umiddelbart | Hvor mange minutter modellen (eller hele kontoen, når kontoens grense er brukt opp – Codex, en OpenAI-nøkkel, betaling) ikke spørres når bruksgrensen er brukt opp og leverandøren ikke har oppgitt når den tilbakestilles. Hver gjentakelse dobler pausen, høyst til ett døgn. En tid leverandøren oppgir går foran. Gjelder fra neste feil. | | `AIHUMMER_LLM_PAUSE_SHORT_S` | Leverandørpause etter en feil, s | `int` | `30` | umiddelbart | Hvor mange sekunder en leverandør ikke spørres etter en feil, et brudd i forbindelsen eller «for mange forespørsler». En ny feil på rad dobler pausen, den tredje og senere gjør den ti ganger lengre. Hvis leverandøren selv oppgir en tid, venter vi på den. Gjelder fra neste feil. | | `AIHUMMER_LLM_PROVIDER` | LLM leverandør | `text` | — | delvis etter omstart | Hvilken modell backend som skal brukes (et OpenAI-kompatibelt endepunkt eller Codex/ChatGPT-abonnementstransporten). Bestemmer hvordan forespørsler sendes og autentiseres. | | `AIHUMMER_LLM_RETRIES` | LLM prøver på nytt ved forbigående feil | `int` | `3` | umiddelbart | Antall LLM forespørsel på nytt på en forbigående feil. | | `AIHUMMER_LLM_TEMPERATURE` | Temperatur | `text` | — | umiddelbart | Hvor varierte modellens svar er (0–2) når agenten ikke angir det: lavere er mer presist og forutsigbart, høyere er livligere. Tomt — modellen bestemmer. Resonnerende modeller (ChatGPT/Codex, Claude generasjon 5) godtar den ikke — la feltet stå tomt for dem. | | `AIHUMMER_LLM_TOP_P` | Topp-p (kjerneprøvetaking) | `text` | — | umiddelbart | En annen måte å gjøre svarene mer varierte på (0–1) når agenten ikke angir det. Tomt — modellen bestemmer. Vanligvis setter man bare én: temperatur eller denne; resonnerende modeller godtar den ikke. | | `AIHUMMER_MODEL_GUARD_INTERVAL_MIN` | Kontroll av agentmodell: intervall, min | `int` | `60` | umiddelbart | Hvor ofte det skal kontrolleres at hver agents modell tilbys av en aktivert leverandør. Agentens modell endres aldri: så lenge ingen tilbyr den, svarer den første modellen i svarrekkefølgen som ikke er satt på pause, og et varsel nevner agentene — og et til når modellen deres er tilbake. Kontrollen kjøres alltid ved oppstart av gatewayen, og 0 slår av bare gjentakelsen. Et nytt intervall gjelder innen ett minutt. | | `AIHUMMER_OPENAI_API` | OpenAI API-stil (chat \| svar) | `enum: \\\| chat \\\| responses` | — | delvis etter omstart | chat = /chat/fullføringer, svar = /responses. Blank = auto/standard. Brukes ved oppstart/etter omstart. | | `AIHUMMER_OPENAI_API_KEY` | Innebygd OpenAI API-nøkkel (distribusjonsstandard) | `text` | — | delvis etter omstart | Din OpenAI-kontonøkkel for den opprinnelige OpenAI-løkken (hvis du bruker OpenAI som standardleverandør). Må ikke forveksles med per-arbeidsområde BYOK på Modeller-siden. Brukes ved oppstart/etter omstart. | | `AIHUMMER_OPENAI_BASE_URL` | Native OpenAI-base URL | `text` | — | etter omstart | Basis for den OpenAI-kompatible API (f.eks. https://api.openai.com/v1). Brukes ved oppstart/etter omstart. | | `AIHUMMER_OPENAI_MODEL` | Native OpenAI-modell | `text` | — | etter omstart | Modell for den opprinnelige OpenAI-løkken (når AIHUMMER_OPENAI_API_KEY er angitt). Brukes ved oppstart/etter omstart. | | `AIHUMMER_ROUTER_COMPLEX_MODEL` | Ruter: modell for komplekse svinger | `text` | — | umiddelbart | Modell for komplekse forespørsler fra en agent uten egen modell (tom = nivået av). Gjelder fra neste tur. | | `AIHUMMER_ROUTER_SIMPLE_MODEL` | Ruter: modell for enkle svinger | `text` | — | umiddelbart | Modell for enkle forespørsler fra en agent uten egen modell (tom = nivået av). Gjelder fra neste tur. | | `AIHUMMER_ROUTER_STANDARD_MODEL` | Ruter: modell for standardsvinger | `text` | — | umiddelbart | Modell for vanlige forespørsler fra en agent uten egen modell (tom = nivået av). Gjelder fra neste tur. | | `AIHUMMER_SUBSCRIPTION_QUOTA_REFRESH_MIN` | Abonnementskvoter: oppdateringsperiode, min | `int` | `15` | umiddelbart | Hvor ofte panelet spør ChatGPT (Codex) om abonnementets kvotevinduer: høyst én gang per periode, ikke oftere enn hvert 5. minutt og bare mens kvotene er åpne; imellom vises den lagrede kopien. Claude blir aldri spurt: grensene er vårt anslag. Gjelder neste gang kvotene åpnes. | ## Media | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_DEEPGRAM_API_KEY` | Deepgram API nøkkel | `text` | — | umiddelbart | Nøkkelen til Deepgram — nødvendig hvis Deepgram gjenkjenner talemeldinger. Hvis tom, brukes den felles talegjenkjenningsnøkkelen fra innstillingen ved siden av. Gjelder umiddelbart. | | `AIHUMMER_DEEPGRAM_DETECT_LANGUAGE` | Deepgrams språkgjenkjenning | `bool` | `0` | umiddelbart | Gjenkjenn språket i stedet for å sende et fast språk. Trer i kraft umiddelbart. | | `AIHUMMER_DEEPGRAM_MODEL` | Deepgram-modell | `text` | `nova-2` | umiddelbart | Deepgram-modell (f.eks. nova-2, nova-3, base). Avhenger av prosjektets tilgang for nøkkelen. Trer i kraft umiddelbart. | | `AIHUMMER_DEEPGRAM_PUNCTUATE` | Deepgrams tegnsetting | `bool` | `1` | umiddelbart | Legg til tegnsetting og store bokstaver. Trer i kraft umiddelbart. | | `AIHUMMER_DEEPGRAM_SMART_FORMAT` | Deepgrams smarte formatering | `bool` | `1` | umiddelbart | Formater gjenkjente tall og datoer. Trer i kraft umiddelbart. | | `AIHUMMER_DEEPGRAM_URL` | Basis-URL for Deepgram | `text` | — | umiddelbart | Deepgram API base. Blank = https://api.deepgram.com. Trer i kraft umiddelbart. | | `AIHUMMER_IMAGE_BASE_URL` | Bilde API base URL (OpenAI fallback) | `text` | — | umiddelbart | Basis for /images API når du arbeider gjennom en OpenAI-nøkkel (tom = https://api.openai.com/v1). | | `AIHUMMER_IMAGE_MODEL` | Bildegenereringsmodell | `text` | — | umiddelbart | Modell for image_generate (standard gpt-image-2). | | `AIHUMMER_MEDIA_MAX_UPLOAD_MB` | Maks. opplastingsstørrelse (MB) | `int` | `256` | umiddelbart | Den største filen (bilde, talemelding, video) som kan lastes opp om gangen, i megabyte. Beskytter serverens disk mot å bli full. Standard 256. Gjelder umiddelbart. | | `AIHUMMER_SIDECAR_STT` | Talegjenkjenning på denne serveren (faster-whisper) | `bool` | `0` | umiddelbart | Lokal talegjenkjenning (faster-whisper). IKKE inkludert i pakken: aktiver laster ned det signerte tillegget (~620 MiB for alle versjoner av Python) og installerer tjenesten på verten. 🔴 Tillegget publiseres etter en separat leverandørbeslutning (pakkene har ffmpeg under GPL); hvis det ikke er publisert for utgivelsen din, inkludert vil det være ærlig om det og vil ikke ødelegge noe. Skyplan: gjenkjenning konfigureres av leverandøren. | | `AIHUMMER_SIDECAR_TTS` | Opplesning av svar (edge-tts) | `bool` | `0` | umiddelbart | Talesyntese (edge-tts, stemmer Microsoft Edge). IKKE inkludert i pakken: aktiverer laster ned det signerte tillegget (~26 MiB) og installerer tjenesten på verten. Selve syntesen går online for stemmer - "offline" refererer her til å installere pakken, ikke fungere. | | `AIHUMMER_STT_API_KEY` | STT API nøkkel (valgfritt) | `text` | — | umiddelbart | Tilgangsnøkkel for talegjenkjenningstjenesten, hvis den krever en. For en tjeneste på denne serveren setter installasjonsprogrammet den — den trenger ikke endres. Gjelder umiddelbart. | | `AIHUMMER_STT_ENGINE` | STT motor | `enum: auto \\\| faster-whisper \\\| deepgram \\\| codex \\\| off` | `auto` | umiddelbart | Hva talemeldinger skal skrives ut med. Auto (standard): Deepgram hvis nøkkelen er satt, ellers den lokale tjenesten hvis den er installert (bryteren over), ellers ingenting – og boten sier ærlig til avsenderen at den ikke kan lytte ennå. faster-whisper: den lokale tjenesten eller en kompatibel ekstern /v1/audio/transcriptions. deepgram: Deepgram i skyen med egen nøkkel. codex: det tilkoblede ChatGPT-abonnementet (Modeller → Koble til ChatGPT), bruker kvoten. off: ikke skriv ut. Trer i kraft umiddelbart. | | `AIHUMMER_STT_LANGUAGE` | STT språk | `text` | — | umiddelbart | Gjenkjenningsspråk (BCP-47, f.eks. ru/en). Brukes av deepgram-motoren (nova-2-modell). Blank = auto-detect / motor standard. Trer i kraft umiddelbart. | | `AIHUMMER_STT_MODEL` | STT modell | `text` | `Systran/faster-whisper-small` | umiddelbart | faster-whisper-modell (f.eks. small/medium/large-v3 eller Systran/faster-whisper-⟨size⟩). Trer i kraft umiddelbart. | | `AIHUMMER_TTS_API_KEY` | TTS API nøkkel (p⟩ge-tts) | `text` | — | delvis etter omstart | Tilgangsnøkkel for opplesningstjenesten. Settes automatisk ved installasjon — den trenger ikke endres. | | `AIHUMMER_TTS_ENABLED` | Tekst-til-tale aktivert | `bool` | `1` | delvis etter omstart | Lar agenten svare med stemme. Det krever opplesningstjenesten — installer den i delen Ekstra tjenester ovenfor. | | `AIHUMMER_TTS_MODEL` | TTS modell | `text` | — | delvis etter omstart | Modellnavn for edge-tts-tjenesten. Brukes ved oppstart/etter omstart. | | `AIHUMMER_TTS_VOICE` | TTS stemme | `enum: de-DE-FlorianMultilingualNeural \\\| de-DE-SeraphinaMultilingualNeural \\\| en-US-AndrewMultilingualNeural \\\| en-US-AvaMultilingualNeural \\\| en-US-BrianMultilingualNeural \\\| en-US-EmmaMultilingualNeural \\\| fr-FR-RemyMultilingualNeural \\\| fr-FR-VivienneMultilingualNeural \\\| ru-RU-SvetlanaNeural \\\| ru-RU-DmitryNeural \\\| en-US-JennyNeural \\\| en-US-GuyNeural \\\| en-GB-SoniaNeural \\\| de-DE-KatjaNeural \\\| fr-FR-DeniseNeural \\\| es-ES-ElviraNeural \\\| tr-TR-EmelNeural \\\| pl-PL-ZofiaNeural \\\| zh-CN-XiaoxiaoNeural` | `de-DE-FlorianMultilingualNeural` | delvis etter omstart | Standard edge-tts-stemme (flerspråklig, inkl. russisk). Brukes ved oppstart/etter omstart. | | `AIHUMMER_VIDEO_API_KEY` | Videoanalyse API nøkkel | `text` | — | umiddelbart | Tilgangsnøkkel for videoanalysetjenesten, hvis den krever en. Tomt — tjenesten brukes uten nøkkel. | ## Media · Voice | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_TTS_AUTO_REPLY` | Automatiske talesvar | `enum: off \\\| always \\\| inbound \\\| tagged` | `inbound` | umiddelbart | Av, alltid, ved innkommende lyd eller tydelig merking. Kan endres for hver samtale. | | `AIHUMMER_TTS_MAX_CHARS` | Tegngrense for opplesing | `int` | `0` | umiddelbart | 0: hele teksten; 100–10000: grense for opplesing. Hele svaret beholdes i historikken. | | `AIHUMMER_TTS_SUMMARIZE` | Oppsummer lange talesvar | `bool` | `1` | umiddelbart | Oppsummer lange svar for opplesing. Ved feil leses begynnelsen innenfor grensen. | | `AIHUMMER_VOICE_AEC` | Ekkokansellering (AEC) | `bool` | `1` | umiddelbart | Fjerner ekko: agentens egen stemme fra høyttaleren kommer ikke tilbake i mikrofonen og avbryter ikke samtalen. Slå av bare hvis stemmen høres forvrengt ut i hodesettet. | | `AIHUMMER_VOICE_AGC` | Automatisk forsterkningskontroll | `bool` | `1` | umiddelbart | Krev automatisk forsterkningskontroll for mikrofonen (WebRTC autoGainControl) i talemodus. | | `AIHUMMER_VOICE_BARGEIN_FRAMES` | Avbryte agenten: hvor lenge man må snakke | `int` | `5` | umiddelbart | Hvor lenge du må snakke (i rammer på 20 ms) for at agenten skal tie og lytte. Standard 5 — omtrent 0,1 sekund. | | `AIHUMMER_VOICE_DUPLEX` | Live full-dupleks stemme | `bool` | `0` | umiddelbart | Aktiverer direkte full-dupleks-modus (streaming + VAD + pruting). Trer i kraft umiddelbart. | | `AIHUMMER_VOICE_NOISE_SUPPRESSION` | Støydemping | `bool` | `1` | umiddelbart | Krev støyreduksjon ved opptak fra mikrofonen (WebRTC noiseSuppression) i talemodus. | | `AIHUMMER_VOICE_VAD_THRESHOLD` | Stemmefølsomhet (0–1) | `text` | `0.02` | umiddelbart | Hvor høy en lyd må være for å regnes som tale. Lavere — mer følsom: agenten hører stille tale, men også bakgrunnsstøy. Standard 0.02. | ## Memory | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_EMBEDDER_DIM` | Dimensjon for betydningssøkemodellen | `int` | `768` | etter omstart | Vektordimensjon – må samsvare med modellen (multilingual-e5-base=768, bge-m3=1024). | | `AIHUMMER_EMBEDDER_KEEPALIVE` | Embedder holde-i live | `text` | `5m` | etter omstart | Hvor lenge betydningssøkemodellen forblir lastet etter siste forespørsel (bare i modusen «Etter betydning»). Standard 5m — 5 minutter: deretter lastes modellen ut og frigjør minne og CPU. Å holde den alltid (-1) anbefales ikke: en modell som har hengt seg kan oppta en CPU-kjerne i dagevis. Format: 30s, 5m, 1h. | | `AIHUMMER_EMBEDDER_MODEL` | Modell for betydningssøk | `text` | `yxchia/multilingual-e5-base` | etter omstart | Modellen som gjør det mulig å søke i minnet etter betydning. Standard multilingual-e5-base forstår russisk, er lett og kjører raskt på en vanlig CPU. For bedre kvalitet på et grafikkort passer bge-m3, men sett da dimensjonsinnstillingen ved siden av til 1024: tallet må passe til modellen. | | `AIHUMMER_EMBEDDER_PASSAGE_PREFIX` | Innebygd passasjeprefiks | `text` | — | etter omstart | Overstyr prefikset for lagret dokument (e5-modeller bruker automatisk "passage: "). La feltet stå tomt for å automatisk gjenkjenne etter modellnavn. | | `AIHUMMER_EMBEDDER_QUERY_PREFIX` | Embedder-spørringsprefiks | `text` | — | etter omstart | Overstyr prefikset for gjenfinningsspørring (e5-modeller bruker automatisk "query: "). La feltet stå tomt for å automatisk gjenkjenne etter modellnavn. | | `AIHUMMER_EMBEDDER_THREADS` | Innbyggingsmodellens CPU-tråder | `int 0…256` | `0` | etter omstart | Hvor mange prosessortråder modellen for søk etter mening bruker per forespørsel. 0 — automatisk: halvparten av serverens tråder, men minst 2. Uten grense tok omberegning av kunnskapsbasens vektorer på en svak server hele prosessoren i timevis og bremset agentenes svar. Flere — raskere omberegning, men tyngre belastning. | | `AIHUMMER_MEMORY_AGENT_WRITES` | Fakta agenten lagrer selv | `enum: strangers \\\| immediate \\\| review` | `strangers` | umiddelbart | Hva som skjer med det agenten husker selv — for eksempel ved «husk dette». «Rett i minnet; fra fremmede — til gjennomgang» (standard) — rett i minnet hvis eieren eller agentens betrodde krets sa det; fra alle andre — til gjennomgang. «Rett i minnet» — agenten finner det med en gang. «Til gjennomgang» — først i køen Minne → gjennomgang; kommer med i svar først etter at du har godkjent. På agentkortet (Minne → Innstillinger) kan du velge en egen modus. | | `AIHUMMER_MEMORY_AUTOREPAIR` | Automatisk reparasjon av minnet | `bool` | `1` | umiddelbart | Etter egenkontrollen repareres minnet: duplikater slås sammen, motsigelser med en klar vinner lukkes (bekreftet av et menneske, senere hendelsesdato, tyngre kilde), fakta merket som bekreftet som ingen person har bekreftet, kontrolleres mot kildene sine (ubekreftede går til gjennomgang, ingenting slettes). Det omstridte går bare i køen. Hver rettelse loggføres med en angre-knapp; finner minnet dårligere etter kjøringen, angrer den seg selv, og du får et varsel. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MEMORY_CAPTURE` | Minnefangstmodus | `enum: auto \\\| review \\\| off` | `review` | umiddelbart | Hva som skjer med fakta agenten selv legger merke til i samtalen etter hvert svar. «Til gjennomgang» legger dem i køen Minne → gjennomgang: de kommer med i svar først etter at du har godkjent. «Rett i minnet» uten gjennomgang: raskere, men mer støy. «Ikke lagre» henter ingenting ut av samtaler. Hva agenten husker på forespørsel, stilles inn separat. | | `AIHUMMER_MEMORY_CONTEXT_TIMEOUT` | Tidsavbrudd for minnehydrering | `text` | `3s` | umiddelbart | Hvor lenge agenten venter på relevante minner før den begynner å svare. Hvis søket er for tregt, svarer agenten uten dem i stedet for å henge. For eksempel: 2s — 2 sekunder, 1500ms — 1,5 sekunder. 0 — vent så lenge som nødvendig. | | `AIHUMMER_MEMORY_DIARY_BOOT` | Agentens dagbok ved øktens start | `bool` | `1` | umiddelbart | Hold agentens dagbok for i dag og i går for øye i hver tur i en økt på hvilken som helst kanal: notater fra tidligere økter, den nattlige oppsummeringen og agentens egne innlegg. Bare innlegg om den nåværende samtalepartneren og de felles (dine, opplastede) vises — én kunde ser aldri en annens. Høyst ~6000 tegn; resten leser agenten selv (memory_get). Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MEMORY_DIARY_HOUR` | Tidspunkt for nattlig oppsummering | `int` | `3` | umiddelbart | Etter hvilken time (0–23, instansens tidssone) oppsummeringen av den foregående dagen skrives. Standard 3 — om natten, når dagens samtaler er over. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MEMORY_DIARY_NIGHTLY` | Nattlig dagsoppsummering i agentens dagbok | `bool` | `1` | umiddelbart | Én gang i døgnet skrives en oppsummering av den foregående dagen i agentens dagbok — separat for hver person den snakket med (alle personens kanaler samlet): hva som ble bedt om og gjort, avtaler, oppgaver med datoer. Ett kall til modellen for serviceoppgaver per agent og person, høyst 3 per kjøring hvert 10. minutt; tapte dager hentes inn opptil en uke tilbake. Samtaler med «ikke husk» hoppes over. Skrives ikke når minneinnsamling er slått av. Resultatet av siste kjøring vises i agentkortet → Minne → Dagbok. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MEMORY_DREAM_INTERVAL` | Drømmepassintervall | `string` | `1h` | umiddelbart | Hvor ofte det selvvedlikeholdende drømmepasset skanner gjennomgåtte påstander for motsetninger på tvers av alle scopes (Go-varighet, f.eks. 30m/1t/6t). Sett 0 for å deaktivere. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MEMORY_EXTRACT` | LLM faktautvinning | `bool` | `1` | umiddelbart | Trekk ut normaliserte emne-/predikat-/objektfakta via LLM (standard PÅ) i stedet for å lagre rå setningsfragmenter – nødvendig for at grafen/motsigelsen/drømmemaskineriet skal utløses. Legger til ett LLM-anrop per fanget melding; sette av for å lagre samtalen. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MEMORY_MEANING_TIMEOUT` | Tidsgrense for søk etter betydning | `text` | `4s` | umiddelbart | Hvor lenge et søk i minnet og i kunnskapsbasen venter på søket etter betydning. Hvis betydningsmodellen er opptatt (for eksempel beregner vektorer etter en import) og ikke svarer i tide, får agenten straks det som ble funnet etter ord, med en merknad, i stedet for å vente i titalls sekunder. For eksempel: 4s — 4 sekunder, 1500ms — 1,5 sekunder. 0 — vent så lenge som nødvendig. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MEMORY_QUALITY_CHECK` | Daglig egenkontroll av minnet | `bool` | `1` | umiddelbart | Én gang i døgnet stiller minnet seg selv kontrollspørsmål om sine bekreftede fakta (opptil 60 fakta, de samme spørsmålene hver dag) og spørsmål uten svar, kjører dem gjennom minnesøket og den automatiske påminnelsen og måler treffrate, presisjon, MRR og falske påminnelser. Resultat og daglig graf: Minne → Minnekvalitet. Spørsmål om nye fakta skrives én gang av tjenestemodellen (den som henter fakta ut av samtaler; uten den — etter mal); resultatene blir på instansen. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MEMORY_RECALL` | Automatisk gjenkalling av minne | `enum: strong \\\| always \\\| off` | `strong` | umiddelbart | Om det som finnes i minnet legges til svaret automatisk. «Bare sterke treff» — et faktum må dele minst to viktige ord med meldingen; hilsener og «ok» henter ingenting. «Alt som ligner» — alt som traff på noen måte, pluss koblede oppføringer: mer støy. «Ikke legg til» — agenten søker selv i minnet når den mener det trengs. | | `AIHUMMER_MEMORY_RECALL_MAX` | Fakta per svar | `int` | `5` | umiddelbart | Høyeste antall minnefakta som legges til ett svar (standard 5). Omformuleringer av samme faktum teller som ett. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MEMORY_RECALL_MIN_SCORE` | Minste treff for automatisk gjenkalling, % | `int` | `10` | umiddelbart | Hvor stor andel av meldingens meningsbærende ord (vektet etter sjeldenhet) et faktum må dekke for å legges til automatisk, i prosent. Standard 10 – justert etter ekte samtaler. Høyere = sjeldnere og mer presist, lavere = oftere og mer støy. Påvirker ikke det eksplisitte søket memory_search. 0 = ingen terskel: to samsvarende meningsbærende ord er nok. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MEMORY_RECALL_MIN_SIMILARITY` | Minste meningslikhet for automatisk henting, % | `int` | `86` | umiddelbart | Bare for minnesøk etter mening (embedder): hvor nær meldingen i mening et faktum må være for å legges til automatisk, i prosent likhet. Standard 86 — tilpasset modellen multilingual-e5-base på ekte minne: under dette legges uvedkommende fakta til nesten hver melding. Andre modeller (for eksempel bge-m3) måler likhet annerledes — velg en verdi med «Spør minnet» på agentkortet. 0 = ingen terskel. Påvirker ikke det eksplisitte memory_search. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MEMORY_RETRIEVAL` | Modus for minnehenting | `enum: fulltext \\\| embedding` | `fulltext` | etter omstart | Hvordan agenten slår opp i minnet. «Etter ord» er vanlig tekstsøk: virker med en gang og belaster ikke serveren. «Etter betydning» finner det som ligner i betydning, selv med andre ord, men krever betydningssøkemodellen (delen Ekstra tjenester) og merkbar CPU-belastning. | | `AIHUMMER_QDRANT_API_KEY` | Qdrant API nøkkel | `text` | — | etter omstart | Qdrant API-nøkkel, hvis vektorlageret krever autorisasjon. Trengs bare når en Qdrant-adresse er angitt. Brukes ved oppstart/etter omstart. | | `AIHUMMER_QDRANT_URL` | Qdrant URL (holdbart vektorlager) | `text` | — | etter omstart | Adressen til Qdrant-lageret for betydningssøk. Tomt — søkedata holdes i minnet og forsvinner når serveren startes på nytt; angi en adresse for varig bruk. | | `AIHUMMER_RAG_QUERY_EXPANSION` | Omformuler spørringer til kunnskapsbasen med modellen | `bool` | `0` | umiddelbart | Før søk i kunnskapsbasen bes modellen for serviceoppgaver om 3 omformuleringer av spørringen, og det søkes med alle. Finner noen ganger mer, men det er et ekstra modellkall ved HVERT søk (kvote og ventetid); feiler modellen, søkes det bare med den opprinnelige formuleringen, og feilen vises i loggen og i søkeresultatet. Av som standard: ord finnes uansett med fulltekstsøk. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_RERANKER_URL` | RAG reranker sidevogn URL | `text` | — | etter omstart | HTTP URL av sidevognen med krysskoder for omrangering av hybridsøk. Blank = omrangering av. Brukes ved oppstart/etter omstart. | ## Moderation | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_MODERATION` | Inputmoderering | `bool` | `1` | umiddelbart | "off" slår av den innebygde beskyttelsen mot jailbreak/prompt-injection. Enhver annen verdi = aktivert. Trer i kraft umiddelbart, ingen omstart nødvendig. | | `AIHUMMER_MODERATION_REFUSAL` | Moderasjonsavslagsmelding | `text` | — | umiddelbart | Avvisningstekst som returneres når moderatoren blokkerer en forespørsel (tom = innebygd). Trer i kraft umiddelbart, ingen omstart nødvendig. | ## Network | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OUTBOUND_PROXY_CUSTOM_URL` | Utgående proxy: egen adresse | `text` | — | umiddelbart | HTTPS-proxy-URL; HTTP tillates bare på loopback, uten sti, spørring eller fragment. Lagre adressen før du velger custom. Maskert i API-et; lagret i appens innstillinger. | | `AIHUMMER_OUTBOUND_PROXY_MODE` | Utgående proxy for utenlandske modellleverandører | `enum: auto \\\| off \\\| custom` | `auto` | umiddelbart | Hvordan serveren når utenlandske modelleverandører. «Som leverandøren angir» — slik det er satt opp i leverandørens konto; «Direkte, uten proxy» — uten mellomledd; «Gjennom din egen proxy» — via adressen du lagret nedenfor. Om det virker, avhenger av den enkelte leverandørens regler. | | `AIHUMMER_RUSSIAN_TRUSTED_EXTRA_HOSTS` | Verter utenfor .ru for rotsertifikater fra Russlands departement for digital utvikling | `list` | — | etter omstart | Liste over verter, atskilt med kommaer, som tillates kontrollert av røttene til Russlands departement for digital utvikling OVER russiske domener (.ru/.su/.рф - allerede inkludert). Nødvendig hvis noden din med Russlands departement for digital utvikling-sertifikatet bor på et annet domene. Samsvar etter navn eller underdomenegrense: example.com dekker api.example.com. Tomt = kun russiske domener. Gjelder ved start/etter omstart. | ## Performance | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_TURN_QUEUE_WAIT_SEC` | Ventetid i kø: kanalmelding (sekunder) | `int 10…1200` | `600` | umiddelbart | Hvor lenge en kanalmelding (Telegram og andre) venter på en ledig plass når alle plassene for turer er opptatt. Får den ingen i tide, får personen beskjed om at serveren er opptatt og at de kan skrive igjen. Ventetiden teller med i turens grense på 30 minutter. 10–1200. Gjelder umiddelbart. | | `AIHUMMER_MAX_ACTIVE_TURNS` | Agentturer som kjører samtidig (hele serveren) | `int 1…512` | `32` | umiddelbart | Hvor mange agentturer (svar i kanaler og nettchat, tidsplaner) serveren kjører samtidig. Resten venter i kø så lenge innstillingene «Ventetid i kø» nedenfor tillater, og personen ser «serveren er opptatt, i kø». Høyere gir mindre venting, men mer minne, databasetilkoblinger og samtidige modellforespørsler. Halvparten av tallet begrenser samtidige hjelpekall til modellen (minneuttrekk, sammendrag). 1–512. Gjelder umiddelbart. | | `AIHUMMER_SYNC_INBOUND_QUEUE_WAIT_SEC` | Ventetid i kø: synkront integrasjonskall (sekunder) | `int 1…120` | `10` | umiddelbart | Hvor lenge et kall fra en integrasjon som venter på svaret i samme forespørsel, venter på en ledig plass når alle plassene for turer er opptatt. Får det ingen, mottar integrasjonen «serveren er opptatt» med råd om å prøve igjen etter like mange sekunder; et nytt forsøk med samme meldingsnummer lagrer ikke meldingen to ganger. 1–120. Gjelder umiddelbart. | | `AIHUMMER_WEB_TURN_QUEUE_WAIT_SEC` | Ventetid i kø: nettchatmelding (sekunder) | `int 10…1200` | `180` | umiddelbart | Hvor lenge en nettchatmelding venter på en ledig plass når alle plassene for turer er opptatt. Imens viser chatten «serveren er opptatt, i kø»; får den ingen i tide, avvises svaret med knappen «Prøv på nytt», som blir liggende i historikken også etter at siden lastes inn på nytt. 10–1200. Gjelder umiddelbart. | ## Public access | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PUBLIC_URL` | Serverens offentlige adresse | `text` | — | delvis etter omstart | Adressen der panelet og appene åpnes fra internett, f.eks. https://ai.example.com. Send den gjennom proxyen din (nginx, Caddy) til serverporten — som standard 8780. | | `AIHUMMER_WIDGET_ALLOWED_ORIGINS` | Nettwidget: tillatte nettstedopprinnelser | `list` | — | umiddelbart | Kommaseparert liste over nettleseropprinnelser som kan bygge inn nettpratwidgeten, for eksempel https://example.com,https://www.example.com. Skjema og port må samsvare nøyaktig. Tomt = ingen eksterne nettsteder kan bruke widgeten. Oppføringen `*` ignoreres med hensikt, fordi enhver side på internett ellers kunne bruke budsjettet til denne instansen. | | `POCKET_AGENT_GATEWAY_BASE_URL` | Pocket-agent gateway offentlig URL | `text` | — | umiddelbart | Proxy → porten for pocket-agent (POCKET_AGENT_PORT, standard 8080) Den eksterne agenten ringer dette via en engangsbillett. | | `TELEGRAM_PUBLIC_URL` | Telegram webhook offentlig URL | `text` | — | umiddelbart | Bare webhook-modus — proxy → telegram-kontaktporten (standard 8091). La stå tomt for å bruke polling (ingen offentlig URL nødvendig). | ## SSO (LDAP/AD) | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LDAP_BASE_DN` | Brukersøkebase DN | `text` | — | etter omstart | Søk i roten, f.eks. OU=Users,DC=corp,DC=example. | | `AIHUMMER_LDAP_BIND_DN` | Tjeneste-DN for binding | `text` | — | etter omstart | Konto som brukes for den første søkebindingen, f.eks. CN=svc-aihummer,OU=Service,DC=corp,DC=eksempel. Blank = anonymt søk. | | `AIHUMMER_LDAP_DEFAULT_ROLE` | LDAP: Standardrolle (ingen gruppetreff) | `text` | — | etter omstart | Rolle gitt når ingen gruppe samsvarer med en tilordning. Blank = ingen rolle. | | `AIHUMMER_LDAP_ENABLED` | Aktiver LDAP/AD-pålogging | `bool` | `0` | etter omstart | Når på, faller admin-pålogginger tilbake til katalogen. Bindingspassordet finnes i Secrets (scope ldap, name bind_password). | | `AIHUMMER_LDAP_GROUP_ATTR` | Gruppeattributt (standard memberOf) | `text` | — | etter omstart | Attributt på DN-er for brukeroppføringsliste. Blank deaktiverer gruppe→rolletilordning. | | `AIHUMMER_LDAP_ROLE_MAPPINGS` | LDAP: Gruppe→rolletilordninger (JSON) | `text` | — | etter omstart | JSON objekt for gruppe DN (eller bare CN) → rolle, f.eks. {"CN=Admins,OU=Groups,DC=corp,DC=example":"admin","Operators":"operator"}. | | `AIHUMMER_LDAP_SKIP_TLS_VERIFY` | Hopp over TLS-verifisering (kun lab, 1/0) | `bool` | `0` | etter omstart | Deaktiverer verifisering av katalogsertifikat. Aldri aktiver i produksjon. | | `AIHUMMER_LDAP_URL` | Katalog URL | `text` | — | etter omstart | f.eks. ldaps://ad.corp.example:636 (TLS) eller ldap://dc1.corp.example:389. | | `AIHUMMER_LDAP_USER_ATTR` | Påloggingsattributt (standard sAMAccountName) | `text` | — | etter omstart | LDAP/Active Directory-attributtet samsvarte med påloggingen brukertypene (standard sAMAccountName; uid for OpenLDAP, userPrincipalName for pålogginger i UPN-stil). | | `AIHUMMER_LDAP_USER_FILTER` | Brukersøkefilter | `text` | — | etter omstart | Må inneholde %s for påloggingen. AD: (sAMAccountName=%s); OpenLDAP: (uid=%s). | ## SSO (OIDC) | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OIDC_AUDIENCE` | OIDC publikum | `text` | — | etter omstart | Forventet `aud`-krav – sett dette til THIS ressursens publikum for å avvise tokens preget for en annen pålitelig part. `aud`-kravet er nå REQUIRED på hvert token som standard (et token uten aud blir avvist); når dette er satt, må aud også inneholde det. Anbefales på det sterkeste i produksjon. | | `AIHUMMER_OIDC_ISSUER` | OIDC utsteder URL | `text` | — | etter omstart | IdP-utstederen (f.eks. https://login.example.com). Aktiverer OIDC JWT auth når den er angitt. | | `AIHUMMER_OIDC_JWKS_URL` | OIDC JWKS-URL | `text` | — | etter omstart | JSON Nettnøkkelsett endepunkt som brukes til å bekrefte. | | `AIHUMMER_OIDC_TENANT_CLAIM` | OIDC arbeidsområdekrav | `text` | — | etter omstart | JWT krav som bærer arbeidsområde-ID-en (f.eks. tenant_id / org). | ## SSO (SAML) | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SAML_DEFAULT_ROLE` | SAML: Standardrolle (ingen gruppesamsvar) | `text` | — | etter omstart | Rolle gitt når ingen påstått verdikart. Blank = ingen rolle. | | `AIHUMMER_SAML_ENABLED` | Aktiver SAML 2.0 SSO | `bool` | `0` | etter omstart | Utsetter /saml/metadata, /saml/acs, /saml/login. SPs private nøkkel bor i Secrets (omfang saml, navn sp_key). | | `AIHUMMER_SAML_ENTITY_ID` | SP-enhets-ID | `text` | — | etter omstart | SP-enhets-ID (standard til ⟨root⟩/saml/metadata hvis tom). | | `AIHUMMER_SAML_IDP_METADATA` | IdP-metadata XML | `text` | — | etter omstart | Lim inn IdPs SAML metadatadokument (Okta/Azure AD/ADFS). | | `AIHUMMER_SAML_ROLE_ATTRIBUTE` | Rolle/gruppeattributt (standardgrupper) | `text` | — | etter omstart | Assertion-attributt som bærer gruppe-/rolleverdier. | | `AIHUMMER_SAML_ROLE_MAPPINGS` | SAML: Gruppe→rolletilordninger (JSON) | `text` | — | etter omstart | JSON objekt med påstått verdi → rolle, f.eks. {"AdminGroup":"admin","Ops":"operator"}. | | `AIHUMMER_SAML_ROOT_URL` | SP-rot URL | `text` | — | etter omstart | Eksternt tilgjengelig base URL for denne gatewayen, f.eks. https://app.example.com. ACS = ⟨root⟩/saml/acs. | | `AIHUMMER_SAML_SP_CERT` | SP-sertifikat (PEM) | `text` | — | etter omstart | Offentlig SP-signeringssertifikat (PEM). Den samsvarende private nøkkelen går i Secrets (scope saml, navn sp_key). | ## Schedules | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SCHEDULE_AGENT_MAX_ACTIVE` | Agent: grense for aktive tidsplaner | `int` | `20` | umiddelbart | Hvor mange aktive tidsplaner én agent kan ha når den selv oppretter eller slår på en tidsplan (med sine tidsplanverktøy). Tidsplaner opprettet i panelet telles med, men panelet blir aldri avvist. Ved grensen får agenten beskjed om først å sette en på pause eller slette en. Gjelder umiddelbart. | | `AIHUMMER_SCHEDULE_AGENT_MAX_FIRES_PER_DAY` | Agent: tidsplankjøringer per døgn | `int` | `288` | umiddelbart | Hvor mange ganger per døgn (UTC) alle tidsplanene til én agent til sammen kan kjøre, inkludert tidsplaner opprettet i panelet og manuelle kjøringer. Kjøringer over grensen hoppes over og vises i kjøringsloggen. Gjelder umiddelbart. | | `AIHUMMER_SCHEDULE_AGENT_MIN_INTERVAL_MINUTES` | Agent: minste intervall for tidsplan, minutter | `int` | `5` | umiddelbart | Det korteste mellomrommet mellom to kjøringer av en gjentakende tidsplan som en agent selv oppretter eller endrer. En hyppigere tidsplan avvises. Tidsplaner opprettet i panelet begrenses ikke av dette. Gjelder umiddelbart. | | `AIHUMMER_SCHEDULE_COMMANDS` | Kommandoer på serveren i tidsplaner | `bool` | `0` | umiddelbart | Lar en tidsplan kjøre et program på denne serveren — en innsamler, en rapport, en sjekk av sikkerhetskopier. Av som standard. Bare kommandoer fra «Tillatte kommandoer» kjøres, nøyaktig slik de står; det finnes ikke noe skall. Utdata går til agenten eller rett til en chat, og hver kjøring vises i tidsplanens kjørelogg. Gjelder straks. | | `AIHUMMER_SCHEDULE_COMMANDS_ALLOWLIST` | Tillatte kommandoer | `argvlist` | — | umiddelbart | De nøyaktige kommandoene en tidsplan kan kjøre: programmet (et navn som df eller en full bane) og argumentene. En tidsplan kjører bare en kommando som nøyaktig samsvarer med en oppføring, argumentene medregnet. En fjernet kommando stopper tidsplanene som bruker den, og kjøringene deres oppgir hvorfor. Gjelder straks. | | `AIHUMMER_SCHEDULE_COMMANDS_MAX_OUTPUT_KB` | Utdatagrense for tidsplankommandoer, KB | `int 1…1024` | `64` | umiddelbart | Hvor mye av en kommandos utdata (1–1024 KB) som lagres i kjøreloggen og sendes til agenten eller chatten; resten kuttes, og loggen sier fra. Gjelder straks. | | `AIHUMMER_SCHEDULE_COMMANDS_SANDBOX` | Kjør tidsplankommandoer i operativsystemets sandkasse | `bool` | `1` | umiddelbart | På: kommandoen kjøres i operativsystemets sandkasse, som kodekjøring — installasjonens hemmeligheter og SSH-nøkler er skjult, og den skriver bare til sin egen midlertidige mappe. Uten sandkasse (bubblewrap) på serveren kjøres ikke kommandoen, og kjøreloggen sier hvorfor. Av: den kjøres med gatewayens rettigheter. Gjelder straks. | | `AIHUMMER_SCHEDULE_FAILURE_ADMIN` | Varsle administratoren om mislykkede oppgaver | `bool` | `1` | umiddelbart | Når en planlagt oppgave mislykkes eller ikke kan starte, vises et varsel med navnet, årsaken og hvor det rettes i administrasjonspanelets varselbjelle, og det samme sendes til eiernes egne kanalchatter (høyst én gang hver 6. time per oppgave). Dette kommer i tillegg til meldingen til oppgavens mottaker. Av: administratoren får vite om feil bare fra kjøringsloggen. Gjelder umiddelbart. | | `AIHUMMER_SCHEDULE_FAILURE_NOTIFY` | Varsle mottakeren når en oppgave mislykkes | `bool` | `1` | umiddelbart | Når en planlagt oppgave mislykkes, får samme mottaker en kort melding (etter første feil, maks én gang hver sjette time). Av: feilene vises bare i kjøreloggen. En oppgave kan slå dette av for seg selv i skjemaet sitt. Gjelder straks. | ## Security | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AIRGAPPED` | Isolert modus (uten internett) | `bool` | `0` | umiddelbart | Hindrer agentene i å gå på internett: nettsøk, henting av sider og forespørsler når bare interne adresser og de på tillatelseslistene. Slå på for lukkede nett uten tilgang utad. | | `AIHUMMER_AUDIT_RETENTION_DAYS` | Hvor mange dager handlingsloggen lagres | `int` | `0` | etter omstart | Oppføringer i revisjonsloggen og historikken over endringer i innstillingene som er eldre enn dette, slettes én gang i døgnet. 0 eller tomt — lagre for alltid. | | `AIHUMMER_CORS_ORIGINS` | Tillatte CORS-opprinnelse | `list` | — | etter omstart | Kommaseparert liste over tillatte opprinnelser. Blank = CORS ikke tillatt (bare med samme opprinnelse). Brukes ved oppstart/etter omstart. | | `AIHUMMER_CSP` | Content-Security-Policy-overskrift (overstyring) | `text` | — | etter omstart | Overstyrer CSP-overskriften. Blank = en sikker standard. Brukes ved oppstart/etter omstart. | | `AIHUMMER_INBOUND_SECRET` | Kanalprogramtilleggenes nøkkel til serveren | `text` | — | etter omstart | Tilkoblede kanaler (Telegram, VK og andre) bruker den til å bevise at meldinger virkelig kommer fra dem. Settes automatisk ved installasjon — den trenger ikke endres. Står den tom, avviser serveren alle kanaler til en nøkkel er angitt. | | `AIHUMMER_OPENAI_COMPAT_KEY` | OpenAI-kompatibel inngående: statisk API nøkkel | `text` | — | etter omstart | En felles nøkkel for programmer som kobler seg til serveren som til en OpenAI-kompatibel tjeneste. Tomt — den felles nøkkelen er av; programmer kan koble til med personlige nøkler fra siden API-nøkler. | | `AIHUMMER_OPENAI_COMPAT_WORKSPACE` | OpenAI-kompatibel inngående: arbeidsområde-id | `text` | — | etter omstart | Arbeidsområde-ID som statisk OpenAI-kompatibel autentisering tilordnes. Blank = AIHUMMER_DEFAULT_WORKSPACE_ID. Brukes ved oppstart/etter omstart. | | `AIHUMMER_REQUIRE_2FA` | Krev 2FA for operatører | `bool` | `0` | umiddelbart | Krev en ekstra faktor (TOTP/passkey) for operatører. Når den er på, blir operatører uten 2FA bedt om å sette den opp umiddelbart ved pålogging (uten blokkering, slik at eieren aldri er utestengt). Brukes umiddelbart. | | `AIHUMMER_REQUIRE_SECURE` | Godta bare sikre (HTTPS/WSS) tilkoblinger | `bool` | `0` | etter omstart | Når på, blir vanlige HTTP-forespørsler omdirigert til HTTPS (for GET/HEAD) eller avvist (403); Localhost-tilgang er alltid tillatt, så operatøren er aldri inngjerdet. Hederer X-Forwarded-Proto fra en TLS-terminerende omvendt proxy. Brukes ved oppstart/etter omstart. | | `AIHUMMER_TRUSTED_PROXIES` | Betrodde proxyer | `list` | — | umiddelbart | Hvis en proxy (nginx, Caddy, lastbalanserer) står foran serveren, skriv adressen eller nettverket kommaseparert, f.eks. 10.0.0.0/8. Da ser handlingsloggen, IP-tillatelseslisten og beskyttelsen mot passordgjetting besøkendes ekte adresse. Tomt — bare adressen til den direkte tilkoblingen teller, og den kan ikke forfalskes. | ## Tools | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_BROWSER_ALLOWED_HOSTNAMES` | Nettleser: unntak for private vertsnavn | `list` | — | umiddelbart | Nøyaktige kommaseparerte vertsnavn uten jokertegn, URL-er eller porter. Ekstra private unntak for innebygd CDP på egen server, atskilt fra web_fetch. | | `AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK` | Nettleser: tillat privat nettverk | `bool` | — | umiddelbart | Tomt beholder tidligere policy; true eller false aktiverer kontrollert innebygd CDP. Privat tilgang bare på egen server. Loopback, link-local og metadata forblir blokkert. | | `AIHUMMER_BROWSER_PROFILE_SOCKET` | Kontrollsocket for nettleserprofiler | `text` | — | umiddelbart | Valgfritt. La stå tomt — gatewayen finner selv nettlesertjenestens managed-profiles.sock på standard installasjonssted. Profiler med nettstedspålogginger opprettes under Tilkoblinger → Nettleserprofiler. Ikke en URL og ikke en sti til en kildeprofil. | | `AIHUMMER_CODE_EXEC` | Kodekjøring av agenten | `enum: off \\\| host \\\| sandbox` | `off` | umiddelbart | Agentens verktøy for kodekjøring (code_exec). «Av» er standard. «På denne serveren»: kommandoer kjører på gatewayens server; operativsystem-sandkassen (bubblewrap) skjuler installasjonens hemmeligheter, men en agent i modusen «Ingen begrensninger» ser SSH-nøkler og kan skrive utenfor mappen sin — bare for en betrodd server. «Bare i en sandkasse»: alltid i operativsystem-sandkassen — hemmeligheter og nøkler er skjult, og det skrives bare i agentens mappe; uten bubblewrap (eller et containeravbilde) kan denne modusen ikke lagres. Hva hver agent får kjøre, settes på agenten: Agenter → profil → Verktøy. | | `AIHUMMER_CODE_EXEC_INTERPRETERS` | Code-exec-tolkere (JSON) | `text` | — | umiddelbart | JSON objekt {language: path_to_binary}, f.eks. {"python":"/usr/bin/python3"}. Blank = automatisk gjenkjenning. | | `AIHUMMER_CODE_EXEC_NET_PORTS` | Nettverksporter åpne for agentkode | `list` | `53,80,443` | umiddelbart | TCP-porter som agentkode i OS-sandkassen (kodekjøring og tidsplankommandoer) kan koble seg til, skilt med komma. Som standard 53, 80 og 443: DNS og nettsteder. Andre tjenester på denne serveren og dens lokale nettverk (databasen, administrasjonspanelet, nettleseren, adb, lokale modeller, Home Assistant) forblir stengt for agentkode. En port i listen er åpen på alle adresser, også denne serverens, så legg bare til det koden trenger, for eksempel 22 for SSH. Skriv any for å fjerne begrensningen. Agenter i modusen «Ingen begrensninger» begrenses ikke. Krever Linux 6.7 eller nyere; uten det gjelder ikke begrensningen, og Agenter → Verktøy sier fra. Gjelder umiddelbart. | | `AIHUMMER_CODE_EXEC_READ_DIRS` | Mapper åpne for agentkode (skrivebeskyttet) | `list` | — | umiddelbart | Mapper på denne serveren som agentkode kan lese: kodekjøring og tidsplankommandoer i OS-sandkassen. Skill med komma eller én per linje, for eksempel ~/reports. Du kan også oppgi én enkelt fil, for eksempel ~/scripts/report.py. Det som åpnes her, er synlig for koden til alle agenter, så åpne bare det koden trenger. Tom som standard: i sandkassen ser koden bare sin egen agents mappe og systemmappene; hjemmemappen til gateway-brukeren, installasjonens data, andre agenters mapper, nøkler og kommandohistorikk forblir skjult. Roten, hele hjemmemappen, installasjonens data og steder med nøkler kan ikke åpnes. Koden kan ikke skrive til disse mappene. Gjelder umiddelbart. | | `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Sandbox-bilde | `text` | — | umiddelbart | Valgfritt, bare for «Bare i en sandkasse»: et Docker-containeravbilde i stedet for operativsystem-sandkassen (uten nettverk, skrivebeskyttet rot, grenser); krever Docker på serveren. Tomt = operativsystem-sandkassen (bubblewrap). | | `AIHUMMER_CODE_EXEC_TIMEOUT_SECONDS` | Tidsgrense for kodekjøring (sekunder) | `int` | `1800` | umiddelbart | Hvor lenge én agentkommando kan kjøre, bakgrunnskommandoer inkludert: 10 sekunder til 24 timer. En kommando som ikke har svart innen 30 sekunder, avbrytes ikke, men flyttes til bakgrunnen, der agenten sjekker den med verktøyet process. Agenten kan be om en kortere grense, aldri en lengre. | | `AIHUMMER_DB_QUERY_DSN` | Databasetilkobling for verktøyet for databasespørringer | `text` | — | umiddelbart | Tilkoblingsstreng til en database agenten kan lese (bare lesing), f.eks. postgres://reader:passord@host/db. Bruk en bruker med minimale rettigheter — ikke databaseeieren. Tomt — verktøyet er av. | | `AIHUMMER_FS_ROOT` | Filsystemverktøyrot | `text` | — | umiddelbart | Mappen agenten leser serverens filer innenfor (filesystem_read; agenter kan ikke skrive filer). Tom = hele serveren med gateway-brukerens rettigheter, unntatt hemmelighetene: installasjonsinnstillinger (gateway.env), SSH/GPG-nøkler og prosessmiljøer. Angi en mappe for å begrense tilgangen. | | `AIHUMMER_HTTP_ALLOWLIST` | Adresser for agentens HTTP-forespørsler | `list` | — | umiddelbart | Kommaseparert liste over verter som verktøyet http_request kan kontakte. Tomt = alle er tillatt, bortsett fra interne og private adresser. | | `AIHUMMER_HTTP_AUTH_JSON` | http_request-autentisering (JSON) | `text` | — | umiddelbart | JSON-kart som knytter vert til autorisasjonshoder for verktøyet http_request, slik at tokener ikke lagres i ledeteksten. Tomt = uten autorisasjon. | | `AIHUMMER_MCP_SERVERS` | MCP servere (JSON) | `text` | — | umiddelbart | JSON-beskrivelse av de eksterne MCP-serverne hvis verktøy kobles til agenten. Tomt = ingen eksterne MCP. | | `AIHUMMER_PROJECT_STUDIOS_PUBLIC_NETWORK` | Prosjektstudioer: offentlig nettverk | `bool` | `false` | umiddelbart | Tillat offentlig HTTP(S) for valgte leverandører og uttrykkelig forespurte modellnedlastinger. Private, lokale og metadataadresser forblir blokkert. Frakoblet modus har forrang. Gjelder umiddelbart. | | `AIHUMMER_SIDECAR_CLOAKBROWSER` | Nettleser for agenten (CloakBrowser) | `bool` | `0` | umiddelbart | Anti-detect-nettleser (CloakBrowser, browser/computer-verktøy). Hva er IKKE inkludert i leveringspakken: inkluderingen laster ned det signerte tillegget (~477 MiB, hvorav Chromium ~207 MiB) og installerer tjenesten på verten. Den tyngste sidevognen - aktiver kun hvis agenten trenger å åpne nettsider. | | `AIHUMMER_SIDECAR_SEARXNG` | Nettsøk (SearXNG) | `bool` | `0` | umiddelbart | Nettsøk (SearXNG, web_search-verktøy). IKKE inkludert i pakken: å slå på laster ned det signerte tillegget (~154 MiB) og installerer tjenesten på verten, og slår av stopper det og frigjør plass. Installasjonen skjer i bakgrunnen og tar noen minutter; tilstanden her viser hva som faktisk er på serveren. | | `AIHUMMER_WEBFETCH_ALLOWLIST` | Nettsteder agenten kan åpne | `list` | — | umiddelbart | Kommaseparert liste over domener som verktøyet web_fetch kan kontakte. Tomt = alle er tillatt, bortsett fra interne og private adresser. | | `AIHUMMER_WEB_SEARCH_LANGUAGE` | Nettsøk: standardspråk for resultater | `text` | `auto` | umiddelbart | Språk for resultater når agenten ikke oppgir et: en kode som ru, en eller de, eller auto for å finne det ut fra søket (passer nesten alltid). Agenten kan fortsatt velge et annet språk i et bestemt søk. | | `AIHUMMER_WEB_SEARCH_RESULTS` | Nettsøk: resultater per søk | `int` | `5` | umiddelbart | Hvor mange resultater et søk returnerer når agenten ikke ber om et antall: 1 til 10. Flere resultater gir et fyldigere svar, men lengre kontekst. | | `AIHUMMER_WEB_SEARCH_SOURCE` | Kilde for nettsøk | `enum: auto \\\| searxng \\\| provider` | `auto` | umiddelbart | Hvor agenten søker på internett (verktøyet web_search). auto — SearXNG hvis den er installert, ellers modellleverandørens innebygde søk. searxng — bare SearXNG: uten den er det ikke noe søk. provider — leverandørens innebygde søk der det finnes, og SearXNG for andre modeller. Innebygd søk finnes hos Codex (ChatGPT-abonnement) og OpenAI (api.openai.com); GigaChat, YandexGPT og andre OpenAI-kompatible har det ikke — uten SearXNG søker ikke agenter på disse modellene. Claude (api.anthropic.com og Claude-abonnementet) bruker Anthropics innebygde søk; avviser kontoen det, skriver gatewayen det i loggen og tilbyr deretter agenten bare SearXNG. Hvilke agenter som får søke, angis som før på agentkortet. Gjelder fra neste tur. | | `AIHUMMER_WEB_SEARCH_TIMEOUT_SECONDS` | Tidsgrense for nettsøk (sekunder) | `int` | `30` | umiddelbart | 1–600 sekunder per søk. En kortere tidsfrist for oppgaven gjelder fortsatt. | ## Updates | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_RESTART_APPLY` | Bruk innstillinger som krever omstart | `enum: quiet \\\| manual` | `quiet` | umiddelbart | quiet (standard) — lagrede innstillinger som først trer i kraft når gatewayen starter på nytt, brukes av seg selv: gatewayen starter på nytt i neste rolige øyeblikk, når agentene ikke gjør noe og folk har vært stille minst like lenge som stillhetsvinduet. manual — bare merket «venter på omstart» og knappen. En omstart tar noen sekunder; samtaler og oppgaver går ikke tapt. Trer i kraft umiddelbart. | | `AIHUMMER_RESTART_QUIET_MINUTES` | Rolig øyeblikk: minutter stillhet før en automatisk omstart | `int 0…1440` | `10` | umiddelbart | Hvor mange minutter folk må være stille (og agentene ledige) før gatewayen starter på nytt av seg selv for å bruke lagrede innstillinger. 0 — så snart agentene er ferdige med arbeidet de holder på med. 0–1440. Trer i kraft umiddelbart. | ## Web UI (separate port) | Nøkkel | Navn | Type | Standard | Trer i kraft | Funksjon | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_WEBUI_API_BASE` | Serveradresse for et separat hostet panel | `text` | — | etter omstart | Bare nødvendig hvis panelet åpnes fra en annen adresse enn selve serveren. Oppgi adressen der nettleseren når serveren, f.eks. https://api.example.com. Tomt — serverens offentlige adresse brukes, eller den lokale hvis den ikke finnes. | | `AIHUMMER_WEBUI_ENABLED` | Panel på en egen port | `bool` | `1` | etter omstart | På — panelet åpnes på en egen intern port som kan stenges for internett, og den offentlige porten betjener bare apper og kanaler. Slå av for å gjøre panelet helt utilgjengelig. | | `AIHUMMER_WEBUI_ORIGIN` | Adressen panelet åpnes på | `text` | — | etter omstart | Fyll ut hvis panelet åpnes via en proxy eller et navn som avviker fra portadressen, f.eks. https://admin.example.com. Serveren lar da en nettleser fra den adressen snakke med den. Tomt — adressen til panelporten brukes. | Innstillinger tilgjengelige for operatøren: 237.