📚 Agente IA

Construindo sua Knowledge Base — documentos, URLs e FAQs

14 min de leitura Atualizado em Jan 2025

A Knowledge Base (KB) é o repositório de informações que o seu Agente IA usa para responder às perguntas dos clientes. Pense nela como a "memória" do agente — tudo o que você colocar lá, o agente pode usar para responder de forma precisa e contextual. Quanto mais rica e bem organizada for sua KB, mais precisas e úteis serão as respostas do agente, e maior será a taxa de resolução automática sem intervenção humana.

Neste artigo você aprenderá como funciona o mecanismo de RAG que alimenta o Agente IA, como adicionar diferentes tipos de conteúdo à sua KB, e as melhores práticas para manter a base de conhecimento sempre atualizada e eficiente.

Tela de Conteúdos da IA no Chatys

Área "Conteúdos da IA" — gerencie toda a Knowledge Base do seu agente em um único lugar, com status de indexação em tempo real

Como funciona a indexação: Quando você adiciona um conteúdo à KB, o Chatys o processa usando embeddings semânticos (representações vetoriais do texto). Isso permite que o agente encontre respostas relevantes mesmo quando o cliente usa palavras diferentes das que estão no documento — a busca é por significado, não por palavras exatas. Por isso uma KB bem escrita supera qualquer FAQ tradicional de texto.

O que é a Knowledge Base e como funciona o RAG

RAG significa Retrieval-Augmented Generation — Geração Aumentada por Recuperação. É a tecnologia que diferencia um Agente IA moderno de um chatbot simples.

O processo funciona assim em cada mensagem:

  • 1. Cliente envia mensagem: "Qual o prazo de entrega para o nordeste?"
  • 2. Retrieval (Recuperação): O Chatys busca na sua KB os trechos mais semanticamente próximos da pergunta. Encontra o FAQ de frete e as condições de entrega por região.
  • 3. Augmented (Aumento): Esses trechos relevantes são enviados junto com a pergunta original para o modelo de IA (GPT-4o, Claude, etc.) como contexto adicional.
  • 4. Generation (Geração): O modelo de IA gera uma resposta coerente, em português natural, baseada nas informações da KB — não em informações genéricas da internet.

Isso significa que o agente responde com as suas informações, na sua voz, sem precisar ser "treinado" no sentido técnico do machine learning. Você apenas fornece o conteúdo e o agente o usa inteligentemente.

Implicação prática: Se o agente responder errado, geralmente é porque a informação certa não está na KB (ou está escrita de forma confusa). Antes de ajustar o modelo de IA, sempre verifique primeiro se o conteúdo está na Knowledge Base.

Adicionando documentos PDF

O upload de PDF é a forma mais rápida de introduzir grandes volumes de informação na Knowledge Base. Ideal para catálogos de produto, manuais técnicos, tabelas de preço, políticas internas e contratos.

1
No menu lateral do Chatys, clique em "Conteúdos da IA". Na tela que abre, selecione o agente cujo KB você quer alimentar no seletor do topo.
2
Clique em "+ Adicionar Conteúdo" e selecione "Documento / PDF" no menu. A área de upload será exibida.
3
Arraste o arquivo para a área de upload ou clique em "Selecionar arquivo". Formatos aceitos: .pdf, .docx, .txt, .csv. Tamanho máximo: 50 MB por arquivo. Documentos muito grandes são automaticamente divididos em chunks para indexação.
4
No campo "Título", dê um nome descritivo ao documento. Exemplo: "Catálogo de Produtos — Linha Premium 2025". Esse título aparece nos logs de rastreabilidade e ajuda o sistema a contextualizar o conteúdo do arquivo.
5
Opcionalmente, adicione uma descrição resumida sobre o conteúdo do documento. Essa descrição melhora a precisão da busca semântica, especialmente para documentos com conteúdo variado.
6
Clique em "Processar Documento". O indicador mudará para "Indexando...". PDFs de até 50 páginas levam entre 2 e 5 minutos. Documentos maiores podem levar até 15 minutos. PDFs com OCR de imagens (escaneados) podem demorar mais.
7
Quando o status mudar para "Indexado" (ícone verde), o conteúdo já está disponível para o agente. Faça um teste usando a função "Testar KB" antes de ativar o agente para clientes reais.
PDFs escaneados vs PDFs nativos: PDFs gerados por scan de imagem (foto de um documento físico) têm qualidade de extração muito inferior. O sistema usa OCR para tentar extrair o texto, mas erros são comuns. Sempre prefira PDFs com texto selecionável — você pode confirmar selecionando um trecho de texto com o cursor no arquivo antes de enviá-lo ao Chatys.

Adicionando páginas da web por URL

Se você tem um site com informações sobre seus produtos, preços ou políticas, o Chatys pode extrair esse conteúdo automaticamente — sem que você precise copiar e colar nada manualmente. E o melhor: é possível configurar a re-sincronização automática para manter o conteúdo sempre atualizado.

1
Clique em "+ Adicionar Conteúdo" → selecione "URL / Site".
2
Cole a URL completa da página, incluindo o https://. Exemplo: https://sualoja.com.br/politica-de-frete. Evite URLs com parâmetros dinâmicos, sessões ou que exijam login.
3
Se quiser indexar também as subpáginas linkadas a partir daquela URL, ative "Incluir subpáginas" e defina a profundidade (recomendado: 2 níveis). Útil para sites com múltiplas páginas de produto ou uma wiki interna.
4
Configure a frequência de sincronização automática: diária, semanal ou manual. Para páginas de preços e promoções que mudam com frequência, use sincronização diária. Para políticas estáveis, use semanal ou manual.
5
Clique em "Extrair e Indexar". O sistema vai acessar a URL, extrair o texto relevante (ignorando menus, rodapés e elementos visuais), dividir em chunks e processar o conteúdo para busca semântica.
Formulário para adicionar conteúdo à Knowledge Base

Formulário de adição de conteúdo — escolha o tipo (PDF, URL ou FAQ), preencha o título descritivo e configure a sincronização

Dica: Use a opção de URL com crawling de subpáginas para sites de e-commerce. Se você tem 50 produtos diferentes, adicione a URL da página de listagem e o Chatys indexa todos automaticamente. Muito mais eficiente do que criar um FAQ por produto.

Criando perguntas e respostas (FAQ)

O formato de texto manual é o mais eficiente para FAQs. Você tem controle total sobre exatamente o que o agente vai responder para cada pergunta, e textos curtos e diretos são processados com altíssima precisão pelo sistema de busca semântica.

1
Clique em "+ Adicionar Conteúdo" → selecione "Texto / FAQ". Um editor de texto simples será exibido.
2
No campo "Título", escreva o assunto geral do bloco. Exemplo: "Perguntas Frequentes — Entrega e Frete". Use títulos específicos por tema — não crie um único bloco enorme com tudo misturado.
3
No campo de texto, escreva as perguntas e respostas. O formato recomendado é uma pergunta por linha, seguida pela resposta, com linha em branco entre os pares:
Qual o prazo de entrega para São Paulo?
Para São Paulo capital, o prazo é de 2 a 3 dias úteis com frete padrão e 1 dia útil com frete expresso. O prazo começa a contar após confirmação do pagamento.

Quando chega meu pedido? / Quantos dias para entregar?
O prazo varia conforme a região. Para capitais do Sudeste: 2-3 dias úteis. Para demais capitais: 4-6 dias úteis. Para interior: 5-8 dias úteis.

Posso cancelar meu pedido depois de pagar?
Sim, você pode cancelar em até 24 horas após o pagamento sem nenhuma taxa. Após esse prazo, entre em contato com nossa equipe — avaliamos caso a caso.
4
Inclua variações da mesma pergunta no mesmo bloco. Por exemplo, além de "Qual o prazo de entrega?" adicione "Quando chega?" e "Quantos dias para entregar?". Isso aumenta a cobertura semântica e a precisão das respostas do agente.
5
Seja específico nos valores e condições. Em vez de "a entrega é rápida", escreva "entregamos em 2 dias úteis para capitais do Sudeste". Respostas vagas levam o cliente a fazer mais perguntas de esclarecimento.
6
Clique em "Salvar e Indexar". Textos e FAQs são processados em menos de 30 segundos — o status muda para "Indexado" quase instantaneamente.
Por onde começar? Peça para cada membro da sua equipe de atendimento listar as 10 perguntas que mais recebem. Junte as listas, elimine as duplicadas e você terá um conjunto de 15 a 25 FAQs — já suficiente para uma KB inicial muito eficaz. Qualidade supera quantidade: 20 FAQs bem escritos superam 100 FAQs vagos.

Sincronização e atualização de conteúdos

Manter a KB atualizada é tão importante quanto criá-la. Conteúdo desatualizado causa respostas erradas — o que é pior do que o agente admitir que não sabe. Siga estas práticas de manutenção:

1
Para atualizar um texto ou FAQ, encontre o item na lista da KB, clique no ícone de três pontos (menu de ações) ao lado do título e selecione "Editar". Faça as alterações e salve — o conteúdo será reindexado automaticamente em segundos.
2
Para substituir um PDF, exclua o documento antigo clicando em "Excluir" no menu de ações, depois faça upload da versão atualizada com o mesmo título. Não é possível editar um PDF já indexado — apenas substituir completamente.
3
Para forçar re-sincronização de uma URL sem esperar o ciclo automático, clique nos três pontos do item e selecione "Reindexar agora". Útil quando você atualizou o site e quer que o agente use o conteúdo novo imediatamente.
4
Para excluir permanentemente um item que ficou desatualizado, clique em "Excluir" no menu do item. A remoção da indexação ocorre instantaneamente e a ação não pode ser desfeita.
5
Estabeleça uma revisão mensal da KB: bloqueie 30 minutos no calendário todo primeiro dia do mês para verificar se os dados continuam corretos e identificar novas perguntas que o agente ainda não sabe responder.
Atenção em datas importantes: Verifique sempre as informações de preço, prazo de entrega e política de troca na KB antes de campanhas (Black Friday, Natal, Dia das Mães). Essas informações mudam com frequência e uma resposta errada do agente pode gerar problemas com clientes e até obrigações legais (Código de Defesa do Consumidor).

Boas práticas para uma KB eficiente

A qualidade do conteúdo é o principal fator que determina a eficiência do seu agente. Siga estas boas práticas sistematicamente:

  • Escreva com clareza e sem ambiguidade: Evite termos como "pode ser", "às vezes" ou "depende de vários fatores" sem especificar quais. O agente replica o nível de clareza do conteúdo que você forneceu. Se o conteúdo for vago, a resposta será vaga.
  • Use linguagem do cliente, não jargão interno: Sua equipe sabe que "OS" significa "Ordem de Serviço", mas seu cliente provavelmente não. Escreva os FAQs como se o cliente fosse lê-los diretamente — sem siglas, sem termos técnicos internos.
  • Separe assuntos diferentes em entradas distintas: Um bloco sobre "Entrega e Frete" e outro sobre "Trocas e Devoluções" funcionam melhor do que um documento gigante misturando temas. A separação temática melhora a precisão da busca semântica.
  • Inclua números e prazos concretos: "Respondemos em até 2 horas úteis" é muito melhor que "respondemos rapidamente". Dados concretos reduzem a necessidade de o cliente perguntar novamente para confirmar.
  • Evite informações temporárias na KB: Promoções sazonais, preços que variam e estoques limitados devem ser gerenciados no system prompt do agente, que é mais fácil de atualizar pontualmente. KB é para informações estáveis.
  • Monitore as transferências para humano: Quando o agente transfere para humano, o motivo aparece no relatório de Insights IA. Use esses dados para identificar quais perguntas a KB ainda não cobre e adicione esse conteúdo proativamente.
  • Não contradiga a KB com o System Prompt: Se a KB diz "entregamos em 5 dias" mas o System Prompt diz "informar prazo de 3 dias", o agente ficará confuso e pode gerar respostas inconsistentes. Mantenha consistência entre KB e instruções.
Benchmark de desempenho: Uma KB bem estruturada com 30 a 50 entradas de FAQ resolve em média 65% a 75% das perguntas dos clientes automaticamente. Com documentos de produto e política completos adicionados, esse índice pode chegar a 80% a 85%. Acima de 90% indica uma KB verdadeiramente madura.

Casos de uso — como aplicar no seu negócio

Veja como empresas de diferentes segmentos utilizam esta funcionalidade na prática:

🛍️ E-commerce e lojas online

Com o catálogo completo de produtos (PDF de 200 páginas com especificações técnicas) carregado na KB, a IA responde perguntas como "O tênis Nike Air Max 90 vem em quais cores?" com precisão total, consultando o catálogo em tempo real. Antes, o atendente precisava abrir o site ou planilha separada para encontrar a informação.

🏥 Clínicas e profissionais de saúde

O protocolo médico de cada especialidade fica como PDF na KB. Quando o paciente pergunta "preciso fazer jejum para o exame de tireoide?", a IA consulta o protocolo exato e responde corretamente — sem risco de erro de interpretação humana. Cada atualização de protocolo é feita uma única vez e reflete em todas as respostas automaticamente.

🏠 Imobiliárias e construtoras

O site de imóveis disponíveis é sincronizado via URL na KB. A base fica atualizada automaticamente quando um novo imóvel é cadastrado — corretores não precisam atualizar o bot manualmente. A IA já conhece o novo imóvel em até 24 horas após o cadastro no site.

🍕 Restaurantes e food service

Um FAQ construído manualmente com as 30 perguntas mais frequentes ("Tem opção sem lactose?", "Entregam no bairro X?", "Qual o horário?") é rápido de configurar e garante altíssima acurácia nas respostas mais comuns. A equipe não precisa de habilidades técnicas para manter essa base atualizada.

💼 Serviços, consultoria e SaaS

Para escolas e cursos online, o manual do aluno (PDF) na KB permite que a IA responda sobre datas de prova, grade curricular, formas de pagamento e política de cancelamento. A secretaria reduz os atendimentos em 80% — os alunos preferem a resposta instantânea da IA ao aguardar fila de atendimento.

Melhores práticas:
  • Qualidade é mais importante que quantidade: 1 documento bem estruturado supera 10 documentos confusos — a IA aprende melhor com conteúdo claro e objetivo.
  • Atualize a KB sempre que mudar preços, políticas ou horários — informações desatualizadas geram respostas incorretas e frustram o cliente.
  • Use o FAQ para as perguntas mais específicas do negócio e nomeie os documentos de forma descritiva para facilitar a identificação e manutenção futura.

Problemas comuns

  • PDF enviado mas a IA não usa o conteúdo nas respostas: Verifique se o status do item está como "Indexado" (verde). Se estiver em "Erro", tente excluir e fazer o upload novamente. Se o PDF foi gerado por scan, o OCR pode ter falhado — converta para PDF nativo usando uma ferramenta como Adobe Acrobat ou SmallPDF antes de enviar. Também faça o teste usando a função "Testar KB" digitando uma pergunta relacionada ao conteúdo do PDF.
  • URL não sincroniza ou aparece como "Erro": A URL pode ter proteção contra crawlers (robots.txt bloqueando bots, Cloudflare com desafio CAPTCHA, ou conteúdo carregado via JavaScript pesado que o extrator não consegue processar). Solução: copie o texto relevante da página e adicione como FAQ manual. Outra causa comum é URL inválida — verifique se começa com https:// e não tem parâmetros de sessão.
  • IA mistura informações de documentos diferentes gerando resposta incorreta: Isso acontece quando há informações conflitantes na KB (por exemplo, um PDF antigo com preço antigo e um FAQ com preço novo). Identifique o conteúdo desatualizado usando a função "Testar KB" (veja qual trecho foi recuperado para a resposta) e exclua o conteúdo antigo. Mantenha sempre uma única fonte de verdade por assunto.
  • FAQ foi adicionado mas o agente ignora a resposta criada: O sistema de busca semântica encontra os trechos mais relevantes, mas se o FAQ estiver escrito de forma muito diferente da pergunta do cliente, o score de relevância pode ser baixo. Adicione variações da pergunta dentro do mesmo bloco de FAQ. Também verifique se o agente está usando a KB correta — confirme que o conteúdo está vinculado ao agente certo na tela de Conteúdos da IA.

Este artigo foi útil?