Asetusten hakemisto

Tässä on lueteltu kaikki asetukset, joita ylläpitäjä voi muuttaa AiHummer-palvelimella. Sivu luodaan tuotteen omasta luettelosta, joten se vastaa palvelintasi. Arvo asetetaan verkkokäyttöliittymässä tai komennolla `aihummer settings set KEY VALUE` ([Komentorivi](/fi/v1.4/reference/cli/)). Oletusarvon sarake kertoo, mitä palvelin käyttää, kunnes oma arvo on asetettu. > [!NOTE] > Salaisia arvoja ei koskaan tulosteta tähän, eikä toimittajan huoltoavaimia luetella lainkaan — tuote piilottaa ne kaikista luetteloista. Ajatusviiva tarkoittaa tyhjää arvoa tai selitystä, joka näkyy vain verkkokäyttöliittymässä. ## API | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PERSONAL_API_KEYS` | OpenAI-compatin henkilökohtaiset API-avaimet | `bool` | `1` | uudelleenkäynnistyksen jälkeen | "off" poistaa henkilökohtaisen avaimen todennuksen käytöstä OpenAI-yhteensopivassa päätepisteessä. Mikä tahansa muu arvo = käytössä. Käytetään käynnistyksen yhteydessä/uudelleenkäynnistyksen jälkeen. | ## Agent | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_ANNOUNCE_SLOW_TOOLS` | Agentti: kertoa ennen pitkiä toimintoja | `bool` | `1` | heti | Ennen pitkää toimintoa (kuva, perusteellinen haku, video, tehtävä aliagentille) agentti kirjoittaa lyhyesti, mitä tekee, jotta odotus ei ole hiljainen. Kytke pois, jos tällaiset viestit häiritsevät. | | `AIHUMMER_AGENT_COMPACT_AT_PCT` | Agentti: tiivistä historia alkaen, % sen budjetista | `int 50…99` | `85` | heti | Kun keskustelun historia täyttää tämän osuuden tilastaan mallin ikkunassa, vanhemmat viestit tiivistetään yhteenvedoksi — taustalla, vastauksen jälkeen; vuoro ei odota. Pienempi — tiivistetään useammin, mutta malli muistaa sanatarkasti vähemmän; suurempi — harvemmin, mutta vuorot raskaampia. 50–99; agentti voi asettaa oman arvonsa. | | `AIHUMMER_AGENT_COMPACT_TO_PCT` | Agentti: jätä tiivistyksen jälkeen, % historiabudjetista | `int 10…90` | `50` | heti | Kuinka suuri osa historian tilasta jää tiivistyksen jälkeen sanatarkaksi; kaikki vanhempi menee yhteenvetoon. Oltava pienempi kuin tiivistyksen kynnys: niiden väli ratkaisee, montako vuoroa kuluu seuraavaan tiivistykseen. 10–90; agentti voi asettaa oman arvonsa. | | `AIHUMMER_AGENT_HISTORY_TURNS` | Agentti: sanatarkasti säilytettävät keskusteluvuorot | `int 1…1000` | `30` | heti | Kuinka monta viimeisintä keskusteluvuoroa malli näkee sanatarkasti (enintään 10 lisää ennen tiivistystä). Vanhemmat viestit tiivistetään taustalla; itse keskustelua ei koskaan poisteta. Mallin kontekstiikkuna otetaan huomioon automaattisesti. 1–1000; agentille voi asettaa oman arvon. | | `AIHUMMER_AGENT_MAX_ITERATIONS` | Agentti: työkaluvaiheita enintään vuorossa | `int 1…256` | `25` | heti | Kuinka monta kertaa agentti voi kutsua työkaluja yhden vuoron aikana ennen vastaamista. Rajalla vuoro ei epäonnistu: agentti kertoo, mitä ehti tehdä ja mitä jäi, ja voit pyytää sitä jatkamaan. Kolme peräkkäistä samanlaista kutsua samalla tuloksella lopettaa vuoron aiemmin. 1–256; agentille voi asettaa oman arvon. | | `AIHUMMER_AGENT_MEMORY_FLUSH` | Agentti: tallenna muistiinpano ennen tiivistystä | `bool` | `1` | heti | Ennen kuin vanhemmat viestit tiivistetään yhteenvedoksi, agentti tallentaa muistiin lyhyen muistiinpanon tavoitteista, päätöksistä ja avoimista tehtävistä. Poista käytöstä säästääksesi mallikutsun. | | `AIHUMMER_AGENT_MEMORY_FLUSH_PROMPT` | Agentti: mitä tiivistystä edeltävä muistiinpano tallentaa | `text` | — | heti | Oma tehtävä tiivistystä edeltävälle muistiinpanolle: mitä yhteenvetoon menevistä viesteistä säilytetään (esim. ”kirjaa vain ostokset, määräajat ja sopimukset”). Tyhjä — sisäänrakennettu: tavoitteet, päätökset, avoimet tehtävät. Suojausta ei voi poistaa: keskustelun teksti pysyy tietona, ei ohjeina, eikä salasanoja tai avaimia tallenneta. Enintään 4000 merkkiä; agentilla voi olla oma. | | `AIHUMMER_AGENT_NEW_REMINDERS_MEMORY` | Uudet agentit: muistutukset ja muistiin kirjoittaminen | `bool` | `1` | heti | Käsin luotu uusi agentti (käyttöönoton ohjattu toiminto, ”Luo agentti”, API) luo, muuttaa ja peruu ensimmäisestä vuorosta alkaen OMIA muistutuksiaan ja aikataulujaan ja kirjoittaa tosiasioita omaan muistiinsa – kuten henkilökohtaisen avustajan malli. Yksittäiseltä agentilta tämän voi kytkeä pois sen kortista (Kyvyt). Kirjaston mallit päättävät itse, kopio säilyttää alkuperäisen oikeudet, toisen agentin luomat agentit aloittavat ilman niitä; olemassa olevat agentit eivät muutu. Koskee seuraavaa luotavaa agenttia. | | `AIHUMMER_AGENT_PROMPT_PART_MAX_CHARS` | Agentti: merkkien enimmäismäärä kehotteen osaa kohden | `int 1000…1000000` | `20000` | heti | Kuinka monta merkkiä malli saa agentin persoonan YHDESTÄ osasta: profiilin osiosta, kehotteen osasta tai pääkehotteesta. Pidemmästä osasta säilyvät alku (3/4) ja loppu (1/4) merkinnällä siitä, paljonko karsittiin; tämä näkyy keskustelukortissa ja agentin kehotteen koostumuksessa. Nimeä, puhuttelua ja persoonan rajoituksia ei karsita koskaan. 1000–1000000; agentille voi asettaa oman arvon. | | `AIHUMMER_AGENT_PROMPT_TOTAL_MAX_CHARS` | Agentti: koko persoonan merkkien enimmäismäärä | `int 1000…2000000` | `60000` | heti | Agentin persoonan kokonaisraja: kaikki osat yhteensä. Jos se ylittyy, pisimmät osat antavat tilaa ensin ja lyhyet säilyvät kokonaisina. 1000–2000000; agentille voi asettaa oman arvon. | | `AIHUMMER_AGENT_SELF_INTRO` | Agentti: esittäytyminen | `enum: first_contact \\\| each_dialog \\\| never` | `first_contact` | heti | ”Kerran, ensitapaamisella” – agentti esittäytyy lyhyesti ensimmäisessä keskustelussa ihmisen kanssa, ellei tämä halua mennä suoraan asiaan; tutulle ihmiselle se ei esittäydy uudelleen ja vastaa tervehdykseen luontevasti. ”Ei esittäydy” – agentti ei koskaan kerro nimeään oma-aloitteisesti. «Jokaisen uuden keskustelun alussa» — jokaisen uuden keskustelun alussa ja pitkän tauon jälkeen, lyhyesti ja ilman yhteenvetoa aiemmista asioista. Agentilla voi olla oma valinta kortillaan («Konteksti ja käyttäytyminen»). | | `AIHUMMER_AGENT_SESSION_IDLE_RESET_MINUTES` | Agentti: aloita keskustelu alusta hiljaisuuden jälkeen (minuuttia) | `int 0…525600` | `360` | heti | Tiloissa ”hiljaisuuden jälkeen” ja ”joka päivä ja hiljaisuuden jälkeen”: jos henkilö kirjoittaa tätä pidemmän hiljaisuuden jälkeen, agentti aloittaa keskustelun alusta. Koskee agentteja, joilla ei ole omaa arvoa kortillaan. 0 — ei hiljaisuuden perusteella. 0–525600; 360 = 6 tuntia, 1440 = vuorokausi. | | `AIHUMMER_AGENT_SESSION_INDEX_MAX_ENTRIES` | Agentti: pidä luettelossa enintään näin monta istuntoa | `int 0…100000` | `0` | heti | Hiljaisimmat poistuvat ensin; mitään ei poisteta. 0 — ei rajaa. 0–100000. Koskee agentteja, joiden kortilla ei ole omaa arvoa. | | `AIHUMMER_AGENT_SESSION_INDEX_PRUNE_DAYS` | Agentti: poista istuntoluettelosta näin monen hiljaisen päivän jälkeen | `int 0…3650` | `0` | heti | Mitään ei poisteta: keskustelu poistuu luettelosta ja palaa uuden viestin myötä. 0 — säilytä. 0–3650. Koskee agentteja, joiden kortilla ei ole omaa arvoa. | | `AIHUMMER_AGENT_SESSION_RESET_AT_HOUR` | Agentti: päivittäisen uudelleenaloituksen tunti | `int 0…23` | `4` | heti | ”Joka päivä” -tiloille: ennen tätä tuntia alkanut keskustelu alkaa alusta ihmisen seuraavasta viestistä. Tunti noudattaa palvelimen aikavyöhykettä (asetus ”Aikavyöhyke” kohdassa Järjestelmä ja asetukset). 0–23; 4 on yöllä, kun lähes kukaan ei kirjoita. | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_IDLE_MINUTES` | Agentti: aloita ryhmäkeskustelu alusta hiljaisuuden jälkeen (minuuttia) | `int 0…525600` | `0` | heti | Ryhmäkeskusteluille tiloissa ”hiljaisuuden jälkeen” ja ”joka päivä ja hiljaisuuden jälkeen”: hiljaisuuden minuutit, joiden jälkeen ryhmäkeskustelu alkaa alusta. 0 tarkoittaa samaa kuin henkilökohtaisissa. 0–525600. | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_MODE` | Agentti: milloin ryhmäkeskustelu alkaa alusta | `enum: inherit \\\| daily \\\| idle \\\| both \\\| none` | `inherit` | heti | Oma sääntö ryhmäkeskusteluille (Telegram-ryhmät, VK-keskustelut, MAX-keskustelut ja muut): kuten henkilökohtaisissa, joka päivä nollaustuntina, hiljaisuuden jälkeen, kumpi tulee ensin, tai ei koskaan. Nollaustunti on yhteinen. Koskee agentteja, joiden kortissa ei ole omaa sääntöä. | | `AIHUMMER_AGENT_SESSION_RESET_MODE` | Agentti: milloin keskustelu alkaa alusta | `enum: idle \\\| daily \\\| both \\\| none` | `idle` | heti | Milloin agentti aloittaa keskustelun alusta: joka päivä nollaustunnilla (instanssin aikavyöhykkeellä), hiljaisuuden jälkeen, kumpi tahansa ensin, tai ei koskaan. Aloittaessaan alusta agentti kirjoittaa muistiinsa muistiinpanon edellisestä keskustelusta, ja sen ensimmäinen vuoro saa aiemman yhteenvedon ja viimeisimmät viestit; viestit säilyvät arkistossa ja haussa. Koskee agentteja, joilla ei ole omaa sääntöä kortillaan; siellä ryhmäkeskusteluille voi asettaa erillisen säännön. | | `AIHUMMER_AGENT_SESSION_SCOPE` | Agentti: minne henkilökohtaiset keskustelut menevät | `enum: chat \\\| per-channel-peer \\\| per-peer` | `chat` | heti | «Yksi henkilöä kohden» yhdistää saman henkilön Telegramin, sovelluksen ja muut henkilökohtaiset chatit yhdeksi keskusteluksi. Ryhmächatit pitävät aina omansa. Voimassa seuraavasta viestistä. Koskee agentteja, joiden kortilla ei ole omaa arvoa. | | `AIHUMMER_AGENT_SILENT_REPLY` | Agentti: saa olla vastaamatta | `enum: groups \\\| all \\\| off` | `groups` | heti | Ryhmäkeskusteluissa agentti saa olla vastaamatta, jos viestiä ei ole osoitettu sille tai sillä ei ole lisättävää; yksityiskeskusteluissa se vastaa aina. Voit sallia hiljaisuuden myös yksityiskeskusteluissa tai poistaa sen käytöstä. Hiljainen vuoro ei lähetä mitään, keskustelukortti merkitsee sen ”agentti oli hiljaa”, eikä malli näe sitä historiassa. Tulee voimaan seuraavasta vuorosta. | | `AIHUMMER_AGENT_SKILLS_PROMPT_MAX_CHARS` | Agentti: kehotteen taitoluettelon merkkien enimmäismäärä | `int 1000…200000` | `18000` | heti | Joka vuorolla malli ei näe taitojen tekstejä vaan niiden luettelon: tunnisteen, nimen ja milloin käyttää; agentti lataa taidon ohjeen itse, kun tehtävä sopii. Jos luettelo on pidempi, ensin poistetaan kuvaukset ja sitten luettelon loppu — loput agentti löytää pyynnöstä. 1000–200000. | | `AIHUMMER_AGENT_STALE_GAP_HOURS` | Agentti: tauko, jonka jälkeen aiempi keskustelu on historiaa (tuntia) | `int 0…8760` | `12` | heti | Jos ihminen kirjoittaa tätä pidemmän tauon jälkeen, agentti saa merkinnän: kaikki aiemmin käsitelty on historiaa — sitä ei kerrata eikä vanhoja tehtäviä jatketa pyytämättä. Jokainen viesti kantaa jo aikansa ja kuluneen ajan edellisestä. 0 = ei merkintää. 0–8760. | | `AIHUMMER_AGENT_TOOL_HISTORY_TURNS` | Agentti: vuorot, joissa työkalujen tulokset muistetaan | `int 0…100` | `5` | heti | Kuinka monen viimeisimmän vuoron työkalukutsut ja niiden tulokset malli näkee kokonaan (tulos säilytetään enintään 16 kt). Vanhemmista vuoroista jäävät kutsu ja tuloksen alku. Näin agentti muistaa, mitä se löysi ja teki, eikä kutsu työkaluja uudelleen. 0 = tuloksia ei siirretä myöhempiin vuoroihin. 0–100; agentti voi ohittaa arvon. | | `AIHUMMER_APPROVAL_TOOLS` | Hyväksyntää vaativat työkalut | `multiselect` | — | heti | Pilkuin eroteltu luettelo työkaluista, joiden kutsut vaativat operaattorin manuaalisen hyväksynnän ennen suoritusta. Tyhjä = hyväksyntää ei vaadita. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | Alagentin enimmäissyvyys | `int 0…10` | `2` | heti | Aliagenttien suurin sisäkkäisyyssyvyys (agentti, joka käynnistää agentin). Oletus 2 — suoja loputonta rekursiota vastaan. | | `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | Alagentin aikakatkaisu (sekuntia) | `int 0…86400` | `180` | heti | Maksimiaika yksittäiselle aliagentille sekunneissa. | | `AIHUMMER_TOOL_SEARCH` | Työkalujen laiska lataus | `bool` | `false` | heti | Näyttää työkalujen työytimen suoraan ja piilottaa suuren luettelon loput hakutyökalun taakse, joka nimeää jokaisen piilotetun työkalun. Kannattaa vain suurissa luetteloissa (kymmeniä laajennus-, MCP- tai OpenAPI-työkaluja): kokorajan alapuolella kaikki työkalut näytetään suoraan, koska ylimääräinen mallikutsu työkalun etsimiseen maksaa enemmän kuin skeemat. Tulee voimaan seuraavalla vuorolla. | | `AIHUMMER_TOOL_SEARCH_CORE` | Laska työkalun lataus: aina päällä olevat työkalut | `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` | heti | Työkalut, jotka näytetään laiskassa tilassa aina suoraan. Oletuksena työydin: verkkohaku, sivujen nouto, muisti, keskusteluhistoria, tietopankki, koodi, tiedostot, viestit, ajastukset ja sovelluksen yhdistäminen. Muistin ja tietopankin haku (memory_search, memory_get, search_knowledge) näkyy aina, olipa tässä luettelossa mitä tahansa. Tyhjä luettelo palauttaa tämän ytimen. | | `AIHUMMER_TOOL_SEARCH_MIN_POOL_TOKENS` | Työkalujen laiska lataus: piilotettujen työkalujen vähimmäiskoko (tokenit) | `int 0…1000000` | `4000` | heti | Piilota työkalut vain, kun ytimen ulkopuoliset skeemat ovat yhteensä vähintään näin monta tokenia (noin 4 merkkiä kukin). Sen alle kaikki työkalut näytetään suoraan: ylimääräinen mallikutsu työkalun etsimiseen maksaa enemmän kuin skeemojen näyttäminen. | | `AIHUMMER_TOOL_SEARCH_THRESHOLD` | Laska työkalun lataus: lykkäystyökalujen vähimmäismäärä | `int 0…1000` | `12` | heti | Lyö vain, kun enemmän kuin tämä monta työkalua selviää agentin profiilisuodattimesta. | ## Agent · Reasoning | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_BEST_OF_N` | Paras N:stä: ehdokkaiden määrä | `int 0…8` | `0` | heti | Agentti laatii näin monta vastausehdokasta ja pitää parhaan. 0 tai 1 — pois, 2 tai enemmän — päällä. Jokainen ehdokas maksaa kuin erillinen vastaus. | | `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | Keskustelu: tuomarikehote (ohita) | `text` | — | heti | Ohittaa keskustelutuomarin kehotteen (tyhjä = sisäänrakennettu). | | `AIHUMMER_AGENT_DEBATE_N` | Väittely: vastausehdokkaiden määrä | `int 0…8` | `0` | heti | Agentti laatii näin monta vastausehdokasta, vertaa niitä ja antaa parhaan. 0 tai 1 — pois, 2 tai enemmän — päällä. Jokainen ehdokas maksaa kuin erillinen vastaus. | | `AIHUMMER_AGENT_DEBATE_PROMPT` | Keskustelu: ehdokaskehote (ohita) | `text` | — | heti | Ohittaa keskusteluehdokkaiden kehotteen (tyhjä = sisäänrakennettu). | | `AIHUMMER_AGENT_DEBATE_ROUNDS` | Keskustelu: kierrokset | `int 1…10` | `1` | heti | Ehdokaspaneelin keskustelukierrosten määrä. | | `AIHUMMER_AGENT_JUDGE_PROMPT` | N-parhaan tuomarikehote (ohitus) | `text` | — | heti | Ohittaa N-parhaan tuomarikehotteen (tyhjä = sisäänrakennettu). | | `AIHUMMER_AGENT_PLAN_PROMPT` | Suunnittelijakehote (ohita) | `text` | — | heti | Ohittaa suunnittelijan kehotteen (tyhjä = sisäänrakennettu). | | `AIHUMMER_AGENT_PLAN_STEPS` | Suunnittelija-suunnittelija: suunnitelman enimmäisvaiheet (0=pois) | `int 0…32` | `0` | heti | ⟩0 suorittaa erillisen suunnittelija→suoritin→synteesipassin (sopii monimutkaisiin monivaiheisiin tehtäviin). 0 poistaa käytöstä. Tyypilliset 4–8. | | `AIHUMMER_AGENT_PLAN_STEP_ITERS` | Suunnittelija: työkalun iteraatiot askelta kohti (0=oletus) | `int 0…64` | `0` | heti | Korjaa työkalukutsun iteraatiot suunnitelman vaihetta kohti. 0 = sisäänrakennettu oletus (4). | | `AIHUMMER_AGENT_REFLECT` | Itsekritiikin läpäisy | `bool` | `0` | heti | Lisää pohdinta-/itsekritiikkipassin ennen lopullista vastausta. | | `AIHUMMER_AGENT_REFLECT_PROMPT` | Reflektiokehote (ohitus) | `text` | — | heti | Ohittaa itsekritiikkikehotteen (tyhjä = sisäänrakennettu). | | `AIHUMMER_AGENT_SELF_HEAL` | Itsekorjaustyökalun virheen uudelleenyritykset (0=pois) | `int 0…10` | `0` | heti | ⟩0 epäonnistunutta työkalukutsua uudelleen yrittämällä korjausvihjeellä tähän rajaan asti. | ## Agent · System prompt | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LOCALE` | Oletuskieli | `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` | heti | Vastauksen oletuskieli/paikallinen vihje, esim. ru-RU. Henkilö-/operaattoriohjeet ohittavat. | | `AIHUMMER_TIMEZONE` | Aikavyöhyke | `text` | `UTC` | heti | IANA-aikavyöhyke agentin nykyiselle päivämäärälle ja aikatauluille, joilla ei ole omaa vyöhykettä, esim. Europe/Moscow. Oletus UTC. | ## Channels | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_FAILURE_NOTICE` | Kerro keskustelijalle, kun vastaus epäonnistuu | `enum: always \\\| once \\\| off` | `always` | heti | Mitä kanavan (Telegram ja muut) keskustelija saa, kun agentti ei pystynyt vastaamaan: ”Joka kerta” — lyhyt viesti hänen kielellään; ”Enintään kerran 4 tunnissa” — yksi viesti keskustelua kohden 4 tunnin aikana; ”Älä kerro” — ei mitään. Viestissä ei ole virhekoodeja eikä palveluntarjoajien nimiä; yksityiskohdat näet Istunnoissa ja ilmoituksissa. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BLOCKED` | Virheviesti: instanssi on keskeytetty | `text` | — | heti | Jätä tyhjäksi, niin lähetetään sisäänrakennettu viesti henkilön omalla kielellä. Tekstisi lähetetään sellaisenaan, sillä kielellä, jolla kirjoitat sen; {ref} lisää vastauksen koodin, jolla löydät vuoron Istunnoista. Tulee voimaan heti. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUDGET` | Virheviesti: omistajan budjetti on käytetty | `text` | — | heti | Jätä tyhjäksi, niin lähetetään sisäänrakennettu viesti henkilön omalla kielellä. Tekstisi lähetetään sellaisenaan, sillä kielellä, jolla kirjoitat sen; {ref} lisää vastauksen koodin, jolla löydät vuoron Istunnoista. Tulee voimaan heti. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUSY` | Virheviesti: yhdyskäytävä on ylikuormitettu | `text` | — | heti | Jätä tyhjäksi, niin lähetetään sisäänrakennettu viesti henkilön omalla kielellä. Tekstisi lähetetään sellaisenaan, sillä kielellä, jolla kirjoitat sen; {ref} lisää vastauksen koodin, jolla löydät vuoron Istunnoista. Tulee voimaan heti. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_CONFIG` | Virheviesti: malliyhteys vaatii omistajaa | `text` | — | heti | Jätä tyhjäksi, niin lähetetään sisäänrakennettu viesti henkilön omalla kielellä. Tekstisi lähetetään sellaisenaan, sillä kielellä, jolla kirjoitat sen; {ref} lisää vastauksen koodin, jolla löydät vuoron Istunnoista. Tulee voimaan heti. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_FAILED` | Virheviesti: muu virhe | `text` | — | heti | Jätä tyhjäksi, niin lähetetään sisäänrakennettu viesti henkilön omalla kielellä. Tekstisi lähetetään sellaisenaan, sillä kielellä, jolla kirjoitat sen; {ref} lisää vastauksen koodin, jolla löydät vuoron Istunnoista. Tulee voimaan heti. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_QUOTA` | Virheviesti: mallin käyttöraja on täynnä | `text` | — | heti | Jätä tyhjäksi, niin lähetetään sisäänrakennettu viesti henkilön omalla kielellä. Tekstisi lähetetään sellaisenaan, sillä kielellä, jolla kirjoitat sen; {ref} lisää vastauksen koodin, jolla löydät vuoron Istunnoista. Tulee voimaan heti. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_STEP_LIMIT` | Virheviesti: tehtävä ei mahtunut yhteen vastaukseen | `text` | — | heti | Jätä tyhjäksi, niin lähetetään sisäänrakennettu viesti henkilön omalla kielellä. Tekstisi lähetetään sellaisenaan, sillä kielellä, jolla kirjoitat sen; {ref} lisää vastauksen koodin, jolla löydät vuoron Istunnoista. Tulee voimaan heti. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_TOO_LONG` | Virheviesti: keskustelu on mallille liian pitkä | `text` | — | heti | Jätä tyhjäksi, niin lähetetään sisäänrakennettu viesti henkilön omalla kielellä. Tekstisi lähetetään sellaisenaan, sillä kielellä, jolla kirjoitat sen; {ref} lisää vastauksen koodin, jolla löydät vuoron Istunnoista. Tulee voimaan heti. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_UNAVAILABLE` | Virheviesti: malli ei ole tilapäisesti käytettävissä | `text` | — | heti | Jätä tyhjäksi, niin lähetetään sisäänrakennettu viesti henkilön omalla kielellä. Tekstisi lähetetään sellaisenaan, sillä kielellä, jolla kirjoitat sen; {ref} lisää vastauksen koodin, jolla löydät vuoron Istunnoista. Tulee voimaan heti. | | `AIHUMMER_CONFIDENTIAL_PERSONA` | Luottamuksellinen verkkohenkilö | `bool` | `0` | heti | Kun se on päällä, verkkokeskusteluagentti ei paljasta tai säilytä henkilö-/identiteettitietojaan ja säilyttää vastaukset käsillä olevaan tehtävään – käytä sitä anonyymeissä tai yksityisyyden kannalta arkaluontoisissa verkkoasetuksissa. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_INBOUND_COALESCE_MS` | Viestien yhdistämisikkuna (ms) | `int` | `500` | heti | Useat viestit, jotka sama henkilö lähettää peräkkäin samaan keskusteluun (lyhyet viestit, valokuva-albumi, nopea korjaus), saavat YHDEN vastauksen, jos niiden välinen tauko on tätä ikkunaa lyhyempi. Vastauksen valmistelun aikana saapuviin viesteihin vastataan heti sen jälkeen, ei koskaan rinnakkain. Oletus 500 ms; 0 = ei odotusta erillisten viestien välillä; valokuva-albumi kootaan silti (tauot enintään 3 s, yhteensä enintään 20 s), jotta se saa yhden vastauksen. Yhdistäminen toimii Telegramissa; Slack, WhatsApp, VK, sähköposti ja muut liittimet, jotka odottavat vastausta jokaiseen viestiin (sekä integraatiot osoitteen /v1/inbound/generic kautta), saavat vastauksen jokaiseen viestiin — edelleen yksi kerrallaan ja järjestyksessä. Tulee voimaan heti. | | `AIHUMMER_INBOUND_EDIT_MODE` | Kun henkilö muokkaa jo vastattua viestiä | `enum: correct \\\| history` | `correct` | heti | correct — botti vastaa uudelleen tietäen, että kyse on korjauksesta (”oli / nyt”); history — muokkaus korjaa vain keskusteluhistorian, uutta vastausta ei tule (kätevä kirjoitusvirheille). Muokkaus viestiin, johon botti ei ole vielä vastannut, korvaa aina vain sen tekstin. Toimii, kun kanava ilmoittaa muokkauksista (Telegram). Tulee voimaan heti. | | `AIHUMMER_INBOUND_QUEUE_MODE` | Viestit, jotka kirjoitetaan agentin työskennellessä | `enum: steer \\\| collect \\\| followup` | `steer` | heti | Mitä tapahtuu viestille, jonka sama henkilö lähettää agentin vielä valmistellessa vastausta (hakiessa, ajaessa työkaluja): steer (oletus) — agentti näkee sen ennen seuraavaa vaihettaan ja huomioi sen samassa vastauksessa; collect — siihen vastataan seuraavalla vastauksella. followup — jokainen tällainen viesti saa vuorollaan oman vastauksensa. Kuvat, tiedostot, vastaukset viestiin ja edelleenlähetykset odottavat aina seuraavaa vastausta. Voimassa heti. | | `AIHUMMER_INBOUND_REQUIRE_BINDING` | Vastaa vain valtuutetuille käyttäjille | `bool` | `true` | heti | true = robotti jättää huomioimatta kanavan lähettäjän, joka on NOT AiHummer-käyttäjä (käyttäjä, jolla on roolisidonna) – satunnaiset chat-jäsenet ja vieraskutsut eivät saa vastausta false (oletus) = vastaa kaikille. | ## Integrations | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_A2A_PUBLISH` | Pgent Agent (A2A) | `bool` | `0` | uudelleenkäynnistyksen jälkeen | Julkaise agentti A2A-palvelimena (Agent Card + POST /a2a/message). Käytetty käynnistettäessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_MCP_EXPORT_TOOLS` | Ulkoisille avustajille avatut työkalut | `multiselect` | — | uudelleenkäynnistyksen jälkeen | Selkeä luettelo ulkoisille MCP-asiakkaille sallituista työkalunimistä pilkuilla erotettuna. Tyhjä = älä julkaise työkaluja. Vaaralliset isäntätason luokat ovat lisäksi kiellettyjä sisäänrakennetulla käytännöllä, vaikka ne olisivat luettelossa. Voimassa käynnistyksen yhteydessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_MCP_PUBLISH` | Julkaise työkaluja yli MCP | `bool` | `0` | uudelleenkäynnistyksen jälkeen | Sallii ulkoisten avustajien (esim. Claude Desktop) käyttää agenttiesi työkaluja. Avattavat työkalut valitaan viereisessä asetuksessa: niin kauan kuin luettelo on tyhjä, yhtään ei avata. | | `AIHUMMER_MODULE_CPU_QUOTA` | Laajennuksen suoritinraja (kullekin) | `text` | `75%` | heti | Kuinka suuren osan suorittimesta kukin laajennus saa käyttää (systemd CPUQuota): 75 % on kolme neljäsosaa yhdestä ytimestä, 150 % puolitoista ydintä. Laajennus saa uuden arvon seuraavassa asennuksessa, päivityksessä tai asetustensa tallennuksessa; siihen asti käynnissä olevat laajennukset toimivat aiemmalla rajalla. | | `AIHUMMER_MODULE_MEMORY_MAX` | Laajennuksen muistiraja (kullekin) | `text` | `512M` | heti | Kuinka paljon muistia kukin laajennus saa käyttää (systemd MemoryMax): koko kuten 512M, 1G tai 2048M (vähintään 64M) tai infinity, jolloin rajaa ei ole. Järjestelmä pysäyttää rajan ylittävän laajennuksen. Laajennus saa uuden arvon seuraavassa asennuksessa, päivityksessä tai asetustensa tallennuksessa; siihen asti käynnissä olevat laajennukset toimivat aiemmalla rajalla. | ## Knowledge connectors | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_KB_SYNC_INTERVAL` | Kuinka usein tietokanta päivitetään lähteistä | `text` | — | heti | Kuinka usein palvelin itse hakee muutokset yhdistetyistä tietokannan lähteistä. Esimerkiksi: 30m — 30 minuutin välein, 6h — 6 tunnin välein. Tyhjä tai 0 — vain käsin. Uudelleenlataus ei luo kaksoiskappaleita. Slack-vienti ladataan käsin. | ## LLM | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AUX_FALLBACK_MODELS` | Palvelutehtävät: varamallit | `list` | — | heti | Pilkulla erotetut mallit, joita kokeillaan järjestyksessä, jos palvelumalli epäonnistuu (kiintiö, häiriö). Päämallia kokeillaan aina viimeisenä, jottei tiivistelmä katoa. Jokainen vaihto kirjataan lokiin. Tulee voimaan heti. | | `AIHUMMER_AUX_MODEL` | Palvelutehtävien malli (tiivistelmät, muistiinpanot, otsikot) | `text` | — | heti | Taustalla ajettavien palvelutehtävien malli: vanhan historian tiivistäminen, muistiinpano ennen tiivistystä, keskustelujen otsikot, faktojen poiminta, hakukyselyjen uudelleenmuotoilu ja käännös. Tyhjä = automaattinen: saman palveluntarjoajan halvempi malli (Claude → claude-haiku-4-5, Codex → gpt-…-luna/mini); jos sellaista ei ole, päämalli. "main" = aina päämalli. Tulee voimaan heti. | | `AIHUMMER_CASCADE_MIN_CHARS` | Caskadi: vähitellen eskaloitavia merkkejä | `int` | `0` | heti | Pyynnön pituuden kynnys (merkkiä), jolla vahvempi kaskadimalli käynnistyy. 0 = oletus. | | `AIHUMMER_CASCADE_STRONG_MODEL` | Kaskadi: vahvempi varamalli | `text` | — | heti | Malli, johon jaksotetaan pitkiä/monimutkaisia ​​pyyntöjä (tyhjä = pois päältä). | | `AIHUMMER_CLAUDE_AUTH_URL` | Claude-tilaus: kirjautumissivun osoite | `text` | — | heti | Sivu, jolla sallit Claude-tilauksen yhdistämisen. Tyhjä — vakio-osoite; muuta vain, jos tuki pyytää. | | `AIHUMMER_CLAUDE_CLIENT_ID` | Claude-tilaus: OAuth-asiakastunnus | `text` | — | heti | Sovelluksen tunniste Claude-tilauksella kirjautumiseen. Tyhjä — vakio; muuta vain, jos tuki pyytää. | | `AIHUMMER_CLAUDE_EFFORT` | Claude: pohdinnan syvyys | `enum: low \\\| medium \\\| high \\\| xhigh \\\| max` | `medium` | heti | Kuinka syvällisesti Claude-mallit pohtivat ennen vastaamista, kun agentti ei sitä määritä. Korkeampi on tarkempi vaikeissa tehtävissä, mutta hitaampi ja kuluttaa enemmän kiintiötä; matalampi on nopeampi ja edullisempi. Malli, joka ei tunne valittua tasoa, saa lähimmän matalamman; Haiku 4.5 ja vanhemmat mallit eivät tue pohdintaa. Agentille asetettu syvyys on etusijalla. Tulee voimaan seuraavasta vuorosta. | | `AIHUMMER_CLAUDE_MAX_TOKENS` | Claude: vastauksen enimmäispituus (tunnisteita) | `int` | `16000` | heti | Montako tunnistetta yksi Clauden vastaus saa viedä — sekä tilauksella että avaimella. Mallin pohdinta lasketaan samaan rajaan: liian pieni arvo katkaisee vastauksen kesken lauseen tai antaa tyhjän vastauksen. Jos agentilla on oma vastauspituus, se on voimassa. | | `AIHUMMER_CLAUDE_REDIRECT_URI` | Claude-tilaus: uudelleenohjaus URI | `text` | — | heti | Toimittajan rekisteröimä palautusosoite. Sen on vastattava sen puolella määritettyä, muuten koodinvaihto hylätään. | | `AIHUMMER_CLAUDE_TOKEN_URL` | Claude-tilaus: käyttöoikeuden osoite | `text` | — | heti | Osoite, josta palvelin hakee ja uusii Claude-tilauksen käyttöoikeuden. Tyhjä — vakio-osoite; muuta vain, jos tuki pyytää. | | `AIHUMMER_CODEX_BASE_URL` | Koodipohja URL | `text` | — | osittain uudelleenkäynnistyksen jälkeen | Codex- (ChatGPT-tilaus) -kuljetuksen perusta. Käytetty käynnistyksen yhteydessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_CODEX_MAX_OUTPUT_TOKENS` | Lähtötunnisteiden enimmäismäärä (0 = ei ylärajaa) | `int` | `0` | heti | Max_output_tokens-raja chat-vuorolle. 0 = ei korkkia. Päättelymalleissa päättelytunnukset lasketaan myös tähän budjettiin, joten liian pieni arvo antaa tyhjän 'incomplete: max_output_tokens' -vastauksen. Käytetään lennossa (ei uudelleenkäynnistystä). | | `AIHUMMER_CODEX_MODEL` | Mallitunnus (Codex / gpt-5.5 transport) | `text` | `gpt-5.5` | osittain uudelleenkäynnistyksen jälkeen | Ensisijaisen Codex/ChatGPT-siirron mallitunnus (esim. gpt-5.5, gpt-5.5-codex). Käytetään käynnistyksen yhteydessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_CODEX_REASONING_EFFORT` | Päättely | `enum: none \\\| low \\\| medium \\\| high \\\| xhigh` | `medium` | heti | Kuinka syvällisesti ChatGPT (Codex) -malli pohtii ennen vastausta, jos agentilla ei ole asetusta. Oletus — ”Keskitaso”. Korkeampi on tarkempi mutta hitaampi ja kalliimpi. | | `AIHUMMER_LLM_CALL_TIMEOUT_S` | Puhelukohtainen aikakatkaisu (sekuntia) | `int` | `120` | heti | Montako sekuntia mallin vastausta odotetaan yhteen pyyntöön. Jos malli vaikenee pidempään, pyyntö katkaistaan ja vastaus siirtyy luettelon seuraavalle mallille. Claudella lasketaan tauko vastausvirrassa, ei koko vastausta: pitkää mutta jatkuvaa vastausta ei katkaista. 0 — ei rajaa. | | `AIHUMMER_LLM_FALLBACK_MODELS` | Varamallit (kaikille agenteille) | `text` | `auto` | heti | Kuka vastaa, kun päämalli ja muut tarjoajat pettävät (käyttöraja täynnä, häiriö, liikaa pyyntöjä). auto — jokaisen tarjoajan edullisempi malli viimeisenä varana (Claude: claude-haiku-4-5, Codex: gpt-…-luna/mini); pilkuin eroteltu luettelo — oma järjestys, kukin malli menee oman valmistajansa tarjoajille; off — ei varamalleja. Agentin oma varamalli menee edelle. Tulee voimaan heti. | | `AIHUMMER_LLM_GATEWAY_URL` | LLM yhdyskäytävä URL | `text` | — | osittain uudelleenkäynnistyksen jälkeen | OpenAI-yhteensopivan mallin päätepisteen URL perusta, jota agentti kutsuu (paikallinen llama.cpp/vLLM/Ollama-palvelin tai isännöity gateway). Jätä tyhjäksi, jos haluat käyttää palveluntarjoajan oletuspäätepistettä. | | `AIHUMMER_LLM_MODEL` | LLM malli | `text` | — | osittain uudelleenkäynnistyksen jälkeen | Mallin nimi/tunnus, joka lähetetään toimittajalle joka käänteessä (malli, jota päätepisteesi palvelee). Sen on vastattava mallia, jonka päätepiste todella paljastaa. | | `AIHUMMER_LLM_PAUSE_AUTH_MIN` | Tauko hylättyjen tunnistetietojen jälkeen, min | `int` | `10` | heti | Montako minuuttia ei kysytä tarjoajalta, joka hylkäsi tunnistetiedot. Jokainen toisto kaksinkertaistaa tauon, enintään kuusinkertaiseksi. Onnistunut yhteystesti tai ”Jatka nyt” -painike palauttaa tarjoajan heti. Tulee voimaan seuraavasta epäonnistumisesta. | | `AIHUMMER_LLM_PAUSE_MODEL_MIN` | Tauko mallille, jota tarjoaja ei palvele, min | `int` | `60` | heti | Montako minuuttia tarjoajalle ei tarjota mallia, jota se kertoi, ettei se palvele; sen muilta malleilta kysytään tavalliseen tapaan. Tulee voimaan seuraavasta epäonnistumisesta. | | `AIHUMMER_LLM_PAUSE_QUOTA_MIN` | Tauko käyttörajan täytyttyä, min | `int` | `300` | heti | Montako minuuttia mallilta (tai koko tililtä, jos tilin raja on täynnä – Codex, OpenAI-avain, maksu) ei kysytä, kun sen käyttöraja on täynnä eikä tarjoaja ilmoittanut nollausaikaa. Jokainen toisto kaksinkertaistaa tauon, enintään vuorokauteen. Tarjoajan ilmoittama aika menee edelle. Tulee voimaan seuraavasta epäonnistumisesta. | | `AIHUMMER_LLM_PAUSE_SHORT_S` | Tarjoajan tauko häiriön jälkeen, s | `int` | `30` | heti | Montako sekuntia tarjoajalta ei kysytä häiriön, katkenneen yhteyden tai ”liian monta pyyntöä” -vastauksen jälkeen. Toinen peräkkäinen epäonnistuminen kaksinkertaistaa tauon, kolmas ja sitä seuraavat kymmenkertaistavat sen. Jos tarjoaja itse ilmoittaa ajan, odotetaan sitä. Tulee voimaan seuraavasta epäonnistumisesta. | | `AIHUMMER_LLM_PROVIDER` | LLM palveluntarjoaja | `text` | — | osittain uudelleenkäynnistyksen jälkeen | Mitä taustajärjestelmää käytetään (OpenAI-yhteensopiva päätepiste vai Codex/ChatGPT-tilauskuljetus). Päättää, kuinka pyynnöt lähetetään ja todennetaan. | | `AIHUMMER_LLM_RETRIES` | LLM yrittää uudelleen ohimenevää virhettä | `int` | `3` | heti | LLM-pyyntöjen uudelleenyritysten lukumäärä ohimenevän virheen vuoksi. | | `AIHUMMER_LLM_TEMPERATURE` | Lämpötila | `text` | — | heti | Kuinka vaihtelevasti malli vastaa (0–2), jos agentilla ei ole asetusta: pienempi on tarkempi ja ennustettavampi, suurempi eloisampi. Tyhjä — malli päättää. Päättelevät mallit (ChatGPT/Codex, Clauden 5. sukupolvi) eivät hyväksy tätä — jätä kenttä niille tyhjäksi. | | `AIHUMMER_LLM_TOP_P` | Top-p (ytimen näytteenotto) | `text` | — | heti | Toinen tapa monipuolistaa vastauksia (0–1), jos agentilla ei ole asetusta. Tyhjä — malli päättää. Yleensä asetetaan vain toinen: lämpötila tai tämä; päättelevät mallit eivät hyväksy tätä. | | `AIHUMMER_MODEL_GUARD_INTERVAL_MIN` | Agentin mallin tarkistus: väli, min | `int` | `60` | heti | Kuinka usein tarkistetaan, että jokaisen agentin mallia tarjoaa jokin käytössä oleva palveluntarjoaja. Agentin mallia ei koskaan muuteta: niin kauan kuin kukaan ei tarjoa sitä, vastaa vastausjärjestyksen ensimmäinen malli, joka ei ole tauolla, ja ilmoitus nimeää agentit — sekä toinen, kun niiden malli palaa. Tarkistus tehdään aina yhdyskäytävän käynnistyessä, ja 0 poistaa käytöstä vain toiston. Uusi väli tulee voimaan minuutin kuluessa. | | `AIHUMMER_OPENAI_API` | OpenAI API -tyyli (keskustelu \| vastaukset) | `enum: \\\| chat \\\| responses` | — | osittain uudelleenkäynnistyksen jälkeen | chat = /chat/completions, responses = /responses. Tyhjä = automaattinen/oletus. Käytetty käynnistyksen yhteydessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_OPENAI_API_KEY` | Alkuperäinen OpenAI API avain (käytön oletusarvo) | `text` | — | osittain uudelleenkäynnistyksen jälkeen | OpenAI-tilisi avaimesi alkuperäistä OpenAI-silmukkaa varten (jos käytät OpenAI:ta oletuspalveluntarjoajana). Ei pidä sekoittaa työtilakohtaiseen BYOK Mallit-sivulla. Käytetty käynnistettäessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_OPENAI_BASE_URL` | Natiivi OpenAI-kanta URL | `text` | — | uudelleenkäynnistyksen jälkeen | OpenAI-yhteensopivan API-perus (esim. https://api.openai.com/v1). Käynnistetään käynnistettäessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_OPENAI_MODEL` | Natiivi OpenAI-malli | `text` | — | uudelleenkäynnistyksen jälkeen | Natiivin OpenAI-silmukan malli (kun AIHUMMER_OPENAI_API_KEY on asetettu). Käytetään käynnistyksen yhteydessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_ROUTER_COMPLEX_MODEL` | Reititin: malli monimutkaisille käännöksille | `text` | — | heti | Malli monimutkaisiin pyyntöihin agentille, jolla ei ole omaa mallia (tyhjä = taso pois päältä). Tulee voimaan seuraavasta vuorosta. | | `AIHUMMER_ROUTER_SIMPLE_MODEL` | Reititin: malli yksinkertaisiin käännöksiin | `text` | — | heti | Malli yksinkertaisiin pyyntöihin agentille, jolla ei ole omaa mallia (tyhjä = taso pois päältä). Tulee voimaan seuraavasta vuorosta. | | `AIHUMMER_ROUTER_STANDARD_MODEL` | Reititin: malli vakiokäännöksille | `text` | — | heti | Malli tavallisiin pyyntöihin agentille, jolla ei ole omaa mallia (tyhjä = taso pois päältä). Tulee voimaan seuraavasta vuorosta. | | `AIHUMMER_SUBSCRIPTION_QUOTA_REFRESH_MIN` | Tilausten kiintiöt: kyselyväli, min | `int` | `15` | heti | Kuinka usein paneeli kysyy ChatGPT:ltä (Codex) tilauksen kiintiöikkunat: enintään kerran jaksossa, ei useammin kuin 5 minuutin välein ja vain kun kiintiöt ovat auki; välillä näytetään tallennettu kopio. Claudelta ei kysytä koskaan: sen rajat ovat arviomme. Tulee voimaan, kun kiintiöt avataan seuraavan kerran. | ## Media | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_DEEPGRAM_API_KEY` | Deepgram-avain API | `text` | — | heti | Deepgram-palvelun avain — tarvitaan, jos Deepgram tunnistaa ääniviestit. Jos tyhjä, käytetään viereisen asetuksen yhteistä puheentunnistusavainta. Tulee voimaan heti. | | `AIHUMMER_DEEPGRAM_DETECT_LANGUAGE` | Deepgramin kielentunnistus | `bool` | `0` | heti | Tunnista kieli kiinteän kielen lähettämisen sijaan. Tulee voimaan heti. | | `AIHUMMER_DEEPGRAM_MODEL` | Deepgram-malli | `text` | `nova-2` | heti | Deepgram-malli (esim. nova-2, nova-3, base). Riippuu projektin pääsystä avaimeen. Tulee voimaan heti. | | `AIHUMMER_DEEPGRAM_PUNCTUATE` | Deepgramin välimerkit | `bool` | `1` | heti | Lisää välimerkit ja isot alkukirjaimet. Tulee voimaan heti. | | `AIHUMMER_DEEPGRAM_SMART_FORMAT` | Deepgramin älykäs muotoilu | `bool` | `1` | heti | Muotoile tunnistetut luvut ja päivämäärät. Tulee voimaan heti. | | `AIHUMMER_DEEPGRAM_URL` | Deepgram-kanta URL | `text` | — | heti | Deepgram API -kanta. Tyhjä = https://api.deepgram.com. Tulee voimaan heti. | | `AIHUMMER_IMAGE_BASE_URL` | Kuvan API kanta URL (OpenAI-vara) | `text` | — | heti | /images-pohja API käytettäessä OpenAI-avainta (tyhjä = https://api.openai.com/v1). | | `AIHUMMER_IMAGE_MODEL` | Kuvanluontimalli | `text` | — | heti | image_generate-työkalun malli (oletus gpt-image-2). | | `AIHUMMER_MEDIA_MAX_UPLOAD_MB` | Media suurin lähetyskoko (Mt) | `int` | `256` | heti | Suurin tiedosto (kuva, ääniviesti, video), jonka voi ladata kerralla, megatavuina. Suojaa palvelimen levyä täyttymiseltä. Oletus 256. Tulee voimaan heti. | | `AIHUMMER_SIDECAR_STT` | Puheentunnistus tällä palvelimella (faster-whisper) | `bool` | `0` | heti | Paikallinen puheentunnistus (faster-whisper). EI sisälly pakettiin: enable lataa allekirjoitetun lisäosan (~620 MiB kaikille Python-versioille) ja asentaa palvelun isäntään. 🔴 Lisäosa julkaistaan ​​erillisellä toimittajan päätöksellä (sen paketeissa on ffmpeg GPL:n alaisuudessa); jos sitä ei julkaista sinun julkaisuasi varten, se on myös rehellinen eikä riko mitään. Pilvipaketti: palveluntarjoaja määrittää tunnistuksen. | | `AIHUMMER_SIDECAR_TTS` | Vastausten puhe (edge-tts) | `bool` | `0` | heti | Puhesynteesi (edge-tts, äänet Microsoft Edge). EI sisälly pakettiin: käyttöönotto lataa allekirjoitetun lisäosan (~26 MiB) ja asentaa palvelun isäntään. Itse synteesi menee online-äänestykseen - "offline" tarkoittaa tässä paketin asentamista, ei toimimista. | | `AIHUMMER_STT_API_KEY` | STT API avain (valinnainen) | `text` | — | heti | Puheentunnistuspalvelun käyttöavain, jos palvelu sitä vaatii. Tämän palvelimen palvelulle asennusohjelma asettaa sen — sitä ei tarvitse muuttaa. Tulee voimaan heti. | | `AIHUMMER_STT_ENGINE` | STT moottori | `enum: auto \\\| faster-whisper \\\| deepgram \\\| codex \\\| off` | `auto` | heti | Millä ääniviestit litteroidaan. Automaattinen (oletus): Deepgram, jos sen avain on asetettu, muuten paikallinen palvelu, jos se on asennettu (kytkin yllä), muuten ei millään – ja botti kertoo lähettäjälle rehellisesti, ettei se vielä voi kuunnella. faster-whisper: paikallinen palvelu tai yhteensopiva ulkoinen /v1/audio/transcriptions. deepgram: pilvi-Deepgram omalla avaimella. codex: yhdistetty ChatGPT-tilaus (Mallit → Yhdistä ChatGPT), kuluttaa sen kiintiötä. off: älä litteroi. Tulee voimaan heti. | | `AIHUMMER_STT_LANGUAGE` | STT kieli | `text` | — | heti | Tunnistamiskieli (BCP-47, esim. ru/en). Deepgram-moottorin käyttämä (nova-2 malli). Tyhjä = automaattinen tunnistus / moottorin oletusarvo. Tulee voimaan heti. | | `AIHUMMER_STT_MODEL` | STT malli | `text` | `Systran/faster-whisper-small` | heti | nopeampi kuiskausmalli (esim. pieni/medium/large-v3 tai Systran/faster-whisper-⟨size⟩). Tulee voimaan heti. | | `AIHUMMER_TTS_API_KEY` | TTS API avain (edge-tts) | `text` | — | osittain uudelleenkäynnistyksen jälkeen | Puhepalvelun käyttöavain. Asetetaan automaattisesti asennuksessa — sitä ei tarvitse muuttaa. | | `AIHUMMER_TTS_ENABLED` | Tekstistä käyttöön | `bool` | `1` | osittain uudelleenkäynnistyksen jälkeen | Sallii agentin vastata äänellä. Tähän tarvitaan puhepalvelu — asenna se yllä osiossa Lisäpalvelut. | | `AIHUMMER_TTS_MODEL` | TTS malli | `text` | — | osittain uudelleenkäynnistyksen jälkeen | Edge-tts-palvelun mallinimi. Käytetään käynnistettäessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_TTS_VOICE` | TTS ääni | `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` | osittain uudelleenkäynnistyksen jälkeen | Oletusarvoinen edge-tts-ääni (monikielinen, myös venäjä). Käytetään käynnistyksen yhteydessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_VIDEO_API_KEY` | Video-analyysin API-avain | `text` | — | heti | Videoanalyysipalvelun käyttöavain, jos palvelu sitä vaatii. Tyhjä — palvelua käytetään ilman avainta. | ## Media · Voice | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_TTS_AUTO_REPLY` | Automaattiset puhevastaukset | `enum: off \\\| always \\\| inbound \\\| tagged` | `inbound` | heti | Pois, aina, saapuvaan ääniviestiin tai erillisellä merkinnällä. Asetuksen voi ohittaa keskustelukohtaisesti. | | `AIHUMMER_TTS_MAX_CHARS` | Puhevastauksen merkkiraja | `int` | `0` | heti | 0: koko teksti; 100–10000: luettavan tekstin raja. Koko vastaus säilyy historiassa. | | `AIHUMMER_TTS_SUMMARIZE` | Pitkien puhevastausten tiivistäminen | `bool` | `1` | heti | Tiivistä pitkät vastaukset puhetta varten. Virhetilanteessa lue alku annetun rajan sisällä. | | `AIHUMMER_VOICE_AEC` | Kaiunvaimennus (AEC) | `bool` | `1` | heti | Poistaa kaiun: agentin oma ääni kaiuttimesta ei palaa mikrofoniin eikä keskeytä keskustelua. Kytke pois vain, jos ääni kuulostaa kuulokkeissa vääristyneeltä. | | `AIHUMMER_VOICE_AGC` | Automaattinen vahvistuksen säätö | `bool` | `1` | heti | Vaadi mikrofonin automaattista vahvistuksensäätöä (WebRTC autoGainControl) puhetilassa. | | `AIHUMMER_VOICE_BARGEIN_FRAMES` | Agentin keskeyttäminen: kuinka kauan puhua | `int` | `5` | heti | Kuinka kauan pitää puhua (20 ms:n kehyksinä), jotta agentti vaikenee ja alkaa kuunnella. Oletus 5 — noin 0,1 sekuntia. | | `AIHUMMER_VOICE_DUPLEX` | Elävä kaksisuuntainen ääni | `bool` | `0` | heti | Mahdollistaa suoran kaksisuuntaisen tilan (suoratoisto + VAD + sisääntulo). Tulee voimaan heti. | | `AIHUMMER_VOICE_NOISE_SUPPRESSION` | Melun vaimennus | `bool` | `1` | heti | Vaadi kohinanvaimennusta mikrofonin tallennuksessa (WebRTC noiseSuppression) puhetilassa. | | `AIHUMMER_VOICE_VAD_THRESHOLD` | Äänen herkkyys (0–1) | `text` | `0.02` | heti | Kuinka kovan äänen on oltava, jotta se lasketaan puheeksi. Pienempi — herkempi: agentti kuulee hiljaisen puheen, mutta myös taustamelun. Oletus 0.02. | ## Memory | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_EMBEDDER_DIM` | Merkityshaun mallin ulottuvuus | `int` | `768` | uudelleenkäynnistyksen jälkeen | Vektorin ulottuvuus – täytyy vastata mallia (multilingual-e5-base=768, bge-m3=1024). | | `AIHUMMER_EMBEDDER_KEEPALIVE` | Upotus pysyy elossa | `text` | `5m` | uudelleenkäynnistyksen jälkeen | Kuinka kauan merkityshaun malli pysyy ladattuna viimeisen pyynnön jälkeen (vain tilassa ”Merkityksen mukaan”). Oletus 5m — 5 minuuttia: sen jälkeen malli poistetaan muistista ja se vapauttaa muistin ja prosessorin. Pitämistä aina (-1) ei suositella: jumiutunut malli voi varata prosessoriytimen päiväkausia. Muoto: 30s, 5m, 1h. | | `AIHUMMER_EMBEDDER_MODEL` | Merkityshaun malli | `text` | `yxchia/multilingual-e5-base` | uudelleenkäynnistyksen jälkeen | Malli, jolla muistista haetaan merkityksen mukaan. Oletus multilingual-e5-base ymmärtää venäjää, on kevyt ja toimii nopeasti tavallisella prosessorilla. Parempaan laatuun näytönohjaimella sopii bge-m3, mutta aseta silloin viereiseen ulottuvuusasetukseen 1024: luvun on vastattava mallia. | | `AIHUMMER_EMBEDDER_PASSAGE_PREFIX` | Upotuskanavan etuliite | `text` | — | uudelleenkäynnistyksen jälkeen | Ohita tallennetun asiakirjan etuliite (e5-mallit käyttävät automaattisesti "passage:"). Jätä tyhjäksi, jos haluat tunnistaa automaattisesti mallin nimen perusteella. | | `AIHUMMER_EMBEDDER_QUERY_PREFIX` | Upotuskyselyn etuliite | `text` | — | uudelleenkäynnistyksen jälkeen | Ohita hakukyselyn etuliite (e5-mallit käyttävät automaattisesti "kyselyä"). Jätä tyhjäksi, jos haluat tunnistaa automaattisesti mallin nimen perusteella. | | `AIHUMMER_EMBEDDER_THREADS` | Upotusmallin suoritinsäikeet | `int 0…256` | `0` | uudelleenkäynnistyksen jälkeen | Kuinka monta suoritinsäiettä merkityshaun malli käyttää pyyntöä kohden. 0 — automaattinen: puolet palvelimen säikeistä, mutta vähintään 2. Ilman rajaa tietopankin vektorien uudelleenlaskenta heikolla palvelimella vei koko suorittimen tuntikausiksi ja hidasti agenttien vastauksia. Enemmän — nopeampi uudelleenlaskenta, mutta raskaampi kuorma. | | `AIHUMMER_MEMORY_AGENT_WRITES` | Agentin itse tallentamat faktat | `enum: strangers \\\| immediate \\\| review` | `strangers` | heti | Mitä tapahtuu sille, minkä agentti muistaa itse — esimerkiksi pyynnöstä ”muista tämä”. ”Suoraan muistiin; vierailta — tarkistettavaksi” (oletus) — suoraan muistiin, jos sen sanoi omistaja tai agentin luotettu piiri; muilta — tarkistettavaksi. ”Suoraan muistiin” — agentti löytää sen heti. ”Tarkistettavaksi” — ensin jonoon Muisti → tarkistus; vastauksiin vasta hyväksyntäsi jälkeen. Agentin kortilla (Muisti → Asetukset) voi valita oman tilan. | | `AIHUMMER_MEMORY_AUTOREPAIR` | Muistin automaattinen korjaus | `bool` | `1` | heti | Itsetarkistuksen jälkeen muisti korjataan: kaksoiskappaleet yhdistetään, ristiriidat, joilla on selvä voittaja, suljetaan (ihmisen vahvistama, myöhempi tapahtumapäivä, painavampi lähde), vahvistetuiksi merkityt tosiasiat, joita kukaan ihminen ei ole vahvistanut, tarkistetaan lähteitään vasten (vahvistamattomat menevät tarkistettaviksi, mitään ei poisteta). Kiistanalainen menee vain jonoon. Jokainen korjaus kirjataan kumoamispainikkeen kanssa; jos muisti löytää ajon jälkeen huonommin, ajo kumoaa itsensä ja saat ilmoituksen. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MEMORY_CAPTURE` | Muistin kaappaustila | `enum: auto \\\| review \\\| off` | `review` | heti | Mitä tehdään faktoille, jotka agentti itse huomaa keskustelussa jokaisen vastauksen jälkeen. ”Tarkistettavaksi” vie ne jonoon Muisti → tarkistus: vastauksiin ne päätyvät vasta hyväksyntäsi jälkeen. ”Suoraan muistiin” ilman tarkistusta: nopeampi, mutta enemmän turhaa. ”Älä tallenna” ei poimi keskusteluista mitään. Pyynnöstä muistettavat asiat säädetään erikseen. | | `AIHUMMER_MEMORY_CONTEXT_TIMEOUT` | Muistin hydratoinnin aikakatkaisu | `text` | `3s` | heti | Kuinka kauan agentti odottaa sopivia muistoja ennen vastaamisen aloittamista. Jos haku ei ehdi, agentti vastaa ilman niitä jumittumatta. Esimerkiksi: 2s — 2 sekuntia, 1500ms — 1,5 sekuntia. 0 — odota niin kauan kuin tarvitaan. | | `AIHUMMER_MEMORY_DIARY_BOOT` | Agentin päiväkirja istunnon alussa | `bool` | `1` | heti | Pidä agentin tämän päivän ja eilisen päiväkirja näkyvillä istunnon jokaisella vuorolla millä tahansa kanavalla: aiempien istuntojen muistiinpanot, yöllinen yhteenveto ja agentin omat merkinnät. Näytetään vain merkinnät nykyisestä keskustelukumppanista ja yhteiset (sinun, ladatut) — yksi asiakas ei koskaan näe toisen merkintöjä. Enintään ~6000 merkkiä; loput agentti lukee itse (memory_get). Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MEMORY_DIARY_HOUR` | Yöllisen yhteenvedon tunti | `int` | `3` | heti | Minkä tunnin jälkeen (0–23, instanssin aikavyöhykkeellä) edellisen päivän yhteenveto kirjoitetaan. Oletus 3 — yöllä, kun päivän keskustelut ovat ohi. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MEMORY_DIARY_NIGHTLY` | Yöllinen päivän yhteenveto agentin päiväkirjaan | `bool` | `1` | heti | Kerran vuorokaudessa kirjoitetaan agentin päiväkirjaan yhteenveto edellisestä päivästä — erikseen jokaisesta henkilöstä, jonka kanssa se keskusteli (henkilön kaikki kanavat yhdessä): mitä pyydettiin ja tehtiin, sopimukset, päivämäärälliset tehtävät. Yksi palvelutehtävien mallin kutsu agenttia ja henkilöä kohden, enintään 3 ajoa kohden 10 minuutin välein; väliin jääneet päivät kurotaan kiinni enintään viikon ajalta. Keskustelut, joissa pyydettiin ”älä muista”, ohitetaan. Ei kirjoiteta, kun muistin keruu on pois päältä. Viimeisimmän ajon tulos näkyy agentin kortissa → Muisti → Päiväkirja. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MEMORY_DREAM_INTERVAL` | Unelmaväli | `string` | `1h` | heti | Kuinka usein itseään ylläpitävä unelmapassi tarkistaa tarkistetut väitteet ristiriitaisuuksien varalta kaikilla aloilla (Käytön kesto, esim. 30m/1t/6h). Aseta 0 poistaaksesi käytöstä. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MEMORY_EXTRACT` | LLM tosiasian poiminta | `bool` | `1` | heti | Pura normalisoidut aihe-/predikaatti-/objekti-faktaat LLM-komennolla (oletus PÄÄLLÄ) sen sijaan, että tallennat raakoja lauseenpätkiä – tarvitaan kaavio-/ristiriita-/unelmakoneiston käynnistymiseen. Lisää yhden LLM puhelun per kaapattu viesti; lähti tallentamaan puhelun. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MEMORY_MEANING_TIMEOUT` | Merkityshaun aikaraja | `text` | `4s` | heti | Kuinka kauan haku muistista ja tietokannasta odottaa merkityshakua. Jos merkitysmalli on varattu (esimerkiksi laskee vektoreita tuonnin jälkeen) eikä vastaa ajoissa, agentti saa heti sanoilla löydetyt tulokset merkinnän kera eikä odota kymmeniä sekunteja. Esimerkiksi: 4s — 4 sekuntia, 1500ms — 1,5 sekuntia. 0 — odota niin kauan kuin tarvitaan. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MEMORY_QUALITY_CHECK` | Muistin päivittäinen itsetarkistus | `bool` | `1` | heti | Kerran vuorokaudessa muisti esittää itselleen tarkistuskysymyksiä vahvistetuista tosiasioistaan (enintään 60 tosiasiaa, joka päivä samat kysymykset) sekä kysymyksiä, joihin ei ole vastausta, ajaa ne muistihaun ja automaattisen muistuttamisen läpi ja mittaa löytöosuuden, tarkkuuden, MRR:n ja väärät muistutukset. Tulos ja päiväkohtainen kaavio: Muisti → Muistin laatu. Uusien tosiasioiden kysymykset kirjoittaa kerran palvelumalli (sama, joka poimii tosiasiat keskusteluista; ilman sitä mallipohjalla); tulokset jäävät instanssiin. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MEMORY_RECALL` | Muistin automaattinen palautus | `enum: strong \\\| always \\\| off` | `strong` | heti | Lisätäänkö muistista löytynyt vastaukseen automaattisesti. ”Vain vahvat osumat” — faktin on jaettava viestin kanssa vähintään kaksi tärkeää sanaa; tervehdykset ja ”ok” eivät tuo mitään. ”Kaikki samankaltainen” — kaikki jollain tavalla osunut sekä linkitetyt merkinnät: enemmän turhaa. ”Älä lisää” — agentti hakee muistista itse, kun katsoo tarpeelliseksi. | | `AIHUMMER_MEMORY_RECALL_MAX` | Faktoja vastausta kohden | `int` | `5` | heti | Yhteen vastaukseen lisättävien muistifaktojen enimmäismäärä (oletus 5). Saman faktan uudelleenmuotoilut lasketaan yhdeksi. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MEMORY_RECALL_MIN_SCORE` | Automaattisen palautuksen vähimmäisosuma, % | `int` | `10` | heti | Kuinka suuren osan viestin merkitsevistä sanoista (harvinaisuudella painotettuna) faktan on katettava, jotta se lisätään automaattisesti, prosentteina. Oletus 10 – säädetty oikeiden keskustelujen perusteella. Suurempi = harvemmin ja tarkemmin, pienempi = useammin ja kohinaisemmin. Ei vaikuta erilliseen memory_search-hakuun. 0 = ei kynnystä: kaksi täsmäävää merkityksellistä sanaa riittää. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MEMORY_RECALL_MIN_SIMILARITY` | Automaattisen lisäyksen merkityksen vähimmäissamankaltaisuus, % | `int` | `86` | heti | Vain muistin haulle merkityksen mukaan (embedder): kuinka lähellä viestiä merkitykseltään faktan on oltava, jotta se lisätään automaattisesti, samankaltaisuusprosenttina. Oletus 86 — valittu mallille multilingual-e5-base oikean muistin perusteella: sen alapuolella asiaankuulumattomia faktoja lisätään lähes jokaiseen viestiin. Muut mallit (esim. bge-m3) mittaavat samankaltaisuutta eri tavalla — valitse arvo agenttikortin ”Kysy muistilta” -toiminnolla. 0 = ei kynnystä. Ei vaikuta suoraan memory_search-hakuun. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MEMORY_RETRIEVAL` | Muistin hakutila | `enum: fulltext \\\| embedding` | `fulltext` | uudelleenkäynnistyksen jälkeen | Miten agentti etsii muistista. ”Sanojen mukaan” on tavallinen tekstihaku: toimii heti eikä kuormita palvelinta. ”Merkityksen mukaan” löytää merkitykseltään läheisen, vaikka se olisi sanottu toisin, mutta vaatii merkityshaun mallin (osio Lisäpalvelut) ja tuntuvaa prosessorikuormaa. | | `AIHUMMER_QDRANT_API_KEY` | Qdrant API avain | `text` | — | uudelleenkäynnistyksen jälkeen | Qdrantin API-avain, jos vektorivarasto vaatii valtuutuksen. Tarvitaan vain, kun Qdrantin osoite on määritetty. Käytetään käynnistettäessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_QDRANT_URL` | Qdrant URL (kestävä vektorivarasto) | `text` | — | uudelleenkäynnistyksen jälkeen | Merkityshaun Qdrant-varaston osoite. Tyhjä — hakutiedot pidetään muistissa ja ne katoavat palvelimen uudelleenkäynnistyksessä; anna osoite pysyvää käyttöä varten. | | `AIHUMMER_RAG_QUERY_EXPANSION` | Muotoile tietokantahaut uudelleen mallilla | `bool` | `0` | heti | Ennen tietokantahakua pyydetään palvelutehtävien mallilta 3 uudelleenmuotoilua ja haetaan niillä kaikilla. Löytää joskus enemmän, mutta se on ylimääräinen mallikutsu JOKAISESSA haussa (kiintiö ja viive); jos malli epäonnistuu, haetaan vain alkuperäisellä muotoilulla ja virhe näkyy lokissa ja hakutuloksessa. Oletuksena pois: sanat löytyvät muutenkin kokotekstihaulla. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_RERANKER_URL` | RAG reranker sivuvaunu URL | `text` | — | uudelleenkäynnistyksen jälkeen | HTTP URL ristiinkooderin sivuvaunusta hybridihaun uudelleensijoittamiseen. Tyhjä = uudelleensijoitus pois. Käytetty käynnistyksen yhteydessä/uudelleenkäynnistyksen jälkeen. | ## Moderation | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_MODERATION` | Syötteen valvonta | `bool` | `1` | heti | "off" poistaa käytöstä sisäänrakennetun suojauksen jailbreak/prompt-injection-hyökkäyksiltä. Mikä tahansa muu arvo = käytössä. Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | | `AIHUMMER_MODERATION_REFUSAL` | Moderoinnin hylkäysviesti | `text` | — | heti | Kieltäytymisteksti, joka palautetaan, kun moderaattori estää pyynnön (tyhjä = sisäänrakennettu). Tulee voimaan heti, uudelleenkäynnistystä ei tarvita. | ## Network | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OUTBOUND_PROXY_CUSTOM_URL` | Lähtevä välityspalvelin: oma osoite | `text` | — | heti | HTTPS-välityspalvelimen URL; HTTP sallitaan vain loopback-osoitteessa ilman polkua, kyselyä tai fragmenttia. Tallenna osoite ennen custom-valintaa. API:ssa peitetty; tallennettu sovelluksen asetuksiin. | | `AIHUMMER_OUTBOUND_PROXY_MODE` | Lähtevä välityspalvelin ulkomaisille mallipalveluntarjoajille | `enum: auto \\\| off \\\| custom` | `auto` | heti | Miten palvelin tavoittaa ulkomaiset mallipalveluntarjoajat. ”Kuten palveluntarjoajalla” — kuten palveluntarjoajan tilillä on määritetty; ”Suoraan, ilman välityspalvelinta” — ilman välikäsiä; ”Oman välityspalvelimen kautta” — alle tallentamasi osoitteen kautta. Toimivuus riippuu kunkin palveluntarjoajan säännöistä. | | `AIHUMMER_RUSSIAN_TRUSTED_EXTRA_HOSTS` | .ru-verkkotunnuksen ulkopuoliset isännät Venäjän digitaalisen kehityksen ministeriön juurivarmenteille | `list` | — | uudelleenkäynnistyksen jälkeen | Luettelo isännistä, pilkuilla erotettuna, jotka voidaan tarkistaa Venäjän digitaalisen kehityksen ministeriön OVER venäläisten verkkotunnusten juurilla (.ru/.su/.рф - jo mukana). Tarvitaan, jos solmu, jolla on Venäjän digitaalisen kehityksen ministeriön-sertifikaatti, asuu eri toimialueella. Vastaa nimen tai aliverkkotunnuksen rajalla: example.com kattaa api.example.com-sivuston. Tyhjä = vain venäläiset verkkotunnukset. Voimassa käynnistyksen yhteydessä/uudelleenkäynnistyksen jälkeen. | ## Performance | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_TURN_QUEUE_WAIT_SEC` | Jonotusaika: kanavaviesti (sekuntia) | `int 10…1200` | `600` | heti | Kuinka kauan kanavaviesti (Telegram ja muut) odottaa vapaata paikkaa, kun kaikki vuorojen paikat ovat varattuina. Jos se ei saa paikkaa ajoissa, käyttäjälle kerrotaan, että palvelin on varattu ja hän voi kirjoittaa uudelleen. Odotus lasketaan vuoron 30 minuutin rajaan. 10–1200. Tulee voimaan heti. | | `AIHUMMER_MAX_ACTIVE_TURNS` | Samanaikaiset agenttien vuorot (koko palvelin) | `int 1…512` | `32` | heti | Kuinka monta agenttien vuoroa (vastaukset kanavissa ja verkkochatissa, ajastukset) palvelin suorittaa kerralla. Muut odottavat jonossa niin kauan kuin alla olevat ”Jonotusaika”-asetukset sallivat, ja käyttäjä näkee ”palvelin varattu, jonossa”. Suurempi arvo vähentää odotusta, mutta vie enemmän muistia, tietokantayhteyksiä ja samanaikaisia mallipyyntöjä. Puolet tästä luvusta rajaa mallin samanaikaisia apukutsuja (muistin poiminta, tiivistelmät). 1–512. Tulee voimaan heti. | | `AIHUMMER_SYNC_INBOUND_QUEUE_WAIT_SEC` | Jonotusaika: synkroninen integraatiokutsu (sekuntia) | `int 1…120` | `10` | heti | Kuinka kauan vastausta samassa pyynnössä odottavan integraation kutsu odottaa vapaata paikkaa, kun kaikki vuorojen paikat ovat varattuina. Jos se ei saa paikkaa, integraatio saa vastauksen ”palvelin varattu” ja neuvon yrittää uudelleen saman sekuntimäärän kuluttua; uusintayritys samalla viestinumerolla ei tallenna viestiä kahdesti. 1–120. Tulee voimaan heti. | | `AIHUMMER_WEB_TURN_QUEUE_WAIT_SEC` | Jonotusaika: verkkochatin viesti (sekuntia) | `int 10…1200` | `180` | heti | Kuinka kauan verkkochatin viesti odottaa vapaata paikkaa, kun kaikki vuorojen paikat ovat varattuina. Sillä aikaa chatissa näkyy ”palvelin varattu, jonossa”; jos se ei saa paikkaa ajoissa, vastaus hylätään ”Yritä uudelleen” -painikkeella, joka jää historiaan myös sivun uudelleenlatauksen jälkeen. 10–1200. Tulee voimaan heti. | ## Public access | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PUBLIC_URL` | Palvelimen julkinen osoite | `text` | — | osittain uudelleenkäynnistyksen jälkeen | Osoite, josta paneeli ja sovellukset avautuvat internetistä, esim. https://ai.example.com. Ohjaa se välityspalvelimesi (nginx, Caddy) kautta palvelimen porttiin — oletuksena 8780. | | `AIHUMMER_WIDGET_ALLOWED_ORIGINS` | Verkkowidget: sallitut sivustojen alkuperät | `list` | — | heti | Pilkuilla erotettu luettelo selaimen alkuperistä, joilla on lupa upottaa verkkokeskusteluwidget, esimerkiksi https://example.com,https://www.example.com. Protokollan ja portin on vastattava täsmälleen. Tyhjä = mikään ulkoinen sivusto ei voi käyttää widgetiä. Merkintä `*` ohitetaan tarkoituksella, koska muuten mikä tahansa internet-sivu voisi kuluttaa tämän instanssin budjettia. | | `POCKET_AGENT_GATEWAY_BASE_URL` | Pocket-agent gateway julkinen URL | `text` | — | heti | Välityspalvelin → taskuagentin yhdyskäytävän portti (POCKET_AGENT_PORT, oletusarvo 8080). Etäagentti soittaa tämän kertalipun kautta. | | `TELEGRAM_PUBLIC_URL` | Telegram-verkkohook julkinen URL | `text` | — | heti | Vain verkkokoukkutila – välityspalvelin → sähkeliitinportti (oletusarvo 8091). Jätä tyhjäksi, jos haluat käyttää kyselyä (julkista URL ei tarvita). | ## SSO (LDAP/AD) | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LDAP_BASE_DN` | Käyttäjän hakukanta DN | `text` | — | uudelleenkäynnistyksen jälkeen | Hae juuresta, esim. OU=Users,DC=corp,DC=example. | | `AIHUMMER_LDAP_BIND_DN` | Palvelutilin bind-DN | `text` | — | uudelleenkäynnistyksen jälkeen | Alkuperäiseen hakusidontaan käytetty tili, esim. CN=svc-aihummer,OU=Palvelu,DC=yritys,DC=esimerkki. Tyhjä = anonyymi haku. | | `AIHUMMER_LDAP_DEFAULT_ROLE` | LDAP: Oletusrooli (ei ryhmäosumaa) | `text` | — | uudelleenkäynnistyksen jälkeen | Rooli myönnetään, kun mikään ryhmä ei vastaa kartoitusta. Tyhjä = ei roolia. | | `AIHUMMER_LDAP_ENABLED` | Ota käyttöön LDAP/AD-kirjautuminen | `bool` | `0` | uudelleenkäynnistyksen jälkeen | Kun päällä, järjestelmänvalvojan kirjautumiset palaavat hakemistoon. Sidossalasana on kohdassa Secrets (scope ldap, nimi bind_password). | | `AIHUMMER_LDAP_GROUP_ATTR` | Ryhmämäärite (oletus MemberOf) | `text` | — | uudelleenkäynnistyksen jälkeen | Attribuutti käyttäjämerkintöjen luettelossa DNs. Tyhjä poistaa ryhmä→roolikartoituksen käytöstä. | | `AIHUMMER_LDAP_ROLE_MAPPINGS` | LDAP: Ryhmä→roolikartoitukset (JSON) | `text` | — | uudelleenkäynnistyksen jälkeen | JSON ryhmän DN objekti (tai paljas CN) → rooli, esim. {"CN=Admins,OU=Groups,DC=corp,DC=example":"admin","Operators":"operator"}. | | `AIHUMMER_LDAP_SKIP_TLS_VERIFY` | Ohita TLS vahvistus (vain lab, 1/0) | `bool` | `0` | uudelleenkäynnistyksen jälkeen | Poistaa hakemistovarmenteen vahvistuksen käytöstä. Älä koskaan ota käyttöön tuotannossa. | | `AIHUMMER_LDAP_URL` | Hakemisto URL | `text` | — | uudelleenkäynnistyksen jälkeen | esim. ldaps://ad.corp.example:636 (TLS) tai ldap://dc1.corp.example:389. | | `AIHUMMER_LDAP_USER_ATTR` | Kirjautumisattribuutti (oletusarvo sAMAccountName) | `text` | — | uudelleenkäynnistyksen jälkeen | Attribuutti LDAP/Active Directory vastasi käyttäjätyyppien kirjautumistunnusta (oletusarvo sAMAccountName; uid OpenLDAP:lle, userPrincipalName UPN-tyylisille kirjautumisille). | | `AIHUMMER_LDAP_USER_FILTER` | Käyttäjähakusuodatin | `text` | — | uudelleenkäynnistyksen jälkeen | Kirjautumisessa on oltava %s. AD: (sAMAccountName=%s); OpenLDAP: (uid=%s). | ## SSO (OIDC) | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OIDC_AUDIENCE` | OIDC yleisö | `text` | — | uudelleenkäynnistyksen jälkeen | Odotettu `aud` -vaatimus – aseta tämä resurssin yleisölle THIS, jotta se hylkää tokeneille, jotka on lyöty toiselle luottavalle osapuolelle. Väite `aud` on nyt oletusarvoisesti REQUIRED jokaisessa tunnuksessa (ilman aud-tunnusta hylätään); kun tämä on asetettu, aud:n on myös sisällettävä se. Suositellaan voimakkaasti tuotannossa. | | `AIHUMMER_OIDC_ISSUER` | OIDC myöntäjä URL | `text` | — | uudelleenkäynnistyksen jälkeen | IdP-myöntäjä (esim. https://login.example.com). Ottaa käyttöön OIDC JWT todennuksen, kun se on asetettu. | | `AIHUMMER_OIDC_JWKS_URL` | OIDC JWKS -osoite | `text` | — | uudelleenkäynnistyksen jälkeen | JSON Verkkoavain Aseta päätepiste, jota käytetään tunnuksen allekirjoitusten vahvistamiseen. | | `AIHUMMER_OIDC_TENANT_CLAIM` | OIDC työtilavaatimus | `text` | — | uudelleenkäynnistyksen jälkeen | JWT vaatimus, joka sisältää työtilan tunnuksen (esim. tenant_id / org). | ## SSO (SAML) | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SAML_DEFAULT_ROLE` | SAML: Oletusrooli (ei ryhmäosumaa) | `text` | — | uudelleenkäynnistyksen jälkeen | Rooli myönnetään, kun vahvistettuja arvokarttoja ei ole. Tyhjä = ei roolia. | | `AIHUMMER_SAML_ENABLED` | Ota käyttöön SAML 2.0 SSO | `bool` | `0` | uudelleenkäynnistyksen jälkeen | Avaa /saml/metadata, /saml/acs, /saml/login. SP:n yksityinen avain sijaitsee Secretsissä (scope saml, nimi sp_key). | | `AIHUMMER_SAML_ENTITY_ID` | SP-yksikön tunnus | `text` | — | uudelleenkäynnistyksen jälkeen | SP-entiteetin tunnus (oletuksena ⟨root⟩/saml/metadata, jos se on tyhjä). | | `AIHUMMER_SAML_IDP_METADATA` | IdP-metatiedot XML | `text` | — | uudelleenkäynnistyksen jälkeen | Liitä IdP:n SAML metatietodokumentti (Okta/Azure AD/ADFS). | | `AIHUMMER_SAML_ROLE_ATTRIBUTE` | Rooli/ryhmämäärite (oletusryhmät) | `text` | — | uudelleenkäynnistyksen jälkeen | Väitteen attribuutti, joka kuljettaa ryhmä-/rooliarvoja. | | `AIHUMMER_SAML_ROLE_MAPPINGS` | SAML: Ryhmä→roolikartoitukset (JSON) | `text` | — | uudelleenkäynnistyksen jälkeen | JSON väitetyn arvon objekti → rooli, esim. {"AdminGroup":"admin","Ops":"operator"}. | | `AIHUMMER_SAML_ROOT_URL` | SP-juuri URL | `text` | — | uudelleenkäynnistyksen jälkeen | Tämän yhdyskäytävän ulkoisesti tavoitettavissa oleva tukikohta URL, esim. https://app.example.com. ACS = ⟨root⟩/saml/acs. | | `AIHUMMER_SAML_SP_CERT` | SP-sertifikaatti (PEM) | `text` | — | uudelleenkäynnistyksen jälkeen | Julkinen SP-allekirjoitusvarmenne (PEM). Vastaava yksityinen avain menee Secrets-kansioon (scope saml, nimi sp_key). | ## Schedules | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SCHEDULE_AGENT_MAX_ACTIVE` | Agentti: aktiivisten aikataulujen enimmäismäärä | `int` | `20` | heti | Montako aktiivista aikataulua yhdellä agentilla saa olla, kun se itse luo tai ottaa käyttöön aikataulun (aikataulutyökaluillaan). Paneelissa luodut aikataulut lasketaan mukaan, mutta paneelia ei koskaan torjuta. Rajalla agenttia pyydetään ensin keskeyttämään tai poistamaan yksi. Tulee voimaan heti. | | `AIHUMMER_SCHEDULE_AGENT_MAX_FIRES_PER_DAY` | Agentti: aikatauluajoja vuorokaudessa | `int` | `288` | heti | Kuinka monta kertaa vuorokaudessa (UTC) yhden agentin kaikki aikataulut saavat yhteensä käynnistyä, mukaan lukien paneelissa luodut aikataulut ja käsin käynnistetyt ajot. Rajan ylittävät ajot ohitetaan ja näkyvät ajolokissa. Tulee voimaan heti. | | `AIHUMMER_SCHEDULE_AGENT_MIN_INTERVAL_MINUTES` | Agentti: aikataulun lyhin väli, minuuttia | `int` | `5` | heti | Lyhin väli kahden ajon välillä toistuvassa aikataulussa, jonka agentti itse luo tai muuttaa. Tiheämpi aikataulu hylätään. Paneelissa luotuja aikatauluja tämä ei rajoita. Tulee voimaan heti. | | `AIHUMMER_SCHEDULE_COMMANDS` | Palvelinkomennot aikatauluissa | `bool` | `0` | heti | Sallii aikataulun suorittaa ohjelman tällä palvelimella — kerääjän, raportin tai varmuuskopion tarkistuksen. Oletuksena pois päältä. Vain «Sallitut komennot» -luettelon komennot suoritetaan, täsmälleen kirjoitetussa muodossa; komentotulkkia ei ole. Tuloste menee agentille tai suoraan keskusteluun, ja jokainen suoritus näkyy aikataulun suoritusloki. Tulee voimaan heti. | | `AIHUMMER_SCHEDULE_COMMANDS_ALLOWLIST` | Sallitut komennot | `argvlist` | — | heti | Täsmälliset komennot, joita aikataulu saa suorittaa: ohjelma (nimi kuten df tai koko polku) ja sen argumentit. Aikataulu suorittaa vain komennon, joka vastaa merkintää täsmälleen argumentteineen. Poistettu komento pysäyttää sitä käyttävät aikataulut, ja niiden suoritukset kertovat syyn. Tulee voimaan heti. | | `AIHUMMER_SCHEDULE_COMMANDS_MAX_OUTPUT_KB` | Aikataulukomennon tulosteen raja, kt | `int 1…1024` | `64` | heti | Kuinka paljon komennon tulosteesta (1–1024 kt) säilytetään suorituslokissa ja välitetään agentille tai keskusteluun; loput katkaistaan, ja loki kertoo sen. Tulee voimaan heti. | | `AIHUMMER_SCHEDULE_COMMANDS_SANDBOX` | Suorita aikataulujen komennot käyttöjärjestelmän hiekkalaatikossa | `bool` | `1` | heti | Päällä: komento suoritetaan käyttöjärjestelmän hiekkalaatikossa kuten koodin suoritus — asennuksen salaisuudet ja SSH-avaimet ovat piilossa, ja kirjoittaa voi vain omaan väliaikaiskansioon. Ilman hiekkalaatikkoa (bubblewrap) palvelimella komentoa ei suoriteta, ja suoritusloki kertoo syyn. Pois: se suoritetaan yhdyskäytävän oikeuksin. Tulee voimaan heti. | | `AIHUMMER_SCHEDULE_FAILURE_ADMIN` | Ilmoita ylläpitäjälle epäonnistuneista tehtävistä | `bool` | `1` | heti | Kun ajastettu tehtävä epäonnistuu tai ei pääse alkamaan, hallintapaneelin ilmoituskelloon tulee ilmoitus, jossa on tehtävän nimi, syy ja paikka, josta sen voi korjata, ja sama lähetetään omistajien omiin kanavakeskusteluihin (enintään kerran 6 tunnissa tehtävää kohden). Tämä tulee tehtävän vastaanottajalle lähtevän viestin lisäksi. Pois: ylläpitäjä saa tietää virheistä vain suoritusten lokista. Tulee voimaan heti. | | `AIHUMMER_SCHEDULE_FAILURE_NOTIFY` | Ilmoita vastaanottajalle epäonnistuneesta tehtävästä | `bool` | `1` | heti | Kun ajastettu tehtävä epäonnistuu, samalle vastaanottajalle lähetetään lyhyt viesti (ensimmäisen virheen jälkeen, enintään kerran 6 tunnissa). Pois päältä — virheet näkyvät vain ajolokissa. Yksittäinen tehtävä voi poistaa tämän käytöstä lomakkeessaan. Tulee voimaan heti. | ## Security | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AIRGAPPED` | Eristetty tila (ei internetiä) | `bool` | `0` | heti | Estää agentteja menemästä internetiin: verkkohaku, sivujen avaus ja pyynnöt ulottuvat vain sisäisiin osoitteisiin ja sallittujen luetteloiden osoitteisiin. Kytke päälle suljetuissa verkoissa ilman yhteyttä ulos. | | `AIHUMMER_AUDIT_RETENTION_DAYS` | Kuinka monta päivää toimintalokia säilytetään | `int` | `0` | uudelleenkäynnistyksen jälkeen | Tätä vanhemmat tarkastuslokin ja asetusten muutoshistorian merkinnät poistetaan kerran vuorokaudessa. 0 tai tyhjä — säilytä aina. | | `AIHUMMER_CORS_ORIGINS` | Sallitut CORS alkuperät | `list` | — | uudelleenkäynnistyksen jälkeen | Pilkuilla eroteltu luettelo sallituista lähteistä. Tyhjä = CORS ei sallittu (vain sama alkuperä). Käytetty käynnistyksen yhteydessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_CSP` | headerity (ohita) | `text` | — | uudelleenkäynnistyksen jälkeen | Ohittaa CSP-otsikon. Tyhjä = turvallinen oletus. Käytetty käynnistyksen yhteydessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_INBOUND_SECRET` | Kanavalaajennusten avain palvelimeen | `text` | — | uudelleenkäynnistyksen jälkeen | Yhdistetyt kanavat (Telegram, VK ja muut) todistavat sillä, että viestit tulevat todella niiltä. Asetetaan automaattisesti asennuksessa — sitä ei tarvitse muuttaa. Jos se on tyhjä, palvelin hylkää kaikki kanavat, kunnes avain on asetettu. | | `AIHUMMER_OPENAI_COMPAT_KEY` | OpenAI-yhteensopiva saapuva: staattinen API avain | `text` | — | uudelleenkäynnistyksen jälkeen | Yhteinen avain ohjelmille, jotka yhdistävät palvelimeen OpenAI-yhteensopivana palveluna. Tyhjä — yhteinen avain on pois käytöstä; ohjelmat voivat yhdistää henkilökohtaisilla avaimilla API-avaimet-sivulta. | | `AIHUMMER_OPENAI_COMPAT_WORKSPACE` | OpenAI-yhteensopiva saapuva: työtilan tunnus | `text` | — | uudelleenkäynnistyksen jälkeen | Työtilan tunnus, johon staattinen OpenAI-yhteensopiva todennus liittyy. Tyhjä = AIHUMMER_DEFAULT_WORKSPACE_ID. Käytetään käynnistettäessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_REQUIRE_2FA` | Vaadi 2FA operaattoreille | `bool` | `0` | heti | Vaadi toinen tekijä (TOTP/passkey) operaattoreille. Kun käytössä, operaattoreita, joilla ei ole 2FA:ta, kehotetaan määrittämään se heti sisäänkirjautumisen yhteydessä (ilman estoa, joten omistajaa ei koskaan lukita ulos). Haettu välittömästi. | | `AIHUMMER_REQUIRE_SECURE` | Hyväksy vain suojatut (HTTPS/WSS) yhteydet | `bool` | `0` | uudelleenkäynnistyksen jälkeen | Kun käytössä, tavalliset HTTP-pyynnöt ohjataan osoitteeseen HTTPS (GET/HEAD) tai hylätään (403); Localhost-pääsy on aina sallittu, joten operaattoria ei koskaan suojata. Kunnioita X-Forwarded-Protoa TLS-päättävältä käänteiseltä välityspalvelimelta. Käytetty käynnistettäessä/uudelleenkäynnistyksen jälkeen. | | `AIHUMMER_TRUSTED_PROXIES` | Luotetut välityspalvelimet | `list` | — | heti | Jos palvelimen edessä on välityspalvelin (nginx, Caddy, kuormantasaaja), kirjoita sen osoite tai verkko pilkuin eroteltuna, esim. 10.0.0.0/8. Silloin toimintaloki, sallittujen IP-osoitteiden luettelo ja salasanojen arvailun esto näkevät vierailijan todellisen osoitteen. Tyhjä — vain suoran yhteyden osoite huomioidaan, eikä sitä voi väärentää. | ## Tools | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_BROWSER_ALLOWED_HOSTNAMES` | Selain: yksityisten isäntien poikkeukset | `list` | — | heti | Tarkat pilkuin erotetut nimet ilman jokerimerkkejä, URL-osoitteita tai portteja. Yksityiset lisäpoikkeukset oman palvelimen natiiville CDP:lle, erillään web_fetchistä. | | `AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK` | Selain: salli yksityinen verkko | `bool` | — | heti | Tyhjä säilyttää aiemman käytännön; true tai false ottaa tarkistetun natiivin CDP:n käyttöön. Yksityinen pääsy vain omalla palvelimella. Loopback, link-local ja metatiedot pysyvät estettyinä. | | `AIHUMMER_BROWSER_PROFILE_SOCKET` | Selainprofiilien ohjaussoketti | `text` | — | heti | Valinnainen. Jätä tyhjäksi — yhdyskäytävä löytää selainpalvelun managed-profiles.sock-tiedoston itse vakioasennuspaikasta. Sivustoille kirjautuneet profiilit luodaan kohdassa Yhteydet → Selainprofiilit. Ei URL-osoite eikä lähdeprofiilin polku. | | `AIHUMMER_CODE_EXEC` | Koodin suoritus agentilla | `enum: off \\\| host \\\| sandbox` | `off` | heti | Agentin koodinsuoritustyökalu (code_exec). Oletus on «Pois». «Tällä palvelimella»: komennot suoritetaan yhdyskäytävän palvelimella; käyttöjärjestelmän hiekkalaatikko (bubblewrap) piilottaa asennuksen salaisuudet, mutta tilassa «Ei rajoituksia» agentti näkee SSH-avaimet ja voi kirjoittaa kansionsa ulkopuolelle — vain luotetulle palvelimelle. «Vain hiekkalaatikossa»: aina käyttöjärjestelmän hiekkalaatikossa — salaisuudet ja avaimet ovat piilossa, ja kirjoittaa voi vain agentin kansioon; ilman bubblewrapia (tai kontti-imagea) tätä tilaa ei voi tallentaa. Mitä kukin agentti saa suorittaa, määritetään agentin kohdalla: Agentit → profiili → Työkalut. | | `AIHUMMER_CODE_EXEC_INTERPRETERS` | Code-exec-tulkit (JSON) | `text` | — | heti | JSON objekti {language: path_to_binary}, esim. {"python":"/usr/bin/python3"}. Tyhjä = automaattinen tunnistus. | | `AIHUMMER_CODE_EXEC_NET_PORTS` | Agentin koodille avatut verkkoportit | `list` | `53,80,443` | heti | TCP-portit, joihin agentin koodi voi muodostaa yhteyden käyttöjärjestelmän hiekkalaatikossa (koodin suoritus ja aikataulujen komennot), pilkuilla eroteltuina. Oletuksena 53, 80 ja 443: DNS ja verkkosivustot. Tämän palvelimen ja sen lähiverkon muut palvelut (tietokanta, hallintapaneeli, selain, adb, paikalliset mallit, Home Assistant) pysyvät suljettuina agentin koodilta. Luettelon portti on auki jokaisessa osoitteessa, myös tällä palvelimella, joten lisää vain se, mitä koodi tarvitsee, esimerkiksi 22 SSH:ta varten. Kirjoita any poistaaksesi rajoituksen. Tilassa «Ei rajoituksia» olevia agentteja ei rajoiteta. Vaatii Linux 6.7:n tai uudemman; ilman sitä rajoitus ei ole voimassa, ja Agentit → Työkalut kertoo siitä. Tulee voimaan heti. | | `AIHUMMER_CODE_EXEC_READ_DIRS` | Agentin koodille luettavaksi avatut kansiot | `list` | — | heti | Tämän palvelimen kansiot, joita agentin koodi saa lukea: koodin suoritus ja aikataulujen komennot käyttöjärjestelmän hiekkalaatikossa. Pilkuilla eroteltuna tai yksi riviä kohden, esimerkiksi ~/reports. Voit myös nimetä yksittäisen tiedoston, esimerkiksi ~/scripts/report.py. Täällä avattu näkyy kaikkien agenttien koodille, joten avaa vain se, mitä koodi tarvitsee. Oletuksena tyhjä: hiekkalaatikossa koodi näkee vain oman agenttinsa kansion ja järjestelmäkansiot; yhdyskäytävän käyttäjän kotikansio, asennuksen tiedot, muiden agenttien kansiot, avaimet ja komentohistoria pysyvät piilossa. Juurta, koko kotikansiota, asennuksen tietoja ja avaimia sisältäviä paikkoja ei voi avata. Koodi ei voi kirjoittaa näihin kansioihin. Tulee voimaan heti. | | `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Code-exec-hiekkalaatikon kuva | `text` | — | heti | Valinnainen, vain tilalle «Vain hiekkalaatikossa»: Docker-kontti-image käyttöjärjestelmän hiekkalaatikon sijaan (ei verkkoa, vain luku -juuri, rajoitukset); palvelimella tarvitaan Docker. Tyhjä = käyttöjärjestelmän hiekkalaatikko (bubblewrap). | | `AIHUMMER_CODE_EXEC_TIMEOUT_SECONDS` | Koodin suoritusaikaraja (sekuntia) | `int` | `1800` | heti | Kuinka kauan yksi agentin komento saa kestää taustakomennot mukaan lukien: 10 sekunnista 24 tuntiin. Komentoa, joka ei vastaa 30 sekunnissa, ei katkaista, vaan se siirtyy taustalle, jossa agentti tarkistaa sen process-työkalulla. Agentti voi pyytää lyhyempää rajaa, ei pidempää. | | `AIHUMMER_DB_QUERY_DSN` | Tietokantayhteys tietokantakyselytyökalulle | `text` | — | heti | Yhteysmerkkijono tietokantaan, jota agentti saa lukea (vain luku), esim. postgres://reader:salasana@host/db. Käytä käyttäjää, jolla on vähimmäisoikeudet — ei tietokannan omistajaa. Tyhjä — työkalu on pois käytöstä. | | `AIHUMMER_FS_ROOT` | Tiedostojärjestelmätyökalun juuri | `text` | — | heti | Kansio, jonka sisällä agentti lukee palvelimen tiedostoja (filesystem_read; agentit eivät voi kirjoittaa tiedostoja). Tyhjä = koko palvelin yhdyskäytävän käyttäjän oikeuksin salaisuuksia lukuun ottamatta: asennuksen asetukset (gateway.env), SSH/GPG-avaimet ja prosessien ympäristöt. Rajaa pääsyä määrittämällä kansio. | | `AIHUMMER_HTTP_ALLOWLIST` | Osoitteet agentin HTTP-pyynnöille | `list` | — | heti | Pilkuin eroteltu luettelo palvelimista, joihin http_request-työkalu saa ottaa yhteyttä. Tyhjä = kaikki sallitaan, paitsi sisäiset ja yksityiset osoitteet. | | `AIHUMMER_HTTP_AUTH_JSON` | http_todennuspyyntö (JSON) | `text` | — | heti | JSON-kartta, joka liittää palvelimen valtuutusotsikoihin http_request-työkalua varten, jottei tunnisteita säilytetä kehotteessa. Tyhjä = ilman valtuutusta. | | `AIHUMMER_MCP_SERVERS` | MCP palvelimet (JSON) | `text` | — | heti | JSON-kuvaus ulkoisista MCP-palvelimista, joiden työkalut liitetään agenttiin. Tyhjä = ei ulkoisia MCP-palvelimia. | | `AIHUMMER_PROJECT_STUDIOS_PUBLIC_NETWORK` | Projektistudiot: julkinen verkko | `bool` | `false` | heti | Salli julkinen HTTP(S) valituille palveluntarjoajille ja erikseen pyydetyille mallilatauksille. Yksityiset, paikalliset ja metatieto-osoitteet pysyvät estettyinä. Verkkoyhteydetön tila on ensisijainen. Tulee voimaan heti. | | `AIHUMMER_SIDECAR_CLOAKBROWSER` | Selain agentille (CloakBrowser) | `bool` | `0` | heti | Tunnistuksenesto selain (CloakBrowser, browser/computer työkalut). Mitä EI sisälly toimituspakettiin: sisällyttäminen lataa allekirjoitetun lisäosan (~477 MiB, josta Chromium ~207 MiB) ja asentaa palvelun isäntään. Raskain sivuvaunu - ota käyttöön vain, jos agentin on avattava verkkosivustoja. | | `AIHUMMER_SIDECAR_SEARXNG` | Verkkohaku (SearXNG) | `bool` | `0` | heti | Verkkohaku (SearXNG, web_search työkalu). EI sisälly pakettiin: päälle kytkeminen lataa allekirjoitetun lisäosan (~154 MiB) ja asentaa palvelun isäntään, sammuttaminen pysäyttää sen ja vapauttaa tilaa. Asennus tapahtuu taustalla ja kestää muutaman minuutin; tässä oleva tila näyttää, mitä palvelimella todella on. | | `AIHUMMER_WEBFETCH_ALLOWLIST` | Sivustot, joita agentti saa avata | `list` | — | heti | Pilkuin eroteltu luettelo verkkotunnuksista, joihin web_fetch-työkalu saa ottaa yhteyttä. Tyhjä = kaikki sallitaan, paitsi sisäiset ja yksityiset osoitteet. | | `AIHUMMER_WEB_SEARCH_LANGUAGE` | Verkkohaku: tulosten oletuskieli | `text` | `auto` | heti | Tulosten kieli, kun agentti ei määritä sitä: koodi kuten ru, en tai de, tai auto, jolloin kieli päätellään hausta (sopii lähes aina). Agentti voi valita toisen kielen yksittäiseen hakuun. | | `AIHUMMER_WEB_SEARCH_RESULTS` | Verkkohaku: tuloksia hakua kohden | `int` | `5` | heti | Kuinka monta tulosta haku palauttaa, kun agentti ei pyydä tiettyä määrää: 1–10. Useampi tulos antaa kattavamman vastauksen mutta pidemmän kontekstin. | | `AIHUMMER_WEB_SEARCH_SOURCE` | Verkkohaun lähde | `enum: auto \\\| searxng \\\| provider` | `auto` | heti | Mistä agentti hakee internetistä (työkalu web_search). auto — SearXNG, jos se on asennettu, muuten mallin tarjoajan sisäänrakennettu haku. searxng — vain SearXNG: ilman sitä hakua ei ole. provider — tarjoajan sisäänrakennettu haku siellä, missä se on, ja SearXNG muille malleille. Sisäänrakennettu haku on Codexilla (ChatGPT-tilaus) ja OpenAI:lla (api.openai.com); GigaChatilla, YandexGPT:llä ja muilla OpenAI-yhteensopivilla sitä ei ole — ilman SearXNG:tä näiden mallien agentit eivät hae. Claude (api.anthropic.com ja Claude-tilaus) käyttää Anthropicin sisäänrakennettua hakua; jos tili hylkää sen, yhdyskäytävä kirjaa sen lokiin ja tarjoaa agentille jatkossa vain SearXNG:tä. Mitkä agentit saavat hakea, määritetään kuten ennenkin agentin kortilla. Tulee voimaan seuraavasta vuorosta. | | `AIHUMMER_WEB_SEARCH_TIMEOUT_SECONDS` | Verkkohaun aikaraja (sekuntia) | `int` | `30` | heti | 1–600 sekuntia hakua kohden. Tehtävän lyhyempi määräaika on edelleen voimassa. | ## Updates | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_RESTART_APPLY` | Ota käyttöön uudelleenkäynnistystä vaativat asetukset | `enum: quiet \\\| manual` | `quiet` | heti | quiet (oletus) — tallennetut asetukset, jotka tulevat voimaan vasta yhdyskäytävän uudessa käynnistyksessä, otetaan käyttöön itsestään: yhdyskäytävä käynnistyy uudelleen seuraavalla hiljaisella hetkellä, kun agentit eivät tee mitään ja ihmiset ovat olleet hiljaa vähintään hiljaisuusikkunan ajan. manual — vain merkintä ”odottaa uudelleenkäynnistystä” ja painike. Uudelleenkäynnistys kestää muutaman sekunnin; keskustelut ja tehtävät eivät katoa. Tulee voimaan heti. | | `AIHUMMER_RESTART_QUIET_MINUTES` | Hiljainen hetki: hiljaisuuden minuutit ennen automaattista uudelleenkäynnistystä | `int 0…1440` | `10` | heti | Montako minuuttia ihmisten on oltava hiljaa (ja agenttien jouten), ennen kuin yhdyskäytävä käynnistyy itse uudelleen ottaakseen tallennetut asetukset käyttöön. 0 — heti kun agentit ovat saaneet nykyisen työnsä valmiiksi. 0–1440. Tulee voimaan heti. | ## Web UI (separate port) | Avain | Nimi | Tyyppi | Oletus | Tulee voimaan | Mitä tekee | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_WEBUI_API_BASE` | Palvelimen osoite erikseen isännöidylle paneelille | `text` | — | uudelleenkäynnistyksen jälkeen | Tarvitaan vain, jos paneeli avataan eri osoitteesta kuin itse palvelin. Anna osoite, josta selain tavoittaa palvelimen, esim. https://api.example.com. Tyhjä — käytetään palvelimen julkista osoitetta tai sen puuttuessa paikallista. | | `AIHUMMER_WEBUI_ENABLED` | Paneeli omassa portissa | `bool` | `1` | uudelleenkäynnistyksen jälkeen | Päällä — paneeli avautuu omassa sisäisessä portissa, jonka voi sulkea internetiltä, ja julkinen portti palvelee vain sovelluksia ja kanavia. Kytke pois, jos paneelin ei pidä olla lainkaan käytettävissä. | | `AIHUMMER_WEBUI_ORIGIN` | Osoite, josta paneeli avataan | `text` | — | uudelleenkäynnistyksen jälkeen | Täytä, jos paneeli avataan välityspalvelimen kautta tai nimellä, joka poikkeaa sen portin osoitteesta, esim. https://admin.example.com. Palvelin sallii selaimen tästä osoitteesta käyttää sitä. Tyhjä — käytetään paneelin portin osoitetta. | Ylläpitäjän käytettävissä olevat asetukset: 237.