# Context pack: Grundläggande begrepp Source: https://nordvec.com/sv/docs/guides/concepts Pack: https://nordvec.com/sv/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äggande begrepp](https://nordvec.com/sv/docs/guides/concepts) (this guide) 2. [Dokument & sökning](https://nordvec.com/sv/docs/guides/concepts/documents) (linked from this guide) 3. [Konversationer & citeringar](https://nordvec.com/sv/docs/guides/concepts/conversations) (linked from this guide) --- # Grundläggande begrepp Source: https://nordvec.com/sv/docs/guides/concepts De två saker som allt i Nordvec bygger på, dokument du kan söka i och konversationer som citerar dem. Varje anslutning, push och sökning i Nordvec skapar eller läser ett dokument, och varje svar assistenten ger är en konversation som grundar sig i dessa dokument. Börja här för att lära dig vad varje dokument innehåller och vem som kan se det. - [Dokument & sökning](https://nordvec.com/sv/docs/guides/concepts/documents): Dokument är den sökbara enheten i Nordvec. Lägg in dem, sedan hittar du dem med fulltextsökning via API:t. - [Konversationer & citeringar](https://nordvec.com/sv/docs/guides/concepts/conversations): En konversation är en chatt som grundar sig i dina dokument, där varje svar spåras till sin källa. --- # Dokument & sökning Source: https://nordvec.com/sv/docs/guides/concepts/documents Dokument är den sökbara enheten i Nordvec. Lägg in dem, sedan hittar du dem med fulltextsökning via API:t. Ett **dokument** är den enhet som Nordvec söker igenom: en fil, en sida, ett meddelande, ett e-postmeddelande, vad du än importerar. När ett dokument har bearbetats blir det sökbart och kan citeras i ett svar. ## Importera dokument [#importera-dokument] Dokument kommer in i din arbetsyta på tre sätt: * **Anslutningar** synkroniserar från en källa du äger (anslutningens ägare). Nya och ändrade dokument hämtas automatiskt. Se [anslutningskatalogen](/docs/guides/connectors). * **Uppladdningar** av filer du lägger till i appen. * **Push** skickar ett dokument till Nordvec direkt från ditt eget system. Se [Push-dokument](/docs/guides/how-to/push-documents). Oavsett hur det anländer bearbetar Nordvec dokumentet, delar upp det i passager och indexerar det för hämtning. Dina dokument lagras och söks inom EU. Ett dokument har en `status`: `processing` medan det indexeras, `indexed` när alla bearbetningssteg är klara, och `failed` om det inte kunde bearbetas. ## Vem ser ett dokument [#vem-ser-ett-dokument] Ett dokument från en anslutning är privat för personen som kopplade den tills den personen delar det. En API-nyckel tillhör arbetsytan, så den ser vad arbetsytan delar och aldrig en persons odelade dokument. ## Sökning [#sökning] `/documents/search` är **fulltextsökning** över titeln och hela texten i varje dokument du kan se, oavsett hur långt dokumentet är. Ord matchar i den form du skriver dem, på vilket språk som helst, och accenter ignoreras på båda sidor, så `cafe` hittar `café`. Det finns ingen stamning: `invoice` matchar inte `invoices`. Sökningen körs fristående, utan samtalskontext. Den returnerar rankade dokument, var och ett med ett utdrag från dess bäst matchande passage och ett relevanspoäng från 0 upp till, 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 också lista dokument (`/documents/list`) eller hämta ett efter id (`/documents/{id}`). Se [API-referensen](/docs/api) för hela uppsättningen parametrar och svarsformat. ### Testa själv [#testa-själv] Kör en fråga mot ett litet demokorpus. Detta söker igenom sex exempel-dokument i din webbläsare, rankade och med källor, i samma format som en riktig sökning returnerar. Semantisk hämtning, som matchar passager efter betydelse istället för exakta ord, är det som driver en [konversations](/docs/guides/concepts/conversations) citerade svar. Sökningens slutpunkt matchar ord. Sökning returnerar endast dokument som den som anropar har rätt att se. Åtkomst tillämpas i databasen, inte i applikationskoden. ## Innehållstyper [#innehållstyper] Ett dokument kan ha en kunskapstyp i `content_type` (till exempel `decision`, `runbook`, `policy` eller `faq`). Ett pushat dokument anger den med push-API:ets `type`; ett dokument utan typ har `content_type: null`. Både sökning och listning filtrerar på den med `contentType`. ## Var dokument citeras [#var-dokument-citeras] Sökning ger dig passager att arbeta med direkt. När du vill ha ett skrivet svar istället för råa passager hämtar en [konversation](/docs/guides/concepts/conversations) över samma dokument och citerar dem i sitt svar. --- # Konversationer & citeringar Source: https://nordvec.com/sv/docs/guides/concepts/conversations En konversation är en chatt som grundar sig i dina dokument, där varje svar spåras till sin källa. En **konversation** är en chatt som är grundad i dina dokument. Du ställer en fråga, Nordvec hämtar de relevanta avsnitten, och svarar utifrån dem, med hänvisningar till de dokument som användes. Om dokumenten inte stöder ett svar, säger den det i stället för att gissa. ## Hänvisningar är poängen [#hänvisningar-är-poängen] Varje svar innehåller de källor som det byggts på. Detta är medvetet: ett RAG-svar som du inte kan spåra är en risk, inte en funktion. Hänvisningarna låter en människa hoppa till exakt det dokument ett påstående kommer från och bekräfta det, vilket är precis vad reglerat och högriskarbete behöver. Svar genereras av AI. Hänvisningar är det som gör dem verifierbara, inte bara trovärdiga. ## Konversationer tillhör en person [#konversationer-tillhör-en-person] En konversation ägs av den inloggade personen som startade den, så dess slutpunkter svarar till en **session**, aldrig till en API-nyckel. En nyckel är sin egen huvudaktör utan någon egen chathistorik; se [Autentisering](/docs/guides/authentication). Med en session kan du: * **Skapa** en konversation (`POST /conversations`). * **Lista** och **söka** bland dina konversationer (`GET /conversations`, `GET /conversations/search`). * **Hämta** en konversation med dess senaste meddelanden (`GET /conversations/{id}`), och bläddra tillbaka genom äldre historik (`GET /conversations/{id}/messages`). * **Lista de dokument** en konversation har använt (`GET /conversations/{id}/documents`). Se [API-referensen](/docs/api) för exakta begäranden och svarsformat. ## Feedback [#feedback] Du kan skicka in feedback på ett svar och på de avsnitt som hämtades. Den signalen används för att förbättra hämtningens kvalitet över tid.