La API de Conversational Analytics es una herramienta potente que te permite consultar tus datos con lenguaje natural. En esta página, se proporciona orientación sobre cómo formular preguntas efectivas para obtener el resultado ideal. En esta página, se incluyen prácticas recomendadas para las siguientes acciones:
- Hacer preguntas generales
- Haz preguntas de varias partes para obtener análisis más complejos
- Haz preguntas con condiciones de datos
- Solicita la agregación de datos
- Haz preguntas de seguimiento
- Cómo solicitar resultados con formato
Hacer preguntas generales
Cuando hagas preguntas generales, sé específico y proporciona contexto. En lugar de hacer preguntas generales, reduce el alcance incluyendo detalles relevantes, como fechas, categorías específicas o filtros numéricos.
Ejemplo
Pregunta original: "¿Cuántas facturas se crean de forma manual y sistemática cada año?"
Pregunta refinada: "Proporciona un recuento de las facturas creadas de forma manual y sistemática cada año. Suponiendo que se tarda 15 minutos en crear 1 factura manual, también calcula y proporciona un resumen del tiempo total empleado en horas para procesar todas las facturas manuales".
Por qué funciona: La pregunta refinada agrega un requisito de cálculo específico (el tiempo dedicado a las facturas manuales) y especifica un formato de salida, un resumen.
Haz preguntas de varias partes para obtener análisis más complejos
Divide las preguntas complejas en varias partes para ayudar a la API de Conversational Analytics a procesar cada componente con precisión.
Ejemplo
Pregunta original: "¿Cuál es el tiempo de respuesta promedio en días del efectivo contra entrega y la liquidación del pago para cada tipo de cuenta por cobrar (PHA, descuento cooperativo, tarjeta de crédito, medios minoristas)? ¿Qué porcentaje de estas liquidaciones son manuales? Si suponemos que dedicamos 15 minutos a cada cuenta por cobrar que se liquida manualmente, ¿cuánto tiempo dedicamos a la app de efectivo y a la liquidación de cada tipo de cuenta por cobrar cada año?"
Pregunta refinada, parte 1: "¿Cuál es el tiempo de respuesta promedio en días para cada tipo de cuenta por cobrar entre el 2025-05-05 y el 2025-06-01?"
Pregunta refinada, parte 2: "¿Qué porcentaje de las autorizaciones son manuales entre el 2025-05-05 y el 2025-06-01 para cada tipo de ingreso?"
Pregunta refinada, parte 3: "Si suponemos que dedicamos 15 minutos a cada cuenta por cobrar liquidada manualmente, ¿cuánto tiempo dedicamos a la app de efectivo y a la liquidación de cada tipo de cuenta por cobrar cada año?".
Por qué funciona: Hacer las preguntas por separado permite que la API de Conversational Analytics aborde cada métrica específica (tiempo de respuesta promedio, porcentaje de eliminaciones manuales, tiempo total dedicado) con los filtros adecuados para obtener un resultado más preciso.
Haz 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 de números y las categorías específicas. Asegúrate de que la API de Conversational Analytics aplique los filtros correctos (por ejemplo, períodos, los N resultados principales y categorías específicas).
Ejemplos
Las siguientes preguntas 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 promedio respectiva de las facturas pendientes únicamente". En esta pregunta, se especifica claramente el período.
"Proporciona el nombre del cliente, la suma del saldo pendiente, la edad promedio y el tipo de cuenta por cobrar para los registros que tienen una antigüedad superior a 46 días. Limita los resultados a un máximo de 5 registros por saldo pendiente". Esta pregunta especifica la antigüedad del registro, proporciona un límite y requisitos de ordenamiento.
"Proporciona los principales sectores por importe de variación en los saldos de cuentas por cobrar de los clientes, junto con los importes para 2025FP1 en comparación con el cierre del año anterior". Esta pregunta especifica las "principales industrias" y los períodos de comparación.
Solicita 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 promedio") y las dimensiones según las que deseas agregar los datos (por ejemplo, "nombre del cliente", "tipo de cuenta por cobrar" o "sector").
Ejemplo
La siguiente pregunta especifica de manera eficaz requisitos claros para la agregación de datos:
"Proporciona el nombre del cliente, la suma del saldo pendiente, la edad promedio y el tipo de cuenta por cobrar para los registros que tienen más de 46 días".
Haz preguntas de seguimiento
Cuando hagas una pregunta adicional, haz referencia al contexto establecido anteriormente, pero sé explícito sobre los cambios o las adiciones. Por ejemplo, si quieres cambiar un período o un límite, indica claramente los parámetros nuevos.
Ejemplos
Pregunta original: "Proporciona el nombre del cliente, la suma del saldo pendiente, la edad promedio y el tipo de cuenta por cobrar para los registros que tienen más de 46 días. Limita los resultados a un máximo de 5 registros por saldo pendiente".
Pregunta de seguimiento: "Proporciona las métricas anteriores para los registros con una antigüedad superior a 90 días y limita la respuesta a los 10 registros principales".
Por qué funciona: La pregunta de seguimiento especifica claramente los cambios en el filtro "Mayor de" y el límite de resultados, al mismo tiempo que hace referencia a las mismas métricas que la pregunta anterior para brindar contexto.
Cómo solicitar resultados con formato
Cuando haces una pregunta que no especifica un formato de resultados, la API de Conversational Analytics determina el formato más adecuado para los criterios específicos y los términos clave que se proporcionan en la pregunta.
Puedes guiar a la API de Conversational Analytics para que proporcione resultados en los siguientes formatos si incluyes términos clave en tu pregunta:
Cómo guiar a la API de Conversational Analytics para que muestre 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 edad promedio y el tipo de cuenta por cobrar para los registros que tienen más de 46 días".
Cómo guiar a la API de Conversational Analytics para que devuelva resultados como texto
Usar términos clave como "resumen" o hacer una pregunta que solo requiera una respuesta directa guía a la API de Conversational Analytics para proporcionar resultados como texto.
Las siguientes preguntas implican que los resultados deben devolverse en un texto:
"Calcula y proporciona un resumen del tiempo total en horas que se tardó en procesar todas las facturas manuales".
"¿Cuál es el tiempo total que se tardó en procesar las facturas manuales la semana pasada?"
Cómo guiar a la API de Conversational Analytics para que muestre los resultados como un gráfico de líneas
Usar términos clave como "tendencia", "cambio" o "cambio delta" en una pregunta guía a la API de Conversational Analytics para proporcionar resultados como un gráfico de líneas.
Las siguientes preguntas implican que los resultados deben devolverse como un gráfico de líneas:
"¿Cuál es la tendencia mensual de los saldos finales de cada industria en el año 2024?".
"¿Cuál es el cambio diario del delta en la edad promedio de las facturas pendientes del día en comparación con el día anterior entre el 2025-05-02 y el 2025-06-03?"
Cómo guiar a la API de Conversational Analytics para que muestre los resultados como un gráfico de barras o de comparación
El uso de términos clave, como "comparar" y "varianza", guía a la API de Conversational Analytics para proporcionar resultados como un gráfico de barras o de comparación.
La siguiente pregunta implica que los resultados se deben devolver como un gráfico de barras o de comparación:
"Proporciona los principales sectores según el importe de la variación en los saldos de las cuentas por cobrar de los clientes, junto con los importes para 2025FP1, en comparación con el cierre del año anterior".
Los resultados de esta pregunta se mostrarán como un gráfico de barras que muestra la varianza de cada sector.
Recursos adicionales
Para obtener sugerencias adicionales para solucionar problemas y respuestas a preguntas frecuentes, consulta la página Preguntas frecuentes sobre la API de Conversational Analytics.
Para obtener más información sobre los errores de la API y las posibles soluciones, consulta la guía Soluciona problemas de la API de Conversational Analytics.