Queste note di rilascio riguardano gli aggiornamenti dell'API Analisi conversazionale.
30 settembre 2026
Aggiornamenti dell'API Conversational Analytics:
Le connessioni a BigQuery Graph nell'API Conversational Analytics sono ora in disponibilità generale (GA). Puoi configurare un agente per i dati in modo che esegua query su uno o più grafici o che combini tabelle e grafici nella stessa configurazione dell'origine dati.
A seconda dello schema del grafo e della domanda posta, l'API Conversational Analytics esegue una query su un grafo utilizzando Graph Query Language (GQL) o la funzione con valori di tabella GRAPH_EXPAND in SQL. Le query GQL richiedono una prenotazione della versione BigQuery Enterprise o Enterprise Plus, mentre le query GRAPH_EXPAND possono essere eseguite con i prezzi on demand. Per i requisiti e le limitazioni, consulta Connettiti a BigQuery Graph.
3 settembre 2026
Aggiornamenti dell'API Conversational Analytics:
L'API Conversational Analytics ora supporta l'osservabilità degli agenti. Puoi monitorare le prestazioni, la latenza e l'utilizzo dei token nella console Google Cloud o utilizzando Cloud Monitoring e Cloud Trace. Per saperne di più, consulta Crea agenti per i dati.
L'API Analisi conversazionale ora supporta la modalità di pensiero Approfondimento per le origini dati BigQuery in Anteprima. La modalità Approfondimento consente agli agenti per i dati di scomporre domande complesse, analizzare domande secondarie e sintetizzare i risultati in un report dettagliato.
Questa funzionalità è limitata da una lista consentita. Per richiedere l'accesso e la guida dell'utente, invia il modulo di interesse per le funzionalità in anteprima di Analisi conversazionale e seleziona l'opzione Approfondimenti.
La modalità Approfondimento presenta i seguenti requisiti e limitazioni durante l'anteprima:
- L'analisi approfondita supporta solo le origini dati BigQuery.
- Deep Dive non è supportato con
LATEST_GA_MODEL. - In genere, il completamento delle query richiede da 3 a 5 minuti. Poiché la scadenza del servizio è di 5 minuti, imposta il timeout del client in modo che corrisponda.
- Le conversazioni a più turni non sono supportate. La cronologia delle conversazioni viene cancellata durante la fase di risoluzione.
L'API Conversational Analytics è ora conforme all'HIPAA. Per ulteriori informazioni, consulta Conformità HIPAA su Google Cloud.
L'API Conversational Analytics ora supporta Access Transparency e Access Approval per le risorse DataAgent e Conversation.
23 giugno 2026
Aggiornamenti dell'API Conversational Analytics:
L'API Analisi conversazionale è in disponibilità generale (GA) per BigQuery e Looker.
Per informazioni sui prezzi, consulta Prezzi e prova senza costi di Data Cloud Agent.
L'API Conversational Analytics supporta v1 endpoint REST.
La residenza dei dati è ora supportata per l'API Analisi conversazionale. Puoi controllare la posizione fisica delle risorse DataAgent e Conversation utilizzando endpoint regionali e multiregionali. Questi endpoint forniscono impegni per i dati at-rest e, a seconda dell'origine dati, l'elaborazione del machine learning (ML) giurisdizionale per i dati in uso. Per saperne di più, consulta Residenza dei dati e Località.
L'API Conversational Analytics supporta le seguenti funzionalità di sicurezza e conformità aziendale:
- Chiavi di crittografia gestite dal cliente (CMEK) per proteggere gli agenti per i dati e le conversazioni
- Controlli di servizio VPC per proteggere le risorse all'interno di un perimetro di servizio
- Cloud Audit Logs per registrare l'attività di amministrazione e l'accesso ai dati
- Conservazione ed eliminazione dei dati per supportare le policy di cancellazione e conservazione dei dati aziendali
L'API Conversational Analytics ora supporta il protocollo Agent2Agent (A2A) in Anteprima. Puoi utilizzare nuovi metodi API, come SendMessage, SendStreamingMessage e GetAgentCard, per orchestrare più agenti. Per un esempio di come utilizzare questi metodi, consulta il blocco note di esempio dell'SDK A2A.
L'API Conversational Analytics ora supporta l'applicazione di filtri e l'ordinamento per i metodi di elenco. Utilizza il campo filter per restringere i risultati per agenti per i dati, conversazioni e messaggi. Utilizza il campo orderBy per ordinare gli agenti per i dati in base al nome o alla data di creazione.
- Per gli agenti per i dati, puoi filtrare per nome, data e ora di creazione ed etichette.
- Per le conversazioni, puoi filtrare in base agli agenti e alle etichette associati.
- Per i messaggi, puoi filtrare in base all'ora di creazione.
- Il supporto dei caratteri jolly è disponibile per i filtri di stringa che includono l'operatore has (
:) e un asterisco finale (*). Esempi:filter=display_name:"*"ofilter=display_name:"foo*". - Le conversazioni e i messaggi vengono restituiti in ordine di attività più recente. L'ordinamento personalizzato non è supportato per queste risorse.
Questa release include le seguenti funzionalità e i seguenti miglioramenti per le origini dati BigQuery:
- Ora puoi utilizzare il campo
big_query_max_billed_bytesnella configurazione dell'agente per limitare i byte fatturati per i job BigQuery avviati dall'agente. - Gli agenti per i dati ora possono citare le fonti, come i termini del glossario o le query di esempio, utilizzate per generare una risposta.
- Ora puoi fornire funzioni definite dall'utente (UDF) BigQuery personalizzate che l'agente può utilizzare per rispondere alle domande.
- Se la domanda di un utente corrisponde sufficientemente a una query di esempio definita, l'agente potrebbe eseguire direttamente la query anziché generarne una nuova. In questo caso, la risposta dell'API include un oggetto
matchedQueryper indicare che è stata utilizzata una query verificata.
L'API Analisi conversazionale ora supporta la chat con BigQuery Graph. Questa funzionalità è in anteprima.
Le seguenti modifiche e ritiri sono in vigore per l'API v1:
- I formati SVG e PNG per i grafici non sono supportati nella versione
v1. Il campooptions.chartinChartOptionsè limitato alle versioniv1alphaev1beta. - Il campo
credentialsnel campocontext(ad esempiodataAgentContext.credentials) è stato ritirato. Per l'autenticazione, fornisci le credenziali direttamente nell'oggettoChatRequest. - I messaggi di chiarimento generati dal sistema (
systemMessage.clarification) sono stati ritirati. Utilizza inveceTextMessagecon il tipo di testoFINAL_RESPONSE.
16 aprile 2026
Aggiornamenti dell'API Conversational Analytics:
L'API Conversational Analytics ora supporta l'esecuzione di query sulle tabelle Lakehouse che si connettono al catalogo REST Apache Iceberg o sono federate a un catalogo esterno. Se utilizzi tabelle Lakehouse, utilizza la sintassi project.catalog.namespace.table (P.C.N.T) in quattro parti.
Per saperne di più, consulta Autenticati e connettiti a un'origine dati.
30 marzo 2026
Aggiornamenti dell'API Conversational Analytics:
L'API Conversational Analytics ora supporta AlloyDB per PostgreSQL, Cloud SQL per MySQL, Cloud SQL per PostgreSQL e Spanner come origini dati. Questa funzionalità consente agli utenti di eseguire query sui dati operativi utilizzando il linguaggio naturale e traduce un dialogo umano complesso in query di database precise per fornire insight utili. Questa funzionalità è in anteprima. Per ulteriori informazioni, consulta le seguenti risorse:
Gli aggiornamenti all'API Conversational Analytics per le origini dati BigQuery includono le seguenti funzionalità e i seguenti miglioramenti:
- L'API Conversational Analytics ora si integra con Cloud Storage tramite le funzioni ObjectRef. In questo modo, l'API può rispondere a domande sui dati non strutturati nei bucket Cloud Storage, come immagini e PDF, facendo riferimento alle colonne ObjectRef in qualsiasi tabella.
- L'API ora supporta un insieme di funzioni BigQuery ML, tra cui
AI.FORECAST,AI.DETECT_ANOMALIESeAI.GENERATE. L'API può utilizzare queste funzioni per rispondere a una gamma più ampia di domande, ad esempio per la previsione, il rilevamento di anomalie e le attività di AI generativa. - L'API Conversational Analytics ora può utilizzare il partizionamento delle tabelle BigQuery. L'API può ottimizzare le query SQL utilizzando colonne partizionate, ad esempio intervalli di date, su una tabella partizionata per data, il che può migliorare le prestazioni delle query e ridurre i costi.
I job BigQuery avviati dall'API Conversational Analytics ora includono etichette che ti consentono di identificarli nella cronologia dei job BigQuery nella console Google Cloud . Queste etichette possono essere utili per monitorare i costi, controllare l'attività degli agenti e analizzare le prestazioni delle query. Poiché queste etichette non sono direttamente visibili nella tabella della cronologia dei job di BigQuery Studio, puoi identificarle eseguendo una query su
INFORMATION_SCHEMA.JOBSper trovare etichette simili a{'ca-bq-job': 'true'}:SELECT COUNT(*) AS job_count FROM `PROJECT_ID`.`region-LOCATION`.INFORMATION_SCHEMA.JOBS WHERE EXISTS ( SELECT 1 FROM UNNEST(labels) AS label WHERE label.key = 'ca-bq-job' AND label.value = 'true' );
Nella query di esempio, sostituisci i valori di esempio come segue:
PROJECT_ID: il tuo ID progetto Google Cloud .LOCATION: la località dei job BigQuery.
Per gli agenti per i dati che utilizzano origini dati Looker o BigQuery, ora puoi specificare un valore thinkingMode di FAST nella richiesta di chat per attivare la modalità di pensiero "Veloce". Il ragionamento rapido può contribuire a migliorare la latenza riducendo il tempo di ragionamento complessivo. Tuttavia, questa modalità rende le risposte meno trasparenti, poiché nel flusso di risposta non vengono emessi messaggi con un valore TextType di THOUGHT. Inoltre, l'utilizzo di questa modalità potrebbe influire sull'accuratezza delle risposte.
Per gli agenti per i dati che utilizzano origini dati di Looker, l'agente può ora porre domande aggiuntive per chiarire le ambiguità in una query, ad esempio quando sono presenti più campi con nomi simili. Queste domande vengono restituite come risposta TextMessage con un prefisso Clarification needed:. Per saperne di più, consulta Fai domande efficaci.
Per gli agenti per i dati che utilizzano origini dati BigQuery, l'agente può ora porre domande aggiuntive per chiarire le ambiguità in una query, ad esempio quando sono presenti più campi con nomi simili. Queste domande vengono restituite come risposta TextMessage.
Per gli agenti per i dati che utilizzano origini dati di Looker, sono stati apportati diversi miglioramenti per ridurre la latenza, tra cui chiamate agli strumenti parallele e un migliore utilizzo della cache di Looker.
26 marzo 2026
Aggiornamenti dell'API Conversational Analytics:
Per l'API Conversational Analytics con origini dati Looker, puoi utilizzare le chiavi di crittografia gestite dal cliente (CMEK) per proteggere le risorse DataAgent e Conversation at-rest. CMEK nell'API Conversational Analytics è disponibile in anteprima. Per saperne di più, consulta Chiavi di crittografia gestite dal cliente (CMEK).
11 febbraio 2026
Aggiornamenti dell'API Conversational Analytics:
Le richieste di chat con origini dati BigQuery ora forniscono maggiori insight sul processo di ragionamento dell'agente. Sebbene lo schema dell'API rimanga invariato, noterai i seguenti nuovi comportamenti nel flusso di risposta:
- Lo stream di risposta dell'API ora include messaggi
systemMessage.textaggiuntivi contextType = THOUGHT. Questi messaggi forniscono informazioni dettagliate sul ragionamento e sul processo decisionale dell'agente. - Dopo i messaggi
THOUGHT, l'API restituisce la risposta come una sequenza di messaggi, ad esempio messaggi di query, job, testo, risultati dei dati e grafici. Per saperne di più sui tipi di messaggi, consultaSystemMessage. - I messaggi dello schema non sono più inclusi nello stream di risposta per le origini dati BigQuery.
Sono disponibili metodi di gestione degli agenti sincroni. Questi metodi ti consentono di creare, aggiornare ed eliminare gli agenti per i dati in modo sincrono, in alternativa ai metodi asincroni esistenti:
CreateDataAgentSyncUpdateDataAgentSyncDeleteDataAgentSync
L'opzione di analisi Python (options.analysis.python.enabled) non è più supportata per le origini dati BigQuery.
6 febbraio 2026
Aggiornamenti dell'API Conversational Analytics:
Per gli agenti per i dati che utilizzano origini dati di Looker, ora puoi definire query Looker d'oro come contesto strutturato.
26 gennaio 2026
Aggiornamenti dell'API Conversational Analytics:
La trasparenza del ragionamento migliorata, che fornisce informazioni dettagliate sul ragionamento e sul processo decisionale dell'agente con i messaggi di textType = THOUGHT, non richiede più una lista consentita ed è disponibile per tutti gli utenti per le origini dati di Looker.
Il recupero dei dati granulari per le origini dati di Looker, che fornisce aggiornamenti sulle ricerche dei valori dei dati con messaggi textType = PROGRESS, non richiede più una lista consentita ed è disponibile per tutti gli utenti.
15 dicembre 2025
Aggiornamenti dell'API Conversational Analytics:
Lo stream di risposta dell'API per le origini dati di Looker include messaggi systemMessage.text aggiuntivi con textType = THOUGHT. Questi messaggi forniscono informazioni dettagliate sul ragionamento e sul processo decisionale dell'agente mentre lavora per rispondere alla tua query. Per eseguire esempi di chat che dimostrano questo ragionamento, consulta i blocchi note di Colaboratory per HTTP e Python SDK. Per indicazioni sul rendering dei messaggi THOUGHT con le origini dati di Looker, consulta Esegui il rendering delle risposte dell'agente per le origini dati di Looker. Questo è un annuncio preliminare di una funzionalità sperimentale disponibile su richiesta. Per richiedere l'accesso a questa funzionalità, invia un'email all'indirizzo conversational-analytics-api-feedback@google.com.
Nota: a partire dal 26 gennaio 2026, questa funzionalità non richiede più una lista consentita ed è disponibile per tutti gli utenti per le origini dati di Looker; consulta la voce relativa al 26 gennaio 2026.
Per le origini dati di Looker, gli agenti utilizzano metodi più granulari per recuperare gli schemi e i valori dei dati di Esplora. Quando l'agente cerca valori di dati specifici, lo stream dell'API include anche messaggi systemMessage.text con textType = PROGRESS, che forniscono aggiornamenti sullo stato e sui risultati della ricerca. Per indicazioni sul rendering dei messaggi PROGRESS, consulta Esegui il rendering delle risposte dell'agente per le origini dati di Looker. Questo è un annuncio preliminare di una funzionalità sperimentale disponibile su richiesta. Per richiedere l'accesso a questa funzionalità, invia un'email all'indirizzo conversational-analytics-api-feedback@google.com.
Nota: a partire dal 26 gennaio 2026, questa funzionalità non richiede più una lista consentita ed è disponibile per tutti gli utenti per le origini dati di Looker; consulta la voce relativa al 26 gennaio 2026.
L'integrazione dell'API Conversational Analytics con i Controlli di servizio VPC è in anteprima. Questa integrazione è pronta per test e utilizzi più ampi, ma non è completamente supportata per gli ambienti di produzione. Per maggiori dettagli, consulta l'elenco dei prodotti supportati.
È stato risolto un problema relativo alla mancata applicazione corretta di big_query_max_billed_bytes.
Sono stati risolti i problemi relativi alla gestione delle origini dati di Looker da parte dell'API, tra cui:
- Formattazione dei valori migliorata nelle risposte di testo
- Filtro migliore per le corrispondenze esatte
- Supporto migliorato per le misure periodo su periodo (PoP)
- Supporto di
always_filtermigliorato
Aggiornamenti delle librerie client:
Sono state aggiunte le seguenti librerie client:
21 ottobre 2025
Aggiornamenti dell'API Conversational Analytics:
Il supporto per il metodo API deleteConversation è stato aggiunto alle API REST e all'SDK.
25 settembre 2025
Aggiornamenti dell'API Conversational Analytics:
È ora disponibile una nuova API, ListAccessibleDataAgents, per elencare gli agenti per i dati accessibili a un utente in un progetto. Un agente per i dati è considerato accessibile se l'utente che richiama l'API dispone dell'autorizzazione get sull'agente. Puoi utilizzare il campo creator_filter per gestire gli agenti restituiti da questo metodo:
NONE(predefinito): restituisce tutti gli agenti per i dati accessibili all'utente, indipendentemente dal creator.CREATOR_ONLY: restituisce solo gli agenti per i dati creati dall'utente.NOT_CREATOR_ONLY: restituisce solo gli agenti per i dati creati da altri utenti.
L'enum systemMessage.text.textType è ora disponibile con i valori FINAL_RESPONSE e THOUGHT, che aiutano i client a distinguere tra diversi tipi di messaggi. L'API Conversational Analytics ora utilizza i messaggi systemMessage.text con textType = THOUGHT per produrre passaggi di ragionamento.
L'API ora supporta fino a cinque origini dati di Esplora di Looker nel contesto. Le richieste di chat generano query nell'esplorazione più pertinente. Per saperne di più, consulta la documentazione sulla connessione ai dati di Looker con HTTP e con l'SDK Python.
Il campo systemMessage.data.generatedLookerQuery è ora systemMessage.data.query.looker.
25 agosto 2025
L'API Conversational Analytics è ora disponibile in Anteprima pubblica.
Aggiornamenti delle librerie client:
Le seguenti librerie client sono ora disponibili per più linguaggi:
Aggiornamenti dell'API Conversational Analytics:
Il supporto per gli endpoint "v1beta" per HTTP REST è ora disponibile.
Il supporto per i metodi API GetLocation e ListLocations è stato aggiunto alle API REST e all'SDK.
Ora puoi condividere gli agenti per i dati utilizzando i metodi API GetIamPolicy e SetIamPolicy.
Ora puoi creare agenti per i dati da origini dati di Looker basate su istanze di Looker (Google Cloud core) che utilizzano reti con IP privato. L'API Analisi conversazionale non supporta le origini dati basate su istanze di Looker (Google Cloud core) che si trovano all'interno di perimetri Virtual Private Cloud.
Ora è disponibile il contesto strutturato per le origini dati BigQuery. Ciò include la possibilità di aggiungere coppie di domande/query di esempio, descrizioni delle tabelle, sinonimi e tag a livello di tabella e campo utilizzando l'API.
Le API di località e operazioni sono ora supportate. I ruoli Identity and Access Management DataAgentCreator e DataAgentEditor ora avranno le autorizzazioni per le API delle operazioni.
È stato apportato un miglioramento per l'archiviazione automatica di Last Published Context nel livello del server ogni volta che viene aggiornato il contesto pubblicato di un agente per i dati.
I nomi visualizzati per i ruoli di Identity and Access Management sono stati aggiornati in "Gemini Data Analytics Stateless Chat User" e "Gemini Data Analytics Data Agent Creator". Per saperne di più sui ruoli di Identity and Access Management utilizzati con l'API, consulta la pagina della documentazione Concedi ruoli e autorizzazioni di Identity and Access Management per l'API Analisi conversazionale.
La versione 1.1 di Colaboratory è ora disponibile.
Sono stati apportati aggiornamenti alla gestione degli errori per gestire gli errori interni 500 relativi alle conversazioni per la chat stateful.
Sono stati implementati messaggi di gestione delle eccezioni migliori per gli errori client 400.
Aggiornamenti della documentazione:
Ora puoi utilizzare la nuova applicazione di avvio rapido di Streamlit su GitHub per configurare una demo dell'API di Analisi conversazionale in pochi minuti.
La demo d'oro dell'API Conversational Analytics è ora disponibile su GitHub. Con la demo d'oro dell'API Conversational Analytics, puoi visualizzare esempi per integrare l'API Conversational Analytics nelle applicazioni web, nonché una demo di produzione completa in TypeScript. Questo progetto è destinato esclusivamente a scopi dimostrativi. Non è destinato all'uso in un ambiente di produzione.
Architettura, workflow e ruoli dell'API Analisi conversazionale: scopri di più sui concetti chiave per l'utilizzo dell'API Analisi conversazionale, tra cui il funzionamento degli agenti per i dati, i workflow tipici degli agenti per i dati, le modalità di conversazione, i ruoli di Identity and Access Management e come progettare sistemi che utilizzano più agenti per i dati.
Limitazioni note dell'API Conversational Analytics: scopri di più sulle limitazioni relative al numero di origini dati, allo stile delle visualizzazioni e alle dimensioni dei set di dati.
Risolvi i problemi dell'API Conversational Analytics: scopri di più su potenziali problemi o errori con l'API Conversational Analytics, nonché sulle soluzioni proposte.
Monitora e gestisci i costi di BigQuery per gli agenti dell'API Conversational Analytics: scopri di più su come implementare i controlli dei costi per gli agenti dell'API Conversational Analytics.
I metodi SetIAMPolicy e GetIAMPolicy sono disponibili nella pagina della documentazione Panoramica dell'API Conversational Analytics per l'utilizzo nella condivisione degli agenti per i dati.
È ora disponibile una nuova pagina della documentazione contenente le risposte alle domande frequenti sull'API Analisi conversazionale.
Definisci il contesto dell'agente per i dati per le origini dati BigQuery: scopri di più su come scrivere istruzioni di sistema per le origini dati BigQuery.
Definisci il contesto dell'agente per i dati per le origini dati di Looker: scopri di più su come scrivere istruzioni di sistema per le origini dati di Looker.
15 luglio 2025
Ora puoi invitare gli utenti a collaborare su agenti per i dati specifici assegnando ruoli IAM predefiniti. Per maggiori dettagli, consulta Ruoli e autorizzazioni IAM dell'API Conversational Analytics.
Una nuova guida alle best practice ti aiuta a fornire ai tuoi agenti un contesto aziendale e dei dati efficace. Per saperne di più, consulta Guida il comportamento dell'agente con il contesto creato.
Aggiornamenti dell'SDK:
Ora puoi installare l'SDK Python da Python Package Index (PyPI).
25 giugno 2025
Aggiornamenti dell'API:
Nuovi ruoli IAM predefiniti controllano l'accesso per la creazione, la gestione e l'interazione con gli agenti per i dati:
geminidataanalytics.dataAgentCreatorgeminidataanalytics.dataAgentOwnergeminidataanalytics.dataAgentEditorgeminidataanalytics.dataAgentUsergeminidataanalytics.dataAgentViewergeminidataanalytics.dataAgentStatelessUser
Per un elenco completo dei ruoli e delle relative autorizzazioni, consulta Concedi ruoli e autorizzazioni IAM dell'API Conversational Analytics.
5 giugno 2025
L'anteprima privata iniziale dell'API Conversational Analytics ha introdotto funzionalità per la creazione e l'interazione con gli agenti per i dati.
I seguenti notebook Colaboratory interattivi sono disponibili per iniziare a utilizzare sia REST che l'SDK Python:
Aggiornamenti dell'API:
Il servizio Agente per i dati ti consente di creare, configurare e gestire in modo programmatico agenti AI persistenti e sensibili al contesto con Looker, Data Studio e BigQuery.
Il servizio di chat con i dati ti consente di interagire con il tuo agente utilizzando diverse modalità di chat. Queste modalità includono una modalità stateful in cui Google gestisce la cronologia delle conversazioni, un'opzione stateful in cui la tua applicazione gestisce la conversazione e una modalità stateless in cui la tua applicazione fornisce il contesto completo con ogni richiesta.
L'API supporta l'analisi avanzata utilizzando Python e riprova automaticamente le query non riuscite.
L'API Analisi conversazionale (geminidataanalytics.googleapis.com) sostituisce l'API Data QnA (dataqna.googleapis.com) deprecata. Ciò include la migrazione da DataQuestionService alla nuova DataChatService. Per istruzioni dettagliate su come aggiornare le richieste, consulta la guida alla migrazione.