Ask

KI-agenten på brencel.no. Arkitektur, API og datahåndtering.

1Oversikt
2Arkitektur
3API
4Vern
5Data
6Stemme
7Endringer

1Oversikt

Ask er en tekstagent bygget av Brencel. Den svarer på spørsmål om Brencel ut fra innholdet på brencel.no, og all bruk av språkmodellen går gjennom en lukket agentkjerne med vern før og etter modellen.

Egenskap	Verdi
Status	I drift, stengt for spørsmål ved lansering. Til den åpner: hello@brencel.no.
Kanal	Tekst. Stemme er bygget, men slått av.
Språk	Bokmål, også på de engelske sidene.
Minne	Av som standard. Den besøkende slår det på.
Merking	Genererte svar er merket `ki-generert`.

2Arkitektur

Ask består av et chatvindu i nettleseren, en API-rute på serveren og agentkjernen. Ruten tar seg av det som gjelder HTTP. Alt som gjelder modellen, skjer i kjernen.

ChatvinduSender spørsmålet til POST /api/ask. Samtalen følger den besøkende mellom sidene.
RuteValiderer forespørselen, håndhever grenser per klient, setter økt og stopper sensitive opplysninger.
KjerneSjekker stoppbryter og budsjett før kjøringen starter.
FaktaoppslagHenter relevante avsnitt fra innholdet på brencel.no og legger dem ved spørsmålet.
SpråkmodellSkriver svaret ut fra faktaene.
UtdatavernKontrollerer hver del av svaret før den sendes. Ved brudd: ett nytt forsøk, deretter et fast avslag.
SvarStrømmes tilbake, merket som KI-generert.

Språkmodellen kan byttes og velges per oppsett. Leverandøren står i personvernerklæringen.

3API

Chatvinduet bruker det samme API-et som beskrives her. Kontrakten er også publisert maskinlesbart i /api/v1/services.json.

`POST /api/ask`

Sender ett spørsmål. Svaret kommer som JSON, eller som en strøm når forespørselen har Accept: text/event-stream.

Felt	Type	Beskrivelse
`sporsmal`	`string`	Påkrevd. Spørsmålet, maks 500 tegn.
`husk`	`boolean`	Valgfri. `true` leser og skriver øktens samtaleminne, `false` sletter det. Uten feltet brukes ikke minne.

curl https://brencel.no/api/ask \
  -H "Content-Type: application/json" \
  -H "Origin: https://brencel.no" \
  -d '{ "sporsmal": "Hva gjør Brencel?" }'

Svar

{
  "ok": true,
  "svar": "Brencel er et teknologistudio …",
  "opphav": "ki-generert"
}

Hvert svar har feltet opphav og headeren x-brencel-opphav: ki-generert for svar fra modellen, fast-tekst for faste svar skrevet av oss.

Strøm

Hendelse	Data	Sendes
`steg`	`{ steg }`	Når kjøringen når et nytt trinn: `sjekket`, `fakta` eller `skriver`.
`del`	`{ tekst, opphav }`	For hver del av svaret som har passert utdatavernet.
`svar`	`{ svar, opphav }`	Til slutt, med hele svaret.
`feil`	`{ feil }`	Hvis kjøringen feiler etter at strømmen har startet.

event: steg
data: {"steg":"sjekket"}

event: steg
data: {"steg":"fakta"}

event: steg
data: {"steg":"skriver"}

event: del
data: {"tekst":"Brencel er et teknologistudio …","opphav":"ki-generert"}

event: svar
data: {"svar":"Brencel er et teknologistudio …","opphav":"ki-generert"}

Feil

Status	`feil`	Betydning
`400`	`validation_error`	Forespørselen ble avvist.
`429`	`rate_limited`	For mange spørsmål. Se `Retry-After`.
`502`	`agent_error`	Feil hos leverandøren av språkmodellen.
`503`	`ask_utilgjengelig`	Ask er stengt eller slått av.

Feil før kjøringen starter, kommer som HTTP-status, også når en strøm er bedt om.

Grenser

Grense	Verdi
Lengde på spørsmål	500 tegn
Spørsmål per time	10 per klient
Samtaleminne	30 minutter uten aktivitet

Minne og økt

Endepunkt	Beskrivelse
`GET /api/ask/minne`	Øktens lagrede turer som `{ ok, turer: [{ sporsmal, svar }] }`. Uten økt: en tom liste.
`POST /api/ask/glem`	Sletter øktens minne. Svarer `204`.

Økten følger informasjonskapselen brencel_ask_sid: HttpOnly, SameSite=Lax, gyldig i 24 timer.

4Vern

Stoppbryter: stanser alle kjøringer. Ruten svarer da 503.
Budsjett: setter et tak på bruken per økt og per døgn.
Sensitive opplysninger: forteller den besøkende om egen helse, tro, politikk eller lignende, når det aldri modellen eller minnet. Svaret er fast og merket fast-tekst.
Utdatavern: faste regler kontrolleres på hver del av svaret mens det skrives. Ved brudd gjør Ask ett nytt forsøk, deretter kommer et fast avslag.
Lenker: svar lenker bare til sidene på brencel.no, e-post og telefon.

Reglene i vernene publiseres ikke.

5Data

Data	Hvor	Hvor lenge
Spørsmål og svar	Sendes til språkmodellen for å lage svaret. Logges ikke hos oss.	Se personvernerklæringen.
Samtaleminne	Serverens minne, aldri disk. Bare når `husk` er `true`.	Til minnet slås av, eller 30 minutter uten aktivitet.
Økt	Informasjonskapselen `brencel_ask_sid`.	24 timer.

Instrumenteringen registrerer tidspunkter og faste kategorier, aldri innholdet i spørsmål eller svar. Leverandøren av språkmodellen og grunnlaget for overføringen står i personvernerklæringen.

6Stemme

Stemmen er bygget, men slått av til databehandleravtalen med leverandøren av talegjenkjenning er signert.

TalegjenkjenningTale blir til tekst.
KjerneSamme kjerne og samme vern som for tekst.
TalesynteseBare tekst som har passert utdatavernet, blir til tale.

7Endringer

Dato	Endring
7. nov. 2026	Første versjon.