Queste note di rilascio riguardano gli aggiornamenti dell'API Conversational Analytics.
15 dicembre 2025
Aggiornamenti dell'API Conversational Analytics:
Il flusso di risposta dell'API per le origini dati Looker e BigQuery include ulteriori messaggi systemMessage.text con textType = THOUGHT. Questi messaggi forniscono informazioni passo passo 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 notebook Colaboratory HTTP e Python SDK. Per indicazioni sul rendering dei messaggi THOUGHT con le origini dati di Looker, vedi Rendering delle risposte dell'agente per le origini dati di Looker. Questo è un annuncio in anteprima 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.
Per le origini dati 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, il flusso API include anche messaggi systemMessage.text con textType = PROGRESS, fornendo aggiornamenti sullo stato e sui risultati della ricerca. Per indicazioni sul rendering dei messaggi PROGRESS, vedi Rendering delle risposte dell'agente per le origini dati di Looker. Questo è un annuncio in anteprima 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.
L'integrazione dell'API Conversational Analytics con i Controlli di servizio VPC è in anteprima. Questa integrazione è pronta per test e utilizzo più ampi, ma non è completamente supportata per gli ambienti di produzione. Per maggiori dettagli, consulta l'elenco dei prodotti supportati.
È stato risolto un problema per cui big_query_max_billed_bytes non veniva applicato correttamente.
Sono stati risolti i problemi relativi alla gestione delle origini dati di Looker da parte dell'API, tra cui:
- Formattazione migliore dei valori nelle risposte di testo
- Filtro migliore per le corrispondenze esatte
- Supporto migliorato della metrica periodo su periodo (PoP)
- Supporto migliorato di
always_filter
Aggiornamenti delle librerie client:
Sono state aggiunte le seguenti librerie client:
21 ottobre 2025
Aggiornamenti dell'API Conversational Analytics:
È stato aggiunto il supporto per il metodo API deleteConversation alle API REST e all'SDK.
25 settembre 2025
Aggiornamenti dell'API Conversational Analytics:
È ora disponibile una nuova API, ListAccessibleDataAgents, per elencare gli agenti di dati accessibili a un utente in un progetto. Un agente dati è considerato accessibile se l'utente che richiama l'API dispone dell'autorizzazione get per l'agente. Puoi utilizzare il campo creator_filter per gestire gli agenti restituiti da questo metodo:
NONE(impostazione predefinita): restituisce tutti gli agenti dati accessibili all'utente, indipendentemente dal creator.CREATOR_ONLY: restituisce solo gli agenti dati creati dall'utente.NOT_CREATOR_ONLY: restituisce solo gli agenti dati creati da altri utenti.
L'enumerazione 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 messaggi systemMessage.text con textType = THOUGHT per produrre passaggi di pensiero.
L'API ora supporta fino a cinque origini dati di esplorazione di Looker nel contesto. Le richieste di chat generano query nella sezione Esplora 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 in più lingue:
Aggiornamenti dell'API Conversational Analytics:
Ora è disponibile il supporto per gli endpoint v1beta per HTTP REST.
Il supporto per i metodi API GetLocation e ListLocations è stato aggiunto alle API REST e all'SDK.
Ora puoi condividere gli agenti dati utilizzando i metodi API GetIamPolicy e SetIamPolicy.
Ora puoi creare agenti di dati da origini dati Looker basate su istanze di Looker (Google Cloud core) che utilizzano reti IP private. L'API Conversational Analytics non supporta le origini dati basate su istanze di Looker (Google Cloud core) all'interno dei perimetri di 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 di tabelle, sinonimi e tag a livello di tabella e campo utilizzando l'API.
Ora sono supportate le API per la posizione e l'operazione. I ruoli Identity and Access Management DataAgentCreator e DataAgentEditor ora avranno le autorizzazioni per le API di operazioni.
È stato apportato un miglioramento per l'archiviazione automatica di Last Published Context nel livello server ogni volta che viene aggiornato il contesto pubblicato di un agente dati.
I nomi visualizzati per i ruoli Identity and Access Management sono stati aggiornati a "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 di documentazione Concedere ruoli e autorizzazioni di Identity and Access Management per l'API Conversational Analytics.
È ora disponibile la versione 1.1 di Colaboratory.
Sono stati apportati aggiornamenti alla gestione degli errori per gestire gli errori interni 500 correlati alle conversazioni per la chat con stato.
Sono stati implementati messaggi di gestione delle eccezioni migliori per gli errori del 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 dorata dell'API Conversational Analytics è ora disponibile su GitHub. Con la demo Golden 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 solo a scopi dimostrativi. Non è destinato all'uso in un ambiente di produzione.
Architettura, flussi di lavoro e ruoli dell'API Conversational Analytics: scopri di più sui concetti chiave per l'utilizzo dell'API Conversational Analytics, tra cui il funzionamento degli agenti di dati, i tipici flussi di lavoro degli agenti di dati, le modalità di conversazione, i ruoli di Identity and Access Management e come progettare sistemi che utilizzano più agenti di dati.
Limitazioni note dell'API Conversational Analytics: scopri di più sui limiti relativi al numero di origini dati, allo stile delle visualizzazioni e alle dimensioni dei set di dati.
Risolvi i problemi relativi all'API Conversational Analytics: scopri di più su potenziali problemi o errori relativi all'API Conversational Analytics, nonché sulle soluzioni proposte.
Monitorare e gestire 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 di documentazione Panoramica dell'API Conversational Analytics per l'utilizzo nella condivisione degli agenti di dati.
È ora disponibile una nuova pagina di documentazione contenente le risposte alle domande frequenti sull'API Conversational Analytics.
Definisci il contesto dell'agente 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 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 di dati specifici assegnando ruoli IAM predefiniti. Per maggiori dettagli, vedi 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 di dati efficace. Per saperne di più, consulta Guidare 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 API:
I nuovi ruoli IAM predefiniti controllano l'accesso per la creazione, la gestione e l'interazione con gli agenti dati:
geminidataanalytics.dataAgentCreatorgeminidataanalytics.dataAgentOwnergeminidataanalytics.dataAgentEditorgeminidataanalytics.dataAgentUsergeminidataanalytics.dataAgentViewergeminidataanalytics.dataAgentStatelessUser
Per un elenco completo dei ruoli e delle relative autorizzazioni, consulta Concedere ruoli e autorizzazioni IAM per l'API Conversational Analytics.
5 giugno 2025
La prima anteprima privata dell'API Conversational Analytics ha introdotto funzionalità per la creazione e l'interazione con gli agenti di dati.
Per iniziare a utilizzare sia REST che l'SDK Python, sono disponibili i seguenti blocchi note interattivi di Colaboratory:
Aggiornamenti API:
Il servizio Data Agent ti consente di creare, configurare e gestire in modo programmatico agenti AI persistenti e sensibili al contesto con Looker, Looker Studio e BigQuery.
Il servizio Data Chat ti consente di interagire con il tuo agente utilizzando più modalità di chat. Queste modalità includono una modalità stateful in cui Google gestisce la cronologia delle conversazioni, un'opzione stateful in cui l'applicazione gestisce la conversazione e una modalità stateless in cui l'applicazione fornisce il contesto completo a ogni richiesta.
L'API supporta l'analisi avanzata utilizzando Python e riprova automaticamente le query non riuscite.
L'API Conversational Analytics (geminidataanalytics.googleapis.com) sostituisce l'API Data QnA (dataqna.googleapis.com) ritirata. Ciò include la migrazione da DataQuestionService al nuovo DataChatService. Per istruzioni dettagliate su come aggiornare le richieste, consulta la guida alla migrazione.