Limitações conhecidas da API Conversational Analytics

A API Conversational Analytics tem as seguintes limitações conhecidas quanto ao número de fontes de dados, estilo de visualizações e tamanho dos conjuntos de dados.

Limitações da fonte de dados

Ao se conectar a uma fonte de dados do Looker, observe o seguinte:

  • Você pode consultar qualquer análise incluída em uma conversa.
  • Um agente só pode consultar uma análise por vez. Não é possível fazer consultas em várias análises detalhadas ao mesmo tempo.
  • Um agente pode consultar várias análises detalhadas na mesma conversa.

  • Um agente pode consultar várias análises detalhadas em uma conversa que inclui perguntas com várias partes ou em conversas com perguntas de acompanhamento.

    Por exemplo, um usuário conecta dois Explorers, um chamado cat-explore e outro chamado dog-explore. O usuário insere a pergunta "O que é maior: a quantidade de gatos ou a quantidade de cachorros?" Isso criaria duas consultas: uma para contar o número de gatos em cat-explore e outra para contar o número de cachorros em dog-explore. O agente compara os números das duas consultas depois de concluí-las.

Limitações de visualização

  • Estes tipos de visualização são totalmente compatíveis: gráfico de linhas, gráfico de área, gráfico de barras (horizontal, vertical, empilhadas), gráficos de dispersão e gráfico de pizza.
  • Estes tipos de visualização são parcialmente compatíveis e podem apresentar um comportamento inesperado: mapas, mapas de calor, gráficos com dicas.

Limitações do tratamento de dados

  • Para fontes de dados do Looker, a API Conversational Analytics pode retornar até 5.000 linhas por consulta.
  • Para fontes de dados do BigQuery, a API Conversational Analytics limita as consultas de dados a 500 GB de bytes processados.
  • Os recursos de raciocínio e recuperação de conteúdo baseados em Python da API Conversational Analytics podem acomodar complexidades de tempo de até O(100k) linhas.
  • Consultar grandes quantidades de dados pode reduzir a precisão do raciocínio nos agentes de dados.
  • A API Conversational Analytics tem um comprimento máximo de saída de 8.192 tokens. Consultar grandes quantidades de dados pode retornar um erro MAX_TOKENS.

Limitações de consulta

  • O recurso de nomes de coluna flexíveis do BigQuery não é compatível.
  • As structs são aceitas no BigQuery, mas podem falhar às vezes.
  • Para fontes de dados do Looker, a API não pode definir o valor de um campo somente para filtro definido usando o parâmetro parameter da LookML.
  • Usar a API Conversational Analytics para se conectar a uma instância do Looker (Google Cloud Core) com IP particular usando o Looker Studio Pro quando essa instância está dentro de um perímetro do VPC Service Controls não é uma configuração compatível e não atende aos requisitos de conformidade do VPC Service Controls.
  • Para conexões com instâncias do Looker (Google Cloud Core) com configurações de IP particular, a API Conversational Analytics não é compatível com instâncias do Looker (Google Cloud Core) configuradas para usar CMEK ou VPC Service Controls.
  • A API Conversational Analytics não funciona bem com fontes de dados do Looker Studio que têm a edição de campos em relatórios desativada, porque essa configuração impede que a API crie campos calculados.

  • Quando ocorre uma falha durante a validação ou execução da consulta, a API Conversation Analytics pode tentar novamente a operação automaticamente gerando uma consulta corrigida. Esse tipo de nova tentativa será feito no máximo três vezes por solicitação.

    Se uma consulta falhar devido a problemas de permissão ou autenticação, a API Conversational Analytics não vai tentar de novo. As novas tentativas não são deterministas. Se a mensagem de erro sugerir que uma consulta é irrecuperável, a API não vai tentar de novo, mesmo que ainda esteja abaixo do limite de três erros por solicitação.

Limitações dos tipos de perguntas

  • A API Conversational Analytics é compatível com perguntas que podem ser respondidas por uma única visualização, por exemplo:

    • Tendências das métricas ao longo do tempo
    • Divisão ou distribuição de uma métrica por dimensão
    • Valores exclusivos de uma ou mais dimensões
    • Valores de uma métrica
    • Os principais valores de dimensão por métrica

  • A API Conversational Analytics ainda não é compatível com perguntas que só podem ser respondidas com os seguintes tipos de visualizações complexas:

    • Previsão e estimativa
    • Análise estatística avançada, incluindo correlação e detecção de anomalias