Aller au contenu
Documentation

Noter une réponse de l'assistant

Dire qu'une réponse de l'assistant a été utile ou qu'elle est à améliorer, et ce qui n'allait pas — le pouce de l'application, depuis votre logiciel.

2 min de lecture Mise à jour le 12 novembre 2026

Sous chaque réponse de l'assistant, l'application propose un pouce vers le haut ou vers le bas. Votre application fait de même, par l'Id du message de l'assistant :

PUT https://staging-api.docage.com/Assistant/Messages/00000000-0000-4000-8000-000000000703/Feedback
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…
Content-Type: application/json

{ "Rating": 2, "Reason": 2, "Comment": "Il manque le rendez-vous de 16 h." }
JSON
{ "MessageId": "00000000-0000-4000-8000-000000000703", "Rating": 2, "Reason": 2, "Comment": "Il manque le rendez-vous de 16 h." }
  • Rating : 1 utile, 2 à améliorer.
  • Sous un avis à améliorer, la raison (Reason) et un commentaire (Comment, 2 000 caractères au plus), l'un et l'autre facultatifs ; sous un avis utile, ils sont ignorés.
Reason Ce qui n'allait pas
1 La réponse est inexacte.
2 Elle est incomplète.
3 Ce n'est pas ce qui était demandé.
4 Une mauvaise action, ou une mauvaise proposition.
5 Elle est trop longue, ou peu claire.
6 L'assistant n'a pas su le faire.
7 Une autre raison, que le commentaire précise.

Un nouvel avis remplace le précédent ; DELETE https://staging-api.docage.com/Assistant/Messages/{id}/Feedback le retire. L'avis en cours revient à la lecture du fil (GET https://staging-api.docage.com/Conversations/{id}/Messages) : AssistantRating de chaque réponse de l'assistant, nul sans avis.

Ce qui est gardé

Un avis utile ne garde aucun texte. Sous un avis à améliorer, la question, la réponse et l'échange qui les entoure sont gardés avec l'avis pour améliorer l'assistant, puis effacés avec l'historique de l'assistant. Dites-le à l'utilisateur avant qu'il n'envoie un commentaire, comme le fait l'application.

Les refus

  • 404 : le message est introuvable, ou ce n'est pas une réponse de l'assistant de l'utilisateur — seul le propriétaire de « Mon assistant » note ses réponses.
  • 422 : un avis ou une raison inconnus, ou un commentaire de plus de 2 000 caractères.

Les pièges

  • Noter n'est pas répondre : l'avis ne relance pas l'assistant. Pour lui dire ce qui manque, écrivez-lui un nouveau message.
  • Un avis appartient à l'utilisateur : demandez-le-lui, n'en déduisez jamais un de son comportement.