Limitaciones conocidas de la API de Conversational Analytics

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 las fuentes de datos

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

Limitaciones de las fuentes 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 el número de ambas consultas después de completarlas.

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

Limitaciones de las fuentes de datos de bases 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 la credencial 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, este 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, el sistema podría devolver 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 del permiso de búsqueda de BigQuery

Cuando usas un permiso de búsqueda para permitir que la API de Conversational Analytics elija qué tablas de BigQuery consultar, se aplican las siguientes limitaciones:

  • Solo puedes usar un permiso de búsqueda en solicitudes de chat sin estado con contexto intercalado. Los permisos de búsqueda no se admiten en los agentes de datos persistentes ni en las solicitudes de chat con estado que usan una referencia de conversación.
  • Puedes especificar hasta 100 conjuntos de datos y hasta 100 proyectos.

Para obtener más información, consulta Conéctate a conjuntos de datos y proyectos de BigQuery.

Limitaciones de la visualización

Se admiten los siguientes tipos de visualización:

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

Limitaciones del procesamiento de datos

  • En el caso de las fuentes de datos de Looker, la API de Conversational Analytics puede devolver un máximo de 5,000 filas por consulta.
  • En el caso de 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 devolver 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 temporales 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. La consulta de grandes cantidades de datos puede mostrar un error MAX_TOKENS.
  • Los datos que se devuelven 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 de 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.
  • Los structs en BigQuery son compatibles, pero, a veces, pueden fallar.
  • En el caso de las fuentes de datos de Looker, la API no puede establecer el valor de un campo de solo filtro que se define con el parámetro parameter de LookML.
  • Usar la API de Conversational Analytics para conectarse a una instancia de Looker (Google Cloud Core) con IP privada a través de Data Studio Pro cuando esa instancia de Looker (Google Cloud Core) está 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 parámetros de configuración 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.
  • 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 un error durante la validación o ejecución de la consulta, la API de Conversational Analytics puede reintentar la operación automáticamente generando una consulta corregida. Este tipo de reintento se realizará 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 volverá a intentarla. Los reintentos no son deterministas. Si el mensaje de error sugiere que una consulta no se puede recuperar, la API de Conversational Analytics no volverá a intentar la consulta, 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 tasa máxima de 30 consultas por segundo (QPS), que equivale a 1,800 consultas por minuto (QPM) por proyecto
    • Una tasa máxima de 10 QPS, que equivale a 600 QPM por usuario y por proyecto
  • Como excepción, las solicitudes de chat tienen límites más restrictivos:
    • Una tasa máxima de 30 QPM por proyecto
    • Una tasa máxima de 30 QPM por usuario y por proyecto.
    • Cada solicitud de chat cuenta como 8 unidades de cuota, en lugar de la unidad estándar de 1 unidad. Como resultado, en la página Cuotas de la consola de Google Cloud , se muestran límites que son 8 veces superiores a los límites de solicitudes reales. Por ejemplo, un límite de 240 unidades representa 30 solicitudes de chat.
  • Las solicitudes de agente a agente (A2A) tienen una tasa máxima de 100 QPM por proyecto y por agente. Cada agente integrado recibe un límite dedicado, mientras que los agentes de datos personalizados comparten un único límite de 100 QPM 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 el equipo de Atención al cliente deGoogle Cloud .

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 puedan responder con los siguientes tipos de visualizaciones complejas:

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