מגבלות ידועות ב-Conversational Analytics API

ל-Conversational Analytics API יש את המגבלות הידועות הבאות על מספר מקורות הנתונים, סגנון ההמחשות וגודל מערכי הנתונים.

מגבלות על מקורות נתונים

בקטע הזה מתוארים האילוצים וההתנהגויות של Conversational Analytics API כשמתחברים למקורות של Looker ומסדי נתונים ושולחים אליהם שאילתות – AlloyDB ל-PostgreSQL,‏ Cloud SQL ל-MySQL,‏ Cloud SQL ל-PostgreSQL ו-Spanner.

מגבלות של מקורות נתונים ב-Looker

כשמתחברים למקור נתונים של Looker, חשוב לשים לב לנקודות הבאות:

  • אתם יכולים לשאול שאלות על כל דוח Explore שמופיע בשיחה.
  • סוכן יכול לשלוח שאילתה רק ל-Explore אחד בכל פעם. אי אפשר להריץ שאילתות בכמה דוחות Explore בו-זמנית.
  • סוכן יכול לשאול שאילתות בכמה ניתוחים באותה שיחה.

  • סוכן יכול לשלוח שאילתות לכמה ניתוחים בשיחה שכוללת שאלות עם כמה חלקים, או בשיחות שכוללות שאלות המשך.

    לדוגמה: משתמש מקשר שני דוחות Explore, אחד בשם cat-explore ואחד בשם dog-explore. המשתמש מזין את השאלה 'מה גדול יותר: מספר החתולים או מספר הכלבים?' ייווצרו שתי שאילתות: אחת לספירת מספר החתולים ב-cat-explore ואחת לספירת מספר הכלבים ב-dog-explore. הנציג משווה את המספר משתי השאילתות אחרי שהוא מסיים את שתיהן.

  • השיטה QueryData לא תומכת במקורות נתונים של BigQuery או Looker.

מגבלות על מקורות נתונים של מסדי נתונים

כשמתחברים למקורות נתונים של AlloyDB,‏ Cloud SQL ל-MySQL,‏ Cloud SQL ל-PostgreSQL או Spanner, כדאי לשים לב לנקודות הבאות:

  • סוכני נתונים ניגשים לנתונים באמצעות פרטי הכניסה של המשתמש שמקיים אינטראקציה עם סוכן הנתונים. אם משתמש ניגש לסוכן נתונים משותף שאין לו גישה לטבלאות שהוגדרו בסוכן, סוכן הנתונים לא יכול לגשת לטבלאות האלה.

  • הטבלאות שנבחרו לסוכן הנתונים עוזרות לסוכן להתמקד בטבלאות הרלוונטיות. בחירת טבלה היא לא הגדרת אבטחה. גם אם מציינים שמקור הנתונים יכול לשלוף מידע רק מטבלאות מסוימות – כמו table1 ו-table2 – המערכת עדיין עשויה להחזיר נתונים מטבלה לא רצויה (table3) אם למשתמש שמריץ את השאילתה יש הרשאות כלליות לצפייה בתוכן של table3 באותו מסד נתונים.

מגבלות של תצוגות חזותיות

אלה סוגי התרשימים להמחשה שנתמכים:

  • אזור
  • עמודה
  • Geoshape
  • מפת חום
  • קו (פעולות על ציר הזמן)
  • עוגה
  • פיזור

מגבלות על עיבוד נתונים

  • במקורות נתונים של Looker, ממשק Conversational Analytics API יכול להחזיר עד 5,000 שורות לכל שאילתה.
  • במקורות נתונים של BigQuery, ממשק Conversational Analytics API מגביל את השאילתות על נתונים ל-500GB של בייטים שעברו עיבוד.
  • במקורות נתונים של AlloyDB,‏ Cloud SQL ל-MySQL,‏ Cloud SQL ל-PostgreSQL ו-Spanner,‏ Conversational Analytics API יכול להחזיר עד 1,000 שורות לכל שאילתה.
  • היכולות של ממשק ה-API של Conversational Analytics, שמבוססות על Python, לניתוח נתונים ולאחזור תוכן יכולות להתמודד עם מורכבויות זמן של עד O(100k) שורות.
  • שאילתות על כמויות גדולות של נתונים עלולות לגרום לירידה ברמת הדיוק של ההסברים של סוכני הנתונים.
  • האורך המקסימלי של פלט הטוקנים ב-Conversational Analytics API הוא 8,192 טוקנים. הפעלת שאילתות על כמויות גדולות של נתונים עלולה להחזיר שגיאת MAX_TOKENS.
  • יש מגבלת גודל על הנתונים שמוחזרים בשדה DataResult של הודעת מערכת. התוצאות של הנתונים מקוצרות למקסימום של 3,000,000 בייט. במהלך התהליך הזה, המערכת משאירה כמה שיותר שורות מלאות במסגרת מגבלת הגודל.

מגבלות על שאילתות

  • אין תמיכה בתכונה של BigQuery שמאפשרת להגדיר שמות עמודות גמישים.
  • יש תמיכה ב-Structs ב-BigQuery, אבל לפעמים הפעולה נכשלת.
  • במקורות נתונים של Looker, ה-API לא יכול להגדיר את הערך של שדה לסינון בלבד שמוגדר באמצעות הפרמטר parameter של LookML.
  • שימוש ב-Conversational Analytics API כדי להתחבר למופע פרטי של Looker (Google Cloud core) באמצעות Data Studio Pro, כשהמופע הזה של Looker (Google Cloud core) נמצא בתוך גבולות גזרה של Service Controls בענן וירטואלי פרטי (VPC), הוא לא תצורה נתמכת ולא עומד בדרישות התאימות של Service Controls בענן וירטואלי פרטי (VPC).
  • בחיבורים למופעים של Looker (Google Cloud core) עם הגדרות של כתובות IP פרטיות, Conversational Analytics API לא תומך במופעים של Looker (Google Cloud core) שמוגדרים לשימוש ב-CMEK או ב-VPC Service Controls.
  • ממשק ה-API של ניתוח נתוני השיחות לא פועל טוב עם מקורות נתונים של Data Studio שבהם השבתת עריכת שדות בדוחות מושבתת, כי ההגדרה הזו מונעת מניתוח נתוני השיחות ליצור שדות מחושבים.

  • אם מתרחשת שגיאה במהלך אימות או ביצוע של שאילתה, יכול להיות ש-Conversational Analytics API ינסה לבצע את הפעולה מחדש באופן אוטומטי על ידי יצירת שאילתה מתוקנת. המערכת תנסה לשלוח מחדש את הבקשה עד שלוש פעמים.

    אם שאילתה נכשלת בגלל בעיות בהרשאות או באימות, Conversational Analytics API לא ינסה שוב להריץ את השאילתה. ניסיונות חוזרים הם לא דטרמיניסטיים. אם בהודעת השגיאה מצוין שלא ניתן לשחזר שאילתה, Conversational Analytics API לא ינסה שוב את השאילתה, גם אם היא עדיין מתחת למגבלה של שלוש שגיאות לכל בקשה.

מגבלות המכסה

  • ל-Conversational Analytics API יש את המגבלות הבאות על בקשות כוללות (כולל בקשות לצ'אט ובקשות אחרות):
    • קצב מקסימלי של 30 שאילתות לשנייה (QPS), כלומר 1,800 שאילתות לדקה (QPM) לכל פרויקט.
    • קצב מקסימלי של 10 QPS, כלומר 600 QPM לכל משתמש לכל פרויקט.
  • כחריג, יש מגבלות מחמירות יותר על בקשות לצ'אט:
    • קצב מקסימלי של 30 שאילתות לדקה לכל פרויקט.
    • קצב מקסימלי של 30 שאילתות לדקה לכל משתמש לכל פרויקט.
    • כל בקשה לצ'אט נספרת כ-8 יחידות מכסה, במקום יחידה אחת כמו בדרך כלל. כתוצאה מכך, בדף Quotas במסוף Google Cloud מוצגות מגבלות שהן פי 8 מהמגבלות בפועל על הבקשות. לדוגמה, מגבלה של 240 יחידות מייצגת 30 בקשות לצ'אט.
  • הקצב המקסימלי של בקשות Agent-to-Agent ‏ (A2A) הוא 10 QPS, כלומר 600 QPM לכל פרויקט לכל סוכן.
  • ל-API של ניתוח נתונים שיחתי ל-AlloyDB, ל-Cloud SQL ל-MySQL, ל-Cloud SQL ל-PostgreSQL ול-Spanner יש מגבלה של 50 שאילתות לדקה לכל פרויקט. כדי להגדיל את המגבלות האלה, צריך לפנות אל Google Cloud שירות לקוחות.

מגבלות על סוגי שאלות

  • ה-API של ניתוח הנתונים בשיחה תומך בשאלות שאפשר לענות עליהן באמצעות תרשים להמחשה אחד, למשל:

    • מגמות של המדדים לאורך זמן
    • פירוט או התפלגות של המדדים לפי מאפיין
    • ערכים ייחודיים של אחד או כמה מהמאפיינים
    • ערכים של מדד מסוים
    • הערכים של המאפיינים הבולטים לפי מדד

  • ה-API של ניתוח נתונים בממשק שיחה עדיין לא תומך בשאלות שאפשר לענות עליהן רק באמצעות סוגי התרשימים המורכבים הבאים:

    • חיזוי
    • ניתוח סטטיסטי מתקדם, כולל זיהוי מתאמים ואנומליות