Limitaciones conocidas de la API de Conversational Analytics

Vista previa

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales de las Condiciones específicas del servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

La API de Conversational Analytics tiene las siguientes limitaciones conocidas en cuanto a la cantidad de fuentes de datos, el estilo de las visualizaciones y el tamaño de los conjuntos de datos.

Limitaciones de la fuente de datos

En esta sección, se describen las restricciones y los comportamientos de la API de Conversational Analytics cuando te conectas a fuentes de Looker y de bases de datos (AlloyDB para PostgreSQL, Cloud SQL para MySQL, Cloud SQL para PostgreSQL y Spanner) y las consultas.

Limitaciones de la fuente de datos de Looker

Cuando te conectes a una fuente de datos de Looker, ten en cuenta lo siguiente:

• Puedes consultar cualquier exploración incluida en una conversación.
• Un agente solo puede consultar una exploración a la vez. No es posible realizar consultas en varias exploraciones de forma simultánea.
• Un agente puede consultar varias exploraciones en la misma conversación.

• Un agente puede consultar varias exploraciones en una conversación que incluya preguntas con varias partes o en conversaciones que incluyan preguntas de seguimiento.

  Por ejemplo, un usuario conecta dos exploraciones, una llamada cat-explore y otra llamada dog-explore. El usuario ingresa la pregunta "¿Qué es mayor: la cantidad de gatos o la cantidad de perros?". Esto crearía dos consultas: una para contar la cantidad de gatos en cat-explore y otra para contar la cantidad de perros en dog-explore. El agente compara la cantidad de ambas consultas después de completarlas.

• El método QueryData no admite fuentes de datos de BigQuery ni de Looker.

Limitaciones de la fuente de datos de la base de datos

Cuando te conectes a fuentes de datos de AlloyDB, Cloud SQL para MySQL, Cloud SQL para PostgreSQL o Spanner, ten en cuenta lo siguiente:

• Los agentes de datos acceden a los datos con las credenciales del usuario que interactúa con el agente de datos. Si un usuario accede a un agente de datos compartido para el que no tiene acceso a las tablas configuradas del agente, el agente de datos no podrá acceder a esas tablas.

• La selección de tablas para el agente de datos guía a tu agente sobre en qué tablas enfocarse. La selección de tablas no es un parámetro de configuración de seguridad. Incluso si especificas que la fuente de datos solo puede extraer información de ciertas tablas, como table1 y table2, es posible que el sistema aún muestre datos de una tabla no deseada (table3) si el usuario que ejecuta la consulta tiene permisos generales para ver el contenido de table3 en la misma base de datos.

Limitaciones de visualización

Se admiten los siguientes tipos de visualización:

• Área
• Bar
• Geoshape
• Mapa de calor
• Línea (serie temporal)
• Circular
• Dispersión

Nota: Los gráficos con información sobre herramientas se admiten parcialmente y pueden mostrar un comportamiento inesperado.

Limitaciones del procesamiento de datos

• Para las fuentes de datos de Looker, la API de Conversational Analytics puede mostrar un máximo de 5,000 filas por consulta.
• Para las fuentes de datos de BigQuery, la API de Conversational Analytics limita las consultas de datos a 500 GB de bytes procesados.
• Para las fuentes de datos de AlloyDB, Cloud SQL para MySQL, Cloud SQL para PostgreSQL y Spanner, la API de Conversational Analytics puede mostrar un máximo de 1,000 filas por consulta.
• Las capacidades de razonamiento y recuperación de contenido basadas en Python de la API de Conversational Analytics pueden adaptarse a complejidades de tiempo de hasta O(100k) filas.
• Consultar grandes cantidades de datos puede reducir la precisión del razonamiento en los agentes de datos.
• La API de Conversational Analytics tiene una longitud máxima de salida de tokens de 8,192 tokens. Consultar grandes cantidades de datos puede mostrar un error MAX_TOKENS.
• Los datos que se muestran en el campo DataResult de un mensaje del sistema están sujetos a un límite de tamaño. Los resultados de los datos se truncan a un máximo de 3,000,000 bytes. Este proceso de truncamiento mantiene la mayor cantidad posible de filas completas dentro de esta restricción de tamaño.

Limitaciones de las consultas

• No se admite la función de nombres de columnas flexibles de BigQuery.
• Se admiten las estructuras en BigQuery, pero a veces pueden fallar.
• Para las fuentes de datos de Looker, la API no puede establecer el valor de un campo solo de filtro que se define con el parámetro parameter de LookML.
• El uso de la API de Conversational Analytics para conectarse a una instancia de Looker (Google Cloud Core) de IP privada con Data Studio Pro cuando esa instancia de Looker (Google Cloud Core) se encuentra dentro de un perímetro de Controles del servicio de VPC no es una configuración admitida y no cumple con los requisitos de cumplimiento de los Controles del servicio de VPC.
• Para las conexiones a instancias de Looker (Google Cloud Core) con configuraciones de IP privada, la API de Conversational Analytics no admite instancias de Looker (Google Cloud Core) que estén configuradas para usar CMEK o Controles del servicio de VPC.
• Para los recursos de la API de Conversational Analytics, CMEK solo se admite para las fuentes de datos de Looker.
• La API de Conversational Analytics no funciona bien con las fuentes de datos de Data Studio que tienen inhabilitada la edición de campos en los informes, ya que este parámetro de configuración impide que Conversational Analytics cree campos calculados.

• Cuando se produce una falla durante la validación o la ejecución de la consulta, la API de Conversation Analytics puede reintentar automáticamente la operación generando una consulta corregida. Este tipo de reintento se intentará un máximo de tres veces por solicitud.

  Si una consulta falla debido a problemas de permisos o autenticación, la API de Conversational Analytics no la reintentará. Los reintentos no son deterministas. Si el mensaje de error sugiere que una consulta no se puede recuperar, la API no volverá a intentarla, incluso si aún está por debajo del límite de tres errores por solicitud.

Limitaciones de cuota

• La API de Conversational Analytics tiene los siguientes límites para las solicitudes generales (incluidas las solicitudes de chat y las que no son de chat):
  • Una frecuencia máxima de 10 consultas por segundo (QPS), que son 600 consultas por minuto (QPM) por proyecto.
  • Una frecuencia máxima de 10 QPS, que son 600 QPM por usuario por proyecto.
• Como excepción, las solicitudes de chat tienen límites más restrictivos:
  • Una frecuencia máxima de 1 QPS, que son 60 QPM por proyecto.
  • Una frecuencia máxima de 1 QPS, que son 60 QPM por usuario por proyecto.
• La API de Conversational Analytics para AlloyDB, Cloud SQL para MySQL, Cloud SQL para PostgreSQL y Spanner tiene un límite de 50 QPM por proyecto. Para aumentar estos límites, comunícate con Google Cloud el equipo de atención al cliente.

Limitaciones de los tipos de preguntas

• La API de Conversational Analytics admite preguntas que se pueden responder con una sola visualización, por ejemplo:

  • Tendencias de las métricas a lo largo del tiempo
  • Desglose o distribución de una métrica por dimensión
  • Valores únicos para una o más dimensiones
  • Valores de una sola métrica
  • Los valores de dimensión principales por métrica

• La API de Conversational Analytics aún no admite preguntas que solo se pueden responder con los siguientes tipos de visualizaciones complicadas:

  • Predicción y previsión
  • Análisis estadístico avanzado, incluida la correlación y la detección de anomalías