Base de conhecimento
A base de conhecimento é o conjunto de informações com que você treina seu agente. Quanto mais completa e precisa ela for, melhores serão as respostas do bot.
Tipos de fontes
Você pode adicionar informações de várias formas:URL
Informe o endereço de uma página web, blog, documentação ou PDF on-line. O ChatNorris extrai o conteúdo automaticamente.
Texto
Cole diretamente qualquer texto: perguntas frequentes, políticas, catálogos, descrições de produtos.
Sitemap
Informe a URL de um
sitemap.xml e o ChatNorris descobre e indexa automaticamente todas as páginas listadas nele.Lista de URLs
Cole várias URLs de uma vez (uma por linha) quando você já sabe exatamente quais páginas quer indexar e não precisa de um sitemap completo.
Documento
Envie arquivos PDF, Word (.docx), texto simples (.txt) ou Markdown (.md) do seu computador: até 10 por vez, de até 25 MB cada um.
Perguntas frequentes (FAQ)
Monte pares de pergunta e resposta manualmente ou importe-os de uma só vez a partir de um CSV de duas colunas.
WooCommerce
Sincronize seu catálogo de produtos a partir de uma loja WooCommerce conectada em Integrações. A partir do plano Standard — veja mais abaixo.
Catálogo do Jumpseller
Importa os produtos disponíveis da sua loja Jumpseller (descrição, variantes, SKU e link para a página do produto) e os mantém sincronizados. A partir do plano Standard.
Zendesk
Importa artigos da sua Central de ajuda do Zendesk como fonte de conhecimento. Disponível apenas para organizações com o piloto habilitado, a partir do plano Standard — veja mais abaixo.
Freshdesk
Importa os artigos públicos da sua base de conhecimento do Freshdesk (a base inteira ou as categorias e pastas que você escolher). A partir do plano Standard — veja mais abaixo.
Google Drive
Importa documentos e pastas específicos da sua conta do Google Drive. A partir do plano Standard — veja mais abaixo.
Loja on-line (site público)
Importa os produtos e preços a partir do site público da sua loja, sem API (Odoo, WooCommerce, Shopify e similares). Todos os planos — veja mais abaixo.
Catálogo ao vivo da sua loja
Se o agente tiver uma Ação de loja com consulta de estoque e preço ativa (por exemplo WooCommerce, Jumpseller ou Odoo), a lista mostra uma linha informativa Catálogo de ao vivo, com a etiqueta Ao vivo e o link Ver ação. Não é uma fonte: o agente consulta preço e estoque direto na loja em cada conversa, então não ocupa caracteres nem precisa ser sincronizado.Adicionar uma fonte
1
Vá até a base de conhecimento do agente
Em Agentes, entre no agente e clique em Base de conhecimento (ou no menu lateral, se você já estiver no agente).
2
Clique em + Adicionar fonte
Aparece um formulário com as opções de tipo.
3
Escolha o tipo e preencha os dados
Se você escolher URL:
- Nome — um nome descritivo para identificar a fonte (ex.: “Página de perguntas frequentes”).
- URL — o endereço completo da página (ex.:
https://empresa.com/faq).
- Nome — um nome descritivo (ex.: “Políticas de envio”).
- Conteúdo — cole o texto diretamente.
4
Salve e aguarde o processamento
Ao salvar, a fonte passa pelos seguintes status:
O processo pode levar de 30 segundos a vários minutos, dependendo do tamanho do conteúdo.
Descobrir páginas de um site (rastreamento)
Em vez de colar uma URL, um sitemap ou uma lista de URLs manualmente, você pode deixar o ChatNorris rastrear seu site por você:1
Escolha Rastrear um site
Ao adicionar uma fonte do tipo URL, em vez de preencher um único endereço, escolha a opção de rastreamento e informe a URL do seu site.
2
Ajuste as opções de rastreamento (opcional)
Você pode limitar o rastreamento com:
- Apenas este domínio — ignora subdomínios como
docs.seudominio.comouapi.seudominio.com. - Excluir caminhos — por exemplo
/blog, para que essa seção não seja rastreada. - Excluir domínios — domínios externos que você não quer incluir, mesmo que o site tenha links para eles.
3
Revise as páginas encontradas
O ChatNorris percorre os links do site e mostra a lista de páginas que encontrou (até 60 por rastreamento). Você pode selecionar todas, desmarcar todas ou escolher uma por uma.
4
Treine com as páginas selecionadas
Ao confirmar, o ChatNorris cria uma fonte do tipo URL para cada página que você escolheu e as processa em lote.
Reprocessar uma fonte
Se você atualizou o conteúdo de uma URL ou quer atualizar uma fonte, use o botão Ressincronizar na linha correspondente. Isso processa o conteúdo novamente do zero.Sincronização automática
Cada fonte do tipo URL, Sitemap ou Lista de URLs tem seu próprio controle de sincronização automática (Manual / Semanal / Diária) no seu detalhe — não é uma configuração única para toda a base de conhecimento. Além disso, seu plano define com que frequência essa sincronização pode rodar:
Quando uma fonte tem a sincronização automática ativa, o ChatNorris a processa novamente com a frequência escolhida. Se o conteúdo da página mudou, a base de conhecimento é atualizada automaticamente, sem que você precise clicar em Ressincronizar.
As fontes conectadas a um serviço externo (Google Drive, Zendesk, Freshdesk, o catálogo do Jumpseller, as variações do WooCommerce e Loja on-line) também são ressincronizadas sozinhas com a frequência do seu plano: semanal no Standard e diária no Premium.
As fontes do tipo Texto não são sincronizadas automaticamente (já que você inseriu o conteúdo manualmente). Para atualizá-las, edite o texto diretamente na base de conhecimento.
WooCommerce
Você pode trazer o catálogo de produtos da sua loja WooCommerce para a base de conhecimento como mais uma fonte. Você só precisa da loja conectada em Integrações: não é necessário ter ativa a ação WooCommerce, que é configurada separadamente (consulta de pedidos e estoque).1
Conecte sua loja em Integrações
Vá em Base de conhecimento → Adicionar fonte → WooCommerce. Se a loja ainda não estiver conectada, clique em Conectar em Integrações: ali você informa a URL da loja e as chaves da API do WooCommerce, uma única vez por agente.
2
Clique em Sincronizar catálogo
Com a loja conectada, volte à fonte WooCommerce e clique em Sincronizar catálogo (ou Ressincronizar, se você já tinha trazido o catálogo antes).
3
Aguarde o processamento
São trazidos até 2.000 produtos publicados. Para cada um, são indexados: nome, SKU, preço, disponibilidade (em estoque / esgotado) e descrição. Passa pelo mesmo pipeline de processamento que qualquer outra fonte (Pendente → Processando → Pronto).
Esta fonte aparece com sua própria aba de filtro WooCommerce na tabela da Base de conhecimento e não tem botão Editar — o conteúdo é gerado automaticamente a partir da sua loja, não é editado manualmente.
Variações de produto (tamanho, cor etc.)
Se sua loja tiver produtos variáveis (por exemplo, uma camiseta com diferentes tamanhos e cores), no mesmo painel você encontrará Variações de produtos. Com Gerar variações, é criado um mapa de atributos (medida, cor etc.) para SKU de todos os produtos com variações, assim o agente pode responder perguntas por características sem depender apenas da consulta ao vivo. Esse conteúdo é regenerado a cada sincronização e não é editado: se precisar de correções, adicione-as em uma fonte de texto separada.Zendesk
Traz artigos da sua Central de ajuda do Zendesk (Help Center) para a base de conhecimento, em vez de você ter que copiá-los manualmente ou indexá-los por URL um por um.1
Conecte sua conta do Zendesk em Integrações
Vá em Base de conhecimento → Adicionar fonte → Zendesk. Se ainda não estiver conectada, clique em Conectar em Integrações e faça login com sua conta do Zendesk. É uma única conexão por agente, compartilhada com a ação Zendesk Tickets: se você usar as duas, a conexão pede as permissões de ambas.
2
Escolha o que importar
Escolha uma de três opções:
- Toda a KB — importa todos os artigos públicos.
- Categorias e seções — escolha categorias e seções específicas, e os idiomas.
- Filtros avançados — além de categorias, seções e idiomas, filtre por Etiquetas, Content tags ou Apenas artigos em destaque.
3
Aguarde o processamento
Os artigos importados passam pelo mesmo pipeline que qualquer outra fonte (Pendente → Processando → Pronto).
Esta fonte é independente da ação Zendesk Tickets (veja Ações do agente): a fonte da Base de conhecimento traz conteúdo da Central de ajuda para responder perguntas gerais, enquanto a ação cria e consulta tickets de suporte pontuais.
Freshdesk
Traz os artigos da sua base de conhecimento do Freshdesk (Solutions) para que o agente responda com eles, em vez de você copiá-los manualmente. Disponível a partir do plano Standard.1
Conecte o Freshdesk em Integrações
A fonte usa a mesma conexão que a ação Freshdesk Tickets: o subdomínio da sua conta e a API key de um agente, informados uma única vez em Integrações (
Agentes → [seu agente] → Integrações → Freshdesk). Se ainda não estiver conectada, o painel da fonte leva você até lá.2
Escolha o que importar
Vá em Base de conhecimento → Adicionar fonte → Freshdesk e escolha Toda a base pública ou Escolher categorias e pastas (uma pasta escolhida inclui suas subpastas públicas). Depois, clique em Importar artigos.
3
Aguarde a primeira sincronização
Pode levar vários minutos, dependendo da quantidade de artigos. Você pode acompanhar o progresso na lista de fontes.
Apenas conteúdo público. São importados apenas os artigos publicados de pastas visíveis para todos. Os rascunhos e as pastas para usuários logados, agentes ou empresas específicas nunca são importados, mesmo que a API key tenha acesso a eles.
- Sempre em dia. As sincronizações seguintes só processam novamente os artigos que mudaram, e os artigos que você apaga no Freshdesk deixam de ser usados.
- Links públicos. Quando o agente compartilha um artigo, usa o link do portal público do Freshdesk.
- Um idioma. É importado o idioma principal da sua base; mesmo assim, o agente responde no idioma em que o visitante escreve.
- Uma fonte por agente. Para mudar o filtro, abra a fonte novamente e clique em Salvar e sincronizar novamente.
Se você desconectar o Freshdesk em Integrações, a fonte é desativada, mas não é apagada. Se você apenas pausar a conexão, o conteúdo já importado continua sendo usado e somente a sincronização é interrompida.
Google Drive
Importa documentos e pastas específicos da sua conta do Google Drive, sem precisar baixá-los e enviá-los de novo como Documento. Disponível a partir do plano Standard.1
Conecte sua conta do Google
Vá em Base de conhecimento → Adicionar fonte → Google Drive. Se ainda não estiver conectada, clique em Conectar em Integrações e faça login com a conta do Google onde estão seus arquivos. O ChatNorris só pede acesso aos arquivos que você escolher explicitamente, não a todo o seu Drive. Mais detalhes em Integrações.
2
Escolha arquivos ou pastas com o seletor do Google
Clique em Escolher no Google Drive. O seletor do Google é aberto para você escolher um ou vários arquivos, ou uma pasta inteira (uma pasta é expandida em até 200 arquivos).
3
Aguarde o processamento
É criada uma fonte da Base de conhecimento para cada arquivo. Formatos suportados: Google Docs, Sheets, Slides, PDF, Word (.docx), texto simples (.txt) e Markdown.
Você só pode conectar uma conta do Google por agente.
Loja on-line (site público)
Importa os produtos da sua loja lendo o site público dela, sem conectar nenhuma API. É útil para lojas que não têm API disponível (por exemplo, Odoo Online no plano Standard) e funciona com Odoo, WooCommerce, Shopify e outras plataformas que publicam os dados de cada produto na página dele. Não exige um plano específico: o único limite é o de caracteres da sua base de conhecimento.1
Escolha a fonte
Vá em Base de conhecimento → Adicionar fonte → Loja on-line (site público).
2
Informe a URL da loja
Por exemplo
https://www.mitienda.cl/shop. Em Opções avançadas você pode indicar:- URL do sitemap (opcional) — se você deixar em branco, é usado o
/sitemap.xmldo site. - Prefixo das URLs de produto (opcional) — só são lidas as páginas cujo caminho começa assim. No Odoo costuma ser
/shop/; no WooCommerce,/producto/ou/product/. Se você deixar em branco e a URL da loja tiver um caminho (como/shop/), esse caminho é usado como prefixo.
3
Teste e depois importe
Testar mostra uma amostra de produtos com nome, SKU, categoria e preço (ou “sem preço publicado”). Se estiver tudo certo, clique em Importar catálogo. Ler o catálogo inteiro pode levar vários minutos; enquanto isso, o agente continua respondendo com o que já tinha.
Um agente usa uma loja por API ou por site público, não as duas. Se ele já tiver uma Ação de WooCommerce ou Odoo com consulta de pedidos, estoque ou compra ativa, o painel avisa você e leva você até Ações.
Ver estatísticas de uma fonte
Cada fonte mostra:- Caracteres indexados — quanto conteúdo foi processado.
- Chunks — em quantos fragmentos o conteúdo foi dividido (o bot pesquisa nesses fragmentos).
- Última sincronização — quando foi processada pela última vez.
Ver e editar o conteúdo de uma fonte
Clique em uma fonte para abrir o detalhe dela. Em Conteúdo extraído você vê o texto com que o agente é treinado; use Ver completo se for longo. Para alterá-lo, abra o menu ⋮ do detalhe e escolha Editar. O que você pode editar depende do tipo:
Ao salvar uma alteração de conteúdo, a fonte é processada novamente e o agente é treinado com o texto novo. Em um documento .txt ou .md, o arquivo é substituído pelo texto editado, então uma ressincronização posterior mantém sua alteração. Se você só mudar o nome, ela não é processada novamente.
Os documentos que você enviou antes de 29 de outubro de 2026 só mostram o conteúdo depois de serem ressincronizados uma vez com Ressincronizar agora.
Boas práticas para treinar seu agente
Que conteúdo funciona melhor?
Que conteúdo funciona melhor?
- Perguntas frequentes (FAQ) — é o tipo de conteúdo mais eficaz.
- Páginas de produtos ou serviços com descrições detalhadas.
- Políticas: devoluções, envios, termos de uso.
- Guias de uso ou manuais.
- Tabelas de preços (em texto ou tabela, não em imagens).
Que conteúdo não funciona bem?
Que conteúdo não funciona bem?
- Imagens e vídeos — o bot não consegue “ver” imagens.
- PDFs com texto digitalizado (imagens de texto) — o conteúdo não é extraído corretamente.
- Conteúdo protegido por login ou autenticação.
- Páginas com muito JavaScript dinâmico (SPAs sem renderização no servidor).
Quantas fontes posso adicionar?
Quantas fontes posso adicionar?
O limite depende do total de caracteres do seu plano (500K no plano gratuito, até 100M nos planos superiores). Você pode adicionar quantas fontes couberem dentro desse limite.
Uma fonte ficou em 'Erro', o que eu faço?
Uma fonte ficou em 'Erro', o que eu faço?
As causas mais comuns são:
- A URL não é acessível publicamente.
- A página exige login.
- O site bloqueia os bots de rastreamento.
Com que frequência devo atualizar minha base de conhecimento?
Com que frequência devo atualizar minha base de conhecimento?
Sempre que mudar alguma informação relevante do seu negócio: novos preços, produtos, políticas, horários. Se você adicionar uma URL, lembre-se de ressincronizá-la depois de atualizar o conteúdo da página.