Bekannte Einschränkungen der Conversational Analytics API

Vorschau

Dieses Produkt oder Feature unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der Dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind „im Ist-Zustand“ verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Für die konversationelle Analyse 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 Looker- und Datenbankquellen herstellen und diese abfragen: AlloyDB for PostgreSQL, Cloud SQL for MySQL, Cloud SQL for PostgreSQL und Spanner.

Einschränkungen für 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-explore und eins mit dem Namen dog-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 in cat-explore und eine zum Zählen der Anzahl der Hunde in dog-explore. Der KI-Agent vergleicht die Anzahl aus beiden Anfragen, nachdem beide Anfragen abgeschlossen sind.

• Die Methode QueryData unterstützt keine BigQuery- oder Looker-Datenquellen.

Einschränkungen für Datenbankdatenquellen

Wenn Sie eine Verbindung zu AlloyDB-, Cloud SQL for MySQL-, Cloud SQL for PostgreSQL- oder Spanner-Datenquellen herstellen, beachten Sie Folgendes:

• Daten-KI-Agenten greifen mit den Anmeldedaten des Nutzers auf die Daten zu, der mit dem Daten-KI-Agenten interagiert. Wenn ein Nutzer auf einen gemeinsam genutzten 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 Daten-KI-Agenten gibt an, auf welche Tabellen sich der KI-Agent konzentrieren soll. Die Tabellenauswahl ist keine Sicherheitseinstellung. Auch wenn Sie angeben, dass die Datenquelle nur Informationen aus bestimmten Tabellen abrufen darf, z. B. table1 und table2, kann das System trotzdem Daten aus einer unerwünschten Tabelle (table3) zurückgeben, wenn der Nutzer, der die Abfrage ausführt, allgemeine Berechtigungen hat, um den Inhalt von table3 in derselben Datenbank anzusehen.

Visualisierungseinschränkungen

Die folgenden Visualisierungstypen werden unterstützt:

• Gebiet
• Balkendiagramm
• Geografische Form
• Heatmap
• Linie (Zeitreihe)
• Kreisdiagramm
• Streudiagramm

**Hinweis**: Diagramme mit Tooltips werden teilweise unterstützt und können gegebenenfalls unerwartetes Verhalten aufweisen.

Datenverarbeitungseinschränkungen

• Bei Looker-Datenquellen kann die Conversational Analytics API maximal 5.000 Zeilen pro Abfrage zurückgeben.
• Bei BigQuery-Datenquellen beschränkt die konversationelle Analyse 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 konversationellen Analyse-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_TOKENS zurückgegeben werden.
• Für die im Feld DataResult einer Systemnachricht zurückgegebenen Daten gilt eine Größenbeschränkung. Die 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 parameter definiert ist, nicht festgelegt werden.
• Die Verwendung der Conversational Analytics API zum Herstellen einer Verbindung zu einer Instanz von Looker (Google Cloud Core) mit einer privaten IP mit Data Studio Pro, wenn sich diese Instanz von Looker (Google Cloud Core) innerhalb eines VPC Service Controls-Perimeters befindet, ist keine unterstützte Konfiguration und entspricht nicht den VPC Service Controls-Compliance-Anforderungen.
• Bei Verbindungen zu Instanzen von Looker (Google Cloud Core) mit privaten IP-Konfigurationen werden von der Conversational Analytics API keine Instanzen von Looker (Google Cloud Core) unterstützt, die für die Verwendung von CMEK oder VPC Service Controls konfiguriert sind.
• Bei Conversational Analytics API-Ressourcen wird CMEK nur für Looker-Datenquellen unterstützt.
• Die konversationelle Analyse API funktioniert nicht gut mit Data Studio-Datenquellen, bei denen Felder in Meldungen bearbeiten deaktiviert ist, da diese Einstellung verhindert, dass die konversationelle Analyse berechnete Felder erstellt.

• Wenn bei der Validierung oder Ausführung einer Abfrage ein Fehler auftritt, kann die Conversation Analytics 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 API nicht noch einmal versucht, auch wenn sie noch unter dem Limit von drei Fehlern pro Abfrage liegt.

Kontingentbeschränkungen

• Für die Conversational Analytics API gelten die folgenden Beschränkungen für alle Anfragen (einschließlich Chat- und Nicht-Chat-Anfragen):
  • Eine maximale Rate von 10 Abfragen pro Sekunde (QPS), also 600 Abfragen pro Minute (QPM) pro Projekt.
  • Eine maximale Rate von 10 QPS, also 600 QPM pro Nutzer und Projekt.
• Ausnahmsweise gelten für Chatanfragen strengere Beschränkungen:
  • Eine maximale Rate von 1 QPS, also 60 QPM pro Projekt.
  • Eine maximale Rate von 1 QPS, also 60 QPM pro Nutzer und Projekt.
• Für die Conversational Analytics API für AlloyDB, Cloud SQL for MySQL, Cloud SQL for PostgreSQL und Spanner gilt ein Limit von 50 QPM pro Projekt. Wenn Sie diese Limits erhöhen möchten, wenden Sie sich an den Google Cloud Kundensupport.

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 Conversational Analytics 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