> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Base de conhecimento
## Introdução
Uma base de conhecimento bem estruturada é essencial para que seus Agentes de IA forneçam respostas útis, precisas e coerentes. Se os documentos enviados estiverem mal estruturados, incompletos ou de difícil interpretação, o Agente de IA pode oferecer respostas incorretas ou inventadas. Por outro lado, quando as informações estão claras, organizadas e escritas com intencionalidade, o Agente de IA entende melhor o contexto e melhora a qualidade das respostas.
Criar uma boa base de conhecimento é como treinar um novo membro da equipe: é preciso explicar com clareza, fornecer documentos bem preparados e garantir que sejam compreendidos.
***
## Use formatos legíveis por IA
A IA só consegue ler texto digital. Arquivos digitalizados ou que contêm texto como imagem não são úteis, mesmo que visualmente pareçam bons.
**Recomendado**: `.docx`, `.txt`, `.md`, `.pdf` (somente se o texto for selecionável)
### Exemplos
✅ **Correto**: Documento `.docx` exportado do Word com estilos de títulos, parágrafos e listas.
✅ **Correto**: Arquivo `.txt` simples com seções separadas por títulos.
⚠️ **Aceitável**: Um `.pdf` gerado a partir do Word ou outra ferramenta digital, desde que o texto possa ser selecionado com o mouse.
❌ **Incorreto**: PDF escaneado a partir de papel ou arquivo com imagem de texto (mesmo com boa aparência, a IA não conseguirá interpretar).
Como saber se seu arquivo é válido? Abra o PDF e tente selecionar e copiar o
texto. Se não conseguir, ele não funcionará com a IA. Evite capturas de tela
ou fotos de documentos como fonte.
***
## Estrutura clara e por tópicos
Uma base de conhecimento eficiente é organizada por temas. Não coloque tudo em um único documento longo e ambíguo. Use títulos, subtítulos e separe o conteúdo de acordo com seu propósito.
**Faça assim:**
* Divida o conteúdo em arquivos separados por tema ou área (ex.: "Políticas de faturamento", "FAQs sobre entregas", "Ficha técnica do Produto A").
* Use títulos hierárquicos (`Título principal`, `Subtítulo`, `Pontos-chave`).
### Exemplos
✅ **Correto**: Documento sobre garantias com seções como "O que está coberto?", "Duração", "Como acionar a garantia".
❌ **Incorreto**: Arquivo que mistura políticas de vendas, contato, produtos e suporte em uma única página.
Adicione um sumário no início se o documento tiver mais de 3 seções. Isso
ajuda os Agentes de IA a se localizarem com rapidez.
***
## Escreva com contexto completo
Cada trecho de texto precisa fazer sentido isoladamente. **A IA muitas vezes lê apenas um parágrafo solto, então ele não deve depender de títulos ou conteúdo anterior.**
**Faça assim:**
* Escreva com contexto explícito.
* Inclua nomes de produtos, locais, datas ou condições diretamente nas frases.
### Exemplos
✅ **Correto**: "A política de garantia para carros elétricos é válida no Brasil por 24 meses a partir da data de compra."
❌ **Incorreto**: "Possui 2 anos de cobertura" (O quê possui? Onde? Desde quando?)
***
## Use linguagem clara, precisa e consistente
A IA não interpreta ambigùidades, jargões ou frases confusas como um humano. É essencial escrever com clareza, evitar sinônimos desnecessários e definir todos os termos.
Use frases curtas e diretas.
Mantenha o mesmo termo para cada conceito (ex.: não alterne entre "cliente" e
"usuário").
Defina siglas na primeira vez que forem usadas.
***
### Exemplos
✅ **Correto**: "O CRM (Customer Relationship Management) ajuda a gerenciar todos os prospects."
❌ **Incorreto**: "A ferramenta de leads ou sistema de usuários permite..." (confuso e inconsistente)
Use a busca do seu editor para verificar se os termos-chave estão sendo usados
de forma consistente. Isso evita erros semânticos nas respostas da IA.
***
## Use modelos e formatos repetíveis
Ao subir vários documentos semelhantes (como fichas de produtos, processos ou guias), manter uma estrutura consistente ajuda o modelo a reconhecer padrões.
**Faça assim:**
* Use modelos fixos para cada tipo de documento.
* Mantenha a mesma ordem de seções em todos os arquivos.
### Exemplos
✅ **Correto**: Cada produto inclui: nome, descrição, especificações, perguntas frequentes, contato de suporte.
❌ **Incorreto**: Cada ficha de produto tem estrutura diferente, algumas sem descrição ou divisão por seções.
Crie um modelo base que possa ser duplicado para cada novo documento. Isso
garante consistência e acelera a documentação.
***
## Inclua perguntas e exemplos
Antecipar perguntas comuns ajuda o modelo a entender melhor a linguagem natural. Incluir exemplos bem escritos de perguntas e respostas melhora muito a qualidade das respostas geradas.
**Faça assim:**
* Inclua uma pequena seção de Perguntas Frequentes (FAQ).
* Redija perguntas reais ou representativas com respostas claras.
### Exemplos
✅ **Correto**:
**P:** Vocês fazem entregas internacionais?
**R:** Atualmente só realizamos entregas no Brasil. Em breve atenderemos outros países.
❌ **Incorreto**: Apenas incluir a frase "não fazemos entregas internacionais" fora de contexto ou em uma lista genérica.
***
## Elimine redundâncias e contradições
Dois arquivos com versões diferentes da mesma informação podem confundir a IA e gerar respostas erradas. A IA não "escolhe a melhor", ela mistura tudo o que encontra.
**Faça assim:**
* Centralize informações importantes (preços, datas, condições).
* Mantenha apenas a versão mais recente de cada documento.
### Exemplos
✅ **Correto**: Um único arquivo chamado "Políticas de garantia atualizadas - março de 2025.pdf"
❌ **Incorreto**: Três arquivos diferentes dizendo que a garantia é de 6, 12 e 24 meses, respectivamente.
***
## Mantenha sua base atualizada
A qualidade do seu agente também depende da atualização das informações. Os documentos devem estar sempre atualizados e relevantes.
**Faça assim:**
* Revise sua base mensalmente ou a cada trimestre.
* Revise sempre que houver mudanças em produtos ou serviços.
* Remova arquivos antigos e envie versões atualizadas com datas claras.
### Exemplos
✅ **Correto**: "Catálogo de produtos - atualizado em abril de 2025"
❌ **Incorreto**: Documentos misturados, sem clareza sobre qual está vigente.
***
## O que incluir de acordo com seu setor
Cada setor possui informações essenciais que devem estar presentes nos documentos. Certifique-se de incluir esses dados para que os agentes tenham o contexto completo:
| Setor | Informações essenciais a incluir |
| ----------- | -------------------------------------------------------- |
| Educação | Datas de matrícula, níveis de ensino, modalidades |
| Saúde | Procedimentos, horários, tipo de atendimento |
| Imóveis | Localização, preços, formas de contato |
| Faturamento | Formas de pagamento, validade das faturas, suporte |
| Automotivo | Modelos disponíveis, garantias, localização das agências |
| Joalheria | Tipos de produto, materiais, políticas de devolução |
**Exemplo**: No setor de saúde, um documento que diga apenas "atendimento pela manhã" não é suficiente. Prefira algo como: "O Dr. Ramírez atende na Clínica Sul de segunda a sexta, das 8h às 14h."