# Context pack: Grunnleggende konsepter
Source: https://nordvec.com/no/docs/guides/concepts
Pack: https://nordvec.com/no/docs/packs/concepts
This pack bundles one Nordvec guide with the guides it builds on and the guides it links to, in reading order, so an assistant reading it meets no reference it cannot follow.
## Contents
1. [Grunnleggende konsepter](https://nordvec.com/no/docs/guides/concepts) (this guide)
2. [Dokumenter og søk](https://nordvec.com/no/docs/guides/concepts/documents) (linked from this guide)
3. [Samtaler og sitater](https://nordvec.com/no/docs/guides/concepts/conversations) (linked from this guide)
---
# Grunnleggende konsepter
Source: https://nordvec.com/no/docs/guides/concepts
De to tingene alt i Nordvec er bygget på, dokumenter du kan søke i og samtaler som siterer dem.
Hver kobling, push og søk i Nordvec produserer eller leser et dokument,
og hvert svar assistenten gir, er en samtale som bygger på disse dokumentene.
Start her for å lære hva hvert dokument inneholder og hvem som kan se det.
- [Dokumenter og søk](https://nordvec.com/no/docs/guides/concepts/documents): Dokumenter er den søkbare enheten i Nordvec. Importer dem, og finn dem deretter med fulltekstsøk via API-en.
- [Samtaler og sitater](https://nordvec.com/no/docs/guides/concepts/conversations): En samtale er en chat som er basert på dokumentene dine, der hvert svar spores tilbake til kilden sin.
---
# Dokumenter og søk
Source: https://nordvec.com/no/docs/guides/concepts/documents
Dokumenter er den søkbare enheten i Nordvec. Importer dem, og finn dem deretter med fulltekstsøk via API-en.
Et **dokument** er enheten Nordvec søker i: en fil, en side, en melding, en
e-post, hva som helst du importerer. Når et dokument er behandlet, blir det søkbart
og kan siteres i et svar.
## Importering av dokumenter [#importering-av-dokumenter]
Dokumenter kommer inn i arbeidsområdet ditt på tre måter:
* **Koblinger** synkroniserer fra en kilde du eier (koblingseieren). Nye og
endrede dokumenter blir plukket opp automatisk. Se
[koblingskatalogen](/docs/guides/connectors).
* **Opplastinger** av filer du legger til i appen.
* **Push** sender et dokument til Nordvec direkte fra ditt eget system. Se
[Push-dokumenter](/docs/guides/how-to/push-documents).
Uansett hvordan det ankommer, behandler Nordvec dokumentet, deler det opp i avsnitt og indekserer
det for gjenfinning. Dokumentene dine lagres og søkes i EU.
Et dokument har en `status`: `processing` mens det indekseres, `indexed`
når alle behandlingstrinn er fullført, og `failed` hvis det ikke kunne behandles.
## Hvem ser et dokument [#hvem-ser-et-dokument]
Et dokument fra en kobling er privat for personen som koblet det til, inntil
den personen deler det. En API-nøkkel tilhører arbeidsområdet, så den ser det arbeidsområdet
deler, og aldri en persons udelte dokumenter.
## Søking [#søking]
`/documents/search` er **fulltekstsøk** i tittelen og hele teksten
til hvert dokument du kan se, uansett hvor langt dokumentet er. Ord matcher i formen du skriver dem,
på alle språk, og aksenter ignoreres på begge sider, så `cafe` finner `café`. Det er ingen ordstammeanalyse:
`invoice` matcher ikke `invoices`.
Søk kjøres frittstående, uten samtalekontekst. Det returnerer rangerte
dokumenter, hvert med et utdrag fra dets best matchende avsnitt og en relevansscore
fra 0 og opp til, men aldri nående, 1.
```bash
curl https://nordvec.com/api/v1/documents/search \
-H "Authorization: Bearer $NORDVEC_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "renewal terms", "limit": 10 }'
```
Du kan også liste dokumenter (`/documents/list`) eller hente ett etter id
(`/documents/{id}`). Se [API-referansen](/docs/api) for hele settet med
parametere og svarskjemaer.
### Prøv det [#prøv-det]
Kjør en spørring mot et lite demokorpus. Dette søker i seks eksempel-dokumenter i
nettleseren din, rangert og med kildehenvisning, samme format som et virkelig søk returnerer.
Semantisk gjenfinning, som matcher avsnitt etter mening i stedet for eksakte ord,
er det som driver en [samtales](/docs/guides/concepts/conversations) siterte
svar. Søkeendepunktet selv matcher ord.
Søk returnerer kun dokumenter som den som kaller har tilgang til. Tilgang håndheves i databasen,
ikke i applikasjonskoden.
## Innholdstyper [#innholdstyper]
Et dokument kan ha en kunnskapstype i `content_type` (for eksempel
`decision`, `runbook`, `policy` eller `faq`). Et dokument som er pushet, setter den med
push-API-ens `type`; et dokument uten type har `content_type: null`. Både søk og liste
filtrerer på den med `contentType`.
## Hvor dokumenter siteres [#hvor-dokumenter-siteres]
Søk gir deg avsnitt å jobbe med direkte. Når du ønsker et skrevet svar
i stedet for rå avsnitt, henter en [samtale](/docs/guides/concepts/conversations)
fra de samme dokumentene og siterer dem i svaret.
---
# Samtaler og sitater
Source: https://nordvec.com/no/docs/guides/concepts/conversations
En samtale er en chat som er basert på dokumentene dine, der hvert svar spores tilbake til kilden sin.
En **samtale** er en chat som er forankret i dokumentene dine. Du stiller et spørsmål,
Nordvec henter de relevante avsnittene, og svarer basert på dem, med henvisninger til
dokumentene som ble brukt. Hvis dokumentene ikke gir grunnlag for et svar, sier den ifra i stedet for å gjette.
## Henvisninger er poenget [#henvisninger-er-poenget]
Hvert svar inneholder kildene det er bygget på. Dette er med vilje: et RAG-svar du ikke kan spore, er en risiko, ikke en funksjon. Henvisningene lar et menneske hoppe til det eksakte dokumentet en påstand kommer fra og bekrefte den, akkurat det som regulert og høyrisk arbeid trenger.
Svar genereres av AI. Henvisninger er det som gjør dem verifiserbare, ikke bare plausible.
## Samtaler tilhører en person [#samtaler-tilhører-en-person]
En samtale eies av den påloggede personen som startet den, så endepunktene svarer til en **sesjon**, aldri til en API-nøkkel. En nøkkel er sin egen hovedaktør uten egen chatthistorikk. Se [Autentisering](/docs/guides/authentication).
Med en sesjon kan du:
* **Opprette** en samtale (`POST /conversations`).
* **Liste** og **søke** i samtalene dine (`GET /conversations`, `GET /conversations/search`).
* **Hente** en samtale med de nyeste meldingene (`GET /conversations/{id}`), og bla tilbake gjennom eldre historikk (`GET /conversations/{id}/messages`).
* **Liste dokumentene** en samtale har trukket på (`GET /conversations/{id}/documents`).
Se [API-referansen](/docs/api) for eksakte forespørsel- og responsstrukturer.
## Tilbakemelding [#tilbakemelding]
Du kan sende inn tilbakemelding på et svar og på avsnittene som ble hentet. Dette signalet brukes til å forbedre hentekvaliteten over tid.