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

Esta seção descreve as restrições e os comportamentos da API Análises de conversação ao se conectar e consultar fontes do Looker e de banco 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 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 duas análises detalhadas, uma chamada cat-explore e outra chamada 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 concluir ambas.

  • O método QueryData não é compatível com 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, do Cloud SQL para MySQL, do Cloud SQL para PostgreSQL ou do Spanner, considere o seguinte:

  • Os agentes de dados acessam os dados usando as credenciais 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 focar. 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

Os seguintes tipos de visualização são aceitos:

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

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 Análises de conversação limita as consultas de dados a 500 GB de bytes processados.
  • Para fontes de dados do AlloyDB, do Cloud SQL para MySQL, do Cloud SQL para PostgreSQL e do 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 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 Análises de conversação tem um comprimento máximo de saída de 8.192 tokens. Consultar 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 máximo 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 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.
  • Para recursos da API Análises de conversação, a CMEK é compatível apenas com fontes de dados do Looker.
  • 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 Análises de conversação 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 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 relacionadas a 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 1 QPS, que é de 60 QPM por projeto.
    • Uma taxa máxima de 1 QPS, que é de 60 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 o atendimento ao cliente doGoogle Cloud .

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