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.
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." }curl -X PUT "https://staging-api.docage.com/Assistant/Messages/00000000-0000-4000-8000-000000000703/Feedback" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
-H "Content-Type: application/json" \
-d '{
"Rating": 2,
"Reason": 2,
"Comment": "Il manque le rendez-vous de 16 h."
}'using HttpClient client = new();
using HttpRequestMessage request = new(HttpMethod.Put, "https://staging-api.docage.com/Assistant/Messages/00000000-0000-4000-8000-000000000703/Feedback");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
request.Content = new StringContent("""
{
"Rating": 2,
"Reason": 2,
"Comment": "Il manque le rendez-vous de 16 h."
}
""", Encoding.UTF8, "application/json");
using HttpResponseMessage response = await client.SendAsync(request);
string result = await response.Content.ReadAsStringAsync();
if (!response.IsSuccessStatusCode)
throw new HttpRequestException(result);const response = await fetch("https://staging-api.docage.com/Assistant/Messages/00000000-0000-4000-8000-000000000703/Feedback", {
method: "PUT",
headers: {
Authorization: `Bearer ${token}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"Rating": 2,
"Reason": 2,
"Comment": "Il manque le rendez-vous de 16 h."
})
});
const text = await response.text();
if (!response.ok) throw new Error(text);
const result = text ? JSON.parse(text) : null;{ "MessageId": "00000000-0000-4000-8000-000000000703", "Rating": 2, "Reason": 2, "Comment": "Il manque le rendez-vous de 16 h." }Rating:1utile,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.