Conteúdo
Prepare e estruture o conhecimento que o Avatar utilizará nas conversas.
Conteúdo
Esta página é para você que quer treinar o avatar sem termos técnicos complicados. Aqui você vai aprender como montar blocos de conteúdo (chunks) para o RAG funcionar melhor e reduzir alucinação.
Ideia central: o avatar responde melhor quando encontra blocos curtos, claros e atualizados.
O que é conteúdo no dia a dia
Conteúdo é tudo que o avatar consulta para responder perguntas:
- regras de negócio,
- políticas,
- FAQs,
- explicações de produto,
- passo a passo de processos.
No RAG, o sistema busca os trechos mais parecidos com a pergunta do usuário e entrega esses trechos para a IA montar a resposta.
Se os blocos estiverem confusos, misturados ou desatualizados, o avatar pode responder errado ou completar lacunas com suposições.
Quando usar Conteúdo, Comportamento ou Automações
Use esta regra simples:
Conteúdo (RAG)
Comportamento (Envelope)
Automações
Use quando a informação depende da pergunta do usuário.
Exemplos:
- “Qual é o prazo da entrega?”
- “Como cancelar meu plano?”
- “Qual documento preciso enviar?”
São fatos e instruções consultáveis.
Envelope instrucional serve para instruções permanentes, que não dependem da
pergunta do usuário.
Automações servem para cenários com contexto mais complexo do que uma busca
semântica (RAG) consegue resolver sozinha.
Como quebrar chunks (sem complicação)
Chunk é um bloco pequeno de conteúdo que o sistema consegue recuperar com precisão.
Regra de ouro
1 chunk = 1 assunto principal.
Se você mistura vários temas no mesmo bloco, o sistema pode recuperar contexto errado.
Tamanho recomendado
- Ideal: 400 a 900 caracteres por chunk.
- Pode passar disso quando necessário, mas evite blocos muito longos.
- Se um texto tiver muitos tópicos, separe em vários chunks.
Não tente “economizar chunks” juntando tudo. Precisão é mais importante que volume.
Estrutura simples de um chunk bom
- Título objetivo do assunto.
- Regra/fato principal em frase direta.
- Detalhes essenciais (sem rodeio).
- Exemplo curto (quando ajudar).
- Data da última revisão.
Passo a passo para criar conteúdo confiável
Template pronto para copiar
ASSUNTO: [nome claro do tema]
REGRA PRINCIPAL:
[o fato mais importante em 1-2 frases]
DETALHES IMPORTANTES:
- [detalhe 1]
- [detalhe 2]
- [detalhe 3]
QUANDO ESTA REGRA NAO SE APLICA:
- [excecao 1]
- [excecao 2]
EXEMPLO RAPIDO:
[pergunta comum] -> [resposta esperada]
FONTE:
[origem da informacao]
ULTIMA REVISAO:
[dd/mm/aaaa]
Checklist anti-alucinação
Antes de publicar um bloco, confirme:
- O chunk tem um único assunto principal.
- O texto está claro para alguém que não conhece o tema.
- Existem condições e exceções explícitas (se houver).
- A informação tem fonte definida.
- A data de revisão está atualizada.
- O conteúdo não contradiz outros blocos.
- O tema não deveria estar em Comportamento ou Automações.
Erros comuns que aumentam alucinação
1) Misturar muitos temas no mesmo bloco
Problema: o sistema busca um bloco “meio certo”.
Correção: separar por assunto e intenção.
2) Texto longo e genérico
Problema: baixa precisão na recuperação.
Correção: frases diretas, regras objetivas e exemplos curtos.
3) Conteúdo sem dono e sem revisão
Problema: informação velha continua sendo usada.
Correção: definir responsável e data de revisão periódica.
4) Colocar regra permanente em conteúdo
Problema: comportamento inconsistente do avatar.
Correção: mover regra permanente para Comportamento.
5) Tentar resolver fluxo complexo só com RAG
Problema: resposta não executa ação necessária.
Correção: configurar Automações para “quando X, então Y”.
Pergunta final de validação
Antes de salvar, pergunte:
“Isso é um fato para consulta (Conteúdo), uma regra permanente (Comportamento) ou uma ação condicional de sistema (Automações)?”
Quando consultar os outros documentos
Durante a escrita de conteúdo, interrompa e revise os outros guias quando aparecer:
- Regra de postura permanente (ex.: “sempre responda em tom X”, “nunca invente”): revisar Comportamento.
Motivo: esse tipo de regra precisa valer em toda conversa e não deve depender da recuperação de chunk. - Fluxo com gatilho e ação operacional (ex.: “se detectar solicitação de reembolso, abrir ticket”): revisar Automações.
Motivo: conteúdo informa, mas não executa ação de sistema.
Exemplo prático de separação:
- “Documento necessário para cadastro” -> Conteúdo.
- “Forma padrão de resposta do avatar” -> Comportamento.
- “Quando faltar documento obrigatório, criar pendência e encaminhar” -> Automações.