> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zelinqa.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Comment fonctionne NBQ
> De la base de questions à la décision retournée à chaque tour.
NBQ sépare deux moments : **préparer le parcours** et **conduire une conversation**.
## 1. Préparer une configuration
Une configuration contient :
* un objectif de qualification ;
* des sous-objectifs, par exemple *besoin*, *budget* et *délai* ;
* les questions que le moteur peut proposer ;
* les informations de réussite à collecter ;
* des règles simples de longueur et d'ordre du parcours.
Les changements restent dans un **brouillon**. Ils n'affectent pas la version actuellement utilisée par les visiteurs.
## 2. Publier une version
La publication vérifie la cohérence du brouillon puis lance une compilation asynchrone. Quand elle réussit, une nouvelle version devient active.
Fermer NBQ Studio n'arrête pas une compilation. Le travail est exécuté côté serveur et son statut reste consultable avec son identifiant.
## 3. Décider pendant la conversation
Pour chaque réponse, votre backend appelle `/v1/sessions/{session_id}/next`. NBQ :
1. comprend le tour précédent ou applique la réponse structurée ;
2. met à jour ce qui est connu ;
3. recalcule la progression ;
4. écarte les questions interdites ou déjà résolues ;
5. classe les questions restantes et retourne les meilleures candidates.
Une réponse à choix peut être appliquée de façon déterministe. Un texte libre peut demander une analyse sémantique. L'API indique un fonctionnement dégradé dans `degraded` et `degraded_reasons` si cette analyse n'est pas disponible.
## Ce que l'API expose
L'API publique expose la décision, les questions, l'état utile et la progression. Elle n'expose ni prompt interne, ni embedding, ni preuve détaillée, ni paramètres de classement.
Découvrez comment enchaîner création, tours, événements, lecture et feedback.