本頁面由 Cloud Translation API 翻譯而成。

對話式數據分析 API 版本資訊

這些版本資訊適用於 Conversational Analytics API 的更新。

2025 年 9 月 25 日

Conversational Analytics API 更新：

我們推出新的 ListAccessibleDataAgents API，可列出使用者在專案中可存取的所有資料代理程式。如果叫用 API 的使用者對資料代理程式具有 get 權限，則視為可存取資料代理程式。您可以使用 creator_filter 欄位管理這個方法傳回的代理程式：

NONE (預設)：傳回使用者可存取的所有資料代理程式，不論建立者為何。
CREATOR_ONLY：只傳回使用者建立的資料代理程式。
NOT_CREATOR_ONLY：只會傳回其他使用者建立的資料代理程式。

systemMessage.text.textType 列舉現在提供 FINAL_RESPONSE 和 THOUGHT 值，可協助用戶區分不同類型的簡訊。對話式 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 現已開放公開測試。

用戶端程式庫更新：

現在提供多種語言版本的用戶端程式庫：

Conversational Analytics API 更新：

現在支援 HTTP REST 的 v1beta 端點。

REST API 和 SDK 已新增對 GetLocation 和 ListLocations 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 上推出。透過對話式數據分析 API Golden Demo，您可以查看將對話式數據分析 API 整合至網頁應用程式的範例，以及 TypeScript 的完整正式版 Demo。這項專案僅供示範之用。不適合在正式環境中使用。

我們已為 REST API 和 SDK 新增要求酬載程式碼範例。

Conversational Analytics API 架構、工作流程和角色：進一步瞭解使用 Conversational Analytics API 的重要概念，包括資料代理程式的運作方式、典型的資料代理程式工作流程、對話模式、身分與存取權管理角色，以及如何設計使用多個資料代理程式的系統。

對話式數據分析 API 已知限制：進一步瞭解資料來源數量、視覺化樣式和資料集大小的限制。

排解 Conversational Analytics API 錯誤：進一步瞭解 Conversational Analytics API 的潛在問題或錯誤，以及建議的解決方案。

監控及管理 Conversational Analytics API 代理程式的 BigQuery 費用：進一步瞭解如何為 Conversational Analytics API 代理程式實作費用控管機制。

SetIAMPolicy 和 GetIAMPolicy 方法可在對話式數據分析 API 總覽說明文件頁面中找到，用於共用資料代理程式。

我們新增了說明文件頁面，提供對話式數據分析 API 常見問題的解答。

為 BigQuery 資料來源定義資料代理程式環境：進一步瞭解如何為 BigQuery 資料來源編寫系統指令。

為 Looker 資料來源定義資料代理程式環境：進一步瞭解如何為 Looker 資料來源編寫系統指令。

2025 年 7 月 15 日

我們推出新的最佳做法指南，協助您為服務專員提供有效的業務和資料背景資訊。詳情請參閱「使用撰寫的內容引導代理程式行為」。

SDK 更新：

您現在可以從 Python Package Index (PyPI) 安裝 Python SDK。

2025 年 6 月 25 日

API 更新：

新的預先定義 IAM 角色可控管資料代理程式的建立、管理和互動存取權：

geminidataanalytics.dataAgentCreator
geminidataanalytics.dataAgentOwner
geminidataanalytics.dataAgentEditor
geminidataanalytics.dataAgentUser
geminidataanalytics.dataAgentViewer
geminidataanalytics.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。如需更新要求的詳細操作說明，請參閱遷移指南。