Slik setter du opp en AI-agent for regnskap i ReAI

En AI-agent for regnskap kan lese regnskapsdata, undersøke avvik og utføre avgrensede oppgaver gjennom ReAI sitt offentlige API. Forskjellen fra en vanlig chatbot er at agenten kan arbeide med filer, kjøre kommandoer, følge faste instrukser og kontrollere resultatet av egne handlinger.

Du kan bruke Codex fra OpenAI, Claude Code fra Anthropic eller en annen agent som kan bruke terminalen og sende HTTPS-kall. Oppsettet mot ReAI er det samme: Agenten trenger en arbeidsmappe, tydelige regler og en API-nøkkel med riktig tilgang.

Denne guiden viser hele grunnoppsettet. Start med lesetilgang og et lite kontrollert oppdrag. Ikke gi agenten ansvar for betaling, innsending til myndigheter eller lukking av perioder før du har sett at arbeidsflyten gir etterprøvbare resultater.

Den enkleste starten: gi denne guiden til agenten

Du kan kopiere URL-en til denne artikkelen og gi den direkte til Codex, Claude Code eller en annen agent:

Følg oppsettet på https://reai.no/regnskap-med-ai/kom-i-gang/ . Opprett en trygg arbeidsmappe, .gitignore, AGENTS.md og .env.example, last ned OpenAPI som JSON, og vis meg hva jeg må gjøre for å opprette API-nøkkelen. Stopp før du trenger den hemmelige nøkkelen eller skal sende et skrivekall.

Agenten kan da klargjøre mappene, skrive de lokale instruksjonene og kontrollere OpenAPI. Du må selv opprette API-nøkkelen i ReAI og legge den sikkert i miljøet. Ikke lim nøkkelen inn i samtalen med agenten.

Dette trenger du

• En bruker i ReAI med tilgang til virksomheten du skal arbeide med.
• Codex, Claude Code eller en tilsvarende lokal agent.
• En egen arbeidsmappe utenfor mapper som synkroniseres eller deles ukontrollert.
• En ReAI API-nøkkel.
• Grunnleggende forståelse av hvilke data agenten skal lese eller endre.

Du trenger ikke bygge en egen integrasjon før du begynner. ReAI tilbyr et REST-API med JSON, og den maskinlesbare API-beskrivelsen ligger i ReAI OpenAPI . Agenten kan lese denne for å finne tilgjengelige endepunkter, felter, valideringsregler og svarformater.

Velg riktig API-nøkkel

ReAI har to typer API-nøkler. Valget bestemmer hvordan agenten finner virksomheten og hvilke tilganger den får.

Vi anbefaler en bruker-API-nøkkel med mindre du vet at du trenger en tenant-API-nøkkel med begrensede scopes. Brukernøkkelen har samme selskaper, roller og rettigheter som brukeren. Agenten kan dermed arbeide på tvers av alle virksomhetene brukeren har tilgang til uten at du må opprette én nøkkel per selskap.

Brukernøkkelen opprettes på brukerprofilen i ReAI . Agenten bruker først GET /api/me for å finne tilgjengelige tenants og sender deretter riktig tenant-id i headeren X-Tenant-Id. Når nøkkelen endrer data, kan ReAI sitt endringsspor vise hvilken bruker som eier API-nøkkelen. Det gir bedre ansvarlighet enn en generell, delt systemidentitet.

Velg en tenant-API-nøkkel når en permanent integrasjon eller en avgrenset agent bare skal bruke ett selskap og du bevisst vil begrense den til bestemte scopes, for eksempel lesetilgang til hovedbok eller bank. Opprett og administrer slike nøkler under Tenant API Keys .

API-nøkkelen vises når den opprettes eller regenereres. Kopier den til et sikkert sted med én gang. Opprett helst en egen nøkkel for hver agent eller arbeidsflyt, gi nøkkelen et beskrivende navn, og slett den når den ikke lenger brukes.

Lag arbeidsmappen

En ryddig mappe gjør det mulig å skille kildedata, midlertidig arbeid, dokumentasjon og ferdige leveranser. Det reduserer også risikoen for at agenten bruker feil fil eller behandler samme dokument to ganger.

reai-agent/
├── AGENTS.md
├── .env.example
├── .gitignore
├── context/
│   └── company.yml
├── input/
├── working/
├── evidence/
├── output/
└── logs/

Bruk mappene slik:

• AGENTS.md inneholder varige regler for agenten.
• context/ inneholder stabile opplysninger agenten trenger, som tenant-id, organisasjonsnummer, MVA-status og hvilke perioder oppdraget gjelder.
• input/ er urørte kildefiler fra bank, kunde eller tidligere system.
• working/ er midlertidige uttrekk, manifest og analyser.
• evidence/ samler dokumentasjon som underbygger vurderinger og posteringer.
• output/ inneholder rapporter og forslag som skal leses av et menneske.
• logs/ inneholder en enkel sporlogg over kall og resultater, men aldri API-nøkkelen.

Regnskapsdata, bankfiler og vedlegg kan inneholde personopplysninger og forretningshemmeligheter. Ikke legg arbeidsmappen i et offentlig Git-repository. Hvis du bruker Git lokalt, bør .gitignore minst inneholde:

.env
input/
working/
evidence/
output/
logs/

Lagre API-nøkkelen i en miljøvariabel

Miljøvariabelens navn bestemmes av oppsettet ditt. ReAI krever Bearer-tokenet i HTTP-headeren, ikke et bestemt lokalt variabelnavn. For det anbefalte oppsettet med bruker-API-nøkkel bruker vi:

export REAI_USER_API_TOKEN="lim-inn-nokkelen-her"
export REAI_TENANT_ID="123"

Hvis du bevisst har valgt en tenant-API-nøkkel, kan du i stedet bruke:

export REAI_TENANT_API_TOKEN="lim-inn-nokkelen-her"

Ikke skriv den virkelige nøkkelen i AGENTS.md, .env.example, et shell-script eller en prompt. Hvis du bruker en lokal .env-fil, skal den være ignorert av Git og bare være lesbar for brukeren din. .env.example kan vise variabelnavn uten verdier:

REAI_USER_API_TOKEN=
REAI_TENANT_ID=

Kontroller nøkkelen med første API-kall

Med en bruker-API-nøkkel er det første kallet alltid en god identitetskontroll:

curl --fail-with-body --silent --show-error \
  https://app.reai.no/api/me \
  -H "Authorization: Bearer ${REAI_USER_API_TOKEN}"

Svaret viser brukeren og tilgjengelige tenants. Finn riktig id, sammenlign selskapsnavnet med oppdraget, og lagre id-en som REAI_TENANT_ID. Ikke velg tenant bare fordi den står først i listen.

Deretter kan du gjøre et ufarlig lesekall, for eksempel hente kontoplanen:

curl --fail-with-body --silent --show-error \
  https://app.reai.no/api/chart-of-accounts \
  -H "Authorization: Bearer ${REAI_USER_API_TOKEN}" \
  -H "X-Tenant-Id: ${REAI_TENANT_ID}"

Med en tenant-API-nøkkel bruker du REAI_TENANT_API_TOKEN og utelater X-Tenant-Id. Hvis kallet gir 401, kontrollerer du tokenet. 403 betyr normalt at nøkkelen mangler nødvendig scope eller at brukeren ikke har den aktuelle tilgangen. Ved 400 bør agenten lese application/problem+json-svaret og rette forespørselen, ikke gjenta samme kall blindt.

La agenten lese OpenAPI

OpenAPI er den autoritative beskrivelsen av det offentlige API-et. Last ned en lokal kopi ved starten av arbeidet:

curl --fail-with-body --silent --show-error \
  https://app.reai.no/openapi \
  -H "Accept: application/json" \
  -o working/reai-openapi.json

Be deretter agenten bruke spesifikasjonen før den konstruerer et skrivekall. En god instruks er:

Les working/reai-openapi.json. Finn endepunktet som løser oppgaven, nødvendige scopes, obligatoriske felter og dokumenterte svar. Vis plan og forespørsel uten hemmeligheter før du sender et kall som endrer data.

OpenAPI erstatter ikke regnskapsfaglig vurdering. Den forteller hvordan et bilag kan opprettes, men ikke om bilaget bør opprettes, hvilken konto som er riktig eller om perioden allerede er rapportert.

Gi agenten varige regler

Legg en kort og konkret arbeidskontrakt i AGENTS.md:

# Regnskapsføring via ReAI API

For å bokføre og arbeide med regnskapssystemet skal du bruke ReAI sitt offentlige API.

## API og autentisering

- Den autoritative API-kontrakten er https://app.reai.no/openapi og skal hentes som JSON.
- Bruk `REAI_USER_API_TOKEN` fra miljøet som Bearer-token. Aldri skriv eller vis tokenet.
- Bruk `GET /api/me` til å oppdage alle tilgjengelige tenants og deres ID-er.
- Tenant-spesifikke API-kall krever `X-Tenant-Id`.
- Bekreft tenant-id, selskapsnavn og oppdragsperiode før du arbeider.
- Når du gir lenker til opprettede eller endrede objekter, skal lenken alltid ha `tenantId` som query-parameter.

## Arbeidsregler

- Les OpenAPI og eksisterende data før du konstruerer et kall.
- Vis plan, berørte objekter og forventet effekt før skrivekall.
- Krev menneskelig godkjenning før betaling, innsending, periodestenging, sletting eller reversering.
- Ikke opprett et nytt bilag hvis et eksisterende bilag kan rettes korrekt og sporbarheten bevares.
- Bevar koblingen mellom kilde, vurdering, API-kall og resultat.
- Verifiser endringer med et nytt lesekall.
- Stopp ved uklar tenant, manglende dokumentasjon eller manglende API-funksjon.

Tilpass reglene til virksomheten, men ikke fyll filen med kundespesifikke hemmeligheter. Detaljert oppgavekontekst hører hjemme i en lokal kontekstfil eller i selve oppdraget.

Det første gode oppdraget

Det første oppdraget bør være lesebasert og lett å kontrollere. Be for eksempel agenten:

1. Bekrefte tenant og periode.
2. Hente kontoplan og hovedbok for et avgrenset datointervall.
3. Finne poster som mangler beskrivelse eller dokumentasjon.
4. Skrive en rapport i output/ uten å endre regnskapet.
5. Oppgi hvilke API-kall og kilder rapporten bygger på.

Når dette fungerer, kan du gå videre til den trygge arbeidsmetoden for regnskapsagenter . For praktiske oppgaver kan du lese om bankavstemming med AI-agent og bilag og dokumentasjon med AI-agent .