![Fluxo da base de conhecimento da Eva: adicionar uma fonte de Texto, URL ou PDF, o worker quebra a fonte em entradas de FAQ, a fonte fica Pronto com trechos pesquisáveis, sincronizar novamente após editar e revisar as candidatas mineradas na Revisão de FAQ.](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcEVRIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--92ca0e7a8b6574de5388fbc71e064ec6fbe2cf40/base-de-conhecimento-da-eva.png)

A **Base de conhecimento da Eva** é o que a Eva consulta para responder aos seus clientes com informações corretas e consistentes. Você alimenta esse conhecimento na aba **Conhecimento** do assistente: adiciona uma fonte (um texto, uma URL ou um PDF) e um processo em segundo plano a transforma em **entradas de FAQ** pesquisáveis. Este artigo mostra como adicionar fontes, acompanhar o processamento, ressincronizar após edições e revisar as FAQs que a Eva minera automaticamente das conversas resolvidas.

![Aba Conhecimento do assistente Eva: formulário de nova fonte com Nome, os modos Texto/URL/PDF e o botão Adicionar fonte](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcElRIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ba01feea82963621a26d59aa44d6e27624865ca5/eva-conhecimento.png)

## Antes de começar

- Você precisa de um assistente Eva já criado e salvo. Só é possível gerenciar o conhecimento depois de salvar o assistente (a mensagem **"Salve o assistente para gerenciar suas caixas de entrada, conhecimento, cenários e ferramentas."** aparece enquanto isso não acontece). Se você ainda não tem um, veja **Criar um assistente Eva**.
- Acesse **Configurações → Assistentes Eva**, abra o assistente e vá até a aba **Conhecimento**.
- Tenha em mãos o conteúdo que quer ensinar à Eva: um texto pronto para colar, o endereço de uma página pública ou um arquivo PDF.

## Como funciona: fontes viram entradas de FAQ

Ao adicionar uma fonte, a Eva não pesquisa diretamente no texto que você colou. Um **worker** (processo em segundo plano) quebra cada fonte em **entradas de FAQ** — pequenos trechos pesquisáveis — e é nessas entradas geradas que a Eva realmente busca as respostas.

Por isso, a recomendação é sempre a mesma: **cadastre o conhecimento como uma fonte de Texto e deixe o worker montar as entradas de FAQ.** O conhecimento pesquisável vive nessas entradas geradas, não na fonte bruta.

## Adicionar uma fonte de conhecimento

1. Na aba **Conhecimento**, preencha o campo **Nome** com um rótulo claro para a fonte (ex.: "Política de reembolso").
2. Escolha o modo da fonte: **Texto**, **URL** ou **PDF**.
   - **Texto** — cole o conteúdo no campo ("Cole o texto do conhecimento…"). É o modo recomendado para a maioria dos casos.
   - **URL** — informe o endereço de uma página pública (ex.: `https://example.com/help`) para que a Eva rastreie o conteúdo.
   - **PDF** — use **"Escolher um PDF…"** para enviar o arquivo.
3. Clique em **Adicionar fonte**.

Pronto: a fonte entra na lista e o processamento começa automaticamente.

## Acompanhar o processamento

Cada fonte mostra um status enquanto o worker faz o trabalho:

- **Pendente** — a fonte está na fila, o processamento ainda não começou.
- **Processando** — o worker está quebrando a fonte em entradas de FAQ.
- **Pronto** — as entradas foram geradas e já podem ser pesquisadas pela Eva.

Junto ao status, a fonte exibe uma contagem no formato **{n}/{total} pesquisáveis**, indicando quantas entradas de FAQ já estão prontas para uso.

Se os trechos nunca ficarem pesquisáveis, você verá o aviso: **"os trechos ainda não são pesquisáveis — o worker de embeddings pode não estar em execução."** Nesse caso, o processamento em segundo plano está indisponível; fale com quem administra a instância.

## Ressincronizar depois de editar

Sempre que você editar o texto de uma fonte, as entradas de FAQ precisam ser reconstruídas para refletir a mudança.

1. Faça a edição no conteúdo da fonte.
2. Clique em **Sincronizar novamente**.
3. Acompanhe o status voltar a **Processando** e, ao terminar, a **Pronto** com a contagem de pesquisáveis atualizada.

## Revisão de FAQ: aprovar candidatas mineradas

Além das fontes que você cadastra, a Eva pode **minerar** perguntas frequentes a partir das conversas já resolvidas — desde que o recurso **Minerar FAQs** esteja ativado nas configurações do assistente. Essas sugestões aparecem na aba **Revisão de FAQ**, em **"Candidatas a FAQ pendentes"**.

Para revisar:

1. Abra a aba **Revisão de FAQ**.
2. Analise cada candidata pelo par **Pergunta** / **Resposta**. O selo de origem indica de onde ela veio: **Manual**, **De um documento** ou **De uma conversa**.
3. Ajuste o que precisar em **Editar**, descarte o que não serve em **Rejeitar** e, ao final, confirme as boas com **Aprovar selecionadas**.

Apenas as candidatas **aprovadas** passam a integrar o conhecimento pesquisável da Eva. As demais ficam de fora até você aprová-las.

## Além do conhecimento: cenários e ferramentas

A base de conhecimento cobre o que a Eva *sabe*. Para moldar *como* ela conduz determinados assuntos e o que ela pode *fazer*, o assistente tem mais duas abas:

- **Cenários** — sub-comportamentos especializados (por exemplo, um "Especialista em reembolsos") com instruções próprias.
- **Ferramentas personalizadas** — chamadas às suas próprias APIs HTTPS para a Eva buscar ou enviar dados durante a conversa.

Para os detalhes de cada uma, veja **Cenários e ferramentas da Eva**.