La API Conversational Analytics es una herramienta potente que te permite consultar tus datos usando lenguaje natural. En esta página se explica cómo formular preguntas eficaces para obtener los resultados ideales. En esta página se incluyen prácticas recomendadas para las siguientes acciones:
- Hacer preguntas generales
- Hacer preguntas de varias partes para obtener análisis más complejos
- Hacer preguntas con condiciones de datos
- Pedir la agregación de datos
- Haz preguntas complementarias
- Pedir resultados con formato
Hacer preguntas generales
Cuando hagas preguntas generales, sé específico y proporciona contexto. En lugar de hacer preguntas generales, acota el tema incluyendo detalles relevantes, como fechas, categorías específicas o filtros numéricos.
Ejemplo
Pregunta original: "¿Cuántas facturas se crean manualmente y sistemáticamente cada año?"
Pregunta refinada: "Proporciona un recuento de las facturas creadas manualmente y de forma sistemática cada año. Suponiendo que se tarda 15 minutos en crear una factura manual, calcula y proporciona un resumen del tiempo total empleado en horas para procesar todas las facturas manuales".
Por qué funciona: la pregunta refinada añade un requisito de cálculo específico (el tiempo dedicado a las facturas manuales) y especifica un formato de salida, un resumen.
Hacer preguntas de varias partes para llevar a cabo análisis más complejos
Divide las preguntas complejas en varias partes para ayudar a la API Conversational Analytics a procesar cada componente con precisión.
Ejemplo
Pregunta original: "¿Cuál es el plazo medio en días de la liquidación de efectivo a la entrega y del pago de cada tipo de cuenta por cobrar (PHA, reembolso cooperativo, tarjeta de crédito, medios de retail) y qué porcentaje de estas liquidaciones son manuales? Si dedicamos 15 minutos a cada cobro liquidado manualmente, ¿cuánto tiempo dedicamos a la aplicación de efectivo y a la liquidación de cada tipo de cobro al año?"
Pregunta perfeccionada (parte 1): "¿Cuál es el plazo medio en días de cada tipo de cuenta por cobrar entre el 5 de mayo del 2025 y el 1 de junio del 2025?"
Pregunta refinada, parte 2: "¿Qué porcentaje de liquidaciones son liquidaciones manuales entre el 05/05/2025 y el 01/06/2025 para cada tipo de cobro?"
Pregunta perfeccionada, parte 3: "Si dedicamos 15 minutos a cada cobro liquidado manualmente, ¿cuánto tiempo dedicamos a la aplicación de efectivo y a la liquidación de cada tipo de cobro al año?"
Por qué funciona: al hacer las preguntas por separado, la API Conversational Analytics puede abordar cada métrica específica (tiempo de respuesta medio, porcentaje de cancelaciones manuales y tiempo total empleado) con los filtros adecuados para obtener resultados más precisos.
Hacer preguntas con condiciones de datos
Cuando hagas preguntas con condiciones de datos, indica claramente todos los filtros y las condiciones necesarios en la pregunta, incluidas las fechas exactas, los límites numéricos y las categorías específicas. Asegúrate de que la API Conversational Analytics aplique los filtros correctos (por ejemplo, intervalos de fechas, los N resultados principales o categorías específicas).
Ejemplos
En las siguientes preguntas se especifican correctamente los criterios de filtro:
"Muéstrame la fecha de la factura del 2025-05-02 al 2025-06-03 junto con la antigüedad media de las facturas pendientes". En esta pregunta se especifica claramente el periodo.
"Proporciona el nombre del cliente, la suma del saldo pendiente, la antigüedad media y el tipo de cobro de los registros que tengan una antigüedad superior a 46 días. Limita los resultados a 5 registros por saldo pendiente". Esta pregunta especifica la antigüedad del registro, proporciona un límite y establece requisitos de ordenación.
"Indica los sectores principales por importe de variación en los saldos de las cuentas por cobrar de los clientes, junto con los importes del primer periodo fiscal del 2025 en comparación con el cierre del año anterior". En esta pregunta se especifican los sectores principales y los periodos que se van a comparar.
Solicitar la agregación de datos
Cuando hagas preguntas para agregar datos, especifica el tipo de agregación (por ejemplo, "suma del saldo pendiente" o "edad media") y las dimensiones por las que quieres agregar los datos (por ejemplo, "nombre del cliente", "tipo de cuenta por cobrar" o "sector").
Ejemplo
La siguiente pregunta especifica claramente los requisitos de la agregación de datos:
"Proporciona el nombre del cliente, la suma del saldo pendiente, la antigüedad media y el tipo de cobro de los registros que tengan una antigüedad superior a 46 días".
Hacer preguntas complementarias
Cuando hagas una pregunta de seguimiento, haz referencia al contexto establecido anteriormente, pero sé explícito sobre los cambios o las adiciones. Por ejemplo, si quieres cambiar un intervalo de fechas o un límite, indica claramente los nuevos parámetros.
Ejemplos
Pregunta original: "Proporciona el nombre del cliente, la suma del saldo pendiente, la edad media y el tipo de cobro de los registros que tengan más de 46 días. Limita los resultados a 5 registros por saldo pendiente".
Pregunta de seguimiento: "Proporciona las métricas anteriores de los registros de más de 90 días y limita los resultados a los 10 primeros registros".
Por qué funciona: La pregunta de seguimiento especifica claramente los cambios en el filtro "Antigüedad superior a" y el límite de resultados, al tiempo que hace referencia a las mismas métricas que la pregunta anterior para contextualizar.
Pedir resultados formateados
Cuando haces una pregunta en la que no se especifica un formato de resultados, la API Conversational Analytics determina el formato que mejor se adapta a los criterios específicos y a los términos clave que se proporcionan en la pregunta.
Puedes indicar a la API Conversational Analytics que proporcione resultados en los siguientes formatos incluyendo términos clave en tu pregunta:
Indicar a la API Conversational Analytics que devuelva los resultados en una tabla
La siguiente pregunta implica que los resultados deben devolverse en formato de tabla, ya que especifica los nombres de las columnas de dimensión y métrica:
"Proporciona el nombre del cliente, la suma del saldo pendiente, la antigüedad media y el tipo de cobro de los registros que tengan una antigüedad superior a 46 días".
Indicar a la API Conversational Analytics que devuelva los resultados como texto
Si usas términos clave como "resumen" o haces una pregunta que solo requiera una respuesta directa, la API Conversational Analytics te proporcionará los resultados en formato de texto.
Las siguientes preguntas implican que los resultados deben devolverse en un texto:
"Calcula y proporciona un resumen del tiempo total empleado en horas para procesar todas las facturas manuales".
"¿Cuánto tiempo se ha tardado en procesar las facturas manuales durante la última semana?"
Indicar a la API Conversational Analytics que devuelva los resultados en forma de gráfico de líneas
Si usas términos clave como "tendencia", "cambio" o "cambio delta" en una pregunta, la API Conversational Analytics te proporcionará los resultados en forma de gráfico de líneas.
Las siguientes preguntas implican que los resultados deben devolverse como un gráfico lineal:
"¿Cuál es la tendencia mensual de los saldos finales de cada sector en el año 2024?"
"¿Cuál es la variación diaria del tiempo medio de las facturas pendientes entre el 2 de mayo y el 3 de junio del 2025?"
Indicar a la API Conversational Analytics que devuelva los resultados en forma de gráfico de barras o de comparación
Si usas términos clave como "comparar" y "varianza", la API Conversational Analytics te proporcionará los resultados en forma de gráfico de barras o de comparación.
La siguiente pregunta implica que los resultados deben mostrarse en un gráfico de barras o de comparación:
"Indica los sectores principales por importe de variación en los saldos de las cuentas por cobrar de los clientes, junto con los importes del primer trimestre del año fiscal 2025, en comparación con el cierre del año anterior".
Los resultados de esta pregunta se mostrarán en un gráfico de barras que muestra la varianza de cada sector.
Recursos adicionales
Para obtener más consejos sobre cómo solucionar problemas y respuestas a preguntas frecuentes, consulta la página Preguntas frecuentes sobre la API Conversational Analytics.
Para obtener más información sobre los errores de la API y las posibles soluciones, consulta la guía Solucionar problemas de la API Conversational Analytics.