> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Base de conhecimento > Como treinar seu agente com o conteúdo da sua empresa. # 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. ![Lista da base de conhecimento](https://mintcdn.com/chatnorris/_RNPg7jBCB9AE-Bf/images/Lista-de-base-de-conocimientos.png?fit=max\&auto=format\&n=_RNPg7jBCB9AE-Bf\&q=85\&s=248e0abcf4c0f61160927f399deea804) ## Tipos de fontes Você pode adicionar informações de várias formas: > [card] URL > > Informe o endereço de uma página web, blog, documentação ou PDF on-line. O ChatNorris extrai o conteúdo automaticamente. > [card] Texto > > Cole diretamente qualquer texto: perguntas frequentes, políticas, catálogos, descrições de produtos. > [card] Sitemap > > Informe a URL de um `sitemap.xml` e o ChatNorris descobre e indexa automaticamente todas as páginas listadas nele. > [card] 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. > [card] 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. > [card] 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. > [card] 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. > [card] [Catálogo do Jumpseller](https://docs.chatnorris.ai/pt/guias/jumpseller.md#importar-o-catálogo-para-a-base-de-conhecimento) > > 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. > [card] 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. > [card] 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. > [card] Google Drive > > Importa documentos e pastas específicos da sua conta do Google Drive. A partir do plano Standard — veja mais abaixo. > [card] 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. > [!TIP] > > Ao entrar na base de conhecimento, você vê primeiro **Todas as fontes**, com uma coluna **Tipo** que indica de onde vem cada uma. Use os filtros por tipo (Link, Texto, FAQ, Documento, WooCommerce, Jumpseller, Zendesk, Freshdesk, Google Drive, Loja on-line) para ver apenas um grupo. ### 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](https://docs.chatnorris.ai/pt/guias/acciones.md#woocommerce), [Jumpseller](https://docs.chatnorris.ai/pt/guias/jumpseller.md) ou [Odoo](https://docs.chatnorris.ai/pt/guias/acciones.md#odoo)), a lista mostra uma linha informativa **Catálogo de {loja} 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`). **Se você escolher Texto:** * **Nome** — um nome descritivo (ex.: "Políticas de envio"). * **Conteúdo** — cole o texto diretamente. **Se você escolher Documento:** Arraste ou selecione arquivos PDF, Word (.docx), texto simples (.txt) ou Markdown (.md) do seu computador. Você pode enviar até 10 arquivos por vez, de até 25 MB cada um. Depois de processado, você pode ver o texto extraído de cada arquivo no detalhe dele e, se for .txt ou .md, editá-lo ali mesmo (veja [Ver e editar o conteúdo de uma fonte](#ver-e-editar-o-conteúdo-de-uma-fonte)). Guardamos o arquivo para poder ressincronizá-lo; ele é apagado dos nossos servidores quando você exclui a fonte ou o agente. **Se você escolher Perguntas frequentes (FAQ):** Adicione pares de **pergunta** e **resposta** um a um com o botão para adicionar um novo par, ou clique em **Importar CSV** para carregar vários de uma vez (o arquivo deve ter exatamente duas colunas: pergunta e resposta). **4. Salve e aguarde o processamento** Ao salvar, a fonte passa pelos seguintes status: | Status | Significado | | - | - | | **Pendente** | Na fila para ser processada | | **Processando** | O conteúdo está sendo extraído e processado | | **Pronto** | O conteúdo está indexado e disponível para o bot | | **Erro** | Ocorreu um problema. Veja a seção de problemas mais abaixo. | 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.com` ou `api.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. > [!TIP] > > É útil quando você não tem um `sitemap.xml` à mão ou quando quer apenas uma parte do site (por exemplo, tudo menos o blog). ## 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. > [!TIP] > > Se você atualiza o conteúdo do seu site com frequência, ressincronize as URLs correspondentes para que o agente tenha as informações em dia. ## 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: | Plano | Frequência de sincronização automática disponível | | - | - | | **Free** | Somente manual | | **Standard** | Até semanal | | **Premium** | Até diária | 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](https://docs.chatnorris.ai/pt/guias/acciones.md#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). > [!TIP] > > Se você também tiver a ação WooCommerce ativa para consultar pedidos ou estoque, sincronize também o catálogo para que o agente responda perguntas gerais sobre produtos. > [!NOTE] > > 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. > [!WARNING] > > A sincronização do catálogo é manual: não há sincronização automática para esta fonte. Se preços, estoque ou produtos mudarem na sua loja, clique de novo em **Sincronizar catálogo** para atualizar a base de conhecimento. > [!TIP] > > Isso é diferente da consulta de estoque em tempo real da ação WooCommerce: o catálogo sincronizado serve para perguntas gerais sobre produtos ("quais camisetas vocês têm?"), enquanto a ação consulta o estoque pontual por SKU no momento da conversa. ### 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 > [!WARNING] > > Esta fonte está em fase piloto: só aparece habilitada para organizações às quais o ChatNorris ativou explicitamente o acesso. Se você precisar dela, escreva para **[hola@chatnorris.ai](mailto:hola@chatnorris.ai)**. 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**. Depois, clique em **Importar artigos**. Por segurança, os rascunhos e os artigos restritos a segmentos privados são sempre excluídos. **3. Aguarde o processamento** Os artigos importados passam pelo mesmo pipeline que qualquer outra fonte (Pendente → Processando → Pronto). > [!NOTE] > > Esta fonte é independente da ação **Zendesk Tickets** (veja [Ações do agente](https://docs.chatnorris.ai/pt/guias/acciones.md)): 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](https://docs.chatnorris.ai/pt/guias/acciones.md#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. > [!NOTE] > > **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**. > [!NOTE] > > 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](https://docs.chatnorris.ai/pt/guias/integraciones.md). **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. > [!NOTE] > > Você só pode conectar uma conta do Google por agente. > [!WARNING] > > Se você escolher uma pasta e depois adicionar arquivos novos a essa pasta no Google Drive, esses arquivos novos **não** são importados automaticamente — volte em **Adicionar fonte → Google Drive** e selecione-os de novo com o seletor. ## 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.xml` do 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. **O que é importado:** nome, SKU, preço ou faixa de preços ("de X até Y"), a categoria que a página do produto mostra (por exemplo "Casa › Carvão") e a disponibilidade. São lidos até 1.000 produtos. **Estoque:** o site público não informa quantidades. O agente só diz que um produto está **esgotado** ou **sob encomenda** quando a loja publica isso; nunca afirma que há estoque, porque muitas lojas marcam tudo como disponível. Nos demais casos, ele não promete unidades e sugere confirmar com a loja. **Preço:** ao responder, o agente lê novamente o preço na página do produto da sua loja, então não depende da última sincronização. **Atualizar:** **Ressincronizar agora** lê novamente o catálogo inteiro. A sincronização automática é semanal no Standard e diária no Premium, e só processa novamente os produtos cujo texto mudou (preço, descrição ou disponibilidade). Se a sincronização for interrompida três vezes sem terminar, a fonte mostra um erro: tente novamente e, se acontecer de novo, escreva para nós. > [!NOTE] > > 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: | Tipo | O que você pode editar | | - | - | | **Texto**, **FAQ** e **Lista de URLs** | Nome e conteúdo | | **URL** e **Sitemap** | Nome e endereço | | **Documento .txt ou .md** | Nome e conteúdo | | **Documento PDF ou Word (.docx)** | Apenas o nome. O texto pode ser visto, mas não editado: para alterá-lo, envie uma nova versão do arquivo. | 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. > [!NOTE] > > 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 > [accordion] 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). > [accordion] 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). > [accordion] 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. > [accordion] 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. > > Nesses casos, copie o texto manualmente e adicione-o como fonte do tipo Texto. > [accordion] 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. > [!WARNING] > > O bot só responde com as informações que tem indexadas. Se há uma pergunta frequente que o bot não responde bem, o mais provável é que essa informação não esteja na base de conhecimento ou não esteja formulada de forma clara. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.