> ## 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

> Aprenda como estruturar uma base de conhecimento efetiva para maximizar o desempenho de seus agentes de IA

Seu agente de IA é tão inteligente quanto a informação que você fornece. Uma base de conhecimento bem estruturada é a diferença entre um agente que confunde seus clientes e um que os converte em compradores satisfeitos.

## Por que é tão importante?

**🎯 Respostas precisas desde o dia 1**

* Evita respostas inventadas ou incorretas
* Fornece informação consistente 24/7
* Reduz a necessidade de intervenção humana

**📈 Melhores resultados de conversão**

* Clientes mais informados tomam melhores decisões
* Aumenta a confiança em sua marca

**⚡ Implementação mais rápida**

* Agentes prontos para produção em menos tempo
* Menos iterações e ajustes posteriores
* ROI mais rápido de seu investimento em IA

<img src="https://mintcdn.com/trebleai/7IH-SHsVEOAxl8kZ/images/Screenshot2025-10-02at9.30.03AM.png?fit=max&auto=format&n=7IH-SHsVEOAxl8kZ&q=85&s=c2abb96fa4f711272c0d9ba5274a1215" alt="Screenshot 2025-10-02 at 9.30.03 AM.png" width="1908" height="732" data-path="images/Screenshot2025-10-02at9.30.03AM.png" />

<Note>
  **Pense no seu agente de IA como um novo membro da equipe**: ele precisa da mesma informação, procedimentos e contexto que você daria a qualquer funcionário para ser bem-sucedido.
</Note>

## 📋 Checklist rápido: Sua base de conhecimento está pronta?

Antes de começar, verifique que você tem:

<Tabs>
  <Tab title="✅ Essenciais">
    * Informação básica da empresa (endereço, horários, contato)
    * Descrição clara de produtos/serviços principais
    * Preços e promoções atuais
    * Políticas importantes (garantia, devoluções, envios)
    * Perguntas frequentes de seus clientes reais
  </Tab>

  <Tab title="🚀 Avançado">
    * Casos de sucesso e depoimentos
    * Comparações com concorrência
    * Processos internos simplificados
    * Scripts de manejo de objeções
    * Critérios de qualificação de leads
  </Tab>

  <Tab title="📁 Formato">
    * Arquivos em formatos legíveis (.docx, .txt, .pdf digital)
    * Texto selecionável (não escaneado)
    * Documentos organizados por tema
    * Versões atualizadas unicamente
    * Nomes de arquivo descritivos com datas
  </Tab>
</Tabs>

***

## 🔧 Melhores práticas por categoria

<Accordion title="📁 Formatos de arquivo que funcionam (e os que não)">
  Nossa IA só pode ler texto digital, não imagens nem arquivos escaneados.

  **✅ Formatos recomendados:**

  * `.docx` - Microsoft Word (ideal para conteúdo estruturado)
  * `.txt` - Texto simples (perfeito para informação simples)
  * `.md` - Markdown (excelente para documentação técnica)
  * `.pdf` - Somente se o texto for selecionável (não escaneado)

  **🧪 Teste rápido:** Você pode selecionar e copiar o texto? Se sim, funcionará.

  **❌ Evite estes formatos:**

  * PDFs escaneados ou convertidos de papel
  * Capturas de tela ou fotos de documentos
  * Imagens com texto incorporado
  * Documentos protegidos com senha
</Accordion>

<Accordion title="🗂️ Organização e estrutura de documentos">
  **Regra de ouro:** Um tema = Um arquivo. A IA processa melhor informação organizada do que documentos massivos.

  **📁 Estrutura recomendada:**

  ```
  📁 Base de conhecimento/
  ├── 📄 Informacao-empresa-2024.docx
  ├── 📄 Produtos-principais-2024.docx
  ├── 📄 Politicas-garantia-2024.docx
  ├── 📄 Perguntas-frequentes-2024.docx
  └── 📄 Precos-promocoes-2024.docx
  ```

  **✅ Dentro de cada documento:**

  * Título claro e descritivo
  * Índice (se tiver +3 seções)
  * Cabeçalhos hierárquicos (H1, H2, H3)
  * Informação completa em cada seção

  **❌ Evite:**

  * Documentos gigantes que misturam tudo
  * Títulos ambíguos como "Info.docx"
  * Pular níveis de cabeçalho (H1 → H3)
  * Referências a "o anterior" ou "como mencionado"
</Accordion>

<Accordion title="✍️ Redação efetiva para IA">
  **Princípio chave:** Cada parágrafo deve funcionar independentemente. A IA pode ler fragmentos isolados.

  **🎯 Contexto completo sempre:**

  * Inclua nomes específicos, datas, lugares
  * Não use referências como "isto", "o anterior", "como mencionado"
  * Cada frase deve ser autossuficiente

  **Exemplos de redação:**

  ✅ **Excelente:**

  > "A garantia de smartphones Xiaomi cobre defeitos de fábrica por 12 meses desde a compra no Brasil, excluindo danos por água ou impactos."

  ❌ **Problemático:**

  > "Tem 12 meses de cobertura, mas não inclui danos externos."

  **📝 Linguagem clara e consistente:**

  * Frases curtas e diretas (máximo 25 palavras)
  * Um termo por conceito ("cliente" OU "usuário", não ambos)
  * Defina acrônimos: "CRM (Customer Relationship Management)"
  * Evite jargão técnico sem explicação

  <Tip>
    **Truque rápido:** Leia cada parágrafo fora de contexto. É completamente compreendido? Se não, adicione mais contexto.
  </Tip>
</Accordion>

<Accordion title="📋 Modelos e formatos consistentes">
  **Por que é importante:** A IA aprende padrões. Documentos com estrutura similar melhoram a precisão das respostas.

  **🛠️ Modelo para fichas de produto:**

  ```
  # [Nome do Produto]

  ## Descrição geral
  [O que é e para que serve]

  ## Especificações técnicas
  [Características detalhadas]

  ## Preços e disponibilidade
  [Informação atual de preços]

  ## Perguntas frequentes
  [3-5 perguntas reais de clientes]

  ## Contato e suporte
  [Como obter ajuda específica]
  ```

  **🏢 Modelo para informação de empresa:**

  ```
  # [Nome da Empresa]

  ## Quem somos?
  ## Serviços principais
  ## Localização e horários
  ## Métodos de contato
  ## Políticas importantes
  ```

  <Tip>
    Crie um documento mestre com seu modelo e duplique-o para cada novo conteúdo. Isto garante consistência automática.
  </Tip>
</Accordion>

<Accordion title="❓ Perguntas frequentes e exemplos">
  **Estratégia vencedora:** Inclua as perguntas REAIS que seus clientes fazem, não as que você acha que deveriam fazer.

  **📋 Formato recomendado:**

  ```
  ## Perguntas frequentes

  **P: Vocês fazem entregas nos fins de semana?**
  R: Realizamos entregas de segunda a sexta-feira. Pedidos de sexta são processados na segunda-feira seguinte.

  **P: Posso cancelar meu pedido?**
  R: Você pode cancelar sem custo até 2 horas depois de confirmar seu pedido ligando para 555-0123.
  ```

  **🎯 Fontes de perguntas reais:**

  * Chat de atendimento ao cliente
  * E-mails de suporte recebidos
  * Comentários em redes sociais
  * Perguntas frequentes de vendedores

  **❌ Evite respostas vagas:**

  * "Depende de cada caso"
  * "Contate para mais informações"
  * "Segundo disponibilidade"

  <Tip>
    Atualize as FAQs mensalmente com novas perguntas reais. Uma base de conhecimento atualizada = melhores conversões.
  </Tip>
</Accordion>

<Accordion title="🚫 Elimine informação contraditória">
  **Problema comum:** A IA não distingue entre versões. Se encontrar informação conflitante, pode misturar respostas incorretas.

  **🎯 Estratégia de fonte única:**

  * Um dado = Um lugar
  * Elimine versões antigas antes de subir novas
  * Use nomes de arquivo com datas para controle de versões

  **Exemplos problemáticos:** ❌ `garantia-v1.pdf` diz 6 meses ❌ `garantia-final.pdf` diz 12 meses ❌ `garantia-atualizada.pdf` diz 24 meses

  **Resultado:** A IA poderia responder "entre 6 e 24 meses" 😱

  **✅ Solução:**

  * Mantenha apenas: `garantia-marco-2025.pdf` com informação atualizada
  * Elimine todas as versões anteriores

  <Warning>
    Antes de subir um documento atualizado, elimine a versão anterior da base de conhecimento. A IA não pode distinguir qual é a versão "correta".
  </Warning>
</Accordion>

<Accordion title="🔄 Manutenção e atualizações">
  **Regra de ouro:** Uma base de conhecimento desatualizada é pior do que não ter base de conhecimento.

  **📅 Calendário de manutenção recomendado:**

  **Semanalmente:**

  * Revise novas perguntas de clientes
  * Atualize promoções ou preços temporários

  **Mensalmente:**

  * Audite respostas do agente de IA
  * Adicione novas FAQs identificadas
  * Verifique vigência de políticas

  **Trimestralmente:**

  * Revisão completa de toda a base
  * Elimine informação obsoleta
  * Atualize informação de contato e horários

  **🎯 Indicadores de que você precisa atualizar:**

  * Clientes mencionam informação incorreta
  * Mudanças em produtos, preços ou políticas
  * Novas perguntas frequentes não contempladas
  * Agente não pode responder temas atuais

  <Tip>
    **Nomeie seus arquivos com datas:** `precos-janeiro-2025.pdf` é melhor que `precos-novos.pdf`. Te ajudará a identificar o que precisa atualização.
  </Tip>
</Accordion>

***

## 🏢 Guias específicos por indústria

Cada setor tem informação crítica que seus agentes DEVEM conhecer para ser efetivos:

<Tabs>
  <Tab title="🏥 Saúde">
    **Informação essencial:**

    * Horários específicos por especialidade
    * Procedimentos disponíveis e requisitos
    * Custos aproximados e métodos de pagamento
    * Tempos de espera típicos
    * Localização exata e estacionamento
    * Políticas de cancelamento/reagendamento

    **Exemplo otimizado:**

    > "A Dra. López (cardiologia) atende terças e quintas das 9:00 às 13:00 no Consultório 205. Custo da consulta: R\$400. Requer referência médica. Estacionamento gratuito disponível."
  </Tab>

  <Tab title="🏠 Imóveis">
    **Informação essencial:**

    * Inventário atual com preços exatos
    * Características detalhadas de propriedades
    * Zona/localização com pontos de referência
    * Processo de compra/aluguel passo a passo
    * Requisitos financeiros e documentação
    * Custos adicionais (manutenção, serviços)

    **Exemplo otimizado:**

    > "Casa em Jardins, 3 quartos, 2 banheiros, 120m². Preço: R\$5.000/mês. Entrada mínima: 30%. Disponível para entrega imediata."
  </Tab>

  <Tab title="🎓 Educação">
    **Informação essencial:**

    * Datas exatas de inscrição e início
    * Requisitos acadêmicos específicos
    * Custos detalhados (mensalidade, materiais, extras)
    * Modalidades disponíveis (presencial, virtual, mista)
    * Horários por programa/nível
    * Processo de admissão completo

    **Exemplo otimizado:**

    > "Mestrado em Marketing Digital: Início 15 janeiro 2025. Modalidade mista (sábados presenciais 8-14h + aulas virtuais terças 19-21h). Custo: R\$2.400 mensais. Requisito: graduação em áreas afins."
  </Tab>

  <Tab title="🛒 E-commerce">
    **Informação essencial:**

    * Inventário em tempo real
    * Preços com descontos aplicáveis
    * Métodos de pagamento aceitos
    * Políticas de envio detalhadas
    * Garantias e políticas de devolução
    * Comparações com produtos similares

    **Exemplo otimizado:**

    > iPhone 15 Pro 256GB disponível em azul e preto. Preço: R$7.999 (12x sem juros). Frete grátis em SP (24-48h). Garantia Apple 1 ano + seguro contra roubo opcional R$149
  </Tab>

  <Tab title="🚗 Automotivo">
    **Informação essencial:**

    * Modelos disponíveis com especificações
    * Preços finais (com impostos)
    * Planos de financiamento
    * Garantias específicas por componente
    * Serviços de manutenção incluídos
    * Localização de concessionárias/oficinas

    **Exemplo otimizado:**

    > Nissan Versa 2024 Sense MT: R$89.900 preço final. Garantia motor 5 anos/100.000km. Financiamento desde R$1.890/mês em 60 meses. Manutenção gratuita primeiros 2 serviços. Disponível na concessionária Morumbi.
  </Tab>
</Tabs>

## 🚀 Próximos passos para implementar

<Steps>
  <Step title="Avalie sua base atual">
    Use o checklist inicial para identificar que informação falta.
  </Step>

  <Step title="Selecione sua indústria">
    Aplique as recomendações específicas do seu setor.
  </Step>

  <Step title="Organize seus documentos">
    Estruture a informação usando os modelos sugeridos.
  </Step>

  <Step title="Teste e otimize">
    Teste seu agente de IA e ajuste a base segundo os resultados.
  </Step>
</Steps>

<Note>
  **Precisa de ajuda específica?** Cada indústria tem nuances únicas. Se seu setor não está coberto aqui, aplique os princípios gerais e foque nas perguntas mais frequentes de seus clientes reais.
</Note>