Base de Conhecimento

A Base de Conhecimento é onde você armazena tudo o que o seu Finn precisa saber sobre o seu negócio. Cardápio, preços, horários, políticas, perguntas frequentes — qualquer coisa que os interlocutores possam perguntar. Quando o interlocutor faz uma pergunta, o Finn busca a resposta aqui.

Não complique. A maioria dos usuários começa enviando um PDF (o FAQ ou um folheto de produto) e isso já basta para o Finn responder 80% das perguntas dos interlocutores. Você sempre pode adicionar mais depois.

Privacidade: tudo o que você coloca na Base de Conhecimento fica pesquisável em todas as chamadas atendidas por este Finn. Não coloque dados individuais de interlocutores aqui (como saldos de conta ou status de pedidos) — para isso, use um webhook de consulta de dados ao vivo.

Onde configurar

Create New Finn → aba Knowledge Base. Também editável depois em View All Finn → [Finn] → Edit → Knowledge Base.

Três fontes, um índice

Você pode combinar três tipos de material de origem:

1. Arquivos enviados — PDF, DOCX, Markdown, texto simples.
2. Texto colado — copie e cole o conteúdo diretamente no editor.
3. Importações de sites — informe uma URL e a plataforma rastreia e indexa as páginas.

As três alimentam um único índice pesquisável por Finn. O Finn não sabe (nem precisa saber) de onde veio um trecho durante a chamada.

Arquivos enviados

Formatos suportados

Limites

• Tamanho máximo do arquivo: 25 MB por arquivo.
• Máximo de arquivos por Finn: 100.
• Tamanho total indexado: 500 MB por Finn (varia conforme o plano).

O que é indexado

A plataforma extrai texto, tabelas e títulos. Imagens e PDFs apenas digitalizados (sem camada de texto embutida) são ignorados — passe por OCR externamente antes.

Boas práticas

• Vários arquivos menores > um PDF gigante. O sistema de recuperação tem melhor desempenho com documentos focados.
• Remova o supérfluo — cabeçalhos, rodapés e números de página só geram ruído.
• Um tópico por arquivo — mais fácil de atualizar sem reindexar tudo.

Texto colado

Para conteúdo rápido que não merece um arquivo. Limites: 100.000 caracteres por colagem, 10 colagens por Finn.

Use para:

• Trechos de perguntas frequentes.
• Descrições curtas de produtos.
• Dados que mudam diariamente (código promocional do dia, tempos de espera atuais) — embora, para dados realmente ao vivo, o ideal seja usar uma tarefa de Webhook.

Importações de sites

Forneça uma URL. A plataforma rastreia o site e indexa as páginas.

Configuração

O que funciona bem

• Centrais de ajuda públicas e páginas de FAQ.
• Catálogos de produtos com HTML limpo.
• Páginas de marketing com renderização estática.

O que não funciona

• Sites que exigem login.
• Single-page apps pesados em que o conteúdo é renderizado por JS após o carregamento da página (use o upload de arquivos).
• Sites que bloqueiam rastreadores via robots.txt (a plataforma respeita o arquivo).

Como funciona a recuperação durante a chamada

Quando o interlocutor faz uma pergunta:

1. O Finn monta uma consulta a partir da fala do interlocutor.
2. A plataforma pesquisa o índice (híbrido de vetor + palavra-chave).
3. Os N melhores trechos correspondentes são inseridos no prompt do LLM.
4. O Finn sintetiza uma resposta fundamentada nesses trechos.

Você pode inspecionar o que foi recuperado em cada chamada na aba Data Extractor Sidebar → Knowledge. Útil para depurar "por que o Finn disse isso?"

Ajuste da recuperação

Se o Finn estiver dando respostas erradas ou fora do tema:

• Adicione conteúdo mais específico. Se "qual é a política de reembolso?" retorna respostas vagas, adicione um arquivo dedicado à política de reembolso.
• Elimine contradições. Dois arquivos dizendo coisas diferentes confundem a recuperação. Audite e reconcilie.
• Reforce as restrições da mensagem de boas-vindas. Diga explicitamente ao Finn o que está no escopo. "Você só responde perguntas sobre agendamento. Qualquer outro assunto, transfira para um humano."
• Reclassificar. Planos premium permitem definir prioridade por fonte — arquivos mais recentes prevalecem sobre os antigos.

Quando não usar a base de conhecimento

Alguns dados não devem ficar aqui:

• Dados por interlocutor (saldos de conta, status de pedido) — use uma tarefa de Webhook para consultá-los ao vivo.
• Dados sensíveis (CPFs, números completos de cartão de crédito) — nunca cole isso aqui. A KB é pesquisável em todas as chamadas.
• Conteúdo altamente dinâmico (preços que mudam a cada hora) — também é caso para webhook.

A KB serve para contexto de apoio que é igual para todos os interlocutores. Qualquer coisa específica do interlocutor ou sensível ao tempo deve ser uma consulta ao vivo.

Reindexação

A plataforma reindexa:

• Automaticamente — quando você adiciona/remove/edita uma fonte.
• Por agendamento — para importações de sites, conforme a frequência de recrawl.
• Manualmente — Base de Conhecimento → Reindexar agora. Força uma reconstrução completa.

A reindexação costuma levar de segundos (KBs pequenas) a alguns minutos (500 MB).

Custo

O armazenamento e as consultas da Base de Conhecimento estão incluídos no seu plano até os limites de tamanho acima. Exceder os limites exige upgrade de plano — veja Faturamento →.

Próximo

• Fluxos de trabalho → — quando a recuperação livre não é estruturada o bastante.
• Integrações → — consultas de dados ao vivo via webhooks.