Saltar para o conteúdo principal

​
Visão Geral

Use este endpoint para relatar uma resposta em cache que estava incorreta, desatualizada, irrelevante ou de outra forma insegura para reutilização. Quando uma entrada acumula feedback negativo suficiente, a TokenLab pode invalidá-la automaticamente.

​
Observações

  • A autenticação exige uma chave padrão da API de inferência.
  • cache_entry_id deve ser um identificador de request/cache entry com cache hit e pertencente à organização desta API Key. Identificadores arbitrários retornam 404, e IDs de outra organização retornam 403.
  • feedback_type aceita wrong_answer, outdated, irrelevant ou other.
  • request_id é opcional; quando informado, deve corresponder a cache_entry_id.
  • description é um contexto livre opcional para operadores e auditoria.

​
Requisição / Resposta

Use o painel interativo de OpenAPI acima para ver o esquema exato e os campos de resposta.

​
Exemplo

curl -X POST "https://api.tokenlab.sh/v1/cache/feedback" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "cache_entry_id": "req_1234567890",
    "feedback_type": "wrong_answer",
    "request_id": "req_1234567890",
    "description": "A resposta em cache fazia referência a uma tabela de preços desatualizada."
  }'

{
  "object": "cache.feedback",
  "recorded": true,
  "invalidated": false,
  "stats": {
    "negative_feedback_count": 1,
    "total_hit_count": 18,
    "negative_feedback_rate": 0.0556
  }
}