# Como buscar informações de uma linha específica do Google Sheets?

A função Buscar fila em planilha permite que seu Assistente vá até seu Excel na nuvem, procure um dado específico (como um RUT, um ID de pedido ou um e-mail) e traga todas as informações dessa linha para responder ao cliente.

**Para que serve?** Para consultas de dados únicos e exatos:

* **Status do Pedido:** O cliente informa seu número de pedido -> A IA busca essa linha e responde "Seu pedido está a caminho".
* **Validação de Cliente:** O cliente informa seu RUT -> A IA verifica se existe no banco de dados.
* **Consulta de Saldo/Pontos:** O cliente informa seu DNI -> A IA diz quantos pontos acumulados ele tem.

***

#### 🛑 Espere! Você quer pesquisar em todo o documento?

É vital entender a diferença:

* **Buscar Linha (Esta função):** Busca única e exclusivamente uma única linha com base em um dado exato (ex.: RUT 123-4).
* Busca Vetorial: Busca informações gerais em todo o documento (ex.: "Quais produtos vocês têm para dor de cabeça?").

> Se o que você precisa é que a IA leia o documento completo para responder perguntas gerais, NÃO use esta função. 👉 [\[Vá para o artigo de Busca de Base Vetorial aqui\]](/asistentes-ia/asistentes-ia-pt-br/funcoes/como-indicar-al-asistente-donde-buscar-informacion-dentro-de-la-base-de-conocimiento.md)

***

#### Configuração Passo a Passo

Para que isso funcione, precisamos de um Dado Chave (o dado único pelo qual vamos buscar, como o RUT ou o ID).

**Passo 1: A Instrução (O Gatilho)**

Diga à IA que, quando receber o "Dado Chave", vá buscar.

* *Fórmula:* `Quando o cliente me entregar seu [Dado Chave], execute a função [Nome da função] para ver suas informações`.

> Exemplo: "Quando o cliente me der seu RUT, execute a função Buscar Cliente para ver se ele está cadastrado".

**Passo 2: Criar a Função**

Clique em + Adicionar Função, selecione Google Sheets e depois Buscar linha na folha (Search Row).

<figure><img src="/files/24dba68cd117c6ca7ee10c8a5a99f9394535724a" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/98bdda20a9bbf2445dc65bc5ec32b23f96ee84c3" alt=""><figcaption></figcaption></figure>

1. **Nome:** Ex.: "Buscar Cliente por RUT".
2. **Descrição:** "Quando eu tiver o RUT do cliente".
3. **Conexão (Token):** Selecione sua conta do Google (lembre-se de atualizar a página se acabou de conectá-la e ela não aparecer).
4. **Seleção de Folha:** Escolha o arquivo (Spreadsheet) e a aba (Sheet) onde estão os dados.

<figure><img src="/files/12553807dfc327484fffbb34f0b5c43af2c65481" alt=""><figcaption></figcaption></figure>

**Passo 3: Configuração das Colunas (O mais importante!)**

Ao carregar a folha, você verá todas as colunas (Nome, RUT, Endereço, Status etc.).

Você deve dizer à IA **qual é a coluna pela qual deve buscar.**

1. Localize a coluna do **Dado Chave** (Ex.: coluna "RUT").
2. Na **Descrição** dessa coluna, escreva: *"Este é o dado pelo qual você deve buscar a linha"*.
3. **ATIVE o interruptor "Obrigatório?"** nessa coluna específica.
   * *Por quê?* Isso diz à IA: "Sem esse dado (RUT), você não pode buscar nada". É a chave que abre a porta dessa linha.

<figure><img src="/files/8f3f55ac108d05495667e20a8ac7176b12a07571" alt=""><figcaption></figcaption></figure>

**Passo 4: Verificação**

Clique em Criar. Agora, quando um cliente fornecer esse dado chave, a IA lerá essa linha específica e poderá responder coisas como: *"Olá \[Nome da coluna A], vejo que seu pedido está no status \[Coluna B]" ou encontrará a informação desse cliente*

<figure><img src="/files/81fac6e2d3d7276d89f46b38d2f9edd8c7343d73" alt=""><figcaption></figcaption></figure>

Por exemplo, nesta função, seria buscado pelo RUT de um cliente e seria trazida para a IA toda a informação correspondente (somente dessa linha da 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-buscar-informacion-de-una-fila-especifica-de-google-sheets.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.