_For utviklarar_

# Fyll ein coreAI-assistent med eigne data via API-et

coreAI gjev utviklarar eit API for å fylle ein assistent med eigne data og bruke dei same dataene i chat og søk. Det passar når eit produkt, CMS, PIM, ERP eller fagsystem skal gjere innhaldet sitt tilgjengeleg i ein coreAI-assistent.

[Snakk med oss om API-integrasjon](https://coreai.no/nn/kontakt)

[Sjå den tekniske API-artikkelen](https://coreai.no/nn/articles/api-data-integration)

## Fyll assistenten med data frå systemet ditt

API-integrasjonen brukar stabile eksterne ID-ar og upsert-kall for å halde kunnskapsbasen synkronisert med systemet ditt. Når eit objekt vert oppretta eller endra hjå deg, sender du den oppdaterte entiteten til coreAI.

Produksjonsmiljøet ligg på `https://portal.coreai.no/api/v2`, og testmiljøet ligg på `https://stage.coreai.no/api/v2`. Kalla brukar Bearer-token, `assistantId` peikar på assistenten som skal svare, og `contentImporterId` peikar på API-kjelda der dataene vert lagra.

Upsert via `POST /assistants/{assistantId}/sources/{contentImporterId}` erstattar heile entiteten. `PATCH` kan brukast for mindre endringar, `DELETE` fjernar entitetar som ikkje lenger skal gje svar, og `GET` let integrasjonen hente ut éin eller fleire entitetar via eksterne ID-ar.

- `POST` opprettar eller erstattar produkt, dokument, innhald og andre entitetar
- `PATCH` oppdaterer berre felta som faktisk har endra seg
- `DELETE` fjernar entiteten og relasjonslenkjene rundt han
- `GET` hentar entitetar tilbake ved hjelp av eksterne ID-ar

## Lat assistenten bruke MCP-verktøy

MCP-importen i coreAI finn verktøy på ein ekstern MCP-server. Verktøya vert gjorde tilgjengelege for assistenten når ein samtale startar, og assistenten vel relevant verktøy for å svare brukaren. Om brukaren er innlogga, kan svar avgrensast til berre brukaren sine saker i eit fagsystem.

[Slik fungerer MCP-import](https://coreai.no/nn/articles/mcp-import)

## Kople AI-agentar til kunnskapsbasen via MCP

coreAI kan eksponere kunnskapsbasen som ein MCP-server, slik at eksterne AI-agentar kan spørje innhaldet i assistenten gjennom ein standardisert protokoll. Teamet kan bruke dei same kuraterte kjeldene i eigne agentverktøy, IDE-ar og interne arbeidsflyter.

[Slik fungerer MCP-serveren](https://coreai.no/nn/articles/mcp-server)

## Send strukturerte entitetar, ikkje berre tekst

coreAI kan indeksere fleire datatypar slik at assistenten forstår skilnaden på produktdata, dokumentasjon, arrangement, utdanningar, stillingar og kontaktpersonar. Det gjer svara meir presise enn ein flat tekstimport.

[Sjå entitetstypane i detalj](https://coreai.no/nn/articles/entity-types)

## Bruk dataene i widget, eigen chat eller søk

Når dataene er inne i assistenten, kan brukarane møte dei gjennom coreAI-widgeten, eit eigenutvikla chatgrensesnitt eller eit reint kunnskapsbasesøk. Du vel kor mykje av opplevinga du vil byggje sjølv.

[Sjå heile API-integrasjonsguiden](https://coreai.no/nn/articles/api-data-integration)

## Vern assistenten med di eiga pålogging

Set ein `callbackUrl` på assistenten, så kallar coreAI di eiga URL med tokenet til brukaren når widgeten vert lasta. Tokenet vert godkjent éin gong per sideinnlasting, og påloggingen vert verande hjå deg.

[Slik vernar du assistenten](https://coreai.no/nn/articles/assistant-protection)

## Bygg ei synkronisering som toler produksjon

Den beste coreAI-integrasjonen lèt kjeldesystemet eige sanninga og brukar API-et til å halde assistenten oppdatert. Då får brukarane ferske svar, og utviklarteamet slepp manuelle importar.

Start med stabile ID-ar, klare datatypar og felt som kan brukast til filtrering. Deretter kan de velje om sluttbrukaren skal møte assistenten i coreAI-widgeten, i eit eige chatgrensesnitt eller som søk inne i produktet dykkar.

[Planlegg API-integrasjonen med oss](https://coreai.no/nn/kontakt)