Skip to content
Retour à l'application

Journal des modifications de l'API de chat publique

Chaque version de l'API de chat publique, avec la date, les changements et les étapes de migration quand un changement est cassant.

2min de lectureVersion de l'API1.2

Cette page liste chaque version de l’API de chat publique. La version courante est la 1.2. 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.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.

Dernière mise à jour: 29 octobre 2026

Cet article vous a-t-il aidé ?