Bekannte Einschränkungen der Conversational Analytics API

Vorschau

Dieses Produkt oder diese Funktion unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und ‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

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

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.

• Die Methoden Chat und DataAgent unterstützen keine Datenbankdatenquellen wie AlloyDB for PostgreSQL, Spanner, Cloud SQL und Cloud SQL for PostgreSQL.

Visualisierungseinschränkungen

• Die folgenden Visualisierungstypen werden vollständig unterstützt: Liniendiagramm, Flächendiagramm, Balkendiagramm (horizontal, vertikal, gestapelt), Streudiagramm, Kreisdiagramm
• Diese Visualisierungstypen werden teilweise unterstützt und können gegebenenfalls unerwartetes Verhalten aufweisen: Karten, Heatmaps, Diagramme mit Tooltips

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.
• 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_TOKENS zurückgegeben werden.
• Die im Feld DataResult einer Systemnachricht zurückgegebenen Daten unterliegen einer Größenbeschränkung. Die Daten werden auf maximal 3.000.000 Byte gekürzt. Bei diesem Prozess 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 Looker 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 kundenverwaltete Verschlüsselungsschlüssel (CMEK) oder VPC Service Controls konfiguriert sind.
• Die Conversational Analytics API funktioniert nicht gut mit Looker Studio-Datenquellen, bei denen Felder in Meldungen bearbeiten deaktiviert ist, da diese Einstellung verhindert, dass Conversational Analytics 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.

• Die Conversational Analytics API hat ein Maximum von 10 Abfragen pro Sekunde (Queries Per Second, QPS). Das ergibt maximal 600 Abfragen pro Minute (QPM) pro Projekt und 600 QPM pro Nutzer und Projekt.

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