Base de conhecimento

A base de conhecimento é o que separa um agente que responde do seu negócio de um que responde qualquer coisa. Esta página explica como alimentá-la, quais são os limites de tamanho e como corrigir o que entrou errado. É para quem conhece o conteúdo — não exige nada técnico.

Onde fica

No menu lateral, clique em Knowledge (“Conhecimento”). A tela se apresenta assim: “Every page your AI agents learn from. Review and edit the extracted content, add pages of your own, and choose what stays in your knowledge base.” (“Cada página com que seus agentes de IA aprendem. Revise e edite o conteúdo extraído, acrescente páginas suas e escolha o que fica na base.”)

O conteúdo pertence à organização. Cada agente pode usar tudo ou apenas parte — dentro do agente, a aba Knowledge mostra o que aquele agente usa, com o botão Link existing (“Vincular existente”) para acrescentar.

Os quatro tipos de fonte

Clique em Add source (“Adicionar fonte”). Abre a janela Add knowledge source, com quatro cartões:

Cartão	Como o painel descreve
Website	Crawl a page or whole site — rastrear uma página ou o site inteiro
Sitemap	Index every listed page — indexar todas as páginas listadas
Document	PDF file, up to 25 MB — arquivo PDF, até 25 MB
Text	Paste content directly — colar conteúdo direto

Website

Informe a PAGE URL e escolha o CRAWL SCOPE (“Alcance do rastreamento”) entre quatro opções:

• This page only (“Só esta página”) — indexa apenas o endereço informado.
• This section (“Esta seção”) — só as páginas abaixo daquele caminho.
• This site (“Este site”) — todas as páginas do mesmo endereço.
• Whole domain (“Domínio inteiro”) — inclui outros subdomínios, como blog e documentação.

O rastreamento entra numa fila e roda no plano de fundo. Ele desce até 5 níveis de profundidade e traz até 25 páginas por fonte. Precisando de mais que isso, quebre em várias fontes — uma por seção do site.

Sitemap

Informe a SITEMAP URL, normalmente https://seusite.com.br/sitemap.xml. O painel explica: o sistema lê o sitemap e enfileira cada página listada; sitemaps grandes são processados em lotes. Aqui o rastreador não segue links das páginas — ele indexa exatamente o que o sitemap lista.

Document (PDF)

Arraste o arquivo para a área escrita Drop a PDF or click to browse (“Solte um PDF ou clique para procurar”). Os limites são 25 MB por arquivo e 20 arquivos por envio. Tentando enviar mais, o sistema recusa com “Too many files: at most 20 per request”.

O painel avisa o que acontece com o arquivo: o texto é extraído, dividido em trechos e indexado; PDFs escaneados passam por reconhecimento de caracteres antes.

Text

Duas caixas: TITLE (“Título”), com o exemplo e.g. Refund policy, e CONTENT (“Conteúdo”). É a fonte que entra na hora — o rodapé muda de Queued for crawling para Added instantly — no crawling needed (“Adicionado na hora — sem rastreamento”).

Use texto colado para o que não está escrito em lugar nenhum: a regra de troca que só existe na cabeça do gerente, o combinado sobre frete, a resposta padrão para a reclamação mais comum. Isso costuma ser o conteúdo mais valioso da base inteira.

Acompanhar o processamento

Depois de adicionar, a fonte aparece na lista com um estado:

Estado	O que significa
Pending (“Pendente”)	Na fila, ainda não começou.
Crawling (“Rastreando”)	Lendo e indexando agora.
Synced (“Sincronizado”)	Pronto. O agente já usa.
Needs sync (“Precisa sincronizar”)	Deu problema; precisa de atenção.
Failed (“Falhou”)	O rastreamento não completou.

Rastreamento de site leva alguns minutos. Você pode sair da tela — o trabalho continua.

Editar depois de importar

Esta é a parte que diferencia o ChatMade da maioria das ferramentas parecidas: o que foi importado não é uma caixa preta. Você abre, lê, corrige e apaga página por página.

Isso importa porque rastreamento de site sempre traz lixo junto — menu, rodapé, aviso de cookies, página de política que ninguém quer que o agente cite. E porque um preço muda antes do site mudar.

Clique numa fonte na lista à esquerda para ver as páginas extraídas. Clicando em uma página, o conteúdo aparece à direita.

Corrigir uma página. Clique em Edit (“Editar”). Aparecem os campos PAGE TITLE (“Título da página”) e PAGE CONTENT (“Conteúdo da página”). O rodapé do editor avisa o que vai acontecer: Editing — re-embeds on save (“Editando — reindexado ao salvar”). Clique em Save page (“Salvar página”). O texto novo passa a valer para as respostas na hora.

Apagar uma página. No painel de detalhe, o botão com a dica Delete page (“Excluir página”). A confirmação avisa que não dá para desfazer.

Acrescentar uma página. No fim da lista de páginas de uma fonte, o botão Add sub-page (“Adicionar subpágina”) acrescenta conteúdo próprio dentro daquela fonte. Serve para completar o que o site não diz. O nome precisa ser único dentro da fonte.

Apagar uma fonte inteira. O ícone de excluir na linha da fonte. A pergunta muda conforme a situação: uma fonte que falhou oferece Dismiss (“Descartar”); uma que está na fila oferece Cancel crawl (“Cancelar rastreamento”); uma pronta oferece Delete (“Excluir”). Dentro de um agente, o botão é Remove (“Remover”) — e o painel deixa claro que o conteúdo continua na organização, saindo apenas daquele agente.

Bom saber: reserve meia hora depois do primeiro rastreamento para passar pelas páginas extraídas. Apagar dez páginas de menu e rodapé melhora mais a qualidade da resposta do que acrescentar dez páginas novas.

Como a busca funciona

O conteúdo é convertido em vetores e guardado numa tabela própria da sua organização. Quando alguém pergunta, o sistema procura por significado, não por palavra exata — quem pergunta “posso devolver?” encontra a página escrita como “política de troca”.

Isso vale para o agente de chat. A busca da central de ajuda pública é outra coisa, e funciona de forma diferente — veja Central de ajuda.

Mostrar de onde veio a resposta

Por padrão, as respostas do agente não indicam a fonte. Existe uma chave para isso, mas ela vem desligada.

Para ligar, vá em AI Agents → Configure → aba Chat Customization (“Personalização do chat”) e ative Show citations (“Mostrar citações”), descrita como Display the knowledge-base sources used to answer, as chips under each reply (“Mostrar as fontes da base de conhecimento usadas na resposta, como etiquetas embaixo de cada resposta”).

Vale ligar. Uma resposta que mostra de onde saiu é uma resposta que o cliente pode conferir — e que seu time consegue auditar quando algo sai errado.

Próximo passo

Para transformar esse conteúdo numa página pública de ajuda, veja Central de ajuda.