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

# Bases de Conhecimento

> Aprenda a fornecer ao seu assistente de IA acesso a FAQs, documentos e outras fontes de conhecimento. 

As **bases de conhecimento** permitem que o seu **assistente de IA** acesse e consulte informações personalizadas de diversas fontes, como **sites**, **documentos** e **arquivos**.\
Esse recurso poderoso possibilita que o assistente forneça **respostas precisas e contextualizadas**, baseadas no **seu próprio conteúdo**.

## Abordagens para Integração de Conhecimento

#### 1. Copiar e Colar no Prompt

* **Prós:** configuração rápida e disponibilidade imediata.
* **Contras:** textos longos podem **deixar as respostas mais lentas** ou causar **interpretações parciais (“alucinações”)**.
* **Uso:** ideal para **referências curtas**, como listas de **10 perguntas frequentes (FAQs)**.

***

#### 2. Recurso de Base de Conhecimento

Nosso **recurso dedicado de Base de Conhecimento** permite **armazenar e gerenciar documentos** que a IA pode **consultar sob demanda**.

<CardGroup cols={2}>
  <Card title="Conteúdo do Site" icon="globe">
    Raspe sites inteiros para capturar todas as informações disponíveis

    Sites da empresa

    Documentação do produto

    Páginas de FAQ

    Conteúdo do blog
  </Card>

  <Card title="Arquivos de Documentos" icon="file">
    Envie diversos formatos de arquivo com suas informações

    **Arquivos PDF:** manuais, guias, relatórios

    **Documentos Word (.docx):** políticas, procedimentos

    **Arquivos de texto (.txt):** conteúdo simples, anotações
  </Card>
</CardGroup>

#### Status de Processamento

Cada base de conhecimento passa por diferentes **etapas de processamento**:

<AccordionGroup>
  <Accordion title="Vazia" icon="folder-open">
    Nenhum documento adicionado ainda.\
    Adicione conteúdo para **ativar a base de conhecimento**.
  </Accordion>

  <Accordion title="Processando" icon="clock">
    Os **documentos estão sendo analisados e indexados**.\
    O **tempo de processamento** varia conforme o **tamanho do conteúdo**.
  </Accordion>

  <Accordion title="Ativa" icon="check">
    A **base de conhecimento está pronta**.\
    Seu **assistente de IA** agora pode **pesquisar e consultar essas informações**.
  </Accordion>

  <Accordion title="Falha" icon="x">
    O **processamento falhou**.\
    Causas comuns: **sites protegidos**, **conteúdo inacessível** ou **arquivos corrompidos**.
  </Accordion>
</AccordionGroup>

#### Modos de Integração

Escolha como o seu **assistente de IA** acessará as informações da **base de conhecimento**:

<CardGroup cols={2}>
  <Card title="Chamada de Função" icon="function">
    **Recomendado:** pesquisa apenas quando necessário — mais **eficiente e rápido**.

    **Ideal para:** conversas gerais
  </Card>

  <Card title="Injeção de Prompt" icon="syringe">
    **Abrangente:** realiza uma pesquisa após **cada mensagem do cliente** — mais **preciso**, porém **mais lento**.

    **Ideal para:** assistentes focados em **suporte**. Use com **áudio de preenchimento**.
  </Card>
</CardGroup>

## Boas Práticas

* Mantenha as informações **concisas** e use **tópicos em lista**.
* Separe os assuntos com **títulos claros** para que a IA possa interpretar de forma mais eficaz.
* **Monitore as transcrições** das chamadas para confirmar que a IA está utilizando corretamente os seus dados.
* Utilize **URLs publicamente acessíveis** para a raspagem de sites.
* Considere o **tamanho dos arquivos** e o **tempo de processamento** para documentos grandes.

***

### Considerações sobre Raspagem de Sites

<Warning>
  **Proteção de Sites:** Alguns sites possuem **mecanismos anti-raspagem** que podem fazer o processamento falhar.\
  Se você for o proprietário do site, **desative temporariamente a proteção** durante o processo de raspagem.
</Warning>

### Problemas Comuns

* **Proteção Cloudflare**, **limitação de taxa** (rate limiting) ou **requisitos de login**
* **Sites com muito JavaScript** ou **conteúdo protegido**

***

### Soluções

* Use **URLs publicamente acessíveis**
* **Exporte o conteúdo manualmente** e envie como documentos
* **Entre em contato com o suporte** para obter ajuda com conteúdo protegido

***

### Processo de Configuração

1. Acesse **Bases de Conhecimento** no seu painel
2. Clique em **“Criar Base de Conhecimento”**
3. Adicione um **nome** e uma **descrição**
4. **Envie documentos** (PDF, DOCX, TXT) ou **adicione URLs de sites**
5. Aguarde o **término do processamento**
6. **Atribua a base** ao seu assistente em **Configurações do Assistente**

***

### Uso

Após a conexão, seu **assistente** pesquisará automaticamente na **base de conhecimento** durante as conversas para fornecer **respostas precisas e contextualizadas**, com base no seu conteúdo.

**Funcionalidade de busca:** a IA pesquisa em todos os documentos da base de conhecimento para encontrar **informações relevantes** conforme a pergunta do cliente e gerar **respostas com contexto**.

***

### Solução de Problemas

* **Falha no processamento:** verifique se as URLs são **publicamente acessíveis** e **desative a proteção do site** se for o proprietário.
* **Nenhum resultado na pesquisa:** confirme a **relevância do conteúdo** e se o **processamento foi concluído** (status ativo).
* **Respostas lentas:** altere o modo de integração de **Injeção de Prompt** para **Chamada de Função**.

***

**Observação:** Para configurações detalhadas e ajustes avançados, consulte o **Guia de Configurações do Assistente**.