Limitazioni note dell'API Conversational Analytics

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

L'API Conversational Analytics presenta le seguenti limitazioni note relative al numero di origini dati, allo stile delle visualizzazioni e alle dimensioni dei set di dati.

Limitazioni delle origini dati

Questa sezione descrive i vincoli e i comportamenti dell'API Conversational Analytics quando ti connetti ed esegui query su Looker e sulle origini database: AlloyDB per PostgreSQL, Cloud SQL per MySQL, Cloud SQL per PostgreSQL e Spanner.

Limitazioni delle origini dati di Looker

Quando ti connetti a un'origine dati di Looker, tieni presente quanto segue:

• Puoi eseguire query su qualsiasi esplorazione inclusa in una conversazione.
• Un agente può eseguire query su un solo Explore alla volta. Non è possibile eseguire query su più esplorazioni contemporaneamente.
• Un agente può eseguire query su più esplorazioni nella stessa conversazione.

• Un agente può eseguire query su più esplorazioni in una conversazione che include domande in più parti o in conversazioni che includono domande di follow-up.

  Ad esempio, un utente collega due esplorazioni, una chiamata cat-explore e una chiamata dog-explore. L'utente inserisce la domanda "Qual è il numero maggiore: quello dei gatti o quello dei cani?". Vengono create due query: una per conteggiare il numero di gatti in cat-explore e una per conteggiare il numero di cani in dog-explore. L'agente confronta il numero di entrambe le query dopo averle completate.

• Il metodo QueryData non supporta le origini dati BigQuery o Looker.

Limitazioni delle origini dati del database

Quando ti connetti a origini dati AlloyDB, Cloud SQL per MySQL, Cloud SQL per PostgreSQL o Spanner, tieni presente quanto segue:

• Gli agenti dei dati accedono ai dati utilizzando le credenziali dell'utente che interagisce con l'agente dei dati. Se un utente accede a un agente dati condiviso per il quale non ha accesso alle tabelle configurate dell'agente, l'agente dati non può accedere a queste tabelle.

• La selezione delle tabelle per l'agente di dati indica all'agente su quali tabelle concentrarsi. La selezione delle tabelle non è un'impostazione di sicurezza. Anche se specifichi che l'origine dati può estrarre informazioni solo da determinate tabelle, ad esempio table1 e table2, il sistema potrebbe comunque restituire dati da una tabella non prevista (table3) se l'utente che esegue la query dispone di autorizzazioni generali per visualizzare i contenuti di table3 nello stesso database.

Limitazioni di visualizzazione

Sono supportati i seguenti tipi di visualizzazione:

• Area
• A barre
• Geoshape
• Mappa termica
• A linee (serie temporale)
• Torta
• A dispersione

Nota: i grafici con descrizioni comando sono supportati parzialmente e potrebbero mostrare un comportamento imprevisto.

Limitazioni al trattamento dei dati

• Per le origini dati Looker, l'API Conversational Analytics può restituire un massimo di 5000 righe per query.
• Per le origini dati BigQuery, l'API Conversational Analytics limita le query sui dati a 500 GB di byte elaborati.
• Per le origini dati AlloyDB, Cloud SQL per MySQL, Cloud SQL per PostgreSQL e Spanner, l'API Conversational Analytics può restituire un massimo di 1000 righe per query.
• Le funzionalità di ragionamento e recupero dei contenuti basate su Python dell'API Conversational Analytics possono gestire complessità temporali fino a O(100k) righe.
• L'esecuzione di query su grandi quantità di dati può causare una riduzione dell'accuratezza del ragionamento negli agenti di dati.
• L'API Conversational Analytics ha una lunghezza massima di output di token di 8192 token. L'interrogazione di grandi quantità di dati può restituire un errore MAX_TOKENS.
• I dati restituiti nel campo DataResult di un messaggio di sistema sono soggetti a un limite di dimensioni. I risultati dei dati vengono troncati a un massimo di 3.000.000 di byte. Questo processo di troncamento mantiene il maggior numero possibile di righe complete all'interno di questo vincolo di dimensioni.

Limitazioni per le query

• La funzionalità dei nomi delle colonne flessibili di BigQuery non è supportata.
• Gli struct in BigQuery sono supportati, ma a volte potrebbero non funzionare.
• Per le origini dati di Looker, l'API non può impostare il valore di un campo solo con filtri definito utilizzando il parametro parameter di LookML.
• L'utilizzo dell'API Conversational Analytics per connettersi a un'istanza di Looker (Google Cloud core) con IP privato utilizzando Data Studio Pro quando l'istanza di Looker (Google Cloud core) si trova all'interno di un perimetro dei Controlli di servizio VPC non è una configurazione supportata e non soddisfa i requisiti di conformità dei Controlli di servizio VPC.
• Per le connessioni alle istanze di Looker (Google Cloud core) con configurazioni IP private, l'API Conversational Analytics non supporta le istanze di Looker (Google Cloud core) configurate per utilizzare CMEK o i Controlli di servizio VPC.
• Per le risorse dell'API Conversational Analytics, CMEK è supportata solo per le origini dati Looker.
• L'API Conversational Analytics non funziona bene con le origini dati di Data Studio in cui è disattivata la modifica dei campi nei report, perché questa impostazione impedisce a Conversational Analytics di creare campi calcolati.

• Quando si verifica un errore durante la convalida o l'esecuzione della query, l'API Conversation Analytics potrebbe riprovare automaticamente l'operazione generando una query corretta. Questo tipo di nuovo tentativo verrà eseguito al massimo tre volte per richiesta.

  Se una query non va a buon fine a causa di problemi di autorizzazione o autenticazione, l'API Conversational Analytics non riproverà a eseguirla. I tentativi sono non deterministici; se il messaggio di errore suggerisce che una query non è recuperabile, l'API non la riproverà, anche se è ancora al di sotto del limite di tre errori per richiesta.

Limitazioni delle quote

• L'API Conversational Analytics (Analisi conversazionale) prevede i seguenti limiti per le richieste complessive (incluse quelle di chat e non):
  • Una frequenza massima di 10 query al secondo (QPS), ovvero 600 query al minuto (QPM) per progetto.
  • Una frequenza massima di 10 QPS, ovvero 600 QPM per utente per progetto.
• In via eccezionale, le richieste di chat hanno limiti più restrittivi:
  • Una tariffa massima di 30 QPM per progetto.
  • Una frequenza massima di 30 QPM per utente per progetto.
• L'API Conversational Analytics per AlloyDB, Cloud SQL per MySQL, Cloud SQL per PostgreSQL e Spanner ha un limite di 50 QPM per progetto. Per aumentare questi limiti, contatta l'assistenza clientiGoogle Cloud .

Limitazioni dei tipi di domande

• L'API Conversational Analytics supporta le domande a cui è possibile rispondere con una singola visualizzazione, ad esempio:

  • Tendenze delle metriche nel tempo
  • Suddivisione o distribuzione di una metrica per dimensione
  • Valori univoci per una o più dimensioni
  • Valori di una singola metrica
  • Valori delle dimensioni principali per metrica

• L'API Conversational Analytics non supporta ancora le domande a cui è possibile rispondere solo con i seguenti tipi di visualizzazioni complesse:

  • Previsione
  • Analisi statistica avanzata, inclusi correlazione e rilevamento anomalie