Base de Conhecimento

A Base de Conhecimento é onde seu chatbot aprende. Adicione conteúdo de várias fontes para tornar sua IA mais inteligente e precisa.

Fontes de Conteúdo

ChatReact oferece múltiplas formas de adicionar conhecimento:

Assistente de Configuração de Conhecimento

Logo após criar um chatbot, o ChatReact abre um assistente de configuração de conhecimento guiado com três etapas: Scan website, Upload documents e Done. Ele usa os mesmos fluxos de varredura do site e upload de documentos descritos nesta página.

Você pode pular qualquer etapa de conteúdo com Skip for now — mas sem conteúdo seu chatbot dará apenas respostas genéricas, por isso recomendamos adicionar pelo menos uma fonte. Você pode sempre voltar e adicionar mais conteúdo na Base de Conhecimento mais tarde.

Aba Visão Geral

A página da Base de Conhecimento tem quatro abas: Overview, Instructions, Websites e Documents. Overview é a aba padrão e oferece um painel com visão geral:

• Knowledge Base Status — contagens de Core Instructions, Improvement Instructions, páginas rastreadas e documentos. Clique em qualquer cartão para ir direto para essa aba.
• Vector Store — mostra se o vector store está Active ou Not initialized, além do tamanho total de armazenamento atualmente utilizado.
• How Knowledge Base Works — uma breve explicação sobre como Core Instructions e Documents são usados juntos para responder perguntas.

Rastreador de Sites

Importando Seu Website

A importação de site é um fluxo de três etapas na aba Websites: visualize a estrutura do site, selecione páginas e, em seguida, importe o conteúdo.

1. Navegue até Knowledge Base na barra lateral e abra a aba Websites
2. Insira a URL do seu site (por exemplo, example.com)
3. Opcionalmente adicione Exclude URL patterns — um padrão por linha, usando * como curinga (por exemplo, /gallery/*)
4. Clique em Preview Pages — o ChatReact escaneia seu site e lista as páginas encontradas
5. Selecione as páginas para importar. Páginas recomendadas pela IA já vêm pré-selecionadas e marcadas com uma estrela — clique em AI Selection a qualquer momento para restaurar essa recomendação. Seu plano determina quantas páginas você pode selecionar.
6. Clique em Import Pages (o botão mostra quantas páginas você selecionou) para iniciar a importação

Limites de Crawl

O número de páginas que você pode rastrear e os crawls por mês dependem do seu plano. Veja nossa Pricing page para detalhes.

Status do Crawl

Monitore o progresso do seu crawl:

• Pending: Aguardando início
• Running: Rastreando páginas no momento
• Completed: Todas as páginas processadas
• Failed: Ocorreu um erro (verifique os detalhes)
• Cancelled: O crawl foi interrompido antes de terminar

O rastreamento é executado em segundo plano — você pode sair da página e retornar depois para verificar o progresso. O indicador de progresso é atualizado em tempo real.

Cancelar um Crawl

Você pode cancelar um crawl em execução ou pendente a qualquer momento:

• Clique no botão Cancel na barra de progresso durante um crawl ativo
• Em Recent Crawls, cada trabalho em execução/pendente também tem um botão Cancel
• Se você sair da página durante um crawl, o botão Cancel ainda estará disponível quando você voltar

Visualizando Resultados do Crawl

Após uma importação ser concluída, suas páginas aparecem em Crawled Websites:

1. Veja todas as páginas importadas com seus títulos
2. Clique no ícone de olho (View indexed content) para ver o conteúdo extraído renderizado como Markdown formatado
3. Pesquise páginas por URL ou título para encontrar uma página específica rapidamente
4. Use as caixas de seleção para selecionar múltiplas páginas e excluí-las de uma vez
5. Re-crawl páginas individuais ou todo o site

Páginas que não foram atualizadas há mais de 30 dias exibem um emblema de idade (por exemplo, "45d old") para que você veja de relance quando o conteúdo precisa de um re-crawl.

Re-Rastreamento

Para atualizar sua base de conhecimento com conteúdo novo:

• Página única: Clique no botão de atualizar ao lado de qualquer página rastreada
• Todo o site: Use o botão de atualizar-tudo para todo o domínio

Os re-crawls atualizam o conteúdo e renovam o carimbo de data/hora "last crawled". Você receberá uma notificação quando for concluído. Também é possível cancelar um re-crawl em andamento.

Adicionando uma Única URL

Você não precisa de um crawl completo para adicionar uma página. Clique em Add URL na barra de ferramentas de Crawled Websites, cole o endereço da página e o ChatReact importa apenas essa página.

Integrações com CMS

Se seu site usa WordPress, conecte o plugin ChatReact para WordPress para varreduras mais inteligentes e rápidas enriquecidas com informações de tipo de conteúdo:

1. Na aba Websites, encontre o cartão CMS Integrations
2. Clique em Generate Integration Key e copie a chave (ela é exibida apenas uma vez)
3. Cole a chave na aba Integration do plugin no WordPress
4. Use Scan Website para importar seu conteúdo

Consulte o WordPress guide para a configuração completa do plugin.

Documents

Faça upload dos seus próprios arquivos na aba Documents:

1. Arraste e solte arquivos na área de upload, ou clique para selecioná-los
2. Formatos suportados: PDF, TXT, Markdown, CSV, JSON, DOCX (máx. 10 MB por arquivo)
3. Cada arquivo mostra seu status de processamento enquanto é adicionado à base de conhecimento
4. Abra ou exclua documentos enviados a qualquer momento

Além do limite de 10 MB por arquivo, seu armazenamento total de documentos é limitado pelo seu plano (por exemplo, 10 MB no total no plano Free, mais em planos pagos — veja nossa Pricing page). Quando atingir essa cota, novos uploads são bloqueados até que você exclua alguns documentos ou faça upgrade.

Bons candidatos: descrições de produtos, listas de FAQ, tabelas de preços, termos de serviço, guias de suporte e outra documentação baseada em texto.

FAQs

As FAQs são a forma mais direta de ensinar seu chatbot:

Adicionando FAQs

1. Vá para FAQs na barra lateral
2. Clique em Add FAQ
3. Insira a pergunta (como um cliente a faria)
4. Insira a resposta — o editor rich-text suporta formatação
5. Opcionalmente atribua a uma categoria
6. Clique em Create FAQ

Categorias de FAQ

Organize as FAQs em categorias:

• Pricing
• Technical Support
• Account Management
• Shipping & Returns

Sugestões de FAQ

Gere sugestões de FAQ sob demanda:

• Generate from Knowledge Base — use o botão na aba Suggestions da página de FAQs
• Improvement Agent — o agente pode sugerir FAQs como parte de suas propostas de melhoria
• Manual — crie FAQs manualmente a qualquer momento

Revise sugestões e aprove ou descarte-as. Sugestões de FAQ estão disponíveis em planos pagos — veja nossa Pricing page. Consulte o FAQ Management guide para mais detalhes.

Core Instructions

Core Instructions são regras específicas que seu chatbot deve seguir:

Adicionando Instruções

1. Navegue até Knowledge Base na barra lateral
2. Abra a aba Instructions
3. Clique em Add Core Instruction
4. Escreva sua instrução claramente no editor (formatação e links são suportados)
5. Se o seu plano inclui o Email Assistant (Professional e superiores), escolha Applies to: Chat only ou Chat + Email. Instruções "Chat + Email" também se aplicam como regras gerais a todos os rascunhos de resposta por e-mail; como um tipo específico de e-mail é respondido é definido por categoria no Email Assistant. Em outros planos essa escolha não é exibida e as instruções se aplicam ao chat.
6. Ative/desative conforme necessário

Improvement Instructions

A aba Instructions também possui uma seção separada e somente leitura chamada Improvement Instructions. Estas são criadas automaticamente pelo Improvement Agent com base no feedback das conversas — você não pode editá-las diretamente, mas cada uma linka de volta para a sessão de melhoria que a criou. Veja o Improvement Agent guide para detalhes.

Instruções Eficazes

Bons exemplos:

• "If a customer asks about pricing, direct them to our pricing page at /pricing"
• "Never disclose internal metrics or customer data"
• "For technical issues, always ask for the error message first"

Evite:

• Instruções vagas: "Be helpful"
• Regras contraditórias
• Lógica excessivamente complexa

Pesquisa de Conteúdo Inteligente

O ChatReact pesquisa sua base de conhecimento por significado, não apenas por palavras-chave. Seu chatbot encontra e referencia a informação correta mesmo quando os clientes formulam suas perguntas de forma diferente de como seu conteúdo está escrito.

Boas Práticas

1. Comece com FAQs: Adicione suas 20 perguntas mais comuns
2. Rastreie estrategicamente: Foque em páginas de documentação, não em conteúdo de marketing
3. Revise regularmente: Verifique quais perguntas seu bot não consegue responder
4. Itere: Use o Improvement Agent para refinar com base no feedback

Acesso por API

Documents (upload, list, delete), rastreamento de sites (preview, start, check status, cancel), páginas rastreadas e Core Instructions podem ser gerenciados programaticamente através da REST API ou do MCP Server — útil para sincronizar conteúdo a partir de um CMS externo ou automatizar atualizações da base de conhecimento.

Próximos Passos

• FAQs Management →
• Improvement Agent →
• Analytics →