Valorar una respuesta: POST /v1/feedback
Registra si la respuesta de un /v1/ask era correcta. El administrador ve las valoraciones en el Historial del panel y puede convertir una respuesta buena en ejemplo, que pasa a guiar las siguientes preguntas.
Solicitud
{
"request_id": "req_0f3c9a7d2b6e4f1a8c5d0e9b7a6f3c21",
"rating": "good",
"comment": "Era exactamente eso"
}
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
request_id | string | sí | El request_id devuelto por /v1/ask. |
rating | string | sí | good o bad. |
comment | string | no | Hasta 500 caracteres, sin caracteres de control. Se guarda y se muestra como texto plano y nunca se envía al LLM. |
Respuesta 204
Sin cuerpo. Reenviar la valoración para el mismo request_id reemplaza la anterior.
Errores
| HTTP | code | Cuándo |
|---|---|---|
| 404 | request_not_found | El request_id no existe, es de otro tenant o no es una respuesta exitosa dada a una API key. |
| 422 | invalid_feedback | rating distinto de good/bad, o comentario demasiado largo o con caracteres de control. |
| 422 | invalid_request | Cuerpo inválido o request_id fuera del formato req_ + 32 hexadecimales. |
Ejemplo
curl -sS -X POST "https://app.datafala.com.br/v1/feedback" \
-H "Authorization: Bearer $DATAFALA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"request_id": "req_0f3c9a7d2b6e4f1a8c5d0e9b7a6f3c21", "rating": "bad", "comment": "Faltó excluir los cancelados"}'
Una buena práctica es mostrar 👍 / 👎 junto al resultado en tu pantalla y enviar el feedback cuando el usuario haga clic.