Journal des modifications de l'API de chat publique

Cette page liste chaque version de l’API de chat publique. La version courante est la 1.4. Les versions mineures ajoutent des éléments et gardent les clients existants fonctionnels. Les versions majeures peuvent casser des clients et viennent avec une période de dépréciation. Voir la politique de versions et de dépréciation.

1.4 (2026-11-06)

Ajouté

Questions de relance : quand l’agent en suggère, une réponse de lire une session a une entrée toolCalls[] nommée suggestFollowUpQuestions. Son arguments.questions liste des questions courtes que l’utilisateur peut envoyer ensuite.

Migration

Aucune. Les clients qui ignorent les noms d’outils inconnus continuent de fonctionner. Pour afficher les questions, lisez cette entrée sur la dernière réponse.

1.3 (2026-10-30)

Ajouté

Envoyer un message et recevoir la réponse en flux avec POST /public/v1/agents/{embedToken}/sessions/{sessionId}/messages/stream. Le message voyage dans le corps JSON. Il n’atteint donc plus les limites d’URL ni les journaux d’accès. La réponse est le même flux.
L’erreur de flux Invalid request body, pour un corps POST sans objet payload.

Déprécié

GET .../sessions/{sessionId}/messages/stream?q=..., qui envoie le message dans l’URL. Cette route reste servie sur la v1 et renvoie le même flux.

Migration

Aucune obligatoire. Pour migrer, envoyez { "payload": { "content": "..." } } en corps JSON à la route POST au lieu du paramètre q. Ajoutez l’en-tête Content-Type: application/json.

1.2 (2026-10-29)

Modifié

Une session vidée par la règle de rétention de l’espace de travail est maintenant refusée. Chaque route de session répond 410 avec message: "Session expired" et code: "SESSION_EXPIRED". Avant, la session répondait 200 avec des messages au content vide.

Migration

Traitez un 410 sur une route de session comme un 401 : oubliez la session stockée et créez-en une nouvelle. Vous pouvez dire à l’utilisateur que la conversation précédente a expiré.

1.1 (2026-10-22)

Ajouté

payload.variables sur créer une session : un agent peut déclarer des {{variables}} dans ses instructions, et l’appelant fournit leurs valeurs à la création de la session. Chaque valeur est substituée dans le prompt de l’agent avant chaque réponse.
Une variable déclarée sans valeur de l’appelant repart sur le défaut configuré dans l’onglet Embed de l’agent.
Quand une variable déclarée n’a ni valeur de l’appelant ni défaut, la session est refusée avec un 400 dont le corps porte code: "MISSING_PROMPT_VARIABLES" et la liste missing des noms de variables.

Migration

Aucune. Les clients existants continuent de fonctionner : payload.variables est optionnel, et un agent qui ne déclare aucune {{variable}} se comporte exactement comme avant.

1.0 (2026-09-09)

Ajouté

Première version publiée de l’API de chat publique, sous /public/v1/agents/{embedToken}/.
Cinq routes : configuration de l’agent, création d’une session, lecture d’une session, lecture du HTML des cartes MCP App, envoi d’un message avec réponse en flux.
La page de référence documente les routes, les événements envoyés par le serveur, les codes d’erreur, le comportement CORS et les limites.

Migration

Aucune. Il s’agit de la première version publiée du contrat.