> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maketalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Base de Conhecimento do Agente

> Conecte uma base de conhecimento ao seu agente para respostas mais precisas e contextuais

## Por que conectar uma Base de Conhecimento?

A **Base de Conhecimento (KB)** é o cérebro informacional do seu agente. Sem ela, o agente só consegue responder com base no prompt do sistema. Com a KB conectada:

| Sem KB                  | Com KB                               |
| ----------------------- | ------------------------------------ |
| Respostas genéricas     | Respostas específicas do seu negócio |
| Inventa informações     | Consulta dados reais                 |
| Limitado ao prompt      | Acesso a documentos completos        |
| Não atualiza facilmente | Atualização via plataforma           |

<Tip>
  A KB permite que o agente responda perguntas sobre preços, produtos, políticas, horários e qualquer informação específica do seu negócio.
</Tip>

***

## Como funciona a integração

```
Cliente pergunta → Agente analisa → Busca na KB → Encontra informação → Responde
                                        ↓
                            Se não encontrar → Usa conhecimento geral
                                              ou transfere para humano
```

### Tecnologia RAG

O Flow Builder usa **RAG (Retrieval-Augmented Generation)**:

1. **Retrieval:** Busca os trechos mais relevantes na KB
2. **Augmented:** Adiciona o contexto encontrado ao prompt
3. **Generation:** Gera resposta baseada no contexto

Isso significa que o agente não "memoriza" todo o conteúdo, mas sabe **onde buscar** a informação quando precisa.

***

## Vinculando KB ao Agente

<Frame caption="Vincule bases de conhecimento ao seu agente">
  <img src="https://mintcdn.com/maketalk-7da59a87/qpFJkk1VzAQuV40_/images/administradores/flow-builder/flow-builder-base-de-conhecimento.png?fit=max&auto=format&n=qpFJkk1VzAQuV40_&q=85&s=31aba2f9b9f22fcbd02a235fce7db94e" alt="Vinculando KB" width="3038" height="1166" data-path="images/administradores/flow-builder/flow-builder-base-de-conhecimento.png" />
</Frame>

<Steps>
  <Step title="Acesse o Flow Builder">
    Entre no Flow Builder e selecione o agente que deseja configurar.
  </Step>

  <Step title="Vá em Base de Conhecimento">
    No painel do agente, acesse a seção "Base de Conhecimento" ou "Knowledge Base".
  </Step>

  <Step title="Selecione as bases disponíveis">
    Você verá as KBs criadas na sua conta Make Talk:

    | Base         | Conteúdo                         | Documentos |
    | ------------ | -------------------------------- | ---------- |
    | KB Produtos  | Catálogo, preços, especificações | 15 docs    |
    | KB Políticas | Trocas, garantia, entregas       | 8 docs     |
    | KB FAQ       | Perguntas frequentes             | 25 docs    |

    Selecione as bases que o agente deve consultar.
  </Step>

  <Step title="Configure a prioridade">
    Se houver múltiplas KBs, defina a ordem de busca:

    1. KB Produtos (prioridade alta)
    2. KB FAQ (prioridade média)
    3. KB Políticas (prioridade baixa)
  </Step>

  <Step title="Salve as configurações">
    Clique em "Salvar" para ativar a integração.
  </Step>
</Steps>

***

## Configurações avançadas

### Limite de resultados

Configure quantos trechos da KB são recuperados por consulta:

| Configuração | Uso                  | Performance |
| ------------ | -------------------- | ----------- |
| 3 trechos    | Respostas focadas    | Rápido      |
| 5 trechos    | Respostas completas  | Moderado    |
| 10 trechos   | Respostas detalhadas | Mais lento  |

<Note>
  Mais trechos significam respostas mais completas, mas também aumentam o tempo de resposta e custo de processamento.
</Note>

### Threshold de relevância

Defina o quão relevante um resultado deve ser para ser usado:

| Threshold       | Comportamento                           |
| --------------- | --------------------------------------- |
| Alto (0.8+)     | Só usa resultados muito relevantes      |
| Médio (0.5-0.8) | Usa resultados razoavelmente relevantes |
| Baixo (\<0.5)   | Usa qualquer resultado encontrado       |

**Recomendação:** Comece com threshold médio e ajuste conforme qualidade das respostas.

### Fallback quando não encontrar

Configure o que acontece quando a KB não tem a informação:

<Tabs>
  <Tab title="Resposta honesta">
    ```
    "Não tenho essa informação em minha base de dados.
    Vou transferir você para um atendente que poderá ajudar."
    ```
  </Tab>

  <Tab title="Solicitar mais detalhes">
    ```
    "Poderia me dar mais detalhes sobre sua pergunta?
    Assim posso buscar a informação correta para você."
    ```
  </Tab>

  <Tab title="Oferecer alternativas">
    ```
    "Não encontrei informações específicas sobre isso,
    mas posso ajudar com [opções relacionadas]. Deseja saber mais?"
    ```
  </Tab>
</Tabs>

***

## Boas práticas para a KB

### Estrutura do conteúdo

Para melhores resultados, organize sua KB:

<Tabs>
  <Tab title="Estrutura ideal">
    ```markdown theme={null}
    # Nome do Produto

    ## Descrição
    [Descrição clara e objetiva]

    ## Especificações
    - Característica 1: valor
    - Característica 2: valor

    ## Preço
    R$ X.XXX,00

    ## Disponibilidade
    Em estoque / Sob encomenda

    ## Perguntas frequentes
    **P: Pergunta comum?**
    R: Resposta direta.
    ```
  </Tab>

  <Tab title="O que evitar">
    ```markdown theme={null}
    # produto xyz

    eh um produto muito bom que a gente vende aqui
    preco bom tbm

    qq coisa fala com a gente
    ```

    Problemas:

    * Sem estrutura clara
    * Linguagem informal
    * Falta informações específicas
  </Tab>
</Tabs>

### Tipos de conteúdo recomendados

<Check>
  **Produtos/Serviços:** Nome, descrição, preço, especificações
</Check>

<Check>
  **Políticas:** Trocas, devoluções, garantia, prazos
</Check>

<Check>
  **FAQ:** Perguntas e respostas diretas
</Check>

<Check>
  **Horários:** Funcionamento, atendimento, entregas
</Check>

<Check>
  **Contatos:** Telefones, emails, endereços por departamento
</Check>

### Manutenção da KB

<Warning>
  Uma KB desatualizada é pior que não ter KB. O agente vai fornecer informações erradas com confiança.
</Warning>

**Checklist de manutenção:**

| Frequência          | Ação                                    |
| ------------------- | --------------------------------------- |
| Semanal             | Verificar promoções e preços            |
| Mensal              | Revisar FAQ e adicionar novas perguntas |
| Trimestral          | Auditoria completa do conteúdo          |
| Conforme necessário | Novos produtos, mudanças de política    |

***

## Testando a integração com KB

### Perguntas de teste

Faça perguntas que exigem consulta à KB:

| Categoria          | Pergunta de teste              |
| ------------------ | ------------------------------ |
| Produto específico | "Quanto custa o \[produto X]?" |
| Política           | "Qual o prazo de troca?"       |
| Horário            | "Vocês abrem no sábado?"       |
| Processo           | "Como faço para devolver?"     |

### Validando respostas

Para cada resposta, verifique:

<Check>
  Informação está correta e atualizada?
</Check>

<Check>
  Fonte foi a KB (não inventou)?
</Check>

<Check>
  Resposta é clara e completa?
</Check>

<Check>
  Tom está adequado à marca?
</Check>

### Debug de problemas

Se as respostas não estiverem corretas:

1. **Verifique se a KB está vinculada** - Configuração do agente
2. **Confira o conteúdo da KB** - Informação existe e está correta?
3. **Teste a busca** - A pergunta encontra o documento certo?
4. **Ajuste o threshold** - Talvez esteja muito alto ou baixo

***

## Exemplos por segmento

<Tabs>
  <Tab title="E-commerce">
    **KB Produtos:**

    * Catálogo completo com preços
    * Especificações técnicas
    * Disponibilidade e prazos

    **KB Políticas:**

    * Troca e devolução (30 dias)
    * Frete grátis acima de R\$X
    * Parcelamento sem juros

    **Perguntas esperadas:**

    * "Tem frete grátis?"
    * "Posso parcelar em quantas vezes?"
    * "Qual o prazo de entrega?"
  </Tab>

  <Tab title="Imobiliária">
    **KB Imóveis:**

    * Características dos empreendimentos
    * Plantas e metragens
    * Faixa de preços por tipo

    **KB Processos:**

    * Documentação necessária
    * Etapas da compra
    * Financiamento e simulação

    **Perguntas esperadas:**

    * "Tem apartamento de 2 quartos na zona sul?"
    * "Quais documentos preciso para financiar?"
    * "Vocês trabalham com qual banco?"
  </Tab>

  <Tab title="Clínica">
    **KB Serviços:**

    * Especialidades disponíveis
    * Exames realizados
    * Convênios aceitos

    **KB Operacional:**

    * Horários por especialidade
    * Preparo para exames
    * Política de cancelamento

    **Perguntas esperadas:**

    * "Vocês atendem Unimed?"
    * "Precisa de jejum para o exame?"
    * "Qual horário do Dr. \[Nome]?"
  </Tab>
</Tabs>

***

## Solução de problemas

<AccordionGroup>
  <Accordion title="Agente não encontra informações que existem na KB">
    **Possíveis causas:**

    * Conteúdo mal estruturado
    * Threshold muito alto
    * Pergunta muito diferente do conteúdo

    **Soluções:**

    * Reformule o conteúdo com palavras-chave claras
    * Reduza o threshold de relevância
    * Adicione variações de perguntas ao FAQ
  </Accordion>

  <Accordion title="Agente responde com informação errada">
    **Possíveis causas:**

    * KB desatualizada
    * Informações conflitantes
    * Conteúdo ambíguo

    **Soluções:**

    * Atualize a KB com dados corretos
    * Remova conteúdo duplicado ou conflitante
    * Seja específico e direto no conteúdo
  </Accordion>

  <Accordion title="Respostas muito genéricas mesmo com KB">
    **Possíveis causas:**

    * Limite de trechos muito baixo
    * Conteúdo pouco detalhado
    * Prompt não orienta a usar KB

    **Soluções:**

    * Aumente o número de trechos recuperados
    * Enriqueça o conteúdo da KB
    * Adicione no prompt: "Sempre consulte a base de conhecimento"
  </Accordion>
</AccordionGroup>

***

## Documentação Relacionada

### Treinamento da IA

<CardGroup cols={2}>
  <Card title="O que é RAG" icon="brain" href="/base-conhecimento/o-que-e-rag">
    Entenda a tecnologia por trás da busca inteligente.
  </Card>

  <Card title="Documento de Treinamento" icon="file-lines" href="/treinamento-ia/documento-treinamento">
    A base principal para ensinar a IA sobre seu negócio.
  </Card>

  <Card title="Criar Base Eficiente" icon="database" href="/base-conhecimento/criar-base-eficiente">
    Aprenda a estruturar sua KB para melhores resultados.
  </Card>

  <Card title="Perguntas e Respostas" icon="messages" href="/treinamento-ia/perguntas-respostas">
    Configure FAQs para respostas mais precisas.
  </Card>
</CardGroup>

### Manutenção e Boas Práticas

<CardGroup cols={2}>
  <Card title="Manter Atualizado" icon="arrows-rotate" href="/base-conhecimento/manter-atualizado">
    Boas práticas de manutenção da KB.
  </Card>

  <Card title="Checklist de Ingestão" icon="list-check" href="/base-conhecimento/checklist-ingestao">
    Verificações antes de publicar conteúdo.
  </Card>

  <Card title="Modelo de Documento" icon="file" href="/base-conhecimento/modelo-documento">
    Templates prontos para sua KB.
  </Card>

  <Card title="Erros Comuns" icon="triangle-exclamation" href="/base-conhecimento/erros-comuns">
    Evite problemas frequentes na criação da base.
  </Card>
</CardGroup>