Knowledge Base não responde

Quando o agente não usa a Knowledge Base nas respostas, ou responde fora do documento, verifique estes pontos.

Verificações

1. A KB está atribuída ao agente no separador Knowledge.
2. O documento foi indexado com sucesso. Erros de indexação aparecem na lista de fontes.
3. O modo de recuperação está correcto: semantic, hybrid ou exact.
4. A pergunta do utilizador está dentro do domínio coberto pelo documento.
5. A instrução do sistema do agente pede explicitamente que use a KB.

Ferramentas de diagnóstico

Use Knowledge Runtime Diagnostics no backoffice ou o endpoint:

GET /api/v1/agents/{agent_id}/knowledge-runtime?query=...

Teste a recuperação com:

POST /api/v1/agents/{agent_id}/knowledge-retrieve
{
  "query": "..."
}

Soluções comuns

• Reindexe o documento após alterações.
• Verifique se o PDF tem texto seleccionável e não é apenas uma imagem.
• Experimente outro modo de recuperação.
• Aumente a quantidade de conteúdo relevante no documento.
• Adicione uma frase nas instruções do agente: "Responde sempre com base na Knowledge Base quando possível".