> ## 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.

# Progression et qualification

> Comprendre quand une dimension est couverte et ce qu'ajoutent les niveaux de qualification.

**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

| Niveau | Intentions à couvrir par dimension | Usage |
| - | - | - |
| **Essentiel** (`essential`) | **1** | Obtenir un premier éclairage sur le sujet. |
| **Équilibré** (`balanced`) | **2** | Examiner le sujet sous deux angles distincts. |
| **Approfondi** (`deep`) | **3** | Explorer davantage le sujet. |

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

| Question | Intention |
| - | - |
| « Quel budget avez-vous prévu ? » | Connaître le montant. |
| « Quelle enveloppe avez-vous réservée ? » | Une reformulation proche, pouvant appartenir à la même intention. |
| « Ce montant peut-il évoluer ? » | Comprendre la flexibilité. |
| « Ce budget a-t-il déjà été validé ? » | Connaître sa validation. |

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

| État calculé | Signification |
| - | - |
| `not_started` | Aucun progrès enregistré. |
| `in_progress` | Le sujet a commencé, mais le seuil d'intentions n'est pas atteint. |
| `covered` | Le seuil du niveau est atteint et aucune donnée de cette dimension n'est en conflit. |
| `blocked` | Une contradiction de données reste à résoudre, même si le seuil d'intentions est atteint. |

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.

<Note>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.</Note>

## 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 de réussite 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 de réussite 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 contributives 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.

<Info>Une dimension obligatoire sans donnée à collecter ne bloque pas, à elle seule, la réussite globale. Choisissez soigneusement les [informations à collecter](/fr/studio/success-information) plutôt que de vous fier seulement au nom du rôle.</Info>

## Qui décide de terminer ?

`objective_achieved` et `max_turns_reached` sont des avertissements, pas des arrêts automatiques. Votre application décide de poursuivre ou de conclure. `action: "stop"` signifie qu'aucune question n'est disponible. Voir [les signaux de décision](/fr/api-reference/decision-signals).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.