> ## Documentation Index
> Fetch the complete documentation index at: https://help.wizebot.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Como ensinar o agente de IA com a base de conhecimento e testar as respostas

> Cadastre perguntas e respostas, páginas do seu site e arquivos para o agente de IA consultar, e teste as respostas na aba Conversar

![Aba Conversar do agente com o simulador de celular mostrando a pergunta Vocês entregam em Campinas e a resposta do agente sobre prazo e frete](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/capa.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=50df1627d5537c8a13faee4113fdae47)

A base de conhecimento é o lugar onde você coloca as informações da sua loja que o agente de IA consulta para responder os clientes: prazo de entrega, política de troca, formas de pagamento, catálogo. Assim o agente responde com os dados certos do seu negócio, sem você ter que escrever tudo nas instruções.

Você pode cadastrar três tipos de conteúdo: perguntas e respostas (FAQ), páginas do seu site e arquivos em PDF ou Word. Antes de começar, você precisa ter um agente criado. Se ainda não tem, veja [como funcionam os agentes de IA](https://help.wizebot.com.br/tutoriais/ia/agentes.md).

**1. Abra o agente**

No menu lateral, clique em **Agents** e depois no nome do agente que você quer ensinar.

![Lista de agentes de IA com o agente Atendente da Loja Exemplo destacado](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/01-abrir-agente.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=80b946ef03d1b436caf671f29e070d2f)

**2. Vá para a aba Instruções**

Clique na aba **Instruções**. Em cima fica o **Prompt do agente** e, logo abaixo, a área **Base de Conhecimento**.

![Tela do agente com a aba Instruções destacada, mostrando o prompt do agente](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/02-aba-instrucoes.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=57cd7a1e53546da58487352491a29572)

**3. Ative a base de conhecimento**

Role a tela até **Base de Conhecimento** e clique em **Ativar base de conhecimento**. Você só faz isso uma vez por agente.

![Área Base de Conhecimento desativada com o botão Ativar base de conhecimento destacado](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/03-ativar.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=a137036ed7e0c3d756436e382bbd3961)

**4. Cadastre perguntas e respostas**

Clique em **Adicionar FAQ**. Na janela que abre:

1. Em **Nome do FAQ**, escreva um nome que ajude você a reconhecer o bloco depois, como "Entregas, trocas e pagamento".
2. Em **Conteúdo**, escreva as perguntas que os clientes costumam fazer, cada uma com a resposta logo abaixo. Cabem várias perguntas e respostas no mesmo bloco.
3. Clique em **Adicionar FAQ**.

Escreva a resposta como você gostaria que o cliente lesse, com prazos, valores e condições. Por exemplo: "Pergunta: Vocês entregam em Campinas? Resposta: Sim. Entregamos em Campinas e região em até 2 dias úteis."

![Janela Adicionar FAQ com o nome Entregas, trocas e pagamento e três perguntas e respostas no campo Conteúdo](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/04-adicionar-faq.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=8a22d34e4bfcfcf70366d93ac3a0a488)

**5. Adicione uma página do seu site**

Se as informações já estão no seu site, clique em **Adicionar website**. Dê um **Título** para a página, cole o endereço completo em **URL** (começando com `https://`) e clique em **Adicionar website**.

A WizeBot lê o texto público da página. Use o endereço da página que tem a informação, como a página de trocas, e não só a página inicial.

![Janela Adicionar website com o título Política de trocas e o endereço da página preenchidos](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/05-adicionar-website.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=a7d03f922e59d65bca5731bedf093171)

**6. Envie um arquivo**

Para usar um catálogo, uma tabela ou um manual, clique em **Adicionar documento** e escolha o arquivo no computador. Você também pode arrastar o arquivo para a área **Arraste PDF ou DOCX aqui**.

São aceitos arquivos PDF e Word (DOCX), com até 50 MB cada. Dá para enviar vários de uma vez.

![Botão Adicionar documento e área para arrastar arquivos PDF ou DOCX destacados](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/06-adicionar-documento.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=89c68f5863d5c5c0d5d7e5935265cb2f)

**7. Espere a fonte ficar pronta**

Cada conteúdo cadastrado aparece na lista como uma fonte. Antes de o agente poder usar, a WizeBot precisa processar o conteúdo, e isso acontece sozinho. A etiqueta ao lado de cada fonte mostra em que pé está:

* **Aguardando**: a fonte entrou na fila.
* **Indexando**: a fonte está sendo processada.
* **Indexado**: pronta. O agente já consulta essa fonte.
* **Erro**: não deu para processar. O motivo aparece em vermelho embaixo do nome da fonte.

O botão com as duas setas (**Reindexar**) manda processar a fonte de novo. Quando a lista crescer, use **Buscar nas fontes** para achar uma fonte pelo nome.

![Lista de fontes com um FAQ e um site indexados e um documento PDF com a etiqueta Indexando destacada](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/07-fontes.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=42b527e101fc91edfceca36ce7e495fc)

**8. Edite um FAQ**

Mudou o prazo de entrega ou o frete? Clique no lápis ao lado do FAQ, altere o texto e clique em **Salvar alterações**. A fonte é processada de novo e o agente passa a usar o texto novo.

![Janela de edição do FAQ com o campo Conteúdo destacado, uma pergunta nova no fim e o botão Salvar alterações](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/08-editar-faq.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=58bc67739427eccc74e3d9a3b51e9b4f)

> [!NOTE]
>
> Só o FAQ tem o lápis de edição. Para atualizar um site ou um documento, remova a fonte e adicione de novo com o conteúdo atualizado.

**9. Remova uma fonte**

Para tirar uma informação que não vale mais, clique na lixeira ao lado da fonte.

![Lista de fontes com a lixeira da fonte Política de trocas destacada](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/09-lixeira.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=7e658cce47600ef1b9c094ae2cabef0e)

Confirme em **Remover fonte**. O agente deixa de consultar esse conteúdo, e não dá para desfazer.

![Janela Remover fonte pedindo confirmação para remover a fonte Política de trocas](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/10-remover.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=393a322f157b051f614eec21803e0c25)

**10. Abra a aba Conversar**

Com as fontes prontas, clique na aba **Conversar**. Ela mostra um celular de teste ao lado, onde você conversa com o agente como se fosse um cliente.

![Tela do agente com a aba Conversar destacada](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/12-aba-conversar.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=d32bcd02e87eccb0ebf0a6d8a22834ad)

> [!NOTE]
>
> Se o agente estiver desligado, abrir a aba **Conversar** liga o agente. Revise as instruções e a base de conhecimento antes de abrir essa aba.

**11. Teste com uma pergunta de cliente**

Digite no celular de teste uma pergunta que um cliente faria, como "Vocês entregam em Campinas?", e aperte Enter. Confira se a resposta usa as informações que você cadastrou, como o prazo e o frete grátis.

As respostas são geradas pelo agente de verdade, e a conversa de teste não afeta seus contatos nem suas conversas. Para começar uma conversa nova do zero, clique em **Reiniciar**, embaixo do celular.

![Simulador da aba Conversar com a pergunta Vocês entregam em Campinas e a resposta do agente destacada, citando prazo de 2 dias úteis e frete grátis acima de R\$ 199](https://mintcdn.com/wizebot-d8529edc/YUf2hyAZfWaDlJWZ/images/base-conhecimento/11-conversar.png?fit=max\&auto=format\&n=YUf2hyAZfWaDlJWZ\&q=85\&s=4a0840e4faaa19338e6612d5efd4d9b0)

Se a resposta veio errada ou incompleta, ajuste o FAQ ou as instruções e teste de novo.

> [!WARNING]
>
> O botão **Desativar**, no canto da área **Fontes de conhecimento**, apaga todas as fontes cadastradas e os arquivos enviados. Não é possível desfazer. Para tirar só uma informação, use a lixeira da fonte.

## Problemas comuns

> [accordion] O agente não usou a informação que eu cadastrei
>
> Confira se a fonte está com a etiqueta **Indexado**. Enquanto ela estiver em **Aguardando** ou **Indexando**, o agente ainda não consulta esse conteúdo. Se a pergunta do teste for muito diferente do que está escrito no FAQ, acrescente a pergunta do jeito que os clientes costumam escrever.

> [accordion] A fonte ficou com Erro
>
> Leia o motivo que aparece em vermelho embaixo do nome da fonte. Depois clique em **Reindexar** para tentar de novo. Se for um site, confira se o endereço abre no navegador sem pedir login.

## Precisa de ajuda?

Fale com o suporte da WizeBot pelo WhatsApp ou por e-mail.

> [card] [WhatsApp](https://wa.me/559192226534)
>
> Falar com o suporte

> [card] [E-mail](mailto:suporte@wizebot.com.br)
>
> Enviar um e-mail


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.