# Context pack: Grundlæggende begreber
Source: https://nordvec.com/da/docs/guides/concepts
Pack: https://nordvec.com/da/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. [Grundlæggende begreber](https://nordvec.com/da/docs/guides/concepts) (this guide)
2. [Dokumenter og søgning](https://nordvec.com/da/docs/guides/concepts/documents) (linked from this guide)
3. [Samtaler og citater](https://nordvec.com/da/docs/guides/concepts/conversations) (linked from this guide)
---
# Grundlæggende begreber
Source: https://nordvec.com/da/docs/guides/concepts
De to ting, som alt i Nordvec er bygget på, dokumenter, du kan søge i, og samtaler, der citerer dem.
Hver connector, push og søgning i Nordvec producerer eller læser et dokument, og
hvert svar, assistenten giver, er en samtale, der er forankret i disse dokumenter.
Start her for at lære, hvad hvert enkelt indeholder, og hvem der kan se det.
- [Dokumenter og søgning](https://nordvec.com/da/docs/guides/concepts/documents): Dokumenter er den søgbare enhed i Nordvec. Indlæs dem, og find dem derefter med fuldtekstsøgning via API'et.
- [Samtaler og citater](https://nordvec.com/da/docs/guides/concepts/conversations): En samtale er en chat, der er baseret på dine dokumenter, hvor hvert svar kan spores tilbage til sin kilde.
---
# Dokumenter og søgning
Source: https://nordvec.com/da/docs/guides/concepts/documents
Dokumenter er den søgbare enhed i Nordvec. Indlæs dem, og find dem derefter med fuldtekstsøgning via API'et.
Et **dokument** er den enhed, som Nordvec søger i: en fil, en side, en besked, en
e-mail, hvad som helst, du indtager. Når et dokument er behandlet, bliver det søgbart
og kan citeres i et svar.
## Indtagelse af dokumenter [#indtagelse-af-dokumenter]
Dokumenter kommer ind i dit arbejdsområde på tre måder:
* **Connectors** synkroniserer fra en kilde, du ejer (connector-ejeren). Nye og
ændrede dokumenter bliver hentet automatisk. Se
[connector-kataloget](/docs/guides/connectors).
* **Uploads** af filer, du tilføjer i appen.
* **Push** sender et dokument til Nordvec direkte fra dit eget system. Se
[Push-dokumenter](/docs/guides/how-to/push-documents).
Uanset hvordan det ankommer, behandler Nordvec dokumentet, opdeler det i passager og
indekserer det til genfinding. Dine dokumenter gemmes og søges i EU.
Et dokument har en `status`: `processing`, mens det bliver indekseret, `indexed`,
når alle behandlingstrin er afsluttet, og `failed`, hvis det ikke kunne behandles.
## Hvem ser et dokument [#hvem-ser-et-dokument]
Et dokument fra en connector er privat for den person, der har forbundet det, indtil den pågældende person deler det. En API-nøgle tilhører arbejdsområdet, så den ser, hvad arbejdsområdet deler, og aldrig en persons udelte dokumenter.
## Søgning [#søgning]
`/documents/search` er **fuldtekstsøgning** i titlen og hele teksten
i alle dokumenter, du kan se, uanset hvor langt dokumentet er. Ord matcher i den
form, du skriver dem, på ethvert sprog, og accenttegn ignoreres på begge sider, så
`cafe` finder `café`. Der er ingen ordstammeanalyse: `invoice` matcher ikke `invoices`.
Søgning kører selvstændigt uden samtalekontekst. Den returnerer rangerede
dokumenter, hver med et uddrag fra den bedst matchende passage og en relevansscore
fra 0 og op til, men aldrig 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 et enkelt efter id
(`/documents/{id}`). Se [API-referencen](/docs/api) for det fulde sæt af
parametre og svarskemaer.
### Prøv det [#prøv-det]
Kør en forespørgsel mod et lille demokorpus. Dette søger i seks eksempel-dokumenter i
din browser, rangeret og med kilder, i samme format, som en rigtig søgning returnerer.
Semantisk genfinding, der matcher passager efter betydning frem for eksakte ord,
er det, der driver en [samtales](/docs/guides/concepts/conversations) citerede
svar. Søgningsendepunktet selv matcher ord.
Søgning returnerer kun dokumenter, som den kaldende part har adgang til at se. Adgang
håndhæves i databasen, ikke i applikationskoden.
## Indholdstyper [#indholdstyper]
Et dokument kan have en videns-type i `content_type` (for eksempel
`decision`, `runbook`, `policy` eller `faq`). Et push-dokument angiver den med
push-API'ets `type`; et dokument uden type har `content_type: null`. Både søgning og
liste filtrerer på den med `contentType`.
## Hvor dokumenter citeres [#hvor-dokumenter-citeres]
Søgning giver dig passager at arbejde direkte med. Når du ønsker et skriftligt svar
i stedet for rå passager, henter en [samtale](/docs/guides/concepts/conversations)
i de samme dokumenter og citerer dem i sit svar.
---
# Samtaler og citater
Source: https://nordvec.com/da/docs/guides/concepts/conversations
En samtale er en chat, der er baseret på dine dokumenter, hvor hvert svar kan spores tilbage til sin kilde.
En **samtale** er en chat, der er forankret i dine dokumenter. Du stiller et spørgsmål,
Nordvec henter de relevante passager, og den svarer ud fra dem med henvisninger til
de dokumenter, den har brugt. Hvis dokumenterne ikke understøtter et svar, siger den det i stedet for at gætte.
## Henvisninger er pointen [#henvisninger-er-pointen]
Hvert svar indeholder de kilder, det er bygget på. Det er med vilje: Et RAG-svar, du ikke kan spore, er en risiko, ikke en funktion. Henvisningerne giver en person mulighed for at springe direkte til det præcise dokument, en påstand stammer fra, og bekræfte den, hvilket er præcis, hvad reguleret og højrisiko-arbejde har brug for.
Svar genereres af AI. Henvisninger er det, der gør dem verificerbare, ikke bare plausible.
## Samtaler tilhører en person [#samtaler-tilhører-en-person]
En samtale ejes af den person, der er logget ind og startede den, så dens
endepunkter svarer til en **session**, aldrig til en API-nøgle. En nøgle er sin egen
hovedaktør uden egen chat-historik; se
[Godkendelse](/docs/guides/authentication).
Med en session kan du:
* **Oprette** en samtale (`POST /conversations`).
* **Liste** og **søge** i dine samtaler (`GET /conversations`,
`GET /conversations/search`).
* **Hente** en samtale med dens seneste beskeder
(`GET /conversations/{id}`), og bladre tilbage gennem ældre historik
(`GET /conversations/{id}/messages`).
* **Liste de dokumenter**, en samtale har trukket på
(`GET /conversations/{id}/documents`).
Se [API-referencen](/docs/api) for de præcise anmodnings- og svarsformater.
## Feedback [#feedback]
Du kan indsende feedback på et svar og på de passager, der blev hentet.
Dette signal bruges til at forbedre hentningskvaliteten over tid.