Für die Conversational Analytics API gelten die folgenden bekannten Einschränkungen hinsichtlich der Anzahl der Datenquellen, des Stils von Visualisierungen und der Größe von Datasets.
Datenquelleneinschränkungen
In diesem Abschnitt werden die Einschränkungen und Verhaltensweisen der konversationellen Analyse API beschrieben, wenn Sie eine Verbindung zu BigQuery-, Looker- und Datenbankquellen (AlloyDB for PostgreSQL, Cloud SQL for MySQL, Cloud SQL for PostgreSQL und Spanner) herstellen und diese abfragen.
Einschränkungen von Looker-Datenquellen
Beachten Sie Folgendes, wenn Sie eine Verbindung zu einer Looker-Datenquelle herstellen:
- Sie können in einer Unterhaltung jedes enthaltene Explore abfragen.
- Ein KI-Agent kann jeweils nur ein Explore abfragen. Abfragen für mehrere Explores können nicht gleichzeitig ausgeführt werden.
- Ein KI-Agent kann in derselben Unterhaltung mehrere Explores abfragen.
Ein Agent kann in einer Unterhaltung, die Fragen mit mehreren Teilen oder Folgefragen enthält, mehrere Explores abfragen.
Beispiel: Ein Nutzer verbindet zwei Explores, eins mit dem Namen
cat-exploreund eins mit dem Namendog-explore. Der Nutzer gibt die Frage „Was ist größer: die Anzahl der Katzen oder die Anzahl der Hunde?“ ein. Dadurch werden zwei Abfragen erstellt: eine zum Zählen der Anzahl der Katzen incat-exploreund eine zum Zählen der Anzahl der Hunde indog-explore. Der KI-Agent vergleicht die Anzahl aus beiden Anfragen, nachdem beide Anfragen abgeschlossen sind.Die Methode
QueryDataunterstützt keine BigQuery- oder Looker-Datenquellen.
Einschränkungen bei Datenbank-Datenquellen
Beachten Sie Folgendes, wenn Sie eine Verbindung zu einer AlloyDB-, Cloud SQL for MySQL-, Cloud SQL for PostgreSQL- oder Spanner-Datenquelle herstellen:
Daten-Agenten greifen auf die Daten mit den Anmeldedaten des Nutzers zu, der mit dem Daten-Agenten interagiert. Wenn ein Nutzer auf einen freigegebenen Daten-Agenten zugreift, für den er keinen Zugriff auf die konfigurierten Tabellen des Agenten hat, kann der Daten-Agent nicht auf diese Tabellen zugreifen.
Die Tabellenauswahl für den KI-Daten-Agenten gibt an, auf welche Tabellen sich der KI-Agent konzentrieren soll. Die Tabellenauswahl ist keine Sicherheitseinstellung. Selbst wenn Sie festlegen, dass die Datenquelle nur Informationen aus bestimmten Tabellen wie
table1undtable2abrufen kann, gibt das System möglicherweise trotzdem Daten aus einer nicht beabsichtigten Tabelle (table3) zurück, wenn der Nutzer, der die Abfrage ausführt, allgemeine Berechtigungen zum Aufrufen des Inhalts vontable3in derselben Datenbank hat.
Einschränkungen des BigQuery-Suchbereichs
Wenn Sie einen Suchbereich verwenden, damit die konversationelle Analyse-API die BigQuery-Tabellen für die Abfrage auswählt, gelten die folgenden Einschränkungen:
- Sie können einen Suchbereich nur in zustandslosen Chatanfragen mit Inline-Kontext verwenden. Suchbereiche werden in persistenten KI-Datenagenten oder in zustandsorientierten Chatanfragen, die einen Unterhaltungsverweis verwenden, nicht unterstützt.
- Sie können bis zu 100 Datasets und bis zu 100 Projekte angeben.
Weitere Informationen finden Sie unter Verbindung zu BigQuery-Datasets und -Projekten herstellen.
Visualisierungseinschränkungen
Die folgenden Visualisierungstypen werden unterstützt:
- Gebiet
- Balken
- Geoshape
- Heatmap
- Linie (Zeitreihe)
- Kreisdiagramm
- Streudiagramm
Datenverarbeitungseinschränkungen
- Bei Looker-Datenquellen kann die Conversational Analytics API maximal 5.000 Zeilen pro Abfrage zurückgeben.
- Bei BigQuery-Datenquellen beschränkt die Conversational Analytics API Datenabfragen auf 500 GB verarbeiteter Bytes.
- Bei AlloyDB-, Cloud SQL for MySQL-, Cloud SQL for PostgreSQL- und Spanner-Datenquellen kann die konversationelle Analyse API maximal 1.000 Zeilen pro Abfrage zurückgeben.
- Die Python-basierten Funktionen der Conversational Analytics API für die Schlussfolgerungen und den Abruf von Inhalten können Zeitkomplexitäten von bis zu
O(100k)Zeilen bewältigen. - Wenn große Datenmengen abgefragt werden, kann die Accuracy der Schlussfolgerungen in Daten-KI-Agenten abnehmen.
- Die Conversational Analytics API hat eine maximale Tokenausgabelänge von 8.192 Tokens. Wenn große Datenmengen abgefragt werden, kann der Fehler
MAX_TOKENSzurückgegeben werden. - Die im Feld
DataResulteiner Systemnachricht zurückgegebenen Daten unterliegen einer Größenbeschränkung. Datenergebnisse werden auf maximal 3.000.000 Byte gekürzt. Bei diesem Kürzungsprozess werden so viele vollständige Zeilen wie möglich innerhalb dieser Größenbeschränkung beibehalten.
Abfragebeschränkungen
- Die Funktion der flexiblen Spaltennamen in BigQuery wird nicht unterstützt.
- Structs werden in BigQuery unterstützt, können aber manchmal fehlschlagen.
- Bei Looker-Datenquellen kann mit der API der Wert eines Nur-Filter-Feldes, das mit dem LookML-Parameter
parameterdefiniert ist, nicht festgelegt werden. - Die Verwendung der Conversational Analytics API, um mit Data Studio Pro eine Verbindung zu einer Instanz von Looker (Google Cloud Core) mit privater IP-Adresse herzustellen, wenn sich diese Instanz von Looker (Google Cloud Core) innerhalb eines VPC Service Controls-Perimeters befindet, ist keine unterstützte Konfiguration und erfüllt nicht die Compliance-Anforderungen von VPC Service Controls.
- Bei Verbindungen zu Instanzen von Looker (Google Cloud Core) mit privaten IP-Konfigurationen werden von der konversationellen Analyse API keine Instanzen von Looker (Google Cloud Core) unterstützt, die für die Verwendung von kundenverwalteten Verschlüsselungsschlüsseln (CMEK) oder VPC Service Controls konfiguriert sind.
- Die konversationelle Analyse API funktioniert nicht gut mit Data Studio-Datenquellen, bei denen Felder in Berichten bearbeiten deaktiviert ist, da diese Einstellung verhindert, dass die konversationelle Analyse berechnete Felder erstellt.
Wenn bei der Abfragevalidierung oder Ausführung einer Abfrage ein Fehler auftritt, kann die konversationelle Analyse API den Vorgang automatisch wiederholen, indem sie eine korrigierte Abfrage generiert. Ein solcher Wiederholungsversuch wird maximal dreimal pro Anfrage unternommen.
Wenn eine Abfrage aufgrund von Berechtigungs- oder Authentifizierungsproblemen fehlschlägt, wird sie von der Conversational Analytics API nicht noch einmal versucht. Wiederholungsversuche sind nicht deterministisch. Wenn in der Fehlermeldung angegeben wird, dass eine Abfrage nicht wiederhergestellt werden kann, wird die Abfrage von der konversationellen Analyse API nicht noch einmal versucht, auch wenn sie noch unter dem Limit von drei Fehlern pro Anfrage liegt.
Kontingentbeschränkungen
- Für die konversationelle Analyse API gelten die folgenden Limits für alle Anfragen (einschließlich Chat- und Nicht-Chat-Anfragen):
- Eine maximale Rate von 30 Abfragen pro Sekunde (QPS), d. h. 1.800 Abfragen pro Minute (QPM) pro Projekt.
- Eine maximale Rate von 10 Abfragen pro Sekunde, was 600 Abfragen pro Minute pro Nutzer und Projekt entspricht.
- Für Chatanfragen gelten jedoch strengere Einschränkungen:
- Eine maximale Rate von 30 Anfragen pro Minute und Projekt.
- Eine maximale Rate von 30 QPM pro Nutzer und Projekt.
- Jede Chatanfrage wird mit 8 Kontingenteinheiten statt der standardmäßigen 1 Einheit angerechnet. Daher werden auf der Seite Kontingente der Google Cloud Console Limits angezeigt, die achtmal so hoch sind wie die tatsächlichen Anfragelimits. Ein Limit von 240 Einheiten entspricht beispielsweise 30 Chatanfragen.
- Anfragen von Agent zu Agent (A2A) haben eine maximale Rate von 100 Anfragen pro Minute pro Projekt und Agent. Integrierte Agenten erhalten jeweils ein eigenes Limit, während benutzerdefinierte Daten-Agenten ein gemeinsames Limit von 100 QPM pro Projekt haben.
- Für die konversationelle Analyse API für AlloyDB, Cloud SQL for MySQL, Cloud SQL for PostgreSQL und Spanner gilt ein Limit von 50 Anfragen pro Minute und Projekt. Wenn Sie diese Limits erhöhen möchten, wenden Sie sich an den Google Cloud Customer Care.
Fragetypeneinschränkungen
Die Conversational Analytics API unterstützt Fragen, die mit einer einzelnen Visualisierung beantwortet werden können, z. B.:
- Trends der Messwerte im Zeitverlauf
- Aufschlüsselung oder Verteilung eines Messwerts nach Dimension
- Eindeutige Werte für eine oder mehrere Dimensionen
- Einzelne Messwerte
- Die wichtigsten Dimensionswerte nach Messwert
Die konversationelle Analyse API unterstützt noch keine Fragen, die nur mit den folgenden Arten von komplizierten Visualisierungen beantwortet werden können:
- Vorhersage und Prognose
- Erweiterte statistische Analysen, einschließlich Korrelations- und Anomalieerkennung