הערות לגרסה של Conversational Analytics API

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

‫11 בפברואר 2026

עדכונים ב-Conversational Analytics API:

בבקשות לצ'אט עם מקורות נתונים של BigQuery, אפשר לקבל עכשיו תובנות נוספות לגבי תהליך החשיבה של ה-Agent. למרות שסכימת ה-API לא השתנתה, תראו את ההתנהגויות החדשות הבאות בזרם התגובה:

  • זרם התגובה של ה-API כולל עכשיו הודעות נוספות של systemMessage.text עם textType = THOUGHT. הודעות אלה מספקות תובנה שלב אחר שלב לגבי החשיבה הרציונלית של ה-Agent ותהליך קבלת ההחלטות שלו.
  • אחרי THOUGHT ההודעות, ה-API מחזיר את התשובה כרצף של הודעות, כמו שאילתה, משימה, טקסט, תוצאת נתונים והודעות תרשים. מידע נוסף על סוגי הודעות זמין במאמר SystemMessage.
  • הודעות סכימה לא נכללות יותר בזרם התגובה למקורות נתונים של BigQuery.

שיטות סינכרוניות לניהול סוכנים זמינות. ה-methods האלה מאפשרות ליצור, לעדכן ולמחוק סוכני נתונים באופן סינכרוני, כחלופה ל-methods אסינכרוניות קיימות:

  • CreateDataAgentSync
  • UpdateDataAgentSync
  • DeleteDataAgentSync

אפשרות הניתוח ב-Python‏ (options.analysis.python.enabled) לא נתמכת יותר במקורות נתונים של BigQuery.

‫6 בפברואר 2026

עדכונים ב-Conversational Analytics API:

עכשיו אפשר להגדיר שאילתות Looker מושלמות כהקשר מובנה לסוכני נתונים שמשתמשים במקורות נתונים של Looker.

‫26 בינואר 2026

עדכונים ב-Conversational Analytics API:

שיפור השקיפות של תהליך החשיבה הרציונלית, שמספק תובנות שלב אחר שלב לגבי תהליך החשיבה הרציונלית של הסוכן ותהליך קבלת ההחלטות שלו באמצעות textType = THOUGHT הודעות, כבר לא דורש רשימת היתרים וזמין לכל המשתמשים במקורות נתונים של Looker.

אחזור נתונים גרנולרי ממקורות נתונים של Looker, שמאפשר לקבל עדכונים על חיפושים של ערכי נתונים באמצעות הודעות textType = PROGRESS, כבר לא דורש רשימת היתרים וזמין לכל המשתמשים.

‫15 בדצמבר 2025

עדכונים ב-Conversational Analytics API:

זרם התגובה של ה-API למקורות נתונים של Looker כולל הודעות נוספות עם systemMessage.text textType = THOUGHT. ההודעות האלה מספקות תובנות מפורטות לגבי תהליך החשיבה הרציונלית של ה-Agent והתהליך שבו הוא מקבל החלטות בזמן שהוא עובד על מתן תשובה לשאילתה שלכם. כדי להריץ דוגמאות לשיחות שמדגימות את החשיבה הרציונלית הזו, אפשר לעיין ב-notebooks של Colaboratory‏ HTTP ו-Python SDK. הוראות להצגת הודעות THOUGHT עם מקורות נתונים של Looker זמינות במאמר הצגת תשובות של סוכנים עם מקורות נתונים של Looker. זוהי הודעה מוקדמת על תכונה ניסיונית שזמינה לפי בקשה. כדי לבקש גישה לתכונה הזו, צריך לשלוח אימייל לכתובת conversational-analytics-api-feedback@google.com.

הערה: החל מ-26 בינואר 2026, התכונה הזו לא דורשת יותר רשימת היתרים וזמינה לכל המשתמשים במקורות נתונים של Looker. אפשר לעיין בערך מ-26 בינואר 2026.

במקורות נתונים של Looker, הסוכנים משתמשים בשיטות מפורטות יותר כדי לאחזר סכימות של ניתוחים וערכי נתונים. כשסוכן מחפש ערכי נתונים ספציפיים, זרם ה-API כולל גם systemMessage.text הודעות עם textType = PROGRESS, שמספקות עדכונים על סטטוס החיפוש והתוצאות. הוראות להצגת הודעות PROGRESS זמינות במאמר הצגת תגובות של סוכנים למקורות נתונים של Looker. זוהי הודעה מוקדמת על תכונה ניסיונית שזמינה לפי בקשה. כדי לבקש גישה לתכונה הזו, צריך לשלוח אימייל לכתובת conversational-analytics-api-feedback@google.com.

הערה: החל מ-26 בינואר 2026, התכונה הזו לא דורשת יותר רשימת היתרים וזמינה לכל המשתמשים במקורות נתונים של Looker. אפשר לעיין בערך מ-26 בינואר 2026.

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

תוקנה בעיה שגרמה לכך שbig_query_max_billed_bytes לא הוחל בצורה נכונה.

תוקנו בעיות שקשורות לאופן שבו ה-API מטפל במקורות נתונים של Looker, כולל הבעיות הבאות:

  • עיצוב טוב יותר של ערכים בתשובות טקסט
  • סינון משופר של התאמות מדויקות
  • שיפור התמיכה במדדים של השוואה לתקופה קודמת (PoP)
  • תמיכה משופרת ב-always_filter

עדכונים בספריות לקוח:

הוספנו את ספריות הלקוח הבאות:

‫21 באוקטובר 2025

עדכונים ב-Conversational Analytics API:

הוספנו תמיכה בdeleteConversation API method ל-REST APIs ול-SDK.

‫25 בספטמבר 2025

עדכונים ב-Conversational Analytics API:

‫API חדש, ‏ ListAccessibleDataAgents, זמין עכשיו כדי להציג רשימה של סוכני נתונים שמשתמש יכול לגשת אליהם בפרויקט. סוכן נתונים נחשב לנגיש אם למשתמש שמפעיל את ה-API יש את ההרשאה get בסוכן. אפשר להשתמש בשדה creator_filter כדי לקבוע אילו סוכנים יוחזרו על ידי השיטה הזו:

  • ‫NONE (ברירת מחדל): מחזירה את כל סוכני הנתונים שהמשתמש יכול לגשת אליהם, ללא קשר ליוצר.
  • ‫CREATOR_ONLY: מחזירה רק את סוכני הנתונים שהמשתמש יצר.
  • ‫NOT_CREATOR_ONLY: מחזירה רק את סוכני הנתונים שנוצרו על ידי משתמשים אחרים.

ה-enum‏ systemMessage.text.textType זמין עכשיו עם הערכים FINAL_RESPONSE ו-THOUGHT, ועוזר ללקוחות להבחין בין סוגים שונים של הודעות טקסט. ממשק Conversational Analytics API משתמש עכשיו בהודעות systemMessage.text עם textType = THOUGHT כדי ליצור שלבי חשיבה.

ה-API תומך עכשיו בעד חמישה מקורות נתונים של Looker Explore בהקשר. בקשות בצ'אט יוצרות שאילתות ב'ניתוח נתונים' הרלוונטי ביותר. מידע נוסף זמין במאמרים בנושא חיבור לנתוני Looker באמצעות HTTP ובאמצעות Python SDK.

השדה systemMessage.data.generatedLookerQuery הוא עכשיו systemMessage.data.query.looker.

‫25 באוגוסט 2025

ה-API של ניתוח נתונים בממשק שיחה זמין עכשיו ב-Public Preview.

עדכונים בספריות לקוח:

ספריות הלקוח הבאות זמינות עכשיו בכמה שפות:

עדכונים ב-Conversational Analytics API:

התמיכה בנקודות קצה v1beta עבור HTTP REST זמינה עכשיו.

הוספנו תמיכה ב-methods של API‏ GetLocation ו-ListLocations לממשקי ה-API ל-REST ול-SDK.

עכשיו אפשר לשתף סוכני נתונים באמצעות השיטות GetIamPolicy ו-SetIamPolicy של ה-API.

עכשיו אפשר ליצור סוכני נתונים ממקורות נתונים של Looker שמבוססים על מופעים של Looker (Google Cloud core) שמשתמשים ברשתות IP פרטיות. ממשק ה-API של ניתוח שיחות לא תומך במקורות נתונים שמבוססים על מופעים של Looker ‏(שירות הליבה של Google Cloud) שנמצאים בתוך גבולות גזרה של ענן וירטואלי פרטי (VPC).

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

יש עכשיו תמיכה בממשקי API של מיקום ופעולה. לתפקידים ב-IAM‏ DataAgentCreator ו-DataAgentEditor יהיו עכשיו הרשאות ל-Operation APIs.

בוצע שיפור באחסון האוטומטי של Last Published Context בשכבת השרת בכל פעם שההקשר שפורסם של סוכן נתונים מתעדכן.

השמות המוצגים של תפקידים בניהול זהויות וגישה (IAM) עודכנו ל-Gemini Data Analytics Stateless Chat User (משתמש ב-Gemini Data Analytics לשיחה ללא שמירת מצב) ול-Gemini Data Analytics Data Agent Creator (יוצר סוכן נתונים ב-Gemini Data Analytics). מידע נוסף על התפקידים בניהול הזהויות והרשאות הגישה שמשמשים עם ה-API זמין בדף התיעוד בנושא הענקת תפקידים והרשאות בניהול הזהויות והרשאות הגישה (IAM) של Conversational Analytics API.

גרסה 1.1 של Colaboratory זמינה עכשיו.

בוצעו עדכונים לטיפול בשגיאות כדי לטפל בשגיאות פנימיות מסוג 500 שקשורות לשיחות בצ'אט עם שמירת מצב.

הטמענו הודעות משופרות לטיפול בחריגים בשגיאות לקוח 400.

עדכונים במסמכי התיעוד:

עכשיו אפשר להשתמש במדריך למתחילים החדש של Streamlit ב-GitHub כדי להגדיר הדגמה של Conversational Analytics API תוך דקות.

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

נוספו דוגמאות קוד של מטען ייעודי (payload) לבקשות עבור ממשקי REST API ו-SDK.

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

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

פתרון בעיות שקשורות ל-Conversational Analytics API: מידע נוסף על בעיות או שגיאות פוטנציאליות ב-Conversational Analytics API, וגם על פתרונות אפשריים.

מעקב אחרי העלויות ב-BigQuery וניהול שלהן עבור סוכני Conversational Analytics API: מידע נוסף על הטמעה של אמצעי בקרה על העלויות עבור סוכני Conversational Analytics API.

השיטות SetIAMPolicy ו-GetIAMPolicy זמינות בדף התיעוד סקירה כללית של Conversational Analytics API לשימוש בשיתוף סוכני נתונים.

עכשיו זמין דף חדש של מסמכי תיעוד עם תשובות לשאלות נפוצות על Conversational Analytics API.

הגדרת הקשר של סוכן הנתונים למקורות נתונים של BigQuery: מידע נוסף על כתיבת הוראות מערכת למקורות נתונים של BigQuery

הגדרת הקשר של סוכן הנתונים למקורות נתונים של Looker: מידע נוסף על כתיבת הוראות מערכת למקורות נתונים של Looker

‫15 ביולי 2025

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

מדריך חדש לשיטות מומלצות עוזר לכם לספק לסוכנים הקשר מידע יעיל על העסק ועל הנתונים. מידע נוסף מופיע במאמר איך מכוונים את התנהגות הנציגים באמצעות הקשר שנוצר.

עדכוני SDK:

עכשיו אפשר להתקין את Python SDK מאינדקס החבילות של Python ‏ (PyPI).

‫25 ביוני 2025

עדכוני API:

תפקידים חדשים ב-IAM שמוגדרים מראש מאפשרים לשלוט בגישה ליצירה ולניהול של סוכני נתונים, וגם באינטראקציה איתם:

  • geminidataanalytics.dataAgentCreator
  • geminidataanalytics.dataAgentOwner
  • geminidataanalytics.dataAgentEditor
  • geminidataanalytics.dataAgentUser
  • geminidataanalytics.dataAgentViewer
  • geminidataanalytics.dataAgentStatelessUser

רשימה מלאה של התפקידים וההרשאות שלהם מופיעה במאמר הקצאת תפקידים והרשאות ב-IAM ל-Conversational Analytics API.

‫5 ביוני 2025

בגרסת הפרטית הראשונית של Conversational Analytics API הוספנו יכולות ליצירה של סוכני נתונים וליצירת אינטראקציה איתם.

כדי להתחיל לעבוד עם REST ועם Python SDK, אפשר להיעזר ב-notebook האינטראקטיביים הבאים של Colaboratory:

עדכוני API:

שירות סוכן הנתונים מאפשר ליצור, להגדיר ולנהל באופן פרוגרמטיבי סוכני AI מתמידים שמודעים להקשר באמצעות Looker,‏ Looker Studio ו-BigQuery.

שירות הצ'אט עם נתונים מאפשר לכם לנהל שיחות עם הסוכן באמצעות כמה מצבי צ'אט. המצבים האלה כוללים מצב עם שמירת מצב שבו Google מנהלת את היסטוריית השיחות, אפשרות עם שמירת מצב שבה האפליקציה שלכם מנהלת את השיחה ומצב בלי שמירת מצב שבו האפליקציה שלכם מספקת את ההקשר המלא בכל בקשה.

ה-API תומך בניתוח מתקדם באמצעות Python ומבצע באופן אוטומטי ניסיון חוזר של שאילתות שנכשלו.

ה-API לניתוח שיחות (geminidataanalytics.googleapis.com) מחליף את Data QnA API (dataqna.googleapis.com) שהוצא משימוש. זה כולל את המעבר מ-DataQuestionService ל-DataChatService החדש. הוראות מפורטות לעדכון הבקשות זמינות במדריך להעברת נתונים.