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 BigQuery, Looker e origini di 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 con più parti o in conversazioni che includono domande aggiuntive.
Ad esempio: un utente collega due esplorazioni, una denominata
cat-exploree l'altra denominatadog-explore. L'utente inserisce la domanda "Qual è il numero maggiore: il numero di gatti o il numero di cani?" In questo modo vengono create due query: una per contare il numero di gatti incat-exploree una per contare il numero di cani indog-explore. L'agente confronta il numero di entrambe le query dopo averle completate.Il metodo
QueryDatanon 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 per i dati accedono ai dati utilizzando le credenziali dell'utente che interagisce con l'agente per i dati. Se un utente accede a un agente per i dati condiviso per il quale non ha accesso alle tabelle configurate dell'agente, l'agente per i dati non può accedere a queste tabelle.
La selezione delle tabelle per l'agente per i 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
table1etable2, 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 ditable3nello stesso database.
Limitazioni dell'ambito di ricerca di BigQuery
Quando utilizzi un ambito di ricerca per consentire all'API Analisi conversazionale di scegliere le tabelle BigQuery su cui eseguire query, si applicano le seguenti limitazioni:
- Puoi utilizzare un ambito di ricerca solo nelle richieste di chat stateless con contesto incorporato. Gli ambiti di ricerca non sono supportati negli agenti per i dati persistenti o nelle richieste di chat stateful che utilizzano un riferimento alla conversazione.
- Puoi specificare fino a 100 set di dati e fino a 100 progetti.
Per saperne di più, consulta Connettiti a set di dati e progetti BigQuery.
Limitazioni della visualizzazione
Sono supportati i seguenti tipi di visualizzazione:
- Area
- A barre
- Geoshape
- Mappa termica
- A linee (serie temporale)
- Torta
- A dispersione
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, il limite API di 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 per i dati.
- La lunghezza massima dei token di output dell'API Analisi conversazionale è di 8192 token. L'esecuzione di query su grandi quantità di dati può restituire un errore
MAX_TOKENS. - I dati restituiti nel campo
DataResultdi 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 entro questo vincolo di dimensione.
Limitazioni delle query
- La funzionalità dei nomi delle colonne flessibili di BigQuery non è supportata.
- Gli struct in BigQuery sono supportati, ma a volte potrebbero non riuscire.
- Per le origini dati di Looker, l'API non può impostare il valore di un campo solo con filtri definito utilizzando il parametro LookML
parameter. - 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 a istanze di Looker (Google Cloud core) con configurazioni con IP privato, l'API Analisi conversazionale non supporta le istanze di Looker (Google Cloud core) configurate per l'utilizzo di CMEK o Controlli di servizio VPC.
- L'API Conversational Analytics non funziona bene con le origini dati di Data Studio in cui l'opzione Modifica campi nei report è disattivata, perché questa impostazione impedisce all'Analisi conversazionale di creare campi calcolati.
Quando si verifica un errore durante la convalida o l'esecuzione della query, l'API Conversational Analytics potrebbe riprovare automaticamente l'operazione generando una query corretta. Questo tipo di nuovo tentativo verrà eseguito un massimo di 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 riproverà a eseguirla. I nuovi tentativi non sono deterministici; se il messaggio di errore suggerisce che una query non è recuperabile, l'API Conversational Analytics non proverà di nuovo a eseguire la query, anche se è ancora al di sotto del limite di tre errori per richiesta.
Limitazioni delle quote
- L'API Analisi conversazionale prevede i seguenti limiti per le richieste complessive (incluse le richieste di chat e non di chat):
- Una frequenza massima di 30 query al secondo (QPS), ovvero 1800 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 frequenza massima di 30 QPM per progetto.
- Una frequenza massima di 30 QPM per utente per progetto.
- Ogni richiesta di chat viene conteggiata come 8 unità di quota, anziché l'unità standard. Di conseguenza, la pagina Quote della console Google Cloud mostra limiti 8 volte superiori ai limiti di richiesta effettivi. Ad esempio, un limite di 240 unità rappresenta 30 richieste di chat.
- Le richieste da agente ad agente (A2A) hanno una frequenza massima di 100 QPM per progetto per agente. Ogni agente integrato riceve un limite dedicato, mentre gli agenti per i dati personalizzati condividono un unico limite di 100 QPM 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 Analisi conversazionale supporta 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 e previsione
- Analisi statistica avanzata, tra cui correlazione e rilevamento di anomalie