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`

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"]
}'

Importante

Método HTTP

Parâmetros de Caminho

Cabeçalhos (Headers)

Corpo (Body)

Opções para feedback_options

Exemplo de Requisição com Feedback Positivo

Opções para `feedback_options`