這些版本資訊說明 Conversational Analytics API 的更新內容。
2025 年 12 月 15 日
對話式數據分析 API 更新：
Looker 和 BigQuery 資料來源的 API 回應串流包含額外的 systemMessage.text 訊息，其中含有 textType = THOUGHT。這些訊息會逐步說明代理程式的推理和決策過程，讓您瞭解代理程式如何回答查詢。如要執行聊天範例來展示這項推理功能，請參閱 HTTP 和 Python SDK Colaboratory 筆記本。如要瞭解如何使用 Looker 資料來源算繪 THOUGHT 訊息，請參閱「使用 Looker 資料來源算繪代理程式回覆」。這是實驗功能的搶先公告，這項功能必須經過申請才會啟用。如要要求存取這項功能，請傳送電子郵件至 conversational-analytics-api-feedback@google.com。
如果是 Looker 資料來源，代理程式會使用更精細的方法來擷取「探索」結構定義和資料值。當代理程式搜尋特定資料值時，API 串流也會包含 systemMessage.text 訊息和 textType = PROGRESS，提供搜尋狀態和結果的最新資訊。如需如何顯示 PROGRESS 訊息的指引，請參閱「顯示 Looker 資料來源的代理程式回覆」。這是實驗功能的搶先公告，這項功能必須經過申請才會啟用。如要要求存取這項功能，請傳送電子郵件至 conversational-analytics-api-feedback@google.com。
對話式數據分析 API 與 VPC Service Controls 的整合功能目前為預先發布版。這項整合功能已可進行更廣泛的測試和使用，但尚未完全支援正式環境。詳情請參閱支援的產品清單。
修正 big_query_max_billed_bytes 未正確套用的問題。
已修正 API 處理 Looker 資料來源的問題，包括：
- 文字回覆中的值格式更完善
- 更完善的完全比對篩選功能
- 改善對年對年 (PoP) 衡量指標的支援
- 改善
always_filter支援
用戶端程式庫更新：
新增的用戶端程式庫如下：
2025 年 10 月 21 日
對話式數據分析 API 更新：
REST API 和 SDK 已新增對 deleteConversation API 方法的支援。
2025 年 9 月 25 日
對話式數據分析 API 更新：
我們推出新的 ListAccessibleDataAgents API，可列出專案中使用者可存取的資料代理程式。如果呼叫 API 的使用者對代理程式具有 get 權限，則視為可存取資料代理程式。您可以使用 creator_filter 欄位管理這個方法傳回的代理程式：
NONE(預設)：傳回使用者可存取的所有資料代理程式，不論建立者為何。CREATOR_ONLY：只傳回使用者建立的資料代理程式。NOT_CREATOR_ONLY：只會傳回其他使用者建立的資料代理程式。
systemMessage.text.textType 列舉現在提供 FINAL_RESPONSE 和 THOUGHT 值，可協助用戶區分不同類型的簡訊。Conversational Analytics API 現在會使用含有 textType = THOUGHT 的 systemMessage.text 訊息，產生思考步驟。
API 現在最多支援五個 Looker 探索資料來源。聊天要求會在最相關的「探索」中產生查詢。詳情請參閱這篇文章，瞭解如何透過 HTTP 連線至 Looker 資料，以及這篇文章，瞭解如何透過 Python SDK 連線至 Looker 資料。
systemMessage.data.generatedLookerQuery 欄位現在是 systemMessage.data.query.looker。
2025 年 8 月 25 日
Conversational Analytics API 現已開放公開測試。
用戶端程式庫更新：
下列用戶端程式庫現已支援多種語言：
對話式數據分析 API 更新：
現在支援 HTTP REST 的 v1beta 端點。
REST API 和 SDK 已新增對 GetLocation 和 ListLocations API 方法的支援。
您現在可以使用 GetIamPolicy 和 SetIamPolicy API 方法共用資料代理程式。
您現在可以從 Looker 資料來源建構資料代理程式，這些資料來源是以使用私人 IP 網路的 Looker (Google Cloud Core) 執行個體為基礎。(Conversational Analytics API 不支援以虛擬私有雲邊界內的 Looker (Google Cloud Core) 執行個體為基礎的資料來源)。
BigQuery 資料來源的結構化內容現已推出。包括使用 API 在資料表和欄位層級新增範例問題/查詢配對、資料表說明、同義字和標記。
現在支援位置和作業 API。DataAgentCreator 和 DataAgentEditor Identity and Access Management 角色現在將擁有作業 API 的權限。
當資料代理程式發布的環境更新時，系統會在伺服器層自動儲存 Last Published Context。
Identity and Access Management 角色的顯示名稱已更新為「Gemini Data Analytics 無狀態對話使用者」和「Gemini Data Analytics 資料代理建立者」。如要進一步瞭解 API 使用的 Identity and Access Management 角色，請參閱「授予 Conversational Analytics API Identity and Access Management 角色和權限」說明文件頁面。
Colaboratory 1.1 版現已推出。
我們更新了錯誤處理機制，可處理有狀態對話的 500 內部錯誤。
針對 400 用戶端錯誤，我們已實作更完善的例外狀況處理訊息。
說明文件更新：
您現在可以使用 GitHub 上的全新 Streamlit 快速入門應用程式，在幾分鐘內設定 Conversational Analytics API 的試用版。
Conversational Analytics API Golden Demo 現已在 GitHub 上推出。透過 Conversational Analytics API Golden Demo，您可以查看將 Conversational Analytics API 整合至網頁應用程式的範例，以及 TypeScript 的完整正式版試用。這項專案僅供示範之用。不適合用於正式環境。
Conversational Analytics API 架構、工作流程和角色：進一步瞭解使用 Conversational Analytics API 的重要概念，包括資料代理程式的運作方式、典型的資料代理程式工作流程、對話模式、身分與存取權管理角色，以及如何設計使用多個資料代理程式的系統。
對話式數據分析 API 已知限制：進一步瞭解資料來源數量、視覺化樣式和資料集大小的限制。
排解 Conversational Analytics API 錯誤：進一步瞭解 Conversational Analytics API 的潛在問題或錯誤，以及建議的解決方案。
監控及管理 Conversational Analytics API 代理程式的 BigQuery 費用：進一步瞭解如何為 Conversational Analytics API 代理程式實作費用控管機制。
對話式數據分析 API 總覽說明文件頁面提供 SetIAMPolicy 和 GetIAMPolicy 方法，可用於共用資料代理程式。
我們已推出新的說明文件頁面，其中包含對話式數據分析 API 常見問題的解答。
為 BigQuery 資料來源定義資料代理程式環境：進一步瞭解如何為 BigQuery 資料來源編寫系統指令。
為 Looker 資料來源定義資料代理程式環境：進一步瞭解如何為 Looker 資料來源編寫系統指令。
2025 年 7 月 15 日
您現在可以指派預先定義的 IAM 角色，邀請使用者協作處理特定資料代理程式。詳情請參閱「Conversational Analytics API IAM 角色和權限」。
我們推出新的最佳做法指南，協助您為服務專員提供有效的業務和資料背景資訊。詳情請參閱「使用撰寫的內容引導代理程式行為」。
SDK 更新：
您現在可以從 Python Package Index (PyPI) 安裝 Python SDK。
2025 年 6 月 25 日
API 更新：
新的預先定義 IAM 角色可控管建立、管理及與資料代理程式互動的存取權：
geminidataanalytics.dataAgentCreatorgeminidataanalytics.dataAgentOwnergeminidataanalytics.dataAgentEditorgeminidataanalytics.dataAgentUsergeminidataanalytics.dataAgentViewergeminidataanalytics.dataAgentStatelessUser
如需角色和權限的完整清單，請參閱「授予 Conversational Analytics API IAM 角色和權限」。
2025 年 6 月 5 日
對話式數據分析 API 的初始搶先體驗版，導入了建立資料代理和與資料代理互動的功能。
如要開始使用 REST 和 Python SDK，請參閱下列互動式 Colaboratory 筆記本：
API 更新：
資料代理程式服務可讓您透過程式輔助，使用 Looker、Looker Studio 和 BigQuery 建立、設定及管理持續性 AI 代理程式，並提供相關背景資訊。
資料對話服務提供多種對話模式，可與代理程式進行對話。這些模式包括：由 Google 管理對話記錄的有狀態模式、由應用程式管理對話的有狀態模式，以及由應用程式在每次要求中提供完整脈絡的無狀態模式。
這項 API 支援使用 Python 進行進階分析，並會自動重試失敗的查詢。
對話式數據分析 API (geminidataanalytics.googleapis.com) 會取代已淘汰的 Data QnA API (dataqna.googleapis.com)，包括從 DataQuestionService 遷移至新的 DataChatService。如需更新要求的詳細操作說明，請參閱遷移指南。