Tablas de datos

Objetivo

Guarda tus datos de negocio estructurados (clientes, pedidos, inventario, citas y más) en tablas que tus agentes de IA pueden leer y responder preguntas sobre ellas. Puedes crear una tabla a mano, partir de una plantilla o describirla y dejar que la IA la diseñe. Una vez asignada a un agente, este puede responder preguntas sobre ella en conversaciones de chat, email o voz.

Acceso

Menú lateral -> Data Tables

Ruta(s): /app/\{tenant\}/sql-tables (lista de tablas) y /app/\{tenant\}/sql-tables/\{id\} (detalle de la tabla).

Roles

• owner, admin — acceso completo: crear, editar, duplicar y eliminar tablas; agregar, editar, importar, exportar y eliminar filas; ejecutar consultas en lenguaje natural; gestionar webhooks.

Crear tablas, editar filas, importar datos, ejecutar consultas y gestionar webhooks están restringidos a owners y admins.

Requisitos previos

• Para responder preguntas en una conversación, un agente de IA debe tener el acceso a datos habilitado y esta tabla asignada (ver Asignar tablas a agentes).
• Las funciones Create with AI y Natural Language Query usan tu proveedor de IA configurado.
• Una tabla debe estar Active e incluir la operación SELECT para poder consultarse.

Límites por plan

Notas:

• El límite de filas aplica tanto por tabla como al total combinado de todas tus tablas.
• El medidor de plan en la lista solo cuenta las tablas activas. Una tabla suspendida conserva sus datos pero no cuenta para tu límite de tablas.

---

Crear una tabla

La lista ofrece tres formas de crear una tabla.

Create Table (manual)

1. Pulsa Create Table.
2. Completa el formulario.
3. Pulsa Create Table.

Campos del formulario

Cada campo del esquema tiene un field name, una label amigable opcional, un type y una casilla Optional. Marca un campo como Optional para permitir que quede vacío; de lo contrario será obligatorio al agregar una fila. En Allowed Operations, SELECT viene preseleccionado.

Tipos de campo disponibles

Use a template

Elige un esquema predefinido, revisa sus campos, ajusta el nombre visible, el nombre de tabla y la descripción, y pulsa Create table. Plantillas disponibles:

Create with AI

1. Pulsa Create with AI.
2. Describe los datos que quieres guardar, por ejemplo: "Necesito una tabla para tarifas de envío con origen, destino, rangos de peso y precios."
3. Revisa las tarjetas de esquema sugeridas. Puedes editar campos y tipos, o enviar un mensaje de seguimiento para refinarlas.
4. Pulsa Create en una tarjeta, o Create All cuando se sugiera más de una tabla.

---

Ver y gestionar datos

Ruta: /app/\{tenant\}/sql-tables/\{id\}

Abre una tabla desde la lista (View Data) para ver sus filas y las acciones disponibles en el encabezado.

Acciones del encabezado

El encabezado también muestra el número de filas, las operaciones permitidas de la tabla y una vista Schema desplegable con cada campo y su tipo.

Explorador de filas

Agregar o editar una fila

El formulario genera un campo por cada columna del esquema. Comportamiento por tipo:

• NUMBER: acepta decimales (ej: 99.99).
• BOOLEAN: selector Sí / No.
• DATE: selector de fecha.
• TIMESTAMP: selector de fecha y hora.

Los campos marcados como Optional pueden quedar vacíos. Editar una fila guarda tus cambios; eliminar una fila es permanente.

---

Import CSV

Importa filas desde una exportación de hoja de cálculo en cuatro pasos: Upload, Map columns, Preview, Result.

1. Upload — elige un archivo .csv. Se requiere una fila de encabezado. Tamaño máximo 5 MB; hasta 50,000 filas por archivo.
2. Map columns — el asistente empareja automáticamente las columnas de tu archivo con los campos de la tabla. Ajusta cualquier emparejamiento o marca un campo como Don't import. Las columnas que no asignes se ignoran.
3. Preview — muestra las primeras filas con estado válido / omitido. Las filas con valores inválidos (por ejemplo, texto no numérico en un campo NUMBER) se omiten.
4. Result — un resumen de filas importadas y omitidas.

Tratamiento de valores durante la importación:

Export CSV

Pulsa Export CSV para descargar todas las filas de la tabla como archivo CSV en UTF-8, listo para abrir en Excel o Google Sheets.

---

Webhooks de filas

Los owners y admins pueden notificar a un sistema externo cada vez que cambia una fila. Pulsa Webhooks en el detalle de la tabla.

Al crear un webhook se muestra una clave de firma (signing secret) una sola vez y nunca más: guárdala de inmediato. Cada solicitud incluye un encabezado X-Helios-Signature (HMAC-SHA256 sobre el cuerpo sin procesar) y un encabezado X-Helios-Timestamp, para que tu endpoint pueda verificar la autenticidad.

---

Consultas en lenguaje natural

En el detalle de la tabla, escribe una pregunta en español o inglés y Data Tables la responde. Cada consulta se ejecuta sobre una sola tabla.

Preguntas que funcionan bien

No soportado (aún)

• Agrupar por categoría (GROUP BY).

Notas

• Los agregados (SUM, AVG) se calculan sobre un máximo de 500 registros para mayor precisión.
• Los resultados se limitan a 100 filas por consulta.
• Las fechas deben usar formato ISO (YYYY-MM-DD).
• Cada consulta se ejecuta sobre una tabla a la vez; las tablas no se pueden relacionar entre sí.

---

Gestionar tablas desde la lista

Cada tarjeta de tabla ofrece acciones rápidas:

La tarjeta también lista qué agentes están asignados a la tabla.

Editar el esquema

Cuando cambias el esquema en Edit Table, las filas existentes se migran automáticamente para coincidir, con un resumen de confirmación previo:

• Renombrar un campo — los valores se mueven al nuevo nombre de campo.
• Cambiar el tipo de un campo — los valores que no se pueden convertir se conservan tal cual.
• Eliminar un campo — sus datos se pierden.

Eliminar una tabla (desde la Danger Zone en Edit Table, o Delete Table) borra todas las filas y no se puede deshacer.

---

Asignar tablas a agentes

Para que un agente responda preguntas sobre una tabla:

1. Ve a Agents y selecciona el agente.
2. Habilita el acceso a datos en las herramientas del agente.
3. Selecciona las tablas que el agente puede usar.
4. Guarda los cambios.

El agente podrá entonces responder preguntas sobre esas tablas en conversaciones de chat, email o voz.

---

Buenas prácticas

1. Nombres descriptivos: usa nombres visibles y de campo claros para que los agentes entiendan los datos.
2. Nombres de campo en inglés: mantén los nombres internos de campo en inglés para mejor compatibilidad (usa la label amigable para mostrar).
3. Limitar operaciones: habilita INSERT / UPDATE / DELETE solo cuando un agente realmente deba escribir; deja las tablas de solo lectura en SELECT.
4. Descripciones útiles: agrega una descripción que explique para qué sirve la tabla.
5. Tipos correctos: usa NUMBER para valores numéricos y DATE / TIMESTAMP para fechas, para que los agregados y filtros funcionen.
6. Suspender en vez de eliminar: apaga el Active switch para pausar una tabla sin perder sus datos.

---

Notas comunes

"No se encontraron resultados"

• Verifica que la tabla tenga datos.
• Revisa la ortografía de los valores que buscaste.
• Intenta primero una pregunta más simple.

"No pudimos ejecutar esa consulta"

• Reformula la pregunta; agrupar por categoría (GROUP BY) aún no está soportado.
• Asegúrate de que los campos que mencionas existen en el esquema.

El agente no responde sobre la tabla

• Verifica que la tabla esté asignada al agente.
• Verifica que el agente tenga el acceso a datos habilitado.
• Verifica que la tabla esté Active y que sus Allowed Operations incluyan SELECT.

Se omitieron filas del CSV

• Se requiere una fila de encabezado, y los archivos están limitados a 5 MB y 50,000 filas.
• Revisa que los emparejamientos de columnas sean correctos y que las columnas NUMBER / BOOLEAN contengan valores válidos.

---

Captura

Relacionados

• Agentes de IA - Configuración de agentes
• Herramientas y funciones - Herramientas disponibles

---