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

Nesta seção, descrevemos as restrições e os comportamentos da API Análise conversacional ao se conectar e consultar o BigQuery, o Looker e as fontes 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 realizar consultas em várias Análises ao mesmo tempo.
  • 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 complementares.

    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: o número de gatos ou o número 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 o número das duas consultas depois de concluí-las.

  • 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 uma fonte 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 a credencial do usuário que está interagindo com o agente de dados. Se um usuário acessar um agente de dados compartilhado para o qual não tem acesso às tabelas configuradas, 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 pode retornar dados de uma tabela não intencional (table3) se o usuário que executa a consulta tiver permissões gerais para visualizar o conteúdo de table3 no mesmo banco de dados.

Limitações do escopo de pesquisa do BigQuery

Ao usar um escopo de pesquisa para permitir que a API de Análise conversacional escolha quais tabelas do BigQuery consultar, as seguintes limitações se aplicam:

  • Só é possível usar um escopo de pesquisa em solicitações de chat sem estado com contexto inline. Os escopos de pesquisa não são compatíveis com agentes de dados persistentes ou em solicitações de chat com estado que usam uma referência de conversa.
  • É possível especificar até 100 conjuntos de dados e até 100 projetos.

Para mais informações, consulte Conectar-se a conjuntos de dados e projetos do BigQuery.

Limitações de visualização

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

  • Área
  • Barra
  • 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, o limite da API Análise conversacional 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álise conversacional 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 dos agentes de dados.
  • A API de Análise conversacional 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 do LookML.
  • Usar a API Análise conversacional para se conectar a uma instância do Looker (Google Cloud Core) com IP privado 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álise conversacional não é compatível com instâncias do Looker (Google Cloud Core) configuradas para usar CMEK ou VPC Service Controls.
  • A Análise conversacional 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 Análise conversacional crie campos calculados.
  • Quando ocorre uma falha durante a validação ou execução da consulta, a API Conversational Analytics pode tentar a operação novamente de forma automática, 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 de Análise conversacional não vai tentar novamente. As novas tentativas não são determinísticas. Se a mensagem de erro sugerir que uma consulta é irrecuperável, a API Análise conversacional não vai tentar a consulta novamente, mesmo que ainda esteja abaixo do limite de três erros por solicitação.

Limitações de cota

  • A API de Análise conversacional tem os seguintes limites para solicitações gerais (incluindo solicitações de chat e não chat):
    • Uma taxa máxima de 30 consultas por segundo (QPS), que é de 1.800 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.
    • Cada solicitação de chat conta como 8 unidades de cota, em vez do padrão de 1 unidade. Como resultado, a página Cotas do console do Google Cloud mostra limites que são oito vezes maiores que os limites de solicitação reais. Por exemplo, um limite de 240 unidades representa 30 solicitações de chat.
  • As solicitações de agente para agente (A2A) têm uma taxa máxima de 100 QPM por projeto e por agente. Cada agente integrado recebe um limite dedicado, enquanto os agentes de dados personalizados compartilham um único limite de 100 QPM por projeto.
  • A API Análise conversacional 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 Análise conversacional é 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 Análise conversacional 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