Passer au contenu principal
Une dimension correspond à un sujet ; une intention correspond à ce qu’une question cherche à apprendre. Le niveau choisi fixe combien d’intentions distinctes doivent être traitées dans chaque dimension.

Essentiel, Équilibré, Approfondi

Le seuil est plafonné au nombre d’intentions disponibles : si une dimension n’en contient que deux, Approfondi en exige deux. Il ne demande pas d’inventer une troisième question.

Exemple : la dimension Budget

Si les deux premières questions sont regroupées dans la version publiée, y répondre deux fois ne couvre pas deux intentions. En revanche, traiter le montant et la flexibilité couvre deux angles distincts.

Quand une intention est-elle couverte ?

  • Une question de cette intention a reçu une réponse enregistrée comme asked_answered.
  • Ou l’information recherchée est déjà connue : une donnée confirmée ou non applicable, ou un sujet exploratoire suffisamment couvert.
Pour ce second cas, une exploration est considérée satisfaite à partir d’une couverture de 0.70. Une question simplement posée, refusée ou laissée sans réponse ne suffit pas. Une réponse déjà enregistrée comme asked_answered compte même si l’analyse n’a pas extrait toutes les précisions possibles. Le regroupement des questions proches dépend de la version publiée. Le client ne saisit pas manuellement une liste d’intentions pour chaque appel.

Lire l’état d’une dimension

Le champ computed_status reflète ce calcul. effective_status tient aussi compte d’une éventuelle décision explicite de votre intégration, par exemple exclure une dimension.
Le pourcentage de progression et le statut ne désignent pas la même chose. Une dimension peut être covered sans afficher 100 % : son seuil est atteint, sans que toutes ses questions ou données soient épuisées.

Dimension couverte et réussite globale

Couvrir une dimension ne garantit pas que toutes les données nécessaires sont collectées. Exemple : en Essentiel, le budget a été abordé, mais l’adresse e-mail déclarée comme information à collecter manque encore. La dimension peut être couverte ; la qualification globale reste incomplète. Sans décision explicite de votre intégration, la réussite globale vérifie aussi :
  • que les informations à collecter des dimensions non exclues sont confirmées ou non applicables ;
  • que les données des dimensions obligatoires sont conclues ;
  • que la couverture moyenne des dimensions de rôle Important (contributing) atteint le niveau attendu : aucun minimum supplémentaire en Essentiel, 80 % en Équilibré, 100 % en Approfondi.
Cette moyenne mesure la couverture des données et des intentions, pas le pourcentage de questions posées. Le rôle optionnel n’impose pas de seuil de couverture, mais une information explicitement déclarée comme nécessaire à la réussite reste à collecter.
Une dimension obligatoire sans donnée à collecter ne bloque pas, à elle seule, la réussite globale. Choisissez soigneusement les informations à collecter plutôt que de vous fier seulement au nom du rôle.

Qui décide de terminer ?

objective_achieved est un avertissement, pas un arrêt automatique : votre application décide de poursuivre ou de conclure. La limite de tours est un arrêt : une fois max_turns atteint, /next renvoie action: "stop" avec stop_reason: "max_turns_reached". action: "stop" est aussi renvoyé lorsqu’aucune question n’est disponible. Voir les signaux de décision.