# Context pack: Basisbegrippen Source: https://nordvec.com/nl/docs/guides/concepts Pack: https://nordvec.com/nl/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. [Basisbegrippen](https://nordvec.com/nl/docs/guides/concepts) (this guide) 2. [Documenten & zoeken](https://nordvec.com/nl/docs/guides/concepts/documents) (linked from this guide) 3. [Gesprekken & bronvermeldingen](https://nordvec.com/nl/docs/guides/concepts/conversations) (linked from this guide) --- # Basisbegrippen Source: https://nordvec.com/nl/docs/guides/concepts De twee dingen waarop alles in Nordvec is gebouwd: documenten die je kunt doorzoeken en gesprekken die ernaar verwijzen. Elke connector, push en zoekopdracht in Nordvec produceert of leest een document, en elk antwoord dat de assistent geeft, is een gesprek dat gebaseerd is op die documenten. Begin hier om te leren wat elk document bevat en wie het kan zien. - [Documenten & zoeken](https://nordvec.com/nl/docs/guides/concepts/documents): Documenten zijn de doorzoekbare eenheid in Nordvec. Voeg ze toe en vind ze vervolgens met full-text zoeken via de API. - [Gesprekken & bronvermeldingen](https://nordvec.com/nl/docs/guides/concepts/conversations): Een gesprek is een chat die gebaseerd is op jouw documenten, waarbij elk antwoord terug te leiden is naar de bron. --- # Documenten & zoeken Source: https://nordvec.com/nl/docs/guides/concepts/documents Documenten zijn de doorzoekbare eenheid in Nordvec. Voeg ze toe en vind ze vervolgens met full-text zoeken via de API. Een **document** is de eenheid waarover Nordvec zoekt: een bestand, een pagina, een bericht, een e-mail, wat je ook maar importeert. Zodra een document is verwerkt, wordt het doorzoekbaar en kan het geciteerd worden in een antwoord. ## Documenten importeren [#documenten-importeren] Documenten komen op drie manieren in jouw werkruimte terecht: * **Connectors** synchroniseren vanuit een bron die jij bezit (de eigenaar van de connector). Nieuwe en gewijzigde documenten worden automatisch opgepikt. Bekijk de [connectorcatalogus](/docs/guides/connectors). * **Uploads** van bestanden die je toevoegt in de app. * **Push** stuurt een document rechtstreeks naar Nordvec vanuit jouw eigen systeem. Zie [Documenten pushen](/docs/guides/how-to/push-documents). Hoe het document ook aankomt, Nordvec verwerkt het, splitst het in passages en indexeert het voor retrieval. Jouw documenten worden opgeslagen en doorzocht in de EU. Een document heeft een `status`: `processing` terwijl het geïndexeerd wordt, `indexed` zodra elke verwerkingsstap is voltooid, en `failed` wanneer het niet verwerkt kon worden. ## Wie een document ziet [#wie-een-document-ziet] Een document van een connector is privé voor de persoon die hem heeft aangesloten, totdat die persoon het deelt. Een API-sleutel behoort tot de werkruimte, dus ziet die wat de werkruimte deelt en nooit iemands niet-gedeelde documenten. ## Zoeken [#zoeken] `/documents/search` is **full-text** zoeken in de titel en de volledige tekst van elk document dat je kunt zien, hoe lang het document ook is. Woorden matchen in de vorm waarin je ze schrijft, in elke taal, en accenten worden aan beide kanten genegeerd, dus `cafe` vindt `café`. Er is geen stemming: `invoice` matcht niet met `invoices`. Zoeken werkt standalone, zonder gesprekscontext. Het retourneert gerangschikte documenten, elk met een snippet uit de best passende passage en een relevantiescore van 0 tot, maar nooit bereikend, 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 }' ``` Je kunt ook documenten opvragen (`/documents/list`) of een document ophalen via id (`/documents/{id}`). Bekijk de [API-referentie](/docs/api) voor de volledige set parameters en responsvormen. ### Probeer het uit [#probeer-het-uit] Voer een zoekopdracht uit op een kleine democorpus. Dit doorzoekt zes voorbeelddocumenten in jouw browser, gerangschikt en met bronvermelding, in dezelfde vorm als een echte zoekopdracht retourneert. Semantische retrieval, die passages matcht op betekenis in plaats van exacte woorden, is wat een [gesprek](/docs/guides/concepts/conversations) van geciteerde antwoorden voorziet. Het zoekendpoint zelf matcht woorden. Zoeken retourneert alleen documenten die de aanroeper mag zien. Toegang wordt afgedwongen in de database, niet in de applicatiecode. ## Contenttypes [#contenttypes] Een document kan een kennistype bevatten in `content_type` (bijvoorbeeld `decision`, `runbook`, `policy` of `faq`). Een gepusht document stelt dit in met de `type` van de push-API; een document zonder type heeft `content_type: null`. Zoeken en opvragen filteren beide hierop met `contentType`. ## Waar documenten geciteerd worden [#waar-documenten-geciteerd-worden] Zoeken levert passages op waarmee je direct kunt werken. Als je liever een geschreven antwoord hebt in plaats van ruwe passages, haalt een [gesprek](/docs/guides/concepts/conversations) dezelfde documenten op en citeert ze in het antwoord. --- # Gesprekken & bronvermeldingen Source: https://nordvec.com/nl/docs/guides/concepts/conversations Een gesprek is een chat die gebaseerd is op jouw documenten, waarbij elk antwoord terug te leiden is naar de bron. Een **gesprek** is een chat die gebaseerd is op jouw documenten. Je stelt een vraag, Nordvec haalt de relevante passages op, en geeft antwoord op basis daarvan, met bronvermelding van de documenten die gebruikt zijn. Als de documenten geen antwoord ondersteunen, geeft het dat aan in plaats van te gokken. ## Bronvermeldingen zijn het doel [#bronvermeldingen-zijn-het-doel] Elk antwoord bevat de bronnen waarop het is gebaseerd. Dit is met opzet: een RAG-antwoord dat je niet kunt traceren, is een risico, geen feature. De bronvermeldingen laten een mens direct naar het exacte document springen waar een bewering vandaan komt en deze bevestigen, wat precies is wat gereguleerd en hoogrisicowerk nodig heeft. Antwoorden worden gegenereerd door AI. Bronvermeldingen zijn wat ze verifieerbaar maakt, niet alleen aannemelijk. ## Gesprekken horen bij een persoon [#gesprekken-horen-bij-een-persoon] Een gesprek is eigendom van de ingelogde persoon die het is gestart, dus de eindpunten reageren op een **sessie**, nooit op een API-sleutel. Een sleutel is een eigen hoofdgebruiker zonder eigen chatgeschiedenis; zie [Authenticatie](/docs/guides/authentication). Met een sessie kun je: * Een gesprek **aanmaken** (`POST /conversations`). * Jouw gesprekken **lijsten** en **doorzoeken** (`GET /conversations`, `GET /conversations/search`). * Een gesprek **ophalen** met de recente berichten (`GET /conversations/{id}`), en terugbladeren door oudere geschiedenis (`GET /conversations/{id}/messages`). * De **documenten** **lijsten** waar een gesprek gebruik van heeft gemaakt (`GET /conversations/{id}/documents`). Bekijk de [API-referentie](/docs/api) voor de exacte vorm van verzoek en antwoord. ## Feedback [#feedback] Je kunt feedback geven op een antwoord en op de passages die zijn opgehaald. Dat signaal wordt gebruikt om de kwaliteit van het ophalen in de loop van de tijd te verbeteren.