put https://api.nama.ai/searcher/v1/feedback/ (COPY)
Esse endpoint permite enviar feedback sobre um resultado específico retornado pelo endpoint de busca (search). O feedback é associado ao identifier único de cada resultado, obtido no campo identifier da resposta do endpoint de busca.
Importante
Após o feedback ser enviado, ele não pode ser modificado.
Método HTTP
PUT: Envia o feedback para um resultado específico.
URL: https://api.nama.ai/searcher/v1/feedback/{identifier}
Parâmetros de Caminho
| Parâmetro | Tipo | Descrição |
|---|---|---|
identifier | string | Identificador único de um resultado retornado pela busca. Esse valor é obtido a partir da resposta do endpoint de busca (/search). |
Cabeçalhos (Headers)
| Cabeçalho | Tipo | Descrição |
|---|---|---|
Content-Type | string | Tipo de conteúdo da requisição. Deve ser sempre application/json. |
Authorization | string | Token de autenticação. Exemplo: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... |
Corpo (Body)
| Campo | Tipo | Descrição |
|---|---|---|
evaluation | string | Avaliação geral do resultado. Valores aceitos: positive ou negative. |
feedback | string (opcional) | Comentário livre do usuário sobre o resultado. |
feedback_options | array de strings (opcional) | Lista de opções específicas de feedback, como as descritas abaixo. |
Opções para feedback_options
feedback_options| Avaliação | Opção de Feedback | Descrição |
|---|---|---|
| Positiva | answer_accurate_complete | A resposta foi precisa e completa |
| Positiva | answer_helpful_but_needs_more_detail | A resposta foi útil, mas precisa de mais detalhes |
| Positiva | answer_helpful_but_delayed | A resposta foi útil, mas chegou atrasada. |
| Negativa | answer_incorrect | A resposta estava incorreta |
| Negativa | answer_incomplete | A resposta estava incompleta |
| Negativa | answer_outdated | A resposta estava desatualizada |
| Negativa | technical_issue | Houve um problema técnico |
| Negativa | other | Outro motivo |
Exemplo de Requisição com Feedback Positivo
curl --location --request PUT 'https://api.nama.ai/searcher/v1/feedback/a8cf3f08-7570-41a3-9375-2021ef4acd7c' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...eyJpZGVudGlmaWVy' \
--data '{
"evaluation": "positive",
"feedback": "Comentário adicional sobre o resultado",
"feedback_options": ["answer_accurate_complete"]
}'