Citações e Groundedness na UX — studyAI

Regras para mostrar citações, excertos e lidar com respostas sem fonte suficiente.

---

Índice

1. Decisões
2. Onde mostrar citações
3. Formato das citações
4. Respostas sem fonte suficiente
5. Confiança e groundedness

---

Decisões

---

Onde mostrar citações

---

Formato das citações

Chat

Resposta: "A colonoscopia é um exame..."

Fontes:
• artigo.pdf, p. 3 — "A colonoscopia permite visualizar o cólon..."
• guidelines.md — "Exame endoscópico de rotina..."

Documento gerado

No fim de cada secção (se houver fontes):

---
*Fontes: artigo.pdf (p. 3, 5), guidelines.md*

Ou inline para frases específicas: [1] com legenda no fim.

---

Respostas sem fonte suficiente

Quando acontece

• Retrieval não encontrou chunks relevantes (top-k com score baixo)
• Query muito específica, material não cobre

Comportamento

1. RAG QA Agent: Incluir no prompt instrução: "Se não houver informação nos chunks, diz 'Não encontrei informação suficiente no material carregado.' e sugere onde procurar."
2. UI: Mostrar aviso: "Esta resposta pode não estar fundamentada no teu material."
3. API: Campo has_sufficient_sources: false na resposta
4. Content Writer (strict): Nunca inventar. Se chunks insuficientes, escrever "Esta secção requer mais fontes. Considera adicionar documentos sobre X."

Níveis de confiança

---

Confiança e groundedness

• groundedness_score (0–1) na rag_evaluations
• UI: Indicador opcional (ex: ícone verde/amarelo/vermelho)
• Chat: Se score < 0.6, mostrar "Resposta com baixa confiança no material."
• Conteúdo gerado: Por secção, indicar se baseado em fontes ou extrapolado (modo hybrid)