Como indicar ao assistente onde buscar informações dentro da Base de Conhecimento

Para que o assistente possa entregar respostas precisas, é fundamental ensiná-lo como, quando e onde deve buscar informações dentro dos documentos conectados ao Vambe.

Existem dois métodos diferentes para realizar buscas de informação na Base de Conhecimento:

• Busca Baseada em Vetores (busca semântica em textos).

• Buscar linha na planilha (busca exata por coluna no Google Sheets).

Cada método funciona de forma diferente e é usado de acordo com o tipo de informação que precisamos encontrar.

Antes de explicar como configurá-los, dois conceitos essenciais:

---

Informação que a IA pode e não pode ler

• A IA pode ler:

  • Texto dentro de PDF (se o PDF for texto real).

  • Google Sheets.

  • Google Docs.

  • Arquivos do Drive, Notion, Dropbox e outros conectados.

• A IA NÃO pode ler:

  • Imagens.

  • PDFs escaneados que contêm imagens em vez de texto.

  • Documentos em que a informação não é selecionável.

Isso é crítico: se o documento não contiver texto real, a busca falhará.

---

Onde as funções de busca devem ser configuradas?

As funções de busca só podem ser configuradas nos seguintes blocos de instrução:

• Passos a seguir

• Casos possíveis

Isso acontece porque são os únicos blocos que permitem adicionar funções.

---

Método 1: Busca Baseada em Vetores (Busca Vetorial)

O que esse método faz?

Realiza uma busca semântica, comparando o que o cliente escreve com o conteúdo dos documentos para encontrar o texto mais parecido.

Ideal para:

• Buscar descrições de produtos.

• Buscar preços.

• Buscar políticas ou perguntas frequentes.

• Encontrar texto semelhante dentro de documentos extensos.

Exemplo:

Se o cliente escrever “vocês têm marteletes?”, a IA pode encontrar textos relacionados a martelos, martelete, jogo de martelos, etc., mesmo que não coincidam exatamente palavra por palavra.

1

Entrar no assistente

• Acessar o funil.

• Abrir a etapa onde está o assistente.

• Configuração → Editar assistente.

(Link de referência: https://academy.vambe.ai/es/academy/c%C3%B3mo-ingresar-al-asistente-de-inteligencia-artificial)

2

Selecionar o passo em que a busca será executada

Deve ser definido quando queremos buscar a informação. Exemplo: “Quando o cliente perguntar por um produto”. Esse será o gatilho da busca.

captura

3

Adicionar a função

• Ir para o passo correspondente.

• Clicar em Adicionar função.

• Selecionar Busca de base vetorial.

• Criar nova função.

adicionar função

selecionar

criar

4

Configurar parâmetros

Dentro da função, deve-se definir:

• Seleção de documentos: selecionar os documentos previamente carregados na Base de Conhecimento de onde a IA poderá extrair informações.

  

  seleção de documentos
• Número de documentos ou resultados: indica quanta informação trazer dos documentos. Exemplo: 12 → os “12 fragmentos mais semelhantes”.

  

  número de resultados
• Limite de similaridade (opcional): define o quão parecido deve ser o conteúdo encontrado (valor entre 0 e 1). Exemplos:

  • 0.2 → busca ampla.

  • 0.5 → correspondências moderadas.

  • 0.8 → correspondências muito restritas.

  

  limite
• Palavra-chave de busca: a pista que damos à IA. Exemplo: “Usar o produto mencionado pelo cliente como palavra-chave de busca.”

• Estrutura do documento: descrever como o documento está organizado para que a IA interprete corretamente as informações. Exemplo: “Esta planilha tem 5 colunas: nome do produto, descrição, preço, categoria e estoque.”

  

  estrutura

5

Salvar e usar a função

No passo correspondente, escrever a instrução para executar a função, por exemplo:

“Você deve executar a função buscar_informação_produto.”

usar função

---

Método 2: Buscar linha na planilha (somente Google Sheets)

O que esse método faz?

Permite buscar um valor exato em uma coluna do Google Sheets e obter a linha inteira.

É usado quando precisamos:

• Buscar um cliente pelo telefone ou e-mail.

• Buscar um produto por um código exato.

• Buscar informações perfeitamente estruturadas.

Exemplo:

A IA busca na coluna “Produto” o valor exato “Martelo Industrial Nº4” e traz toda a linha que inclui preço, fornecedor, estoque, peso etc.

1

Entrar no assistente

Mesmo procedimento que no método anterior.

2

Selecionar o passo em que ocorrerá a busca

Exemplo: “Quando o cliente mencionar um produto específico.”

3

Criar a função

• Adicionar função.

• Selecionar Buscar linha na planilha.

• Criar nova função.

4

Configurar parâmetros

A função permite duas formas de conexão:

• Conexão direta com o Google: conectar com sua conta Google → selecionar a Google Sheet.

• Por meio de URL: é necessário dar permissão ao e-mail que aparece na interface.

Depois:

• Selecionar a planilha.

• Definir os nomes das colunas.

• Marcar como “Obrigatória” a coluna de onde será feita a busca exata.

Erros comuns

Ver erros comuns

1. As colunas da planilha do Google mudam no meio da planilha.

   • Isso confunde a IA. Todas as linhas devem seguir a mesma estrutura.

2. O documento contém imagens em vez de texto.

   • A IA não consegue lê-las.

3. A URL foi carregada incorretamente ou as permissões não foram atribuídas.

---

Resumo claro de ambos os métodos

Método	Tipo de busca	Ideal para	Limitações
Busca Baseada em Vetores	Semântica / por similaridade	Produtos, textos longos, políticas, descrições	Não serve para valores exatos
Buscar linha na planilha	Exata por coluna	Preços, clientes, catálogos estruturados	Funciona apenas com Google Sheets