# Context pack: Grundlegende Konzepte Source: https://nordvec.com/de/docs/guides/concepts Pack: https://nordvec.com/de/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. [Grundlegende Konzepte](https://nordvec.com/de/docs/guides/concepts) (this guide) 2. [Dokumente & Suche](https://nordvec.com/de/docs/guides/concepts/documents) (linked from this guide) 3. [Unterhaltungen & Zitate](https://nordvec.com/de/docs/guides/concepts/conversations) (linked from this guide) --- # Grundlegende Konzepte Source: https://nordvec.com/de/docs/guides/concepts Die zwei Dinge, auf denen alles in Nordvec aufbaut: Dokumente, die du durchsuchen kannst, und Gespräche, die sie zitieren. Jeder Connector, Push und jede Suche in Nordvec erstellt oder liest ein Dokument, und jede Antwort, die der Assistent gibt, ist eine Konversation, die auf diesen Dokumenten basiert. Beginne hier, um zu erfahren, was jedes Dokument enthält und wer es sehen kann. - [Dokumente & Suche](https://nordvec.com/de/docs/guides/concepts/documents): Dokumente sind die durchsuchbare Einheit in Nordvec. Nimm sie auf und finde sie dann mit der Volltextsuche über die API. - [Unterhaltungen & Zitate](https://nordvec.com/de/docs/guides/concepts/conversations): Eine Unterhaltung ist ein Chat, der auf deinen Dokumenten basiert, bei dem jede Antwort auf ihre Quelle zurückverfolgt wird. --- # Dokumente & Suche Source: https://nordvec.com/de/docs/guides/concepts/documents Dokumente sind die durchsuchbare Einheit in Nordvec. Nimm sie auf und finde sie dann mit der Volltextsuche über die API. Ein **Dokument** ist die Einheit, über die Nordvec sucht: eine Datei, eine Seite, eine Nachricht, eine E-Mail, was auch immer du ingestierst. Sobald ein Dokument verarbeitet ist, wird es durchsuchbar und kann in einer Antwort zitiert werden. ## Dokumente ingestieren [#dokumente-ingestieren] Dokumente gelangen auf drei Wegen in deinen Arbeitsbereich: * **Connectors** synchronisieren aus einer Quelle, die dir gehört (dem Connector-Eigentümer). Neue und geänderte Dokumente werden automatisch erfasst. Sieh dir den [Connector-Katalog](/docs/guides/connectors) an. * **Uploads** von Dateien, die du in der App hinzufügst. * **Push** sendet ein Dokument direkt von deinem eigenen System an Nordvec. Sieh dir [Dokumente pushen](/docs/guides/how-to/push-documents) an. Unabhängig davon, wie es ankommt, verarbeitet Nordvec das Dokument, teilt es in Passagen auf und indexiert es für die Abfrage. Deine Dokumente werden in der EU gespeichert und durchsucht. Ein Dokument hat einen `status`: `processing` während es indexiert wird, `indexed` sobald jeder Verarbeitungsschritt abgeschlossen ist, und `failed`, wenn es nicht verarbeitet werden konnte. ## Wer ein Dokument sieht [#wer-ein-dokument-sieht] Ein Dokument aus einem Connector ist privat für die Person, die es verbunden hat, bis diese es freigibt. Ein API-Schlüssel gehört zum Arbeitsbereich, sodass er sieht, was der Arbeitsbereich teilt, und niemals die nicht freigegebenen Dokumente einer Person. ## Suche [#suche] `/documents/search` ist eine **Volltextsuche** über den Titel und den gesamten Text jedes Dokuments, das du sehen kannst, egal wie lang das Dokument ist. Wörter stimmen in der Form überein, in der du sie schreibst, in jeder Sprache, und Akzente werden auf beiden Seiten ignoriert, sodass `cafe` `café` findet. Es gibt keine Stammformreduktion: `invoice` stimmt nicht mit `invoices` überein. Die Suche läuft eigenständig, ohne Konversationskontext. Sie gibt gerankte Dokumente zurück, jedes mit einem Ausschnitt aus der am besten passenden Passage und einem Relevanzwert zwischen 0 und, aber nie ganz, 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 kannst Dokumente auch auflisten (`/documents/list`) oder eines nach ID abrufen (`/documents/{id}`). Siehe das [API-Referenz](/docs/api) für den vollständigen Satz an Parametern und Antwortformaten. ### Probier es aus [#probier-es-aus] Führe eine Abfrage gegen einen kleinen Demo-Korpus aus. Dies durchsucht sechs Beispieldokumente in deinem Browser, gerankt und mit Quellenangabe, in derselben Form, die eine echte Suche zurückgibt. Semantische Abfrage, die Passagen nach Bedeutung statt nach exakten Wörtern zuordnet, ist das, was die zitierten Antworten einer [Konversation](/docs/guides/concepts/conversations) antreibt. Der Suchendpunkt selbst ordnet Wörter zu. Die Suche gibt nur Dokumente zurück, die der Aufrufer sehen darf. Der Zugriff wird in der Datenbank erzwungen, nicht im Anwendungscode. ## Inhaltstypen [#inhaltstypen] Ein Dokument kann einen Wissenstyp in `content_type` tragen (zum Beispiel `decision`, `runbook`, `policy` oder `faq`). Ein gepushtes Dokument setzt ihn mit dem `type` der Push-API; ein Dokument ohne Typ hat `content_type: null`. Suche und Auflistung filtern beide mit `contentType` danach. ## Wo Dokumente zitiert werden [#wo-dokumente-zitiert-werden] Die Suche liefert dir Passagen, mit denen du direkt arbeiten kannst. Wenn du stattdessen eine schriftliche Antwort möchtest, ruft eine [Konversation](/docs/guides/concepts/conversations) über dieselben Dokumente ab und zitiert sie in ihrer Antwort. --- # Unterhaltungen & Zitate Source: https://nordvec.com/de/docs/guides/concepts/conversations Eine Unterhaltung ist ein Chat, der auf deinen Dokumenten basiert, bei dem jede Antwort auf ihre Quelle zurückverfolgt wird. Eine **Unterhaltung** ist ein Chat, der auf deinen Dokumenten basiert. Du stellst eine Frage, Nordvec ruft die relevanten Passagen ab und antwortet darauf, wobei es die verwendeten Dokumente zitiert. Wenn die Dokumente keine Antwort stützen, sagt es das, anstatt zu raten. ## Zitate sind der entscheidende Punkt [#zitate-sind-der-entscheidende-punkt] Jede Antwort enthält die Quellen, aus denen sie erstellt wurde. Das ist Absicht: Eine RAG-Antwort, die du nicht nachverfolgen kannst, ist ein Risiko, keine Funktion. Die Zitate ermöglichen es einer Person, direkt zu dem Dokument zu springen, aus dem eine Aussage stammt, und sie zu bestätigen – genau das, was regulierte und hochriskante Arbeiten erfordern. Antworten werden von KI generiert. Zitate sind es, die sie überprüfbar machen, nicht nur plausibel. ## Unterhaltungen gehören einer Person [#unterhaltungen-gehören-einer-person] Eine Unterhaltung gehört der angemeldeten Person, die sie gestartet hat. Daher antworten ihre Endpunkte auf eine **Sitzung**, nie auf einen API-Schlüssel. Ein Schlüssel ist sein eigenes Hauptprinzip ohne eigene Chat-Historie; siehe [Authentifizierung](/docs/guides/authentication). Mit einer Sitzung kannst du: * Eine Unterhaltung **erstellen** (`POST /conversations`). * Deine Unterhaltungen **auflisten** und **durchsuchen** (`GET /conversations`, `GET /conversations/search`). * Eine Unterhaltung mit ihren letzten Nachrichten **abrufen** (`GET /conversations/{id}`) und durch ältere Historie blättern (`GET /conversations/{id}/messages`). * Die **Dokumente auflisten**, auf die eine Unterhaltung zurückgegriffen hat (`GET /conversations/{id}/documents`). Weitere Details zu den genauen Anfrage- und Antwortformaten findest du im [API-Referenz](/docs/api). ## Feedback [#feedback] Du kannst Feedback zu einer Antwort und zu den abgerufenen Passagen geben. Dieses Signal wird genutzt, um die Abrufqualität im Laufe der Zeit zu verbessern.