Perguntas e respostas

Pares Q&A: a pergunta é embedada, a resposta é devolvida — o formato certo para FAQ.

Atualizado em 10 de ago. de 2026

Para FAQ, embedar a pergunta rende buscas muito melhores do que embedar o texto corrido: a pergunta do usuário casa direto com a pergunta cadastrada. O par Q&A faz exatamente isso — a pergunta vira o vetor, e a busca devolve a resposta no campo text, com a pergunta original em question para referência.

POSThttps://api.hinow.ai/v1/rag/documents/qaBearer

Cadastra um par pergunta-resposta na base.

Parâmetros

rag_idstring· bodyobrigatório
questionstring· bodyobrigatório
answerstring· bodyobrigatório

Respostas

200Par indexado (o document_id identifica o par)

{
  "document_id": "0388772e3fe94ec19217790846d79133",
  "chunks": 1,
  "embed_tokens": 4
}

PUThttps://api.hinow.ai/v1/rag/documents/qa/{document_id}Bearer

Edita um par existente (re-embeda a pergunta).

Parâmetros

document_idstring· pathobrigatório
rag_idstring· bodyobrigatório
questionstring· bodyobrigatório
answerstring· bodyobrigatório

Respostas

200Par atualizado

404Par fora do escopo/base informados

Na busca, um resultado de Q&A chega assim — repare que text é a resposta e a pontuação é alta quando a pergunta casa:

{
  "score": 0.824,
  "document_id": "0388772e3fe94ec19217790846d79133",
  "source": "Voces aceitam pix?",
  "question": "Voces aceitam pix?",
  "text": "Sim! Pix, cartao de credito, boleto e transferencia.",
  "metadata": { "kind": "qa", ... }
}

Removendo um par

Q&A é um documento como outro qualquer: use DELETE /v1/rag/documents/{document_id}?rag_id=... e ele vai para a lixeira como os demais.

Esta página foi útil?