Conhecimento — as fontes do agente

Tela: Agente, aba Conhecimento · Endereço: /agente · Menu: Agente → Agente

Ensine o agente sobre o seu negócio e defina como ele conduz cada conversa.

O conhecimento é o material com que o agente aprende. É dele que saem o perfil do negócio, os playbooks e as respostas que o agente dá às dúvidas do visitante. Duas formas de alimentar: sites e documentos.

Adicionar um site

Cartão Adicionar site — "O agente lê as páginas públicas e responde com base nelas."

1. Em URL do site, informe o endereço começando com http:// ou https://. Exemplo: https://suaempresa.com.br.
2. Em Máximo de páginas, defina quantas páginas o Data Lead deve ler. O padrão é 30; o mínimo é 1 e o máximo é 500.
3. Clique em Adicionar site.

A confirmação aparece como "Site adicionado. A leitura começa em instantes."

Só páginas públicas são lidas — nada de área logada. Vale a pena apontar para seções específicas (/produtos, /precos, /faq) em vez de recontar o site inteiro toda vez: fontes menores e mais focadas dão respostas melhores.

Com www. ou sem? Com http ou https?

Tanto faz. suaempresa.com.br e www.suaempresa.com.br são tratados como o mesmo site: o Data Lead segue o redirecionamento do endereço que você informou e continua lendo as páginas mesmo quando os links internos do site usam a outra forma. Se o endereço que você cadastrou não responder — ou responder com erro (404, 403, 500) —, a outra forma é tentada antes de a fonte falhar.

O mesmo vale para http:// e https://: links do seu site escritos em http:// são seguidos normalmente, e sempre lidos por https:// quando o site atende nos dois. O Data Lead nunca desce de https para http.

O que não entra junto são os demais subdomínios. blog.suaempresa.com.br, loja.suaempresa.com.br e app.suaempresa.com.br são endereços diferentes, quase sempre com conteúdo de outro sistema: se você quer o agente sabendo o que está lá, cadastre cada um como uma fonte.

Endereço que redireciona para outro site

Se o endereço cadastrado redireciona para outro domínio — suaempresa.com.br respondendo com um desvio para outraempresa.com, por exemplo —, a fonte vai para Erro com a mensagem "O endereço redireciona para outro site. Cadastre o endereço final."

É de propósito: o conteúdo de um site que não é o seu não entra na base do agente sem alguém ter pedido. Cadastre o endereço final, que é o que você realmente quer indexar.

Mensagens de erro

Enviar documentos

Cartão Enviar documentos — "Propostas, tabelas de preço e FAQs que não estão no site."

Arraste os arquivos para a área tracejada ou clique em Arraste arquivos ou clique para escolher. Depois clique em Enviar documento (ou Enviar N arquivos).

Formatos e limite: PDF, DOCX, TXT ou MD · até 20 MB por arquivo.

O limite é por arquivo, e não pela soma: selecione quantos quiser de uma vez, que eles sobem um de cada vez, cada um com a sua barra de progresso. Enquanto um arquivo sobe, o botão Cancelar envio interrompe o que está no ar e desiste dos que ainda não começaram — os que já foram enviados continuam sendo indexados normalmente.

Por que 20 MB, e por que antes eram 2. O arquivo viajava dentro da requisição que o painel mandava ao servidor, e a plataforma onde o Data Lead roda corta requisições acima de cerca de 3 MB — antes de o produto ver qualquer coisa. Enquanto foi assim, prometer mais do que 2 MB seria prometer uma falha que nem tela de erro tinha.

Agora o arquivo não passa mais por ali: o navegador o envia direto para o armazenamento, por um endereço temporário que o servidor assina na hora. O teto voltou a ser o do armazenamento — 20 MB —, que é grande o bastante para catálogos e manuais inteiros.

Um arquivo fora dessas regras é recusado na hora em que você o escolhe — ele nem entra na lista de pendentes — com a mensagem ""nome-do-arquivo" precisa ser PDF, DOCX, TXT ou MD." Se o problema for tamanho, a mensagem traz a conta: ""nome-do-arquivo" tem 21,0 MB — o limite é 20 MB por arquivo."

Você pode remover um arquivo da lista antes de enviar clicando no X ao lado do nome.

Enviar a mesma fonte duas vezes

O Data Lead reconhece a repetição e não cria uma fonte duplicada:

• O mesmo site (mesma URL) ou o mesmo documento (é o conteúdo que é comparado, não o nome do arquivo) que ainda não terminou de ser processado: o envio reaproveita a fonte que já existe e tenta de novo. É o que você quer quando o primeiro envio falhou.
• Uma fonte que já está Pronto: o envio é recusado com "Esse site já está na base de conhecimento. Use Reindexar no menu da fonte para atualizar." Atualizar conteúdo já indexado é Reindexar, não adicionar de novo.

Acompanhar o status

A tabela Fontes de conhecimento mostra, para cada fonte: Fonte, Tipo (Site ou Documento), Status, Páginas, Trechos e Última indexação. No celular a mesma lista vira cartões.

Os estados possíveis são:

Enquanto houver fonte em andamento, o topo da tela mostra "Indexando conhecimento…" e a lista se atualiza sozinha — não é preciso recarregar. O aviso desliga sozinho quando tudo termina (ou quando uma fonte passa a Sem resposta): ele nunca fica ligado para sempre.

"Na fila" é uma promessa, e ela só aparece depois de aceita. Se o processamento estiver indisponível no momento do envio, a fonte não fica dizendo "Na fila": ela vai para Erro com a mensagem "O processamento em segundo plano está indisponível agora. Tente de novo em alguns minutos." — e o mesmo envio, repetido depois, reaproveita a mesma linha.

Quanto demora? A leitura do site costuma levar de 2 a 5 minutos — é o prazo que o assistente de Início anuncia. Você pode sair da tela e voltar depois.

Páginas e trechos

• Páginas é quantas páginas foram lidas naquela fonte.
• Trechos é em quantos pedaços o conteúdo foi dividido para busca. É o número que realmente indica se o agente tem material: uma fonte com muitas páginas e poucos trechos costuma significar páginas quase vazias (só imagens, ou conteúdo carregado por JavaScript).

"Só uma página com conteúdo legível foi indexada"

Quando uma fonte de site termina Pronto com uma única página — tendo permissão para ler mais —, a lista mostra este aviso ao lado do selo:

Só uma página com conteúdo legível foi indexada. Se o site tem mais páginas, confira o endereço e use Reindexar.

Não é erro: o que foi lido está indexado e o agente já responde com ele. É um resultado para você conferir. As causas comuns:

• o endereço aponta para uma página sem links para o resto do site (uma landing page, por exemplo);
• o conteúdo do site é montado por JavaScript: as páginas são visitadas, mas chegam vazias de texto;
• o robots.txt do site bloqueia o resto.

Repare na diferença entre Páginas e o que foi visitado: a coluna conta as páginas em que havia texto para indexar, não as que o Data Lead tentou ler. É por isso que a frase fala em "conteúdo legível".

Se o seu site realmente tem só uma página, pode ignorar o aviso.

Reindexar e remover

No menu ⋯ (Ações da fonte), no fim da linha:

• Reindexar — manda ler a fonte de novo. Use depois de publicar mudanças no site ou de trocar um documento. A confirmação é "Reindexação na fila." A base antiga continua no ar durante a reindexação: os trechos atuais só são substituídos quando o novo conteúdo termina de ser indexado, e uma reindexação que não consegue nem começar deixa a fonte exatamente como estava.
• Remover — tira a fonte da base do agente. A tela pede confirmação e é explícita: os trechos já indexados saem junto, o agente deixa de responder com esse conteúdo e não dá para desfazer — mas você pode adicionar a fonte de novo.

Limites e boas práticas

Recomendações:

• Comece pelo site da empresa. Como diz a tela quando não há nenhuma fonte: "é de lá que o agente aprende o que você vende e com que palavras".
• Suba o que não está no site. Tabela de preços, condições comerciais, respostas a objeções, política de troca.
• Reindexe depois de mudanças. O conhecimento não se atualiza sozinho quando o seu site muda.
• Não suba dados pessoais. Listas de clientes, contratos com CPF e planilhas de contatos não têm função no conhecimento do agente.

Depois de ter conhecimento

Com pelo menos uma fonte no estado Pronto, libera-se a geração do perfil do negócio — e, a partir dele, dos playbooks.

Veja também

• Perfil do negócio
• Playbooks e slots
• Primeiro acesso: o assistente do Início

Precisa de ajuda?

Fale com o suporte da Data Stone pelo canal combinado no seu contrato. Se uma fonte ficar em Erro, envie o endereço dela e a mensagem que aparece no selo.