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 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 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 l'altra dog-explore. L'utente inserisce la domanda "Qual è maggiore: il numero di gatti o il numero di cani?" In questo modo 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 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 della visualizzazione

Sono supportati i seguenti tipi di visualizzazione:

• Area
• A barre
• Geoshape
• Mappa termica
• Linea (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 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 di dati.
• L'API Analisi conversazionale ha una lunghezza massima di output dei 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 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 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 utilizzare CMEK o i Controlli di servizio VPC.
• Per le risorse dell'API Analisi conversazionale, CMEK è supportata solo per le origini dati Looker.
• L'API Analisi conversazionale non funziona bene con le origini dati di Data Studio in cui è disattivata la modifica dei campi nei report, 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 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 Analisi conversazionale non riprova a eseguire la query. I nuovi tentativi non sono deterministici; se il messaggio di errore suggerisce che una query non è recuperabile, l'API non riproverà la query, 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 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 l'assistenza clientiGoogle Cloud .

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 anomalie