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.- Python
- TypeScript
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.- Python
- TypeScript
Question semi-ouverte
Les choix seuls suffisent. Si la personne ajoute une explication, transmettez-la dansfree_text / freeText. Un texte « autre » seul est aussi possible.
- Python
- TypeScript
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.- Python
- TypeScript
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.
- Python
- TypeScript
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.
- Python
- TypeScript
Ce que fait le SDK
Pouranswer(...), 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èsapply_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_idsont conservés. - Sinon,
pending_decisionporte une nouvelle décision, avec un nouveaudecision_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_decisionvautnull, la session reste active et le prochain appel ànext()choisit.
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.