Base de conhecimento

Como alimentar seu agente com informacoes relevantes usando a base de conhecimento.

O que e a base de conhecimento?

A base de conhecimento e o conjunto de informacoes que seu agente usa para responder perguntas. O Take Sales utiliza RAG (Retrieval-Augmented Generation) para buscar as informacoes mais relevantes a cada pergunta do visitante.

Como o RAG funciona

De forma simplificada, o processo acontece em duas etapas:

1. Indexacao (quando voce adiciona um documento):

• O documento e dividido em pedacos menores chamados chunks (aproximadamente 500 a 1000 tokens cada).
• Cada chunk e convertido em um embedding vetorial — uma representacao numerica que captura o significado do texto.
• Os embeddings sao armazenados em um banco de dados vetorial para busca rapida.

2. Consulta (quando o visitante faz uma pergunta):

• A pergunta do visitante tambem e convertida em um embedding.
• O sistema busca os chunks mais similares (mais relevantes) a pergunta.
• Os chunks encontrados sao enviados ao modelo de IA junto com a pergunta, para que o agente gere uma resposta fundamentada.

Isso significa que o agente nao "memoriza" todo o documento — ele consulta as partes relevantes em tempo real a cada pergunta.

Adicionando conteudo

Tipos de conteudo e limites

Tempo de processamento: textos ficam prontos em segundos; PDFs extensos e sites com muitas paginas levam de 1 a 3 minutos.

Modo de recuperacao

Antes do tipo de conteudo, voce escolhe como o agente acessa aquele item:

• Injetar como prompt — O conteudo inteiro entra no contexto em toda conversa. Bom para textos curtos e sempre relevantes; consome tokens sempre
• Busca semantica (RAG) — O conteudo e indexado e so os trechos relevantes entram na resposta. Obrigatorio para arquivos e recomendado para tudo que for grande

Como adicionar

1. Acesse Base de Conhecimento no menu lateral
2. Crie uma base em Nova Base (ou abra uma existente)
3. Clique em Adicionar Item e escolha o modo de recuperacao
4. Selecione o tipo (texto, arquivo ou website) e envie o conteudo
5. Aguarde o processamento — o card mostra o andamento
6. Em Gerenciar acesso, vincule a base aos agentes que podem consulta-la

Exemplo pratico: catalogo de produtos em PDF

Suponha que voce tem um catalogo de produtos em PDF. Para adicionalo a base de conhecimento:

1. Acesse a base desejada e clique em Adicionar Item → Busca semantica (RAG) → Arquivo.
2. Faca upload do arquivo catalogo-produtos-2026.pdf.
3. Aguarde o processamento terminar.
4. Abra o modo de teste do agente e faca perguntas como:
   • "Quais produtos voces tem na categoria X?"
   • "Qual o preco do produto Y?"
   • "Qual a diferenca entre o modelo A e o modelo B?"
5. Verifique se as respostas estao corretas e completas. Se o agente nao encontrar alguma informacao, revise o PDF para garantir que o texto esta selecionavel (nao e uma imagem).

Boas praticas

Template de FAQ para RAG

O formato de perguntas e respostas funciona muito bem com RAG. Use este template:

Pergunta: Qual o prazo de entrega?
Resposta: O prazo de entrega e de 3 a 7 dias uteis para capitais e de 7 a 15 dias uteis para demais regioes. Entregas expressas estao disponiveis para algumas localidades com prazo de 1 a 2 dias uteis.

Pergunta: Qual a politica de troca?
Resposta: Aceitamos trocas em ate 30 dias apos o recebimento do produto. O produto deve estar em sua embalagem original e sem sinais de uso. Para solicitar uma troca, entre em contato pelo email suporte@empresa.com.

Pergunta: Quais formas de pagamento sao aceitas?
Resposta: Aceitamos cartao de credito (Visa, Master, Elo, Amex) em ate 12x sem juros, boleto bancario, PIX e transferencia bancaria.

Este formato e eficaz porque cada par pergunta-resposta forma um chunk coeso, facilitando a busca semantica.

Estruture o conteudo

• Divida por temas — Em vez de um documento enorme, crie varios documentos focados (ex: um para precos, outro para politicas, outro para FAQs)
• Use titulos claros — Facilita a busca semantica e melhora a qualidade dos chunks
• Inclua perguntas frequentes — O formato de FAQ mostrado acima funciona muito bem com RAG

Mantenha atualizado

• Revise periodicamente o conteudo
• Remova informacoes desatualizadas (precos antigos, politicas alteradas)
• Adicione novas informacoes conforme seu produto evolui

O que incluir

• Informacoes sobre produtos e servicos
• Precos e condicoes comerciais
• Politicas (entrega, troca, garantia)
• FAQs reais dos seus clientes
• Diferenciais competitivos

Erros comuns a evitar

• PDFs com imagens de texto — Se o PDF foi gerado a partir de um escaneamento e contem apenas imagens (sem texto selecionavel), o sistema nao conseguira extrair o conteudo. Use ferramentas de OCR para converter antes de fazer upload.
• Um unico documento gigante — Documentos muito grandes e com temas variados geram chunks desconexos. Divida em documentos menores e tematicos.
• Informacoes desatualizadas nao removidas — O agente pode citar precos antigos ou politicas que ja mudaram. Sempre remova conteudo obsoleto.
• Conteudo duplicado — Evite fazer upload do mesmo conteudo em formatos diferentes (PDF e DOCX do mesmo documento), pois isso pode gerar respostas redundantes.

Gerenciamento de fontes de conhecimento

Associacao com agentes

Uma fonte de conhecimento pode ser compartilhada entre multiplos agentes. Por exemplo, um documento com politicas da empresa pode servir tanto para o agente de vendas quanto para o de suporte.

Para associar uma base a um agente:

1. Abra a base em Base de Conhecimento.
2. Clique em Gerenciar acesso.
3. Marque os agentes que devem consultar essa base e salve.

Voce tambem pode criar fontes exclusivas para agentes especificos. Por exemplo, uma tabela de precos com descontos especiais pode ser associada apenas ao agente de vendas.

Auditando o que o agente usou

Na conversa, a aba Logs traz a Auditoria da RAG: a query original, a reescrita, as sub-queries e os trechos recuperados, com link para a fonte. Use isso antes de mexer no prompt — na maioria das vezes o problema e conteudo faltando, nao o modelo.

Publicando na central de ajuda

Um item pode ser publicado na central de ajuda publica do agente, acessivel sem login. Revise antes: o conteudo fica visivel para qualquer visitante.