# Datos e informes

Convierta los registros comerciales y los archivos fuente en respuestas útiles, con una ruta clara de regreso a la evidencia.

Source: https://docs.opser.com/es/capabilities/data/

## Trabajar con información estructurada
Pídale al agente que busque, compare, resuma o actualice los datos en las aplicaciones a las que pueda acceder. Identifique la aplicación y los filtros útiles, como el rango de fechas, el propietario, el cliente o el estado.

> En Ventas, resume los pedidos confirmados que vencen el próximo mes por cliente y moneda. Incluye enlaces de pedido y órdenes de bandera sin fecha de entrega.

Para los datos fuera de una aplicación instalada, la capacidad de datos de la plataforma puede funcionar con entidades y registros estructurados. Cuando necesite una interfaz de usuario reutilizable en torno a esa información, considere [aplicación interna](https://docs.opser.com/es/capabilities/internal-apps/).

## Registros de las apps y conjuntos de datos del usuario

Las apps son dueñas de sus mesas y reglas de negocio. Use sus herramientas compatibles u operaciones expuestas para esos registros. La herramienta de datos de la plataforma administra los conjuntos de datos comerciales propiedad del usuario por separado: entidades, campos, relaciones, registros y sus configuraciones de acceso.

El agente puede inspeccionar un conjunto de datos existente, definir una estructura, importar registros y consultarlo para su análisis. Los informes SQL admitidos son de solo lectura y están limitados a los datos comerciales permitidos. No es una interfaz de consulta sin restricciones en las tablas privadas de aplicaciones o plataformas.

## Crear un informe
Especifique la audiencia, el intervalo de fechas, la agrupación y el formato de salida. Pida referencias de fuentes o enlaces de registro para que pueda verificar el resultado. Mantenga las monedas y unidades explícitas.

1. Confirme qué registros se incluyen y excluyen.
2. Compruebe las reglas de agrupación y cálculo.
3. Inspeccione una muestra de los registros subyacentes.
4. Elija un resultado útil: un resumen de conversación, una hoja de cálculo, una presentación o un panel.

Los datos faltantes deben ser visibles en el resultado. Pídale al agente que marque la incertidumbre en lugar de llenar vacíos con suposiciones.

## Haga los cambios con cuidado
Separar el análisis exploratorio de las actualizaciones masivas. Pida una vista previa que identifique los registros afectados, luego revísela antes de autorizar el cambio. Los permisos y las reglas de aprobación específicas de la herramienta aún se aplican.

> Muéstrame los contactos con nombres de empresas desaparecidos. Sugiere coincidencias usando sus dominios de correo electrónico, pero espera mi revisión antes de guardar los cambios.

## Informes reproducibles
Utilice un [habilidad](https://docs.opser.com/es/agents/skills/) para mantener un formato de informe consistente, y a [horario](https://docs.opser.com/es/agents/automations/) para ejecutarlo regularmente. Para obtener una vista del espacio de trabajo útil de forma continua, consulte [Cuadros de mando](https://docs.opser.com/es/capabilities/dashboards/).


## Descubrir tablas y columnas sin resultados truncados

La acción `data.describe_schema` del agente devuelve un inventario de tablas en páginas de 25 elementos (hasta 50). Usa `search` para filtrar nombres y sigue `next_input` hasta que sea null. Indica `entityId` para consultar los nombres exactos de las columnas de una tabla; sus campos también se paginan. Así evitas suponer nombres como `sort_order` cuando la columna real es `position`. Se mantienen los controles de acceso a aplicaciones y datos de la persona y del agente.

La acción `list_data` de Dashboard ofrece el mismo flujo con `limit`, `offset`, `search` y `next_input`. Los recuentos exactos requieren `include_record_count: true` (`includeRecordCount` en la herramienta data); la consulta normal no los calcula. Estos controles pertenecen a las herramientas, no cambian Configuración → Datos.

## Límites de los informes SQL

`raw_sql` acepta una sola consulta SELECT o WITH de solo lectura, con etiquetas literales, UNION/UNION ALL, DISTINCT, agregaciones y conversiones aprobadas. Los resultados se limitan a 500 filas y la consulta tiene un plazo de 15 segundos. Solo se permiten tablas empresariales que la persona y el agente solicitante puedan leer. Los informes no modifican registros ni conceden acceso a tablas privadas o de la plataforma.

Las proyecciones de texto incluyen `strpos`, `position`, `regexp_matches`, `regexp_replace`, `lower`, `substring` y `split_part`. La inspección JSON incluye `jsonb_object_keys`, `json_object_keys`, extracción JSON y longitud de arrays JSON. Usa las funciones de expansión de claves en SELECT; las funciones en FROM y las llamadas calificadas por esquema siguen sin admitirse. Los errores de funciones no admitidas enumeran las permitidas. Las funciones arbitrarias y las conversiones inseguras siguen prohibidas.

Para buscar menciones exactas de una persona, usa regex parametrizadas con límites de palabra en lugar de búsquedas amplias por subcadena: por ejemplo, `regexp_matches(note, ?, 'i')` con `params: ["\\mPier\\M"]`. Examina primero el esquema, selecciona solo las columnas necesarias y usa un límite pequeño. Una subcadena como `mark` también aparece en `marketing`; SQL no decide automáticamente si una mención identifica a la persona buscada.