Questa pagina è stata tradotta dall'API Cloud Translation.

Note di rilascio dell'API Conversational Analytics

Queste note di rilascio riguardano gli aggiornamenti dell'API Conversational Analytics.

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ù lingue:

Aggiornamenti dell'API Conversational Analytics:

Ora è disponibile il supporto per gli endpoint v1beta per HTTP REST.

Sono stati aggiunti metodi API GetLocation e ListLocations alle API REST e all'SDK.

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 del cloud privato virtuale.

È 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 Identity and Access Management utilizzati con l'API Conversational Analytics, consulta la pagina di documentazione Concedere ruoli e autorizzazioni 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 stateful.

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 Streamlit su GitHub per configurare una demo dell'API Conversational Analytics 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.

Sono stati aggiunti esempi di codice del payload della richiesta per le API REST e l'SDK.

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.

Risoluzione dei 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.

Guida il comportamento dell'agente con il contesto creato per le origini dati BigQuery: scopri di più su come scrivere istruzioni di sistema per le origini dati BigQuery.

Guida il comportamento dell'agente con il contesto creato per le origini dati di Looker: scopri di più su come scrivere istruzioni di sistema per le origini dati di Looker.

15 luglio 2025

Una nuova guida alle best practice ti aiuta a fornire ai tuoi agenti un contesto aziendale ed efficace per i dati. Per ulteriori informazioni, vedi 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 API:

I nuovi ruoli IAM predefiniti controllano l'accesso per la creazione, la gestione e l'interazione con gli agenti dati:

geminidataanalytics.dataAgentCreator
geminidataanalytics.dataAgentOwner
geminidataanalytics.dataAgentEditor
geminidataanalytics.dataAgentUser
geminidataanalytics.dataAgentViewer
geminidataanalytics.dataAgentStatelessUser

Per un elenco completo dei ruoli e delle relative autorizzazioni, consulta la pagina 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.