"Fontes de conhecimento: site, arquivos e textos"

Alimente o agente com o seu site, documentos e textos longos; ele busca o trecho certo na hora de responder.

As perguntas frequentes resolvem dúvidas curtas e diretas. Mas e quando o material é grande, como o site inteiro, um cardápio de 80 itens ou uma tabela de serviços? Para isso existe o card Fontes de conhecimento (busca inteligente), no fim da aba Conhecimento do editor de agentes.

Como funciona (sem jargão)

Por trás das fontes roda uma técnica chamada RAG (busca inteligente que encontra o trecho certo do seu material). Funciona assim:

  1. Você adiciona uma fonte. O ScalaCRM quebra o conteúdo em trechos pequenos e os indexa por significado, não por palavra exata.
  2. Quando o cliente pergunta algo, o sistema busca os trechos mais parecidos com a pergunta.
  3. Só esses trechos entram na "cabeça" do agente naquela resposta.

Resultado: o agente responde com base num material enorme sem precisar "decorar" tudo, e sem você reescrever nada em formato de pergunta e resposta.

Tipos de fonte

O card tem três botões:

  • Adicionar site/URL: informe o endereço de uma página (seu site, cardápio online); o ScalaCRM lê o conteúdo da página e indexa.
  • Colar texto: cole qualquer conteúdo direto (manuais, tabelas de preço, políticas, descrição longa de serviços).
  • Enviar arquivo: arquivos .txt, .md ou .csv de até 2 MB (ex.: a planilha de produtos exportada como CSV).

Cada agente aceita até 10 fontes, e cada uma pede um Nome da fonte para você reconhecê-la na lista.

💡 Dica: o CSV é subestimado. Exporte sua planilha de serviços e preços como CSV e suba como fonte: o agente passa a responder valores e detalhes item a item.

Status da fonte

Cada fonte mostra seu estado:

  • Processando: o conteúdo está sendo lido e indexado; leva alguns instantes.
  • pronta: indexada e em uso pelo agente, com a quantidade de trechos indexados.
  • erro: algo falhou (página fora do ar, arquivo ilegível). Corrija a origem e use o botão Reprocessar.

O Reprocessar também serve quando o conteúdo original mudou. Atualizou a página do site? Reprocesse a fonte para o agente enxergar a versão nova. Fontes não se atualizam sozinhas. O botão Remover tira a fonte do agente.

⚠️ Atenção: a fonte é uma "foto" do conteúdo no momento em que foi processada. Mudou preço no site? Reprocesse a fonte, senão o agente segue respondendo o valor antigo. Para preço que não pode errar, prefira o Catálogo de produtos ou um Texto oficial.

Fonte, pergunta frequente ou texto oficial?

  • Pergunta frequente com resposta curta: Perguntas frequentes (resposta mais direta e controlada).
  • Texto que precisa sair palavra por palavra, como uma tabela de preços: Textos oficiais.
  • Material extenso, catálogos longos, políticas: Fontes de conhecimento (o agente busca o trecho certo).

Os três convivem: o agente consulta tudo junto. Depois de adicionar fontes, faça perguntas reais sobre o material em Testar agente, na aba Testes.

Veja também