Comment fonctionne NBQ

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.

​

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.