Google Sheets en un agente de IA

Con el paso Google Sheets un agente de IA puede leer, buscar y escribir filas en una hoja de cálculo. Por ejemplo: consultar una lista de precios, guardar cada contacto nuevo o responder con datos de la hoja.

Conectar tu cuenta de Google

1. Entra a Agentes de IA y abre el apartado de Conectores.
2. Haz clic en la tarjeta Google Sheets.

   Captura pendiente: Tarjeta Google Sheets en la lista de conectores
   img/sheets-conector.png

3. Inicia sesión con la cuenta de Google donde están tus hojas y acepta el permiso.
4. Al volver, verás el conector con tu correo. Ya puedes usarlo en cualquier agente.

Agregar el paso a un agente

1. Abre tu agente y entra al constructor de flujos.
2. Haz clic en Agregar paso y busca Google Sheets (categoría Utilidades).

   Captura pendiente: Buscar el paso Google Sheets
   img/sheets-agregar-paso.png

3. En Evento de acción elige qué hará el paso:

   Acción	Qué hace
   Listar pestañas	Devuelve los nombres de las pestañas de la hoja.
   Leer filas	Lee un rango de la hoja (hasta 200 filas).
   Buscar filas	Encuentra las filas donde una columna tiene cierto valor.
   Agregar filas	Añade filas nuevas al final de la hoja.
   Actualizar rango	Reemplaza el contenido de un rango de celdas.

Elegir la hoja de cálculo

1. Haz clic en Elegir hoja de cálculo.
2. Se abre el selector de Google. Elige la hoja y confirma.

   Captura pendiente: Selector de archivos de Google
   img/sheets-selector.png

3. El nombre de la hoja aparece debajo del botón como Hoja elegida.

También puedes pegar el enlace o el ID de la hoja, o usar una variable como {hoja} si el valor cambia en cada ejecución.

Campos del paso

• Nombre de la pestaña: déjalo vacío para usar la primera pestaña.
• Rango: por ejemplo A:Z, A1:D50 o B5.
• Columna / Valor a buscar (Buscar filas): el encabezado de la columna y el valor, por ejemplo Email y {lead_email}.
• Filas (Agregar / Actualizar): una lista de filas, por ejemplo [["{lead_name}","{lead_email}","{lead_phone}"]]. Una fila es una lista de celdas.
• Límite y Formato de salida (Leer / Buscar): JSON para datos estructurados, o Texto plano, que es más fácil de usar en respuestas del chat.

Usar los datos en el siguiente paso

El resultado del paso queda disponible como variable para los pasos siguientes. La forma más segura de usarla es el botón { } de cada campo, que lista las variables disponibles y la inserta con su nombre exacto. Por ejemplo, el resultado de Leer filas suele aparecer como {sheet_read_rows}.

Ejemplo: un paso Enviar mensaje con el texto Datos de la hoja: {sheet_read_rows} responde al usuario con lo leído.

Probar el agente

1. Activa el agente: la prueba solo corre si el agente está Activo.
2. Usa el botón Probar del constructor.
3. Revisa en Ejecuciones que cada paso terminó bien.

Solución de problemas