Limitações conhecidas da API Conversational Analytics

A API Análises de conversação 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

Esta seção descreve as restrições e os comportamentos da API Análises de conversação ao se conectar e consultar fontes de dados do Looker e de bancos de dados: AlloyDB para PostgreSQL, Cloud SQL para MySQL, Cloud SQL para PostgreSQL e Spanner.

Limitações da fonte de dados do Looker

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 realizar consultas em várias análises simultaneamente.
  • Um agente pode consultar várias análises na mesma conversa.

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

    Por exemplo, um usuário conecta duas análises, uma chamada cat-explore e outra chamada dog-explore. O usuário insere a pergunta "O que é maior: a contagem de gatos ou a contagem de cães?" Isso criaria duas consultas: uma para contar o número de gatos em cat-explore e outra para contar o número de cães em dog-explore. O agente compara o número das duas consultas depois de concluir as duas.

  • O método QueryData não oferece suporte a fontes de dados do BigQuery ou do Looker.

Limitações da fonte de dados do banco de dados

Ao se conectar a fontes de dados do AlloyDB, Cloud SQL para MySQL, Cloud SQL para PostgreSQL ou Spanner, considere o seguinte:

  • Os agentes de dados acessam os dados usando a credencial do usuário que está interagindo com o agente de dados. Se um usuário acessar um agente de dados compartilhados para o qual não tem acesso às tabelas configuradas do agente, o agente de dados não poderá acessar essas tabelas.

  • A seleção de tabelas para o agente de dados orienta o agente sobre quais tabelas se concentrar. A seleção de tabelas não é uma configuração de segurança. Mesmo que você especifique que a fonte de dados só pode extrair informações de determinadas tabelas, como table1 e table2, o sistema ainda poderá retornar dados de uma tabela não intencional (table3) se o usuário que executar a consulta tiver permissões gerais para visualizar o conteúdo de table3 no mesmo banco de dados.

Limitações de visualização

Há suporte para os seguintes tipos de visualização:

  • Área
  • Barras
  • Geoshape
  • Mapa de calor
  • Linha (série temporal)
  • Pizza
  • Dispersão

Limitações de tratamento de dados

  • Para fontes de dados do Looker, a API Análises de conversação pode retornar até 5.000 linhas por consulta.
  • Para fontes de dados do BigQuery, a API Análises de conversação limita as consultas de dados a 500 GB de bytes processados.
  • Para fontes de dados do AlloyDB, Cloud SQL para MySQL, Cloud SQL para PostgreSQL e Spanner, a API Análises de conversação pode retornar até 1.000 linhas por consulta.
  • Os recursos de raciocínio e recuperação de conteúdo baseados em Python da API Análises de conversação podem acomodar complexidades de tempo de até O(100k) linhas.
  • A consulta de grandes quantidades de dados pode causar redução na precisão do raciocínio em agentes de dados.
  • A API Análises de conversação tem um comprimento máximo de saída de token de 8.192 tokens. A consulta de grandes quantidades de dados pode retornar um erro MAX_TOKENS.
  • Os dados retornados no campo DataResult de uma mensagem do sistema estão sujeitos a um limite de tamanho. Os resultados de dados são truncados para um máximo de 3.000.000 bytes. Esse processo de truncamento mantém o maior número possível de linhas completas dentro dessa restrição de tamanho.

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 Análises de conversação para se conectar a uma instância do Looker (Google Cloud Core) com IP particular usando o Data 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 Análises de conversação não é compatível com instâncias do Looker (Google Cloud Core) configuradas para usar CMEK ou VPC Service Controls.
  • Para recursos da API Análises de conversação, a CMEK só é compatível com fontes de dados do Looker.
  • A API Análises de conversação não funciona bem com fontes de dados do Data 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 Análises de conversação não vai tentar novamente a consulta. As novas tentativas não são determinísticas. Se a mensagem de erro sugerir que uma consulta não é recuperável, a API não vai tentar a consulta novamente, mesmo que ela ainda esteja abaixo do limite de três erros por solicitação.

Limitações de cota

  • A API Análises de conversação tem os seguintes limites para solicitações gerais (incluindo solicitações de chat e não chat):
    • Uma taxa máxima de 10 consultas por segundo (QPS), que é de 600 consultas por minuto (QPM) por projeto.
    • Uma taxa máxima de 10 QPS, que é de 600 QPM por usuário por projeto.
  • Como exceção, as solicitações de chat têm limites mais restritivos:
    • Uma taxa máxima de 30 QPM por projeto.
    • Uma taxa máxima de 30 QPM por usuário por projeto.
  • A API Análises de conversação para AlloyDB, Cloud SQL para MySQL, Cloud SQL para PostgreSQL e Spanner tem um limite de 50 QPM por projeto. Para aumentar esses limites, entre em contato com Google Cloud o atendimento ao cliente.

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