Base de Conhecimento

📚 Base de Conhecimento para Reduzir Prompt e Tokens

Para deixar o prompt:

• ✅ Mais simples
• ✅ Menor
• ✅ Mais estável
• ✅ Com menor consumo de tokens

Você pode utilizar a Base de Conhecimento integrada à Recepção Inteligente.

Assim, a IA só recebe informações extras quando necessário, em vez de manter tudo fixo no prompt principal.

🎯 Qual o objetivo?

Evitar prompts longos que podem:

• Confundir a IA
• Aumentar consumo de tokens
• Gerar respostas inconsistentes
• “Fazer a IA enlouquecer” 😅

Com a Base de Conhecimento:

• O prompt principal fica enxuto
• Informações específicas são adicionadas apenas quando a palavra-chave é detectada

🛠️ Como Funciona na Prática

1️⃣ Criar uma Base de Conhecimento

Exemplo:

Criar base chamada:

IXC

Dentro dela, você cadastra:

• Como configurar IXC
• Passo a passo
• Requisitos
• Links importantes
• Informações técnicas

2️⃣ Configurar na Recepção Inteligente

Na configuração:

• Selecione a base criada
• Defina a palavra-chave:

ixc

3️⃣ O que acontece quando o cliente falar “ixc”?

Se o cliente escrever algo como:

O sistema automaticamente:

• Detecta a palavra-chave
• Injeta o conteúdo da base no prompt da IA
• Envia junto com as instruções

🧠 Modelo Padrão de Injeção da Base

Quando ativada, o sistema adiciona ao prompt algo como:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📚 BASE DE CONHECIMENTO ATIVADA
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

As seguintes informações foram encontradas na base de conhecimento e devem ser usadas para responder:

${content}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️ INSTRUÇÕES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. USE as informações acima como fonte primária
2. Siga os passos EXATAMENTE como descritos
3. Seja natural - NÃO mencione "consultei a base de conhecimento"
4. Se precisar de mais informações além do que está acima, seja honesto
5. NÃO invente - use APENAS o que foi fornecido
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

A variável:

${content}

Contém exatamente o texto salvo na Base de Conhecimento.

✏️ Personalizando o Próprio Prompt

Você também pode criar seu próprio modelo de injeção.

⚠️ Importante:
Sempre inclua a variável:

{content}

Ela é responsável por inserir o conteúdo da Base de Conhecimento dentro do prompt.

Se esquecer essa variável, a IA não receberá o conteúdo.

Aqui está somente o conteúdo que você deve acrescentar na documentação 👇

🔎 Busca Avançada com IA (Vector / Semântica)

Agora a Base de Conhecimento conta com busca inteligente por similaridade, permitindo encontrar conteúdos mesmo quando o cliente não usa exatamente a palavra-chave.

Também é possível enviar arquivos (PDF, DOC, etc) para serem usados como fonte de conhecimento.

🤖 Como funciona

O sistema pode utilizar o Gemini (Google) para transformar textos em vetores (embeddings), permitindo comparação por significado (semântica), e não apenas por palavras exatas.

🔑 Configuração da API do Gemini

⚠️ Importante

Para ativar a busca inteligente, configure a API Key do Gemini nas configurações da Base de Conhecimento.

• A mesma chave é utilizada para:
  • Base de Conhecimento
  • Correspondência de Arquivos

Sem essa configuração:

• A busca funciona apenas por palavras-chave exatas
• A busca semântica (por similaridade) não será ativada

Essa chave permite:

• Comparar mensagens por significado, não só palavras
• Encontrar respostas mesmo com sinônimos ou frases diferentes
• Analisar conteúdo de arquivos enviados pelo cliente
• Melhorar muito a precisão das respostas

⚠️ Sem a API do Gemini

Se a chave não estiver configurada:

• A busca funciona apenas por palavras-chave exatas
• O sistema procura exatamente o termo digitado pelo cliente
• Arquivos não são analisados por conteúdo, apenas por nome ou palavras-chave

📄 Suporte a Arquivos

Agora você pode adicionar arquivos como fonte de conhecimento:

• PDF
• DOC / DOCX
• Textos em geral

Com o Gemini ativo:

• O conteúdo dos arquivos é lido e indexado
• A IA consegue buscar informações dentro dos arquivos
• Funciona até com perguntas indiretas

⚙️ Estratégia de Busca

Define como o sistema encontra informações na Base:

• somente palavras chaves
  Busca por palavra exata (modo tradicional)
• palavras chaves + busca vetorial (recomendado)
  Primeiro filtra por palavra-chave, depois refina por similaridade

🎯 Similaridade

Define o quão parecida a mensagem precisa ser para retornar um resultado.

Valor entre 0 e 1:

• 0.70 → equilíbrio ideal (recomendado)
• 0.85 → muito restrito (resultados quase idênticos)
• 0.50 → mais aberto (pode trazer conteúdos menos relevantes)

📊 Máximo resultados

Define quantos itens da Base de Conhecimento serão enviados para a IA por mensagem.

💡 Recomendado: entre 2 e 4

• Valores altos podem:
  • Aumentar consumo de tokens
  • Deixar o prompt mais pesado
  • Reduzir performance

🚀 Resultado

Com essa configuração:

• A IA entende melhor o cliente, mesmo sem palavras exatas
• Conteúdos de arquivos também são utilizados
• Respostas ficam mais precisas e inteligentes
• Mantém o sistema otimizado e eficiente

🚀 Vantagens

• 🔥 Reduz consumo de tokens
• 🧠 Melhora precisão das respostas
• 📚 Organiza conteúdos técnicos
• ⚡ Deixa o prompt principal mais leve
• 🎯 Ativa informação apenas quando necessário

✅ Resultado Final

Com essa configuração:

1. Cliente menciona palavra-chave
2. Sistema injeta automaticamente o conteúdo relacionado
3. IA responde com base correta
4. Prompt permanece limpo e otimizado

Isso torna o atendimento mais inteligente, econômico e estável 🚀