Limitazioni note dell'API Conversational Analytics

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei 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 Analisi conversazionale 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 Analisi conversazionale quando ti connetti ed esegui query su origini Looker e 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 una sola esplorazione 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 con più parti o in conversazioni che includono domande di follow-up.

  Ad esempio, un utente connette due esplorazioni, una chiamata cat-explore e una chiamata dog-explore. L'utente inserisce la domanda "Qual è maggiore: il conteggio dei gatti o il conteggio dei cani?" Vengono create due query: una per contare il numero di gatti in cat-explore e una per contare 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 un'origine dati AlloyDB, Cloud SQL per MySQL, Cloud SQL per PostgreSQL o Spanner, tieni presente quanto segue:

• Gli agenti dati accedono ai dati utilizzando le credenziali dell'utente che interagisce con l'agente 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 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ò recuperare 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 delle autorizzazioni generali per visualizzare i contenuti di table3 nello stesso database.

Limitazioni della 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 del trattamento dati

• Per le origini dati di Looker, l'API Analisi conversazionale può restituire un massimo di 5000 righe per query.
• Per le origini dati BigQuery, l'API Analisi conversazionale 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 Analisi conversazionale può restituire un massimo di 1000 righe per query.
• Le funzionalità di ragionamento e recupero dei contenuti basate su Python dell'API Analisi conversazionale possono gestire complessità temporali fino a O(100k) righe.
• L'esecuzione di query su grandi quantità di dati può ridurre l'accuratezza del ragionamento negli agenti dati.
• L'API Analisi conversazionale ha una lunghezza massima di output di token di 8192 token. L'esecuzione di query su 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 delle query

• La funzionalità dei nomi delle colonne flessibili di BigQuery non è supportata.
• Le struct in BigQuery sono supportate, 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 Analisi conversazionale 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 Analisi conversazionale non supporta le istanze di Looker (Google Cloud core) configurate per l'utilizzo di CMEK o dei Controlli di servizio VPC.
• Per le risorse dell'API Analisi conversazionale, CMEK è supportato solo per le origini dati di Looker.
• L'API Analisi conversazionale non funziona correttamente con le origini dati di Data Studio in cui la modifica dei campi nei report è disattivata, perché questa impostazione impedisce ad Analisi conversazionale di creare campi calcolati.

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

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

Limitazioni delle quote

• L'API Analisi conversazionale presenta i seguenti limiti per le richieste complessive (incluse le richieste di chat e non di chat):
  • 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.
• Come eccezione, le richieste di chat hanno limiti più restrittivi:
  • Una frequenza massima di 1 QPS, ovvero 60 QPM per progetto.
  • Una frequenza massima di 1 QPS, ovvero 60 QPM per utente per progetto.
• L'API Analisi conversazionale 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 Google Cloud l'assistenza clienti.

Limitazioni dei tipi di domande

• L'API Analisi conversazionale 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 Analisi conversazionale 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 di anomalie