La API de Conversational Analytics es una herramienta potente que te permite consultar tus datos con lenguaje natural. En esta página, se proporcionan instrucciones para formular preguntas efectivas que permitan obtener el resultado ideal. 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
- Solicitar la agregación de datos
- Hacer preguntas de seguimiento
- Solicitar resultados con formato
Hacer preguntas generales
Cuando hagas preguntas generales, sé específico y proporciona contexto. En lugar de hacer preguntas amplias, reduce el alcance incluyendo detalles relevantes, como fechas, categorías específicas o filtros numéricos.
Un agente de datos que usa una fuente de datos de Looker puede hacer preguntas de seguimiento para aclarar cualquier ambigüedad en la consulta original. Por ejemplo, si hay varios campos con nombres similares, el agente de datos puede pedirte que aclares qué campo es el más adecuado para usar en el procesamiento de tu consulta. Estas preguntas aparecerán en una respuesta Clarification Needed.
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 tardan 15 minutos en crear 1 factura manual, calcula y proporciona un resumen del tiempo total en horas que se tarda en procesar todas las facturas manuales".
Por qué funciona: La pregunta refinada agrega un requisito de cálculo específico (tiempo dedicado a las facturas manuales) y especifica un formato de salida, un resumen.
Hacer 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 compensación de pagos para cada tipo de cuenta por cobrar (PHA, reembolso de cooperativa, tarjeta de crédito, medios minoristas) y qué porcentaje de estos son compensaciones manuales? Suponiendo que dedicamos 15 minutos a cada cuenta por cobrar compensada manualmente, ¿cuánto tiempo dedicamos a la app de efectivo y a la compensación para 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 el tipo de cuenta por cobrar entre el 5 de mayo de 2025 y el 1 de junio de 2025?"
Pregunta refinada, parte 2: "¿Qué porcentaje de las compensaciones son compensaciones manuales entre el 5 de mayo de 2025 y el 1 de junio de 2025 para cada tipo de cuenta por cobrar?"
Pregunta refinada, parte 3: "Suponiendo que dedicamos 15 minutos a cada cuenta por cobrar compensada manualmente, ¿cuánto tiempo dedicamos a la app de efectivo y a la compensación para 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 compensaciones manuales, tiempo total dedicado) con los filtros adecuados, para obtener un resultado más preciso.
Hacer preguntas con condiciones de datos
Cuando hagas preguntas con condiciones de datos, indica claramente todos los filtros y las condiciones necesarios en tu pregunta, incluidas las fechas exactas, los límites numéricos y las categorías específicas. Asegúrate de que la API de Conversational Analytics aplique los filtros correctos (períodos, los N resultados principales, categorías específicas, por ejemplo).
Ejemplos
En las siguientes preguntas, se especifican correctamente los criterios de filtro:
"Muéstrame la fecha de la factura desde el 2 de mayo de 2025 hasta el 3 de junio de 2025 junto con la antigüedad promedio respectiva de las facturas pendientes solamente". En esta pregunta, se especifica claramente el período.
"Proporciona el nombre del cliente, la suma del saldo pendiente, la antigüedad promedio y el tipo de cuenta por cobrar para los registros que tienen más de 46 días. Limita los resultados a 5 registros según el saldo pendiente". En esta pregunta, se especifica la antigüedad del registro, se proporciona un límite y se proporcionan requisitos de ordenamiento.
"Proporciona los sectores principales por importe de variación en los saldos de las cuentas por cobrar de los clientes junto con los importes del 2025FP1 en comparación con el cierre del año anterior". En esta pregunta, se especifican los "sectores principales" y los períodos para la comparación.
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 "antigüedad promedio") y las dimensiones por las que deseas agregar (por ejemplo, "nombre del cliente", "tipo de cuenta por cobrar" o "sector").
Ejemplo
En la siguiente pregunta, se especifican de manera efectiva requisitos claros para la agregación de datos:
"Proporciona el nombre del cliente, la suma del saldo pendiente, la antigüedad promedio y el tipo de cuenta por cobrar para los registros que tienen más de 46 días".
Hacer preguntas de seguimiento
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 deseas 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 antigüedad promedio y el tipo de cuenta por cobrar para los registros que tienen más de 46 días. Limita los resultados a 5 registros según el saldo pendiente".
Pregunta de seguimiento: "Proporciona las métricas anteriores para los registros que tienen más de 90 días y limita los resultados a los 10 registros principales".
Por qué funciona: En la pregunta de seguimiento, se especifican claramente los cambios en el filtro "más de" y el límite de resultados, mientras que se hace referencia a las mismas métricas que en la pregunta anterior para el contexto.
Solicitar resultados con formato
Cuando haces una pregunta en la que no se especifica un formato de resultados, la API de 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 guiar a la API de Conversational Analytics para que proporcione resultados en los siguientes formatos incluyendo 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 mostrarse en formato de tabla, ya que especifica nombres de columnas de dimensiones y métricas:
"Proporciona el nombre del cliente, la suma del saldo pendiente, la antigü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 muestre los resultados como texto
El uso de términos clave como "resumen" o hacer una pregunta que solo requiera una respuesta directa guía a la API de Conversational Analytics para que proporcione resultados como texto.
Las siguientes preguntas implican que los resultados deben mostrarse en un resultado de texto:
"Calcula y proporciona un resumen del tiempo total en horas que se tarda en procesar todas las facturas manuales".
"¿Cuál es el tiempo total que se tarda en procesar las facturas manuales en la última semana?".
Cómo guiar a la API de Conversational Analytics para que muestre los resultados como un gráfico de líneas
El uso de términos clave como "tendencia", "cambio" o "cambio delta" en una pregunta guía a la API de Conversational Analytics para que proporcione resultados como un gráfico de líneas.
Las siguientes preguntas implican que los resultados deben mostrarse como un gráfico de líneas:
"¿Cuál es la tendencia mensual de los saldos finales para cada sector en el año 2024?".
"¿Cuál es el cambio delta diario en la antigüedad promedio de las facturas pendientes para el día en comparación con el día anterior entre el 2 de mayo de 2025 y el 3 de junio de 2025?".
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 "variación" guía a la API de Conversational Analytics para que proporcione resultados como un gráfico de barras o de comparación.
La siguiente pregunta implica que los resultados deben mostrarse como un gráfico de barras o de comparación:
"Proporciona los sectores principales por importe de variación en los saldos de las cuentas por cobrar de los clientes junto con los importes del 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 variación para 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 Solucionar problemas de errores de la API de Conversational Analytics.