Bekannte Einschränkungen der Conversational Analytics API

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 API für konversationelle Analyse beschrieben, wenn Sie eine Verbindung zu Looker- und Datenbankquellen (AlloyDB for PostgreSQL, Cloud SQL for MySQL, Cloud SQL for PostgreSQL und Spanner) herstellen und diese abfragen.

Einschränkungen bei 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 QueryData-Methode unterstützt keine BigQuery- oder Looker-Datenquellen.

Einschränkungen bei Datenbankdatenquellen

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

  • Daten-Agents greifen mit den Anmeldedaten des Nutzers, der mit dem Daten-Agent interagiert, auf die Daten zu. Wenn ein Nutzer auf einen freigegebenen Daten-Agent zugreift, für den er keinen Zugriff auf die konfigurierten Tabellen des Agents hat, kann der Daten-Agent nicht auf diese Tabellen zugreifen.

  • Die Tabellenauswahl für den Daten-Agenten gibt Ihrem Agenten vor, auf welche Tabellen er sich konzentrieren soll. Die Tabellenauswahl ist keine Sicherheitseinstellung. Auch wenn Sie angeben, dass die Datenquelle nur Informationen aus bestimmten Tabellen wie table1 und table2 abrufen darf, kann das System trotzdem Daten aus einer unbeabsichtigten Tabelle (table3) zurückgeben, wenn der Nutzer, der die Abfrage ausführt, allgemeine Berechtigungen zum Aufrufen des Inhalts von table3 in derselben Datenbank hat.

Visualisierungseinschränkungen

Die folgenden Visualisierungstypen werden unterstützt:

  • Gebiet
  • Balkendiagramm
  • 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 API für konversationelle Analyse 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_TOKENS zurückgegeben werden.
  • Die im Feld DataResult einer Systemnachricht zurückgegebenen Daten unterliegen einer 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 konversationellen Analyse-API zum Herstellen einer Verbindung zu einer privaten IP-Instanz von Looker (Google Cloud Core) 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 Compliance-Anforderungen von VPC Service Controls.
  • 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.
  • Für Ressourcen der Conversational Analytics API wird CMEK nur für Looker-Datenquellen unterstützt.
  • 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 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 konversationelle Analyse API gelten die folgenden Limits für Gesamtanfragen (einschließlich Chat- und Nicht-Chat-Anfragen):
    • Eine maximale Rate von 10 Abfragen pro Sekunde (QPS), was 600 Abfragen pro Minute (QPM) pro Projekt entspricht.
    • Eine maximale Rate von 10 Abfragen pro Sekunde, was 600 Abfragen pro Minute pro Nutzer und Projekt entspricht.
  • Ausnahmsweise gelten für Chatanfragen strengere Limits:
    • Eine maximale Rate von 30 Anfragen pro Minute pro Projekt.
    • Eine maximale Rate von 30 QPM pro Nutzer und Projekt.
  • Die Conversational Analytics API für AlloyDB, Cloud SQL for MySQL, Cloud SQL for PostgreSQL und Spanner hat ein Limit von 50 Anfragen pro Minute pro Projekt. Wenn Sie diese Limits erhöhen möchten, wenden Sie sich an den Google Cloud Kundenservice.

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