Avaliar uma resposta: POST /v1/feedback
Registra se a resposta de um /v1/ask estava certa. O administrador vê as avaliações no Histórico do painel e pode transformar uma resposta boa em exemplo, que passa a orientar as próximas perguntas.
Requisição
{
"request_id": "req_0f3c9a7d2b6e4f1a8c5d0e9b7a6f3c21",
"rating": "good",
"comment": "Era isso mesmo"
}
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
request_id | string | sim | O request_id devolvido por /v1/ask. |
rating | string | sim | good ou bad. |
comment | string | não | Até 500 caracteres, sem caracteres de controle. É guardado e mostrado como texto puro e nunca é enviado à LLM. |
Resposta 204
Sem corpo. Reenviar a avaliação para o mesmo request_id substitui a anterior.
Erros
| HTTP | code | Quando |
|---|---|---|
| 404 | request_not_found | O request_id não existe, é de outro tenant ou não é uma resposta bem-sucedida dada a uma API key. |
| 422 | invalid_feedback | rating fora de good/bad, ou comentário longo demais ou com caracteres de controle. |
| 422 | invalid_request | Corpo inválido ou request_id fora do formato req_ + 32 hexadecimais. |
Exemplo
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": "Faltou excluir os cancelados"}'
Uma boa prática é mostrar 👍 / 👎 ao lado do resultado na sua tela e enviar o feedback quando o usuário clicar.