Skip to main content

​
O que é uma base de conhecimento?

Uma base de conhecimento é um repositório de conteúdo estruturado e indexado que o agente pode consultar durante uma conversa. Na Timely.ai, ela funciona como a memória de longo prazo do workspace: informações que não cabem ou não devem ficar no prompt do agente são cadastradas aqui e recuperadas apenas quando relevantes. A base de conhecimento aceita diferentes tipos de conteúdo:
  • Documentos — arquivos PDF, Word ou texto importados diretamente.
  • Sites rastreados — URLs cujo conteúdo é indexado automaticamente pela plataforma.
  • Textos livres — blocos de texto inseridos manualmente, como políticas, scripts e procedimentos.
  • Q&As — pares de pergunta e resposta que o agente usa como referência direta.
  • Dados estruturados — tabelas e listas convertidas em chunks pesquisáveis.
Todo o conteúdo cadastrado passa por um processo de segmentação em chunks e geração de embeddings vetoriais. Esse processamento acontece na ingestão e é o que torna a busca semântica possível.

​
Como a ferramenta funciona

Quando o agente aciona a ferramenta de busca na base de conhecimento, o processo segue três etapas:
  • A consulta do usuário é convertida em um embedding vetorial usando o modelo text-embedding-3-small da OpenAI (1.536 dimensões).
  • Esse embedding é comparado com os embeddings dos chunks já indexados na base, usando similaridade de cosseno.
  • Os chunks com maior pontuação de similaridade são retornados e injetados no contexto do agente antes da geração da resposta.
A busca é semântica — não depende de correspondência exata de palavras. O agente encontra conteúdo relevante mesmo quando o usuário usa vocabulário diferente do que está nos documentos cadastrados.

​
Opções de execução

Você pode controlar como e quando a ferramenta é acionada diretamente nas configurações da ferramenta no agente.

​
Executar sempre

Quando a opção Executar sempre está ativada, o agente consulta a base de conhecimento em toda resposta, independentemente do conteúdo da mensagem do usuário.
  • Indicado para agentes cujo papel principal é responder perguntas sobre o produto ou empresa.
  • Garante que o agente sempre considera o conteúdo cadastrado, mas aumenta o custo por resposta.

​
Pré-selecionar documentos

Quando a opção Pré-selecionar documentos está ativada, você define quais documentos específicos da base o agente deve consultar, em vez de buscar em todo o conteúdo disponível.
  • Útil quando a base de conhecimento é grande e o agente deve responder apenas sobre um escopo delimitado.
  • Reduz o risco de o agente recuperar conteúdo irrelevante de outros domínios cadastrados na mesma base.

​
Quando usar uma base de conhecimento

Use a ferramenta de busca na base de conhecimento quando a resposta ideal depende de conteúdo específico do seu negócio que muda com frequência ou que é extenso demais para o prompt:
  • Documentação de produto com versões atualizadas frequentemente.
  • Políticas internas que variam por região ou tipo de cliente.
  • Catálogos de serviços com descrições detalhadas.
A qualidade da busca depende diretamente da qualidade do conteúdo indexado. Documentos bem estruturados, com títulos e parágrafos claros, geram chunks melhores e resultados mais precisos do que textos corridos sem formatação.

​
Exemplo de configuração

1

Adicione e ative a ferramenta no agente

No painel do agente, acesse a aba de ferramentas e clique em Adicionar ferramenta. Selecione Busca na base de conhecimento no catálogo. Na configuração da ferramenta, escolha a base de conhecimento do workspace que o agente deve consultar. Defina o número de resultados (top-k) — o padrão é 10 — e ajuste o limiar de similaridade se necessário.
2

Valide no Playground

Com a ferramenta ativada, abra o Playground do agente e faça perguntas sobre o conteúdo indexado na base. Verifique se o agente recupera os trechos corretos e se a resposta incorpora as informações de forma coerente. Ajuste o top-k e o limiar de similaridade com base no que observar.

​
Boas práticas

  • Estruture o conteúdo com títulos e seções — chunks gerados de texto bem formatado têm melhor qualidade.
  • Use o formato Q&A para perguntas frequentes — a correspondência entre pergunta do usuário e pergunta indexada tende a ser mais precisa.
  • Evite documentos muito extensos sem estrutura — textos corridos geram chunks genéricos e resultados imprecisos.
  • Revise o conteúdo indexado periodicamente — documentos desatualizados fazem o agente responder com informações incorretas.
  • Combine a ferramenta com instruções no prompt — oriente o agente sobre quando buscar na base e quando pedir mais informações ao usuário antes de buscar.

​
Ponto-chave

A ferramenta de busca na base de conhecimento transforma o agente em um especialista dinâmico sobre o seu negócio — sem precisar embutir todo o conteúdo no prompt. A chave para bons resultados está na qualidade do conteúdo indexado e na configuração cuidadosa do top-k e do limiar de similaridade.