Datos e informes

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.

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 para mantener un formato de informe consistente, y a horario para ejecutarlo regularmente. Para obtener una vista del espacio de trabajo útil de forma continua, consulte Cuadros de mando.

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.