Auditoría de Excel impulsada por IA en C#: Detectar errores y anomalías de datos

Los libros de Excel pueden contener valores faltantes, registros duplicados, números inusuales y fórmulas inconsistentes que son difíciles de detectar manualmente, especialmente cuando se trabaja con grandes conjuntos de datos.

Con un agente de IA, estos problemas se pueden identificar mediante instrucciones de auditoría en lenguaje natural en lugar de depender por completo de reglas de validación codificadas de forma rígida. Este artículo muestra cómo usar Spire.Agent.Office en C# para auditar un libro de Excel, identificar posibles problemas de datos y fórmulas, resaltar celdas sospechosas y generar un informe de auditoría estructurado.

1. ¿Qué es una auditoría de Excel con IA?

Una auditoría tradicional de Excel suele basarse en reglas de validación predefinidas, fórmulas o código personalizado. Por ejemplo, un programa puede comprobar si una celda obligatoria está vacía, si un valor supera un umbral fijo o si existen ID duplicados en una columna.

Una auditoría de Excel con IA añade análisis contextual a este proceso. En lugar de definir todas las condiciones posibles en el código, puede describir los requisitos de auditoría en lenguaje natural y dejar que el agente de IA examine el libro en busca de patrones e inconsistencias.

Por ejemplo, se puede indicar a un agente de IA que busque:

• Datos faltantes o incompletos
• Registros duplicados o sospechosos
• Valores numéricos inusuales o atípicos
• Patrones de datos inconsistentes
• Fórmulas faltantes
• Fórmulas que difieren inesperadamente de las filas cercanas
• Resultados de cálculo o referencias de celda sospechosos

Esto es especialmente útil para problemas que son difíciles de expresar como reglas fijas simples. Un valor puede estar dentro de un rango numérico aceptable pero aun así parecer inusual en comparación con los registros circundantes, mientras que una fórmula puede producir un resultado válido pero usar un patrón que difiere de las celdas vecinas.

Los hallazgos de auditoría generados por IA generalmente deben tratarse como posibles problemas en lugar de errores definitivos. Los resultados se pueden resaltar en el libro y resumir en un informe de auditoría para su revisión posterior.

2. Configurar el proyecto de C#

Cree una nueva aplicación de consola de C# y agregue el paquete Spire.Agent.Office requerido al proyecto.

El ejemplo utiliza los siguientes espacios de nombres:

using Spire.Agent.Office.AI;
using Spire.Agent.Office.Extensions;
using Spire.Xls;

El acceso a la funcionalidad de IA requiere un token de Spire válido. Puede solicitar un token de prueba temporal a través de la página de licencia temporal de Spire.

La configuración básica es:

AIOptions options = new AIOptions();
options.SpireToken = "YOUR_SPIRE_TOKEN";

Los ejemplos a continuación utilizan un libro de Excel llamado:

SalesData.xlsx

El libro puede contener una o varias hojas de cálculo con registros de ventas, fórmulas, fechas, cantidades, precios, descuentos u otros datos comerciales.

3. Preparar el libro de Excel para la auditoría

El primer paso es cargar el libro con Workbook.

Workbook workbook = new Workbook();
workbook.LoadFromFile("SalesData.xlsx");

Como el libro se pasa directamente al procesador de documentos habilitado para IA, no es necesario convertir manualmente cada hoja de cálculo, valor de celda o fórmula a texto sin formato.

El agente puede trabajar con la hoja de cálculo como un documento de Office estructurado e inspeccionar información como:

• Contenido de la hoja de cálculo
• Valores de celda
• Fórmulas
• Filas y columnas
• Patrones de datos
• Relaciones entre celdas cercanas

Por ejemplo, una hoja de cálculo de ventas podría contener datos similares a los siguientes:

La última fila puede merecer atención porque un descuento del 80% es significativamente diferente de los registros circundantes.

Otros posibles problemas podrían incluir ID de pedido duplicados, fechas faltantes, cantidades inusuales o una fórmula que difiere de las fórmulas utilizadas en las filas vecinas.

4. Crear un agente de IA para auditar libros de Excel

La parte principal del flujo de trabajo es definir la tarea de auditoría.

En lugar de escribir manualmente condiciones de C# separadas para cada posible error, los requisitos se pueden describir mediante una instrucción en lenguaje natural.

Definir reglas e instrucciones de auditoría

Por ejemplo:

string instruction = @"
Audit this Excel workbook for potential data quality and formula issues.

Check for:
- Missing or incomplete values
- Duplicate records
- Unusual or suspicious numeric values
- Inconsistent data patterns
- Missing formulas
- Formulas that differ unexpectedly from nearby rows
- Suspicious cell references or calculation results

Do not modify valid source data.

For every detected issue, record:
- Worksheet name
- Cell or range
- Issue type
- Explanation

Highlight problematic cells and create a new worksheet named
'Audit Report' containing the audit results.
";

La instrucción define tanto qué debe inspeccionar el agente como cómo deben presentarse los resultados .

Esto es útil porque la auditoría de hojas de cálculo a menudo depende del contexto. Un valor de 80 puede ser completamente normal en una columna pero muy inusual en otra. El agente puede evaluar el valor junto con los registros cercanos y el significado de los datos.

Analizar patrones de datos y fórmulas

Después de cargar el libro y configurar las opciones de IA, cree un procesador de documentos de IA a partir del libro:

AIDocumentProcessor processor = workbook.AI(options);

Luego envíe la instrucción de auditoría al agente:

processor.ExecuteInstruction(
    workbook,
    instruction,
    "AuditedSalesData.xlsx",
    Array.Empty<string>()
);

Por lo tanto, el código central completo es muy corto:

using Spire.Agent.Office.AI;
using Spire.Agent.Office.Extensions;
using Spire.Xls;

string inputPath = "SalesData.xlsx";
string outputPath = "AuditedSalesData.xlsx";
string spireToken = "YOUR_SPIRE_TOKEN";

Workbook workbook = new Workbook();
workbook.LoadFromFile(inputPath);

AIOptions options = new AIOptions();
options.SpireToken = spireToken;

string instruction = @"
Audit this Excel workbook for potential data quality and formula issues.

Check for missing values, duplicate records, unusual numeric values,
inconsistent data patterns, missing formulas, formulas that differ
unexpectedly from nearby rows, and suspicious calculation results.

Do not modify valid source data.

Highlight cells containing potential issues and create a worksheet named
'Audit Report' with the following columns:

Worksheet | Cell | Issue | Explanation
";

AIDocumentProcessor processor = workbook.AI(options);

processor.ExecuteInstruction(
    workbook,
    instruction,
    outputPath,
    Array.Empty<string>()
);

En comparación con un programa de validación de Excel convencional, la mayor parte de la lógica de auditoría se expresa mediante la instrucción en lugar de una larga serie de sentencias if.

Devolver resultados de auditoría estructurados

Es importante indicar al agente cómo deben organizarse los resultados de la auditoría.

Por ejemplo:

Worksheet | Cell | Issue | Explanation

Un informe de auditoría generado puede verse así:

Los resultados estructurados facilitan la revisión de la auditoría y también se pueden utilizar para el procesamiento automatizado posterior.

5. Resaltar los problemas detectados y generar un informe de auditoría

Devolver simplemente una descripción textual de los problemas de la hoja de cálculo es útil, pero una auditoría es mucho más fácil de revisar cuando los hallazgos se escriben de nuevo en el propio libro.

La instrucción puede pedir al agente que realice dos acciones:

string outputInstruction = @"
Highlight every cell that contains a potential issue.

Create an 'Audit Report' worksheet and list every issue using these columns:

Worksheet | Cell | Issue | Explanation

Do not change cells that do not contain an identified issue.
";

Esto produce dos niveles de salida: hallazgos resaltados en la hoja de cálculo original y un informe centralizado que contiene explicaciones detalladas.

Revisar los problemas resaltados en la hoja de cálculo original

En la hoja de cálculo original, el agente resalta las celdas que contienen posibles problemas. Los hallazgos del mismo tipo usan el mismo color de resaltado, lo que facilita distinguir valores faltantes, registros duplicados, números inusuales, datos inconsistentes y problemas relacionados con fórmulas.

Figura 1. Posibles problemas resaltados en la hoja de cálculo original. Se utiliza el mismo color para los hallazgos del mismo tipo.

En este ejemplo, el agente identificó varios tipos de problemas, incluido el descuento inusualmente alto en G6, el valor atípico de cantidad en E10, la fecha de pedido faltante en B17, el precio unitario negativo en F23 y problemas relacionados con fórmulas en la columna Total.

Al escribir los hallazgos de nuevo en sus ubicaciones originales, el agente permite a los usuarios revisar los valores sospechosos en contexto en lugar de buscarlos manualmente.

Revisar el informe de auditoría detallado

Además de resaltar los datos de origen, el agente crea una hoja de cálculo Audit Report que enumera la celda afectada, el tipo de problema y la explicación de cada hallazgo.

Figura 2. El informe de auditoría generado proporciona la ubicación, el tipo y la explicación de cada problema detectado.

El informe incluye hallazgos como valores faltantes, ID de pedido duplicados, valores numéricos inusuales, patrones de datos inconsistentes, fórmulas faltantes y resultados de cálculo sospechosos.

Por ejemplo, el agente detectó que:

• A8 y A13 contienen el mismo ID de pedido.
• G6 contiene un descuento del 80%, que es significativamente mayor que los otros descuentos.
• H13 contiene un valor codificado de forma rígida en lugar del patrón de fórmula utilizado en las filas cercanas.
• H19 usa suma en lugar de resta al aplicar el descuento.
• H30 produce un total que no coincide con el cálculo esperado.

Una sola celda puede aparecer más de una vez en el informe cuando involucra múltiples dimensiones de auditoría. Por ejemplo, H25 puede informarse tanto como valor faltante como fórmula faltante.

Los hallazgos generados por IA deben tratarse como posibles problemas en lugar de errores definitivos. Algunos valores inusuales pueden representar excepciones comerciales legítimas. Por lo tanto, la hoja de cálculo resaltada y el informe de auditoría proporcionan un punto de partida estructurado para la revisión humana en lugar de cambiar automáticamente los datos subyacentes.

6. Buenas prácticas para la auditoría de Excel con IA

La auditoría basada en IA funciona especialmente bien cuando se utiliza junto con requisitos de auditoría claros.

Primero, proporcione suficiente contexto en la instrucción. En lugar de pedirle al agente que simplemente "encuentre errores", especifique los tipos de problemas que importan, como registros duplicados, valores anómalos, fórmulas faltantes o cálculos inconsistentes.

Segundo, distinga entre reglas deterministas y análisis contextual. Condiciones como "La cantidad nunca debe ser negativa" se pueden comprobar de forma fiable con reglas convencionales. La IA es más útil para situaciones como identificar un valor que parece inconsistente con los registros circundantes o reconocer un patrón de fórmula inesperado.

Tercero, evite pedirle al agente que corrija automáticamente cada problema detectado. Un valor sospechoso no es necesariamente un valor incorrecto. Resaltar la celda y explicar el motivo brinda a los usuarios la oportunidad de verificar el hallazgo antes de realizar cambios.

Para libros grandes, la auditoría también se puede limitar a hojas de cálculo específicas o categorías de problemas. Esto hace que la tarea sea más específica y puede reducir el procesamiento innecesario.

Finalmente, haga que la salida sea estructurada. Incluir la hoja de cálculo, la ubicación de la celda, el tipo de problema y la explicación hace que los hallazgos generados por IA sean más fáciles de verificar e integrar en flujos de trabajo posteriores.

7. Conclusión

La auditoría de hojas de cálculo a menudo implica más que comprobar si las celdas están vacías o si las fórmulas devuelven errores. Muchos problemas solo se hacen visibles cuando se consideran juntos los valores, las fórmulas y los patrones de datos circundantes.

Con un SDK de Agente de IA, estos requisitos de auditoría se pueden describir en lenguaje natural en lugar de implementarse por completo mediante reglas de validación codificadas de forma rígida.

Al usar Spire.Agent.Office en C#, el flujo de trabajo puede seguir siendo relativamente sencillo: cargar el libro de Excel, definir los requisitos de auditoría, ejecutar la instrucción y generar un nuevo libro que contenga los problemas resaltados y un informe de auditoría estructurado.

Este enfoque es especialmente útil para detectar posibles anomalías, fórmulas inconsistentes, registros duplicados, información faltante y otros problemas de hojas de cálculo que pueden requerir análisis contextual.

8. Preguntas frecuentes

¿Puede la IA detectar fórmulas incorrectas en Excel?

La IA puede identificar fórmulas que parecen inconsistentes con las fórmulas cercanas, contienen referencias sospechosas o producen resultados que no coinciden con los patrones de datos esperados. Sin embargo, si una fórmula es lógicamente correcta puede depender de las reglas de negocio detrás del libro, por lo que los problemas detectados aún deben revisarse.

¿Se pueden personalizar las reglas de auditoría?

Sí. Los requisitos de auditoría se definen principalmente a través de la instrucción enviada al agente. Puede agregar reglas para columnas específicas, hojas de cálculo, rangos de valores, fórmulas o condiciones comerciales.

Por ejemplo:

"Flag discounts above 50% and orders with a missing customer ID."

¿Puede la IA detectar registros duplicados de Excel?

Sí. Se puede indicar al agente que identifique ID duplicados, filas repetidas o registros potencialmente duplicados basados en múltiples campos.

Para una detección de duplicados más determinista, la lógica convencional de Excel o C# también se puede combinar con la auditoría de IA.

¿Puede la IA corregir automáticamente los errores detectados?

Se puede indicar al agente que modifique el contenido del libro, pero normalmente no se recomienda corregir automáticamente todas las anomalías detectadas. Algunos valores inusuales pueden ser excepciones comerciales válidas.

Un flujo de trabajo más seguro es resaltar las celdas sospechosas, explicar por qué se marcaron y permitir que los usuarios revisen los hallazgos antes de aplicar correcciones.

¿Se puede usar el mismo enfoque para diferentes tipos de archivos de Excel?

Sí. El mismo flujo de trabajo se puede adaptar a informes de ventas, hojas de cálculo financieras, registros de inventario, informes operativos, datos de encuestas y otros libros de Excel estructurados. En la mayoría de los casos, solo es necesario ajustar la instrucción de auditoría para los datos y las reglas de negocio específicos.

Véase también

• Redacción de documentos con IA en C#: conservar el formato
• Formato, resumen e indexación de Word con IA en C#
• Traductor de documentos con IA: traducir archivos de Word, Excel y PowerPoint en C#