Resumen
Esta guía explica cómo configurar la acción Google Sheets — Buscar y encontrar fila en Astra. Esta acción permite a su agente leer y recuperar filas de una hoja de cálculo de Google Sheets (pestaña) seleccionada y devuelve los resultados como una lista estructurada.
Para asegurarse de que la acción funciona correctamente, su hoja de cálculo debe contener una fila de encabezado no vacía en la parte superior. Estos encabezados definen la estructura de los datos que lee Astra.
Antes de configurar la acción, asegúrese de que su cuenta de Google esté conectada a Astra.
Instrucciones
Siga estos pasos para configurar la acción Google Sheets — Buscar y encontrar fila:
Paso 1: Abra la plantilla de acción
Inicie sesión en su cuenta de Astra.
Vaya a la Biblioteca de acciones.
Seleccione Google Sheets — Buscar y encontrar fila.
Abra la página de Configuración.
Configurará varias secciones en esta página.
Paso 2: Configure la intención de la acción
En la sección Intención de la acción:
Introduzca un Nombre de acción.
Escriba una Intención que explique cuándo el agente debe buscar filas en la hoja de cálculo.
Por qué esto es importante
La intención ayuda al agente a comprender cuándo debe usar esta acción.
Unas instrucciones claras mejoran la exactitud de cuándo se activa la acción.
Por ejemplo, el agente puede buscar en la hoja cuando un usuario solicita detalles del cliente o cuando necesita recuperar información almacenada.
Paso 3: Seleccione la cuenta de Google
En la sección Cuenta de Google:
Elija la cuenta de Google conectada que tiene acceso a la hoja de cálculo.
Cómo funciona esto
Astra utiliza la cuenta seleccionada para acceder a Google Sheets a través de la autenticación segura OAuth.
Se debe poder acceder a la hoja de cálculo desde esa cuenta.
Paso 4: Seleccione la hoja de cálculo y la hoja de trabajo
En la sección Hoja de cálculo y hoja de trabajo:
Elija la Ubicación de Drive.
Seleccione la Hoja de cálculo.
Seleccione la Hoja de trabajo (pestaña) que contiene los datos.
Importante:
Solo se pueden utilizar las hojas de cálculo ubicadas en Mi unidad o en Unidades compartidas.
Astra leerá los datos solo de la hoja de trabajo seleccionada.
Paso 5: Configure el filtrado de filas
Puede controlar cómo Astra lee las filas utilizando el botón de alternancia Leer solo las filas relevantes.
Opción 1: Alternar APAGADO (leer toda la hoja)
Cuando el botón de alternancia está en APAGADO:
Astra lee la hoja de trabajo completa.
Todas las filas se devuelven al agente.
Lo mejor para:
Hojas con conjuntos de datos pequeños (alrededor de 1000 filas o menos).
Opción 2: Alternar ENCENDIDO (leer solo las filas relevantes)
Cuando el botón de alternancia está en ENCENDIDO:
Astra intenta filtrar y devolver solo las filas relevantes.
El agente busca en los datos en lugar de leer toda la hoja.
Notas importantes sobre la coincidencia:
La coincidencia es aproximada (difusa) para el texto ASCII.
Las búsquedas suelen ser:
Insensibles a mayúsculas y minúsculas
Menos sensibles a los espacios o la puntuación
Para texto no latino, la coincidencia es más literal y puede requerir coincidencias más cercanas.
Lo mejor para:
Hojas con grandes conjuntos de datos donde leer toda la hoja sería ineficiente.
Qué sucede cuando se ejecuta la acción
Cuando se activa la acción:
Astra lee la hoja de trabajo de Google Sheets seleccionada.
Recupera las filas según la configuración configurada.
Las filas se devuelven al agente como una lista de datos estructurada.
Esto permite que sus flujos de trabajo recuperen dinámicamente información almacenada en Google Sheets, como registros de clientes, datos de productos o información de seguimiento interno.