# Context pack: Concepts fondamentaux Source: https://nordvec.com/fr/docs/guides/concepts Pack: https://nordvec.com/fr/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. [Concepts fondamentaux](https://nordvec.com/fr/docs/guides/concepts) (this guide) 2. [Documents et recherche](https://nordvec.com/fr/docs/guides/concepts/documents) (linked from this guide) 3. [Conversations et citations](https://nordvec.com/fr/docs/guides/concepts/conversations) (linked from this guide) --- # Concepts fondamentaux Source: https://nordvec.com/fr/docs/guides/concepts Les deux éléments sur lesquels tout est construit dans Nordvec : des documents que vous pouvez rechercher et des conversations qui les citent. Chaque connecteur, chaque envoi et chaque recherche dans Nordvec produit ou lit un document. De plus, chaque réponse fournie par l’assistant s’appuie sur une conversation ancrée dans ces documents. Commencez ici pour découvrir le contenu de chacun d’eux et qui peut y accéder. - [Documents et recherche](https://nordvec.com/fr/docs/guides/concepts/documents): Les documents constituent l'unité interrogeable dans Nordvec. Ingérez-les, puis retrouvez-les grâce à une recherche en texte intégral via l'API. - [Conversations et citations](https://nordvec.com/fr/docs/guides/concepts/conversations): Une conversation est un échange basé sur vos documents, où chaque réponse est tracée jusqu'à sa source. --- # Documents et recherche Source: https://nordvec.com/fr/docs/guides/concepts/documents Les documents constituent l'unité interrogeable dans Nordvec. Ingérez-les, puis retrouvez-les grâce à une recherche en texte intégral via l'API. Un **document** est l'unité sur laquelle Nordvec effectue des recherches : un fichier, une page, un message, un e-mail, tout ce que vous ingérez. Une fois qu'un document est traité, il devient consultable et peut être cité dans une réponse. ## Ingestion de documents [#ingestion-de-documents] Les documents intègrent votre espace de travail de trois manières : * **Les connecteurs** synchronisent depuis une source que vous possédez (le propriétaire du connecteur). Les nouveaux documents et les modifications sont récupérés automatiquement. Consultez le [catalogue des connecteurs](/docs/guides/connectors). * **Les téléversements** de fichiers que vous ajoutez dans l'application. * **Le Push** envoie un document à Nordvec directement depuis votre propre système. Voir [Push documents](/docs/guides/how-to/push-documents). Quelle que soit la manière dont il arrive, Nordvec traite le document, le divise en passages et l'indexe pour la récupération. Vos documents sont stockés et recherchés dans l'UE. Un document possède un `status` : `processing` pendant son indexation, `indexed` une fois toutes les étapes de traitement terminées, et `failed` lorsqu'il n'a pas pu être traité. ## Qui voit un document [#qui-voit-un-document] Un document provenant d'un connecteur est privé pour la personne qui l'a connecté jusqu'à ce que cette personne le partage. Une clé API appartient à l'espace de travail, elle voit donc ce que l'espace de travail partage et jamais les documents non partagés d'une personne. ## Recherche [#recherche] `/documents/search` est une recherche **en texte intégral** sur le titre et le texte complet de chaque document que vous pouvez voir, quelle que soit la longueur du document. Les mots correspondent sous la forme que vous les écrivez, dans n'importe quelle langue, et les accents sont ignorés des deux côtés, donc `cafe` trouve `café`. Il n'y a pas de racinisation : `invoice` ne correspond pas à `invoices`. La recherche s'exécute de manière autonome, sans contexte de conversation. Elle renvoie des documents classés, chacun avec un extrait de son passage le mieux correspondant et un score de pertinence allant de 0 jusqu'à, mais sans jamais atteindre, 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 }' ``` Vous pouvez également lister les documents (`/documents/list`) ou en récupérer un par identifiant (`/documents/{id}`). Consultez la [référence de l'API](/docs/api) pour l'ensemble complet des paramètres et des formes de réponse. ### Essayez [#essayez] Exécutez une requête sur un petit corpus de démonstration. Cette recherche interroge six documents exemples dans votre navigateur, classés et sourcés, avec la même structure qu'une recherche réelle renvoie. La récupération sémantique, qui correspond aux passages par leur sens plutôt que par des mots exacts, est ce qui alimente les réponses citées d'une [conversation](/docs/guides/concepts/conversations). Le point de terminaison de recherche lui-même correspond aux mots. La recherche ne renvoie jamais que les documents que l'appelant est autorisé à voir. L'accès est appliqué dans la base de données, pas dans le code applicatif. ## Types de contenu [#types-de-contenu] Un document peut porter un type de connaissance dans `content_type` (par exemple `decision`, `runbook`, `policy` ou `faq`). Un document poussé le définit avec le `type` de l'API push ; un document sans type a `content_type: null`. La recherche et la liste filtrent toutes deux sur ce type avec `contentType`. ## Où les documents sont cités [#où-les-documents-sont-cités] La recherche vous fournit des passages avec lesquels travailler directement. Lorsque vous souhaitez une réponse écrite plutôt que des passages bruts, une [conversation](/docs/guides/concepts/conversations) récupère les mêmes documents et les cite dans sa réponse. --- # Conversations et citations Source: https://nordvec.com/fr/docs/guides/concepts/conversations Une conversation est un échange basé sur vos documents, où chaque réponse est tracée jusqu'à sa source. Une **conversation** est un échange ancré dans vos documents. Vous posez une question, Nordvec récupère les passages pertinents, et répond en s'appuyant sur eux, en citant les documents utilisés. Si les documents ne permettent pas de répondre, il l'indique plutôt que de deviner. ## Les citations sont essentielles [#les-citations-sont-essentielles] Chaque réponse inclut les sources sur lesquelles elle s'appuie. Ce choix est délibéré : une réponse RAG que vous ne pouvez pas retracer constitue un risque, pas une fonctionnalité. Les citations permettent à un humain de consulter directement le document exact d'où provient une affirmation et de la vérifier, ce qui est précisément ce dont les environnements réglementés et à enjeux élevés ont besoin. Les réponses sont générées par IA. Ce sont les citations qui les rendent vérifiables, et non simplement plausibles. ## Les conversations appartiennent à une personne [#les-conversations-appartiennent-à-une-personne] Une conversation est la propriété de la personne connectée qui l'a initiée, ses points de terminaison répondent donc à une **session**, jamais à une clé API. Une clé est son propre principal sans historique de discussion ; consultez [Authentification](/docs/guides/authentication). Avec une session, vous pouvez : * **Créer** une conversation (`POST /conversations`). * **Lister** et **rechercher** vos conversations (`GET /conversations`, `GET /conversations/search`). * **Récupérer** une conversation avec ses messages récents (`GET /conversations/{id}`), et parcourir l'historique plus ancien (`GET /conversations/{id}/messages`). * **Lister les documents** sur lesquels une conversation s'est appuyée (`GET /conversations/{id}/documents`). Consultez la [référence de l'API](/docs/api) pour connaître les formats exacts des requêtes et des réponses. ## Retour d'information [#retour-dinformation] Vous pouvez soumettre un retour d'information sur une réponse et sur les passages qui ont été récupérés. Ce signal est utilisé pour améliorer la qualité de la récupération au fil du temps.