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

# Utilisation et limites

> Comptage des conversations, contraintes du contrat et bonnes pratiques de débit.

## Comptage

Une session est comptée lorsqu'elle réalise son **premier tour utile**. Créer une session sans appeler `/next` ne consomme pas une conversation. Les tours suivants de la même session ne créent pas une nouvelle conversation facturable.

Votre contrat détermine l'allocation, le dépassement éventuel et les limites de débit. Consultez la page **Consommation** de Zelinqa Studio pour les valeurs de votre organisation.

## Limites techniques importantes

| Élément | Limite du contrat |
| - | - |
| Tours par session (`max_turns`) | 1 à 100 ; limite **souple** : le moteur peut encore proposer une question et émettre `max_turns_reached` |
| Candidates demandées (`selection.candidate_count`) | 1 à 10 |
| Texte de réponse et formulation de la question (`user_text`, `assistant_text`) | 8 000 caractères chacun |
| Résumé de contexte (`context_update.text`) | 16 000 caractères |
| Questions proposées dans une réponse | 10 au maximum |

Toutes les mutations nécessitent `Idempotency-Key` ; les mutations d'une session existante nécessitent aussi `state_version`. Les métadonnées de feedback restent limitées à 50 propriétés avec des valeurs simples ; consultez la référence OpenAPI pour les bornes exactes de chaque champ. Ces limites de forme sont distinctes des quotas et du débit définis par votre contrat.

## En cas de 429

Appliquez un backoff exponentiel avec jitter, respectez les éventuels en-têtes de reprise et évitez les rafales coordonnées entre workers.

<Warning>
  N'utilisez pas les retries pour contourner un quota commercial ou une validation. Contactez votre administrateur si la limite est durablement insuffisante.
</Warning>


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