# 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.

{% stepper %}
{% step %}

#### 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>)
{% endstep %}

{% step %}

#### 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](/files/04b70a65e42ded633df631b31903eec28eb788ff)
{% endstep %}

{% step %}

#### 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](/files/3f91b2577bf383f9a0af1cce2d8fe7e6e9697e4e) ![selecionar](/files/a75ebb3012f57df8158db182fe471e73ea91c307) ![criar](/files/9443cdbe8d06a56fe66432dcf7efadbe4e4f478d)
{% endstep %}

{% step %}

#### 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](/files/963d75de0881c452c5a5000fcaae6af5523b1cbb)
* Número de documentos ou resultados: indica quanta informação trazer dos documentos. Exemplo: **12** → os “12 fragmentos mais semelhantes”.

  ![número de resultados](/files/3383f10535ebb11baa970ed7c2e5991b72beb7fe)
* 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](/files/1bfdd63741c15c44bbf31d7feacf6dd90f5aa309)
* 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](/files/d0d7a451d7a0cf4fb9ec7951834701b229904666)
  {% endstep %}

{% step %}

#### 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](/files/286620e4d61a6582bc0169c805fcac56583af7b1)
{% endstep %}
{% endstepper %}

***

## 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.

{% stepper %}
{% step %}

#### Entrar no assistente

Mesmo procedimento que no método anterior.
{% endstep %}

{% step %}

#### Selecionar o passo em que ocorrerá a busca

Exemplo: “Quando o cliente mencionar um produto específico.”
{% endstep %}

{% step %}

#### Criar a função

* Adicionar função.
* Selecionar **Buscar linha na planilha**.
* Criar nova função.
  {% endstep %}

{% step %}

#### 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.
  {% endstep %}
  {% endstepper %}

### Erros comuns

<details>

<summary>Ver erros comuns</summary>

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.

</details>

***

### 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 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.vambe.ai/asistentes-ia/asistentes-ia-pt-br/funcoes/como-indicar-al-asistente-donde-buscar-informacion-dentro-de-la-base-de-conocimiento.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.