Diese Versionshinweise beziehen sich auf Updates der Conversational Analytics API.
21. Oktober 2025
Updates der Conversational Analytics API:
Die Unterstützung für die API-Methode deleteConversation wurde zu den REST APIs und dem SDK hinzugefügt.
25. September 2025
Updates der Conversational Analytics API:
Eine neue API, ListAccessibleDataAgents, ist jetzt verfügbar, um Datenagenten aufzulisten, auf die ein Nutzer in einem Projekt zugreifen kann. Ein Datenagent gilt als zugänglich, wenn der Nutzer, der die API aufruft, die Berechtigung get für den Agenten hat. Mit dem Feld creator_filter können Sie festlegen, welche Agenten von dieser Methode zurückgegeben werden:
NONE(Standard): Gibt alle Datenagenten zurück, auf die der Nutzer zugreifen kann, unabhängig vom Ersteller.CREATOR_ONLY: Gibt nur die Datenagenten zurück, die vom Nutzer erstellt wurden.NOT_CREATOR_ONLY: Gibt nur die Datenagenten zurück, die von anderen Nutzern erstellt wurden.
Das Enum systemMessage.text.textType ist jetzt mit den Werten FINAL_RESPONSE und THOUGHT verfügbar. So können Clients zwischen verschiedenen Arten von Textnachrichten unterscheiden. Für die Conversational Analytics API werden jetzt systemMessage.text-Nachrichten mit textType = THOUGHT verwendet, um Denkschritte zu generieren.
Die API unterstützt jetzt bis zu fünf Looker-Explore-Datenquellen im Kontext. Bei Chatanfragen werden Abfragen für den relevantesten Explore generiert. Weitere Informationen finden Sie in der Dokumentation zum Herstellen einer Verbindung zu Looker-Daten mit HTTP und mit dem Python SDK.
Das Feld systemMessage.data.generatedLookerQuery heißt jetzt systemMessage.data.query.looker.
25. August 2025
Die Conversational Analytics API ist jetzt in der öffentlichen Vorschau verfügbar.
Updates der Clientbibliothek:
Die folgenden Clientbibliotheken sind jetzt für mehrere Sprachen verfügbar:
Updates der Conversational Analytics API:
v1beta-Endpunkte werden jetzt für HTTP REST unterstützt.
Die Unterstützung für die API-Methoden GetLocation und ListLocations wurde zu den REST APIs und dem SDK hinzugefügt.
Sie können jetzt Datenagenten mit den API-Methoden GetIamPolicy und SetIamPolicy freigeben.
Sie können jetzt Datenagenten aus Looker-Datenquellen erstellen, die auf Looker (Google Cloud Core)-Instanzen mit privaten IP-Netzwerken basieren. Die Conversational Analytics API unterstützt keine Datenquellen, die auf Looker (Google Cloud Core)-Instanzen innerhalb von Virtual Private Cloud-Perimetern basieren.
Strukturierter Kontext für BigQuery-Datenquellen ist jetzt verfügbar. Dazu gehört auch die Möglichkeit, mithilfe der API Frage-Abfrage-Paare, Tabellenbeschreibungen, Synonyme und Tags auf Tabellen- und Feldebene hinzuzufügen.
Standort- und Vorgangs-APIs werden jetzt unterstützt. Die IAM-Rollen DataAgentCreator und DataAgentEditor haben jetzt Berechtigungen für Vorgangs-APIs.
Es wurde eine Verbesserung für die automatische Speicherung von Last Published Context auf Serverebene vorgenommen, wenn der veröffentlichte Kontext eines Datenagenten aktualisiert wird.
Die Anzeigenamen für IAM-Rollen wurden in „Gemini Data Analytics Stateless Chat User“ und „Gemini Data Analytics Data Agent Creator“ geändert. Weitere Informationen zu IAM-Rollen, die mit der API verwendet werden, finden Sie auf der Dokumentationsseite Zugriffssteuerung für die Conversational Analytics API mit IAM.
Die Colaboratory-Version 1.1 ist jetzt verfügbar.
Die Fehlerbehandlung wurde aktualisiert und es werden nun konversationsbezogene interne 500-Fehler für den zustandsorientierten Chat verarbeitet.
Für Client-400-Fehler wurden verbesserte Meldungen bei Ausnahmen eingeführt.
Updates für die Dokumentation:
Mit der neuen Streamlit Quickstart-Anwendung auf GitHub können Sie jetzt in wenigen Minuten eine Demo der Conversational Analytics API einrichten.
Die Conversational Analytics API Golden Demo ist jetzt auf GitHub verfügbar. Mit der Conversational Analytics API Golden Demo können Sie sich Beispiele für die Einbindung der Conversational Analytics API in Webanwendungen sowie eine vollständige Produktionsdemo in TypeScript ansehen. Dieses Projekt dient nur zu Demonstrationszwecken. Es ist nicht für die Verwendung in einer Produktionsumgebung vorgesehen.
Architektur, Workflows und Rollen der Conversational Analytics API: Hier finden Sie weitere Informationen zu den wichtigsten Konzepten für die Verwendung der Conversational Analytics API, darunter die Funktionsweise sowie typische Workflows von Datenagenten, Konversationsmodi, Identity and Access Management-Rollen und die Gestaltung von Systemen, die mehrere Datenagenten verwenden.
Bekannte Einschränkungen der Conversational Analytics API: Hier finden Sie weitere Informationen zu den Einschränkungen bei der Anzahl der Datenquellen, zum Stil von Visualisierungen und zur Größe von Datasets.
Fehlerbehebung bei der Conversational Analytics API: Hier finden Sie Informationen zu möglichen Problemen oder Fehlern bei der Conversational Analytics API sowie Lösungsvorschläge.
BigQuery-Kosten für Ihre Conversational Analytics API-Agenten überwachen und verwalten: Hier erfahren Sie, wie Sie Kostenkontrollen für Ihre Conversational Analytics API-Agenten implementieren.
Die Methoden SetIAMPolicy und GetIAMPolicy zur Freigabe von Datenagenten sind auf der Dokumentationsseite Wichtige API-Vorgänge verfügbar.
Es gibt jetzt eine neue Dokumentationsseite mit Antworten auf häufig gestellte Fragen zur Conversational Analytics API.
Datenagenten-Kontext für BigQuery-Datenquellen definieren: Hier erfahren Sie, wie Sie Systemanweisungen für BigQuery-Datenquellen schreiben.
Datenagenten-Kontext für Looker-Datenquellen definieren: Hier erfahren Sie, wie Sie Systemanweisungen für Looker-Datenquellen schreiben.
15. Juli 2025
Sie können jetzt Nutzer dazu einladen, bei bestimmten Datenagenten zusammenzuarbeiten, indem Sie vordefinierte IAM-Rollen zuweisen. Weitere Informationen finden Sie unter Zugriffssteuerung für die Conversational Analytics API mit IAM.
Ein neuer Leitfaden mit Best Practices unterstützt Sie dabei, effektiven Geschäfts- und Datenkontext für Agenten bereitzustellen. Weitere Informationen finden Sie unter Agent-Verhalten mit selbst erstelltem Kontext steuern.
SDK-Updates:
Sie können das Python SDK jetzt aus dem Python Package Index (PyPI) installieren.
25. Juni 2025
API-Updates:
Neue vordefinierte IAM-Rollen steuern den Zugriff zum Erstellen, Verwalten und Interagieren mit Datenagenten:
geminidataanalytics.dataAgentCreatorgeminidataanalytics.dataAgentOwnergeminidataanalytics.dataAgentEditorgeminidataanalytics.dataAgentUsergeminidataanalytics.dataAgentViewergeminidataanalytics.dataAgentStatelessUser
Eine vollständige Liste der Rollen und ihrer Berechtigungen finden Sie unter Zugriffssteuerung für die Conversational Analytics API mit IAM.
5. Juni 2025
In der ersten privaten Vorabversion der Conversational Analytics API sind Funktionen zum Erstellen und Interagieren mit Datenagenten enthalten.
Die folgenden interaktiven Colaboratory-Notebooks sind verfügbar, um mit REST und dem Python SDK zu starten:
API-Updates:
Mit dem Data Agent Service können Sie persistente, kontextbezogene KI-Agenten anhand von Looker, Looker Studio und BigQuery programmatisch erstellen, konfigurieren und verwalten.
Der Data Chat Service ermöglicht es, mit Agenten in verschiedenen Chat-Modi zu interagieren. Zu diesen Modi gehören ein zustandsorientierter Modus, in dem Google den Unterhaltungsverlauf verwaltet, eine zustandsorientierte Option, in der Ihre Anwendung die Unterhaltung verwaltet, und ein zustandsloser Modus, in dem Ihre Anwendung bei jeder Anfrage den vollständigen Kontext bereitstellt.
Die API unterstützt erweiterte Analysen mit Python und wiederholt fehlgeschlagene Abfragen automatisch.
Die Conversational Analytics API (geminidataanalytics.googleapis.com) ersetzt die eingestellte Data QnA API (dataqna.googleapis.com). Dies umfasst auch die Migration des DataQuestionService zum neuen DataChatService. Eine ausführliche Anleitung zum Aktualisieren Ihrer Anfragen finden Sie in der Migrationsanleitung.