Manual do painel · Inteligência

Base de conhecimento da IA: ensine sua empresa com texto, FAQ, site e arquivos

Base de conhecimento é o item do painel onde você ensina a IA sobre a sua empresa: tudo o que é cadastrado ali vira a fonte da verdade das respostas, e o que não está na base ela passa para a equipe em vez de inventar.

Quem pode usar

Papel	O que vê e faz
Dono	Vê tudo e faz tudo: adiciona, edita, pausa, ativa e exclui fontes, preenche o roteiro e testa a base.
Admin	Mesmo acesso do dono nesta tela.
Atendente	Vê o item no menu, a lista de fontes e o roteiro, e pode usar o Teste a base. Adicionar, editar, pausar ou excluir volta com um aviso de recusa.

Telas

Base de conhecimento

A tela Base de conhecimento serve para cadastrar, testar e organizar as fontes de informação que a IA usa para responder aos leads.

Endereço no painel: /app/conhecimento

Captura da tela Base de conhecimento. A tela Base de conhecimento serve para cadastrar, testar e organizar as fontes de informação que a IA usa para responder aos leads. — A tela Base de conhecimento na conta de demonstração, com dados fictícios e os valores desfocados.

O que a sua IA sabe

Resumo da base no topo da tela.

Texto fixo: o que é adicionado vira a fonte da verdade; quando não souber, a IA encaminha para um especialista e nunca inventa.
Indicador fontes ativas: quantas fontes a IA está usando.
Indicador trechos indexados: em quantos pedaços o conteúdo foi dividido para a busca.

Aviso da planilha importada

Aparece para dono e administrador quando a Base avançada está disponível e há uma planilha importada que uma sincronização pode substituir.

Botões e ações

Ver a comparaçãoDono, Admin: Com o módulo Base avançada ligado, abre a criação da sincronização já com esta planilha.
Conhecer o móduloDono, Admin: Sem o módulo ligado, abre a página do módulo Base avançada.

Título Você importou ‹arquivo› em ‹data›. Trocar pela sincronização?.

Roteiro da base

Os tópicos que o segmento da conta pede na base. Contas sem segmento não veem este cartão.

Botões e ações

Preencher: Em tópico ainda vazio, abre o formulário de texto já com o tópico no título e o cursor no conteúdo. Nenhuma fonte vazia é criada antes de você salvar.

Selo geral ‹n› a preencher ou Tudo preenchido.
Cada tópico com o selo Preenchido ou A preencher.

Adicionar conhecimento / Editar fonte

O formulário de uma fonte. Ao clicar em Editar na lista, ele sobe com a fonte carregada.

Campos e filtros

Título da fonteobrigatório: Nome da fonte na lista.
Conteúdoobrigatório: Nos tipos Texto e FAQ, o conteúdo em si. No FAQ, cada pergunta começa com P: e cada resposta com R:.
Endereço da página: No tipo Página do site. Na edição, deixar em branco mantém o texto já importado (a tela mostra quantos caracteres); colar o endereço reimporta do zero.
Arquivo: No tipo Arquivo, ao criar. Se o arquivo não couber numa fonte só, o aviso explica o que fazer.
Onde esta fonte vale: Aparece com mais de uma conta conectada (ou quando a fonte já tem recorte). Sem marcar nenhuma, vale para todas as contas; marcando, só as escolhidas a enxergam. Conta desconectada aparece com (desconectada) e a marcação fica guardada.

Botões e ações

Texto: Tipo para colar qualquer conteúdo: sobre a empresa, políticas, catálogo.
FAQ: Tipo para perguntas e respostas prontas, no formato P: e R:.
Página do site: Tipo que importa o texto de um endereço da internet na hora.
Arquivo: Tipo para enviar PDF, DOCX, MD, TXT, XLSX ou CSV, de até 10MB.
Adicionar à baseDono, Admin: Salva a fonte nova e a divide em trechos. Mostra Indexando… e depois quantos trechos foram indexados.
Salvar e reindexarDono, Admin: Na edição, grava as mudanças e refaz os trechos.
Cancelar: Na edição, limpa o formulário sem salvar.

Ao vir de Preencher, a frase Preenchendo o tópico do roteiro da base: escreva o que a IA precisa saber sobre isso.

Fontes

A lista de tudo o que está cadastrado.

Botões e ações

PausarDono, Admin: Tira a fonte das respostas da IA sem apagar. Na fonte pausada o botão vira Ativar.
AtivarDono, Admin: Volta a fonte pausada para as respostas.
EditarDono, Admin: Carrega a fonte no formulário do topo.
ExcluirDono, Admin: Remove a fonte da base na hora, sem janela de confirmação.

Etiqueta colorida do tipo: Texto, FAQ, Página ou Arquivo.
Linha ‹n› trecho(s) · atualizada ‹data› · ‹contas›, em que as contas são todas as contas, os nomes das contas marcadas ou conta removida.
Selo de situação: Ativa, Pausada ou Erro.

Teste a base

Painel lateral que mostra os trechos que a IA usaria para responder a uma pergunta.

Campos e filtros

Pergunta de teste: Escreva como um cliente escreveria.
Testar como: Aparece com mais de uma conta conectada. Base inteira (todas as contas) ou uma conta específica, para conferir o recorte que ela enxerga.

Botões e ações

Testar: Busca os trechos mais relevantes. Enquanto busca, mostra ….

Resultados em cartões: o primeiro marcado MAIS RELEVANTE e os seguintes TRECHO ‹n›.
Sem resultado: a IA usaria só a persona e as ofertas do catálogo; a orientação é adicionar o conteúdo à base.

Estados da tela

Carregando: Bloco cinza no lugar da lista de fontes e do roteiro.
Sem nada ainda: Nenhuma fonte ainda — adicione acima o que a sua IA precisa saber (quem vocês são, o que vendem, políticas, dúvidas frequentes).
Se der erro: Não foi possível carregar as suas fontes, avisando que nenhuma foi apagada, com botão para tentar de novo. Os indicadores mostram —.
Roteiro não carregou: Não foi possível carregar o roteiro da base — as fontes continuam valendo, com botão para tentar de novo.
Fonte pausada: Aviso Fonte pausada — a IA deixa de usá-la.
Fonte excluída: Aviso Fonte removida da base.
Arquivo sem tipo aceito: Aviso Escolha um arquivo PDF, DOCX, MD, TXT, XLSX ou CSV.
Falha ao salvar: O motivo devolvido em português, ou Não foi possível salvar a fonte. Confira o conteúdo.

Passo a passo

Como ensinar a IA sobre a minha empresa

Abra Base de conhecimento no menu.
Em Adicionar conhecimento, deixe o tipo Texto escolhido.
Preencha Título da fonte e cole o texto em Conteúdo.
Clique em Adicionar à base.

Como cadastrar perguntas frequentes para a IA

Escolha o tipo FAQ.
Dê um Título da fonte e escreva no Conteúdo cada pergunta começando com P: e cada resposta com R:, separadas por linha em branco.
Clique em Adicionar à base.

Como importar o conteúdo do site para a IA

Escolha o tipo Página do site.
Preencha Título da fonte e cole o link em Endereço da página.
Clique em Adicionar à base e confira na lista quantos trechos vieram.
Se vier pouco texto, cole o conteúdo como Texto.

Como enviar um PDF ou planilha para a base

Escolha o tipo Arquivo.
Selecione o arquivo em Arquivo (PDF, DOCX, MD, TXT, XLSX ou CSV, até 10MB).
Clique em Adicionar à base.

Como testar se a IA sabe responder uma pergunta

No painel Teste a base, escreva a pergunta em Pergunta de teste.
Com várias contas, escolha em Testar como qual conta simular.
Clique em Testar e leia o trecho MAIS RELEVANTE.

Como fazer um documento valer só para um número

Abra a fonte com Editar (ou crie uma nova).
Em Onde esta fonte vale, marque só as contas desejadas.
Clique em Salvar e reindexar e confira com Testar como.

Como preencher o roteiro da base do meu segmento

No cartão Roteiro da base, clique em Preencher no tópico A preencher.
Escreva o conteúdo e clique em Adicionar à base. O tópico passa a Preenchido.

Perguntas frequentes

Excluir uma fonte pede confirmação?

Não. Excluir remove na hora. Se a dúvida for temporária, use Pausar.

Quais arquivos a base aceita?

PDF, DOCX, MD, TXT, XLSX e CSV, de até 10MB por arquivo.

Se o site mudar, a base atualiza sozinha?

Não. O texto é importado no momento do cadastro. Edite a fonte e cole o endereço de novo para reimportar.

Para que serve o número de trechos indexados?

Mostra em quantos pedaços o conteúdo foi dividido para a busca. Fonte com zero trechos não tem texto que a IA consiga usar.

Por que não vejo o campo Onde esta fonte vale?

Ele só aparece quando há mais de uma conta conectada ou quando a fonte já tem um recorte salvo.

O atendente pode testar a base?

Sim. Testar é liberado para toda a equipe; cadastrar e mudar fontes é do dono e do administrador.

Por que o cartão Roteiro da base não aparece?

Ele só existe quando a conta tem um segmento escolhido em Configurações.

O que significa o selo Erro numa fonte?

Que o conteúdo não pôde ser lido ou dividido em trechos. Edite a fonte ou envie o conteúdo de outro jeito.

Guia da Central de ajuda

Base de conhecimento

Tudo o que a sua IA sabe. O que está aqui ela responde; o que não está, ela não inventa — passa para um especialista.

Esta é a fonte da verdade da sua IA. Prazo de entrega, área de atendimento, política de troca, o que está incluso: tudo o que ela responde sai daqui. E o contrário também vale, que é o mais importante — sobre o que não está aqui, ela não arrisca um palpite: encaminha para um especialista. Base curta não deixa a IA burra, deixa ela calada.

A tela por partes

Na tela: Tela da Base de conhecimento com o resumo, o formulário de adicionar conteúdo e, à direita, o painel Teste a base. À esquerda você ensina; à direita você confere se ela aprendeu. As duas metades trabalham juntas.

A regra da tela, e os dois números: fontes ativas é quanto conteúdo está no ar agora. trechos indexados é em quantos pedaços o seu texto foi partido para ela achar a parte certa depressa — texto grande vira muitos trechos, e isso é bom.
De onde vem o conteúdo: Texto, FAQ, Página do site e Arquivo. O tipo escolhido muda o campo logo abaixo: colar o conteúdo, escrever no formato P: / R:, informar um endereço ou anexar um documento.
Título e conteúdo: O título é obrigatório e é como a fonte aparece na lista: Política de troca ajuda, Documento 2 não. No conteúdo cabem cerca de 200 mil caracteres por fonte — umas 50 páginas.
Adicionar à base: Salva e põe a fonte no ar na hora. Editando uma que já existe, o botão vira Salvar e reindexar — ou seja, ela reaprende o texto novo em vez de somar ao antigo.
Teste a base: A ferramenta de trabalho desta tela. Pergunte como um cliente perguntaria e veja os trechos que ela usaria para responder. Nada aqui é enviado para ninguém.
A lista de fontes: Tudo o que já está no ar, com o tipo, quantos trechos gerou e quando mudou. É aqui que ficam Pausar, Editar e Excluir — e é aqui que mora o risco da tela.

O roteiro da base do seu segmento

Com o segmento da conta escolhido, o cartão Roteiro da base lista os tópicos que o seu segmento pede (os serviços e preços, os horários, o que levar no dia…). Cada tópico aparece como A preencher até virar uma fonte. Preencher abre o formulário de fonte com o tópico no título: escreva o que a IA precisa saber e salve. O tópico passa a Preenchido; se você excluir a fonte, ele volta a A preencher.

Na tela: Cartão Roteiro da base: os tópicos do segmento Imobiliária, uns preenchidos e outros a preencher, cada um com o botão Preencher. O roteiro do segmento Imobiliária: o que já virou fonte e o que ainda falta preencher.

Os quatro jeitos de ensinar

Os quatro funcionam de verdade e podem conviver na mesma base. A escolha é sobre onde o conteúdo já está hoje:

Texto: Cole qualquer coisa: quem vocês são, o que vendem, políticas, condições. É o formato mais flexível e o que mais funciona quando você escreve com as suas palavras.
FAQ: Perguntas e respostas prontas, no formato P: na primeira linha e R: na seguinte, com uma linha em branco entre os pares. Bom quando você já tem as dúvidas mapeadas.
Página do site: Informe um endereço público em https e o conteúdo é copiado na hora. O que fica guardado é o texto de hoje, não a página: se ela mudar, edite a fonte e cole o endereço de novo para reimportar.
Arquivo: PDF, DOCX, MD, TXT, XLSX ou CSV, até 10MB. Ideal para catálogo, tabela de condições e manual que já existem em documento. Planilha entra uma linha por frase ("Produto: Losartana 50mg · Preço: 12,90"), com a primeira linha como cabeçalho — é assim que a pergunta do cliente encontra a linha certa. Cabe cerca de mil linhas por arquivo (depende do tamanho de cada linha): lista maior se divide por grupo, um arquivo por grupo, e a tela diz na hora quantas cabem. Tirar colunas que a IA não usa para responder — código de barras, mensagens internas — faz caber bem mais. Dê à coluna o nome do que ela guarda: "Desconto: 20%" a IA entende na hora, "Obs.: 20%" fica ambíguo. Só a lista de preços? O lugar dela é o catálogo, que também importa planilha.

Testar antes de o cliente testar

O painel Teste a base é o que transforma esta tela de cadastro em ferramenta. Use-o toda vez que adicionar conteúdo — leva dez segundos e é a única prova de que ela aprendeu o que você quis ensinar.

Pergunte como um cliente perguntaria: "vcs entregam em curitiba?", e não "área de cobertura logística". A pergunta torta é justamente a que chega no WhatsApp.
Leia o que voltou: Os trechos aparecem em ordem, com MAIS RELEVANTE no topo. Se o primeiro trecho responde a pergunta, a IA responde também.
Se vier "Nenhum trecho relevante", falta conteúdo: Para aquela pergunta ela não tem o que dizer e vai encaminhar para um humano. Escreva o pedaço que falta e teste de novo — a lacuna você acabou de descobrir qual é.
Repita com as cinco perguntas do dia: Prazo, preço, forma de pagamento, garantia, região de atendimento. Cobrindo essas cinco, você tira a maior parte do transbordo bobo do time.

Documento que vale só para uma conta

Se você atende por mais de uma conta, cada documento pode valer só para as contas que você marcar. É o caso de quem tem duas marcas ou duas franquias no mesmo painel: a política de trocas vale para todo mundo, mas o cardápio da filial só a filial deve responder.

A escolha fica no formulário, em Onde esta fonte vale, e aparece quando existe mais de uma conta conectada — com uma conta só não há o que separar. Editando uma fonte que já tem recorte, a escolha aparece de qualquer jeito, para você poder desfazê-lo. Cada fonte da lista mostra o seu recorte: todas as contas ou o nome das contas marcadas.

Testar como uma conta: No painel Teste a base, o campo Testar como faz a pergunta pelos olhos de uma conta específica — é assim que você confere o recorte antes de o cliente conferir por você. Base inteira mostra tudo.
O simulador e as campanhas enxergam tudo: Eles não saem por uma conta específica, então não há o que recortar. O recorte vale onde ele importa: na resposta ao lead, que chega sempre por uma conta.
Se a conta for desconectada: A fonte não é apagada e a marcação continua guardada — a lista mostra a conta com a observação (desconectada). Reconectando a mesma conta, o recorte volta a valer sozinho.

O mesmo raciocínio existe para a voz da IA: cada conta pode ter a sua própria persona. Está em Personas A/B.

Pausar e excluir

Quando a intenção é só tirar de circulação — a promoção acabou, a política está sendo reescrita, o documento venceu — use Pausar. A fonte ganha a marca Pausada, é ignorada por completo enquanto estiver assim, e Ativar devolve tudo. É reversível, e resolve quase todos os casos em que a pessoa clicaria em Excluir.

Pausar: sai do ar, volta quando você quiser, nada se perde.
Editar: corrige o conteúdo e reaprende no lugar da versão antiga.
Excluir: apaga de vez. Guarde antes o texto se ele não existir em outro lugar.

Quando não salva

A tela mostra sempre a mesma mensagem genérica quando algo dá errado, então a causa você descobre eliminando. Nesta ordem:

Arquivo em formato não aceito. Entram PDF, DOCX, MD, TXT, XLSX e CSV. Imagem e apresentação ficam de fora — copie o texto e cole em Texto. Planilha em .xls antigo (ou do Google) não abre: salve como .xlsx ou .csv e envie de novo.
Arquivo acima de 10MB. PDF cheio de imagem estoura fácil. Exporte só as páginas que importam.
PDF que é foto de papel. Documento escaneado não tem texto para ler; digite ou cole o conteúdo à mão.
Texto acima do limite. Passou de cerca de 200 mil caracteres, quebre em duas fontes por assunto — funciona melhor, inclusive.
Endereço que não responde, ou página sem texto legível. Confira se o endereço abre no navegador em https, sem senha e sem aviso de cookies cobrindo a página.

Quem pode mexer

Adicionar, editar, pausar e excluir: administrador ou dono da conta.
Ler as fontes e usar o Teste a base: qualquer pessoa do time — e vale incentivar, porque quem atende é quem sabe o que falta.

No painel: Abrir a Base de conhecimento