Guía de redacción de comandos de TabliSync
Propósito
Enseñarte a redactar comandos efectivos para que TabliSync produzca exactamente el resultado que deseas: rápido, consistente y con mínimo retrabajo.
Por qué importa
TabliSync depende de tus instrucciones en lenguaje natural. Comandos vagos o incompletos obligan a la IA a adivinar, aumentando resultados incompletos, incorrectos o genéricos. Intención clara = mejor extracción de tablas, más rápido.
1. Conceptos básicos de comandos
Enfócate en 4 pilares:
ACCIÓN
¿Qué se debe hacer? (eliminar duplicados, calcular, agrupar, pronosticar, visualizar, extraer, formatear)
ALCANCE
¿Qué columnas / filas / hojas / archivos? Usa nombres exactos de columnas entre comillas simples.
CONDICIÓN(ES)
Filtros, umbrales, rangos de fechas, reglas de negocio.
FORMATO DE SALIDA
Nueva hoja, sobrescribir, solo resumen, gráfico, archivo limpio, añadir columna, etc.
Bueno vs malo (ejemplos clave)
| Objetivo | Malo (vago) | Bueno (específico) | Por qué bueno |
|---|---|---|---|
| Quitar duplicados | Arregla mi archivo | Eliminar duplicados por 'Customer ID'; mantener primera ocurrencia; salida como nueva hoja 'Cleaned'. | Especifica columna clave + regla + destino de salida |
| Resumir ventas | Analizar datos | Sumar 'Sales' por 'Region' y 'Quarter'; incluir fila total y orden descendente por Sales. | Agregación + agrupación + orden claros |
| Ordenar datos | Mejóralo | Ordenar por 'Date' ascendente, luego por 'Revenue' descendente; mantener encabezados. | Orden multinivel explícito |
Patrón simple
ACCIÓN + COLUMNAS OBJETIVO + CONDICIONES + TRANSFORMACIÓN + FORMATO DE SALIDA
Example: Ejemplo: Calcular promedio 'Order Value' por 'Channel' últimos 90 días (donde 'Order Date' >= 2025-05-28); salida tabla resumen + gráfico de barras.
2. Ampliar precisión
Usa estas técnicas de redacción:
Sé específico con nombres de columnas
Usa nombres exactos entre comillas simples: 'Customer ID', 'Order Date', 'Revenue'
Define la salida con claridad
Especifica: "Crear nueva hoja 'Results'", "Añadir columna", "Reemplazar datos existentes"
Incluye formato
Añade: "formato porcentaje 2 decimales", "ordenar descendente", "incluir totales"
3. Técnicas avanzadas de comandos
A. Lógica condicional
"Añadir columna 'Status' = SI 'Revenue' > 1000 ENTONCES 'High' SINO 'Low'"
"Filtrar filas donde 'Date' >= 2025-01-01 Y 'Region' EN ('North', 'South')"
B. Combinar tareas en un paso
Encadena operaciones relacionadas cuando el orden sea claro.
Example: Limpiar 'Orders' eliminando duplicados en 'Order ID', rellenar 'Cost' faltante con mediana, añadir 'Margin'=(Revenue-Cost)/Revenue*100, luego crear gráfico de barras de promedio 'Margin' por 'Region'.
C. Gestión de salida
Especifica: "Crear nueva hoja 'Cleaned'", "Reemplazar 'Sheet1' existente", "Añadir gráfico a nueva hoja 'Charts'", "Devolver solo resumen (sin export por filas)".
4. Plantillas de comandos habituales
Copia, adapta y ejecuta. Sustituye los elementos entre corchetes.
Limpieza y preparación
Análisis
Visualización
Transformación
Pronóstico
Operaciones multiarchivo
5. Galería de comandos buenos vs malos
| Escenario | Malo | Mejorado | Óptimo |
|---|---|---|---|
| Limpieza | Arregla esto | Eliminar duplicados | Eliminar duplicados en 'Order ID', rellenar 'Cost' nulo con mediana, estandarizar 'Date' a YYYY-MM-DD, salida nueva hoja 'Cleaned'. |
| Análisis | Analizar ventas | Sumar ventas | Sumar 'Sales' por 'Region' y 'Quarter'; incluir crecimiento vs trimestre anterior y ordenar por 'Sales' desc. |
| Visualización | Hacer gráfico | Gráfico de barras productos | Gráfico de barras: x='Product', y='Sales', solo top 15, ordenado desc, título 'Top 15 Products', nueva hoja 'Charts'. |
6. Solución de problemas y refinamiento
Síntoma → Acción:
Plantilla de bucle de refinamiento
7. Tu primer comando de práctica
Sube una exportación de ventas reciente y ejecuta:
Eliminar duplicados en 'Order ID'; rellenar 'Unit Cost' faltante con mediana; añadir 'Gross Margin %'=(Revenue-Cost)/Revenue*100 formato porcentaje 1 decimal; crear gráfico de barras promedio 'Gross Margin %' por 'Region' ordenado descendente; colocar gráfico en nueva hoja 'Charts'.
Refina desde ahí: ya escribes como un usuario avanzado.