Skip to main content

​
Endpoint

POST /v1/ai-agents/runs/:id/feedback
Escopo necessário: write:ai_agents O feedback humano é usado para monitorar a qualidade dos agentes e identificar padrões de erro. Pode ser integrado a fluxos de revisão internos.

​
Corpo da requisição

CampoTipoObrigatórioDescrição
ratingnumberSimAvaliação da execução (ex: 1–5)
issuesstring[]NãoProblemas identificados
commentstringNãoComentário livre

​
Tipos de issue disponíveis

ValorDescrição
wrong_infoInformação incorreta fornecida
missed_intentNão entendeu a intenção do cliente
premature_handoffTransferiu para humano cedo demais
late_handoffDemorou para transferir quando deveria
tone_issueTom inadequado na resposta
otherOutro problema

​
Exemplo de requisição

curl -X POST https://api.socialsell.ai/v1/ai-agents/runs/664q2r3s4t5u6v7w8x9y0z1a/feedback \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"rating": 2, "issues": ["premature_handoff"], "comment": "Transferiu cedo demais, poderia ter resolvido."}'

​
Resposta

Retorna HTTP 200 com o feedback registrado.