Passer au contenu principal
Ces exemples supposent une session déjà créée avec le démarrage rapide. Ce sont des variantes indépendantes : n’envoyez pas toutes ces réponses pour une même question. Les libellés de choix sont illustratifs ; utilisez ceux de votre question.

Question ouverte

Envoyez les mots réellement saisis par la personne.

Question à choix

Utilisez les libellés exacts renvoyés par la question en attente. Un seul libellé pour un choix unique ; plusieurs seulement si la question autorise les choix multiples.

Question semi-ouverte

Les choix seuls suffisent. Si la personne ajoute une explication, transmettez-la dans free_text / freeText. Un texte « autre » seul est aussi possible.

Pas de réponse ou refus

Ces issues n’ont pas besoin de texte. Elles ne doivent pas remplacer une réponse réellement donnée.

Contexte reçu en dehors de l’échange

apply_events / applyEvents met à jour l’état sans consommer de tour. Ce texte peut être analysé par le moteur. La décision en attente est ensuite recalculée : voir Quand la question en attente change.

Donnée déjà connue

Utilisez l’identifiant stable de l’information configurée dans votre domaine, pas un identifiant inventé. Ici, available_budget doit exister dans la version publiée. Une valeur structurée confirmée n’a pas besoin d’analyse de texte.

Ce que fait le SDK

Pour answer(...), il rattache la réponse à la décision en attente et résout les libellés de choix. Une question ouverte répondue sans texte est rejetée localement, avant l’appel réseau. Il renvoie ensuite la prochaine décision, pas seulement un accusé de réception. Choix seuls et issues sans réponse ne nécessitent pas d’appel modèle, tant qu’aucun autre texte à analyser n’est fourni. Le texte libre fourni est analysé par le moteur : ne recopiez pas systématiquement un libellé de choix dans user_text.

Quand la question en attente change

Après apply_events / applyEvents, la décision en attente est recalculée sur l’état mis à jour, avec les contraintes de sélection de l’appel qui l’a proposée. Cette étape n’appelle aucun modèle et ne consomme pas de tour.
  • Si les mêmes candidates restent les plus utiles, la décision et son decision_id sont conservés.
  • Sinon, pending_decision porte une nouvelle décision, avec un nouveau decision_id. Fournir l’information que demandait la question en attente en est le cas courant : cette question est retirée.
  • S’il ne reste aucune question, la session s’arrête (status: "stopped"). Si seules les contraintes de sélection de l’appel d’origine ne laissent plus de question, pending_decision vaut null, la session reste active et le prochain appel à next() choisit.
Posez la question de la décision renvoyée. Le handle de session la suit : answer(...) y rattache la réponse suivante. Si votre application avait déjà affiché la question remplacée et que la personne y répond, n’envoyez pas cette réponse avec answer(...), qui vise toujours la décision en attente : transmettez-la comme contexte avec apply_events / applyEvents. Par l’API REST, un previous_turn qui cite le decision_id remplacé est accepté une fois par /next : la réponse est rattachée à cette question si elle reste candidate ; sinon elle est lue comme contexte, sans enregistrer de réponse pour la question retirée ni consommer de tour. Voir Gérer une conversation.