# ¿Cómo buscar información de una fila específica de Google Sheets?
La función Buscar fila en hoja permite que tu Asistente vaya a tu Excel en la nube, busque un dato específico (como un RUT, un ID de pedido o un correo) y traiga toda la información de esa fila para responderle al cliente.
**¿Para qué sirve?** Para consultas de datos únicos y exactos:
* **Estado de Pedido:** El cliente da su número de orden -> La IA busca esa fila y responde "Tu pedido está en camino".
* **Validación de Cliente:** El cliente da su RUT -> La IA verifica si existe en la base de datos.
* **Consulta de Saldo/Puntos:** El cliente da su DNI -> La IA le dice cuántos puntos tiene acumulados.
***
#### 🛑 ¡Espera! ¿Quieres buscar en todo el documento?
Es vital entender la diferencia:
* **Buscar Fila (Esta función):** Busca única y exclusivamente una sola fila basándose en un dato exacto (ej: RUT 123-4).
* Búsqueda Vectorial: Busca información general en todo el documento (ej: "¿Qué productos tienen para el dolor de cabeza?").
> Si lo que necesitas es que la IA lea el documento completo para responder preguntas generales, NO uses esta función. 👉 [\[Ve al artículo de Búsqueda de Base Vectorial aquí\]](/asistentes-ia/funciones/como-indicar-al-asistente-donde-buscar-informacion-dentro-de-la-base-de-conocimiento.md)
***
#### Configuración Paso a Paso
Para que esto funcione, necesitamos un Dato Llave (el dato único por el cual vamos a buscar, como el RUT o el ID).
**Paso 1: La Instrucción (El Gatillo)**
Dile a la IA que cuando reciba el "Dato Llave", vaya a buscar.
* *Fórmula:* `Cuando el cliente me entregue su [Dato Llave], ejecuta la función [Nombre de la función] para ver su información`.
> Ejemplo: "Cuando el cliente me dé su RUT, ejecuta la función Buscar Cliente para ver si está registrado".
**Paso 2: Crear la Función**
Haz clic en + Agregar Función, selecciona Google Sheets y luego Buscar fila en hoja (Search Row).
1. **Nombre:** Ej: "Buscar Cliente por RUT".
2. **Descripción:** "Cuando tenga el RUT del cliente".
3. **Conexión (Token):** Selecciona tu cuenta de Google (Recuerda refrescar la página si acabas de conectarla y no aparece).
4. **Selección de Hoja:** Elige el archivo (Spreadsheet) y la pestaña (Sheet) donde están los datos.
**Paso 3: Configuración de Columnas (¡Lo más importante!)**
Al cargar la hoja, verás todas las columnas (Nombre, RUT, Dirección, Estado, etc.).
Debes decirle a la IA **cuál es la columna por la que debe buscar.**
1. Ubica la columna del **Dato Llave** (Ej: Columna "RUT").
2. En la **Descripción** de esa columna escribe: *"Este es el dato por el cual debes buscar la fila"*.
3. **ACTIVA el interruptor "¿Requerido?"** en esa columna específica.
* *¿Por qué?* Esto le dice a la IA: "Sin este dato (RUT), no puedes buscar nada". Es la llave que abre la puerta de esa fila.
**Paso 4: Verificación**
Haz clic en Crear. Ahora, cuando un cliente entregue ese dato llave, la IA leerá esa fila específica y podrá responder cosas como: *"Hola \[Nombre de la columna A], veo que tu pedido está en estado \[Columna B]" o encontrara la informacion de ese cliente*
Por ejemplo, en esta función se buscaría por el RUT de un cliente y se traería para la IA toda la información correspondiente (solo de esa línea de 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/funciones/como-buscar-informacion-de-una-fila-especifica-de-google-sheets.md?ask=
```
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.