Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

Conversational Analytics API 版本說明

以下是 Conversational Analytics API 的版本資訊。

2026 年 10 月 16 日

Conversational Analytics API 更新：

功能

Conversational Analytics API 現已支援下列加拿大區域端點，可用於 BigQuery 資料來源：

northamerica-northeast1 (蒙特婁)
northamerica-northeast2 (多倫多)

這些端點支援靜態資料的資料落地，以及使用中資料的管轄區機器學習 (ML) 處理。詳情請參閱「位置」和「資料落地」。

2026 年 10 月 13 日

Conversational Analytics API 更新：

功能

如果未在資料代理設定中指定 thinkingMode，使用 Looker 資料來源的資料代理現在會預設為 FAST，而非 THINKING。

2026 年 9 月 30 日

Conversational Analytics API 更新：

功能

Conversational Analytics API 的 BigQuery Graph 連線功能現已正式發布 (GA)。您可以設定資料代理程式，查詢一或多個圖表，或在同一個資料來源設定中合併資料表和圖表。

Conversational Analytics API 會根據圖譜結構定義和問題，使用 Graph Query Language (GQL) 或 SQL 中的 GRAPH_EXPAND 資料表值函式查詢圖譜。GQL 查詢需要 BigQuery Enterprise 或 Enterprise Plus 版預留項目，GRAPH_EXPAND 查詢則可依隨選計費。如需瞭解相關規定和限制，請參閱「連結至 BigQuery Graph」。

2026 年 9 月 3 日

Conversational Analytics API 更新：

功能

Conversational Analytics API 現已支援代理觀測功能。您可以在 Google Cloud 控制台，或使用 Cloud Monitoring 和 Cloud Trace，監控效能、延遲時間和權杖用量。詳情請參閱「建立資料代理」。

功能

Conversational Analytics API 現已支援 Deep Dive 思考模式，可處理預先發布版中的 BigQuery 資料來源。在 Deep Dive 模式下，資料代理可拆解複雜問題、調查子問題，並將發現項目彙整成詳細報表。

這項功能僅限許可清單中的人員使用。如要申請存取權和使用手冊，請提交對話式數據分析預先發布版功能意願調查表，並選取「深入探索」選項。

預先發布版期間，Deep Dive 模式有下列規定和限制：

Deep Dive 僅支援 BigQuery 資料來源。
LATEST_GA_MODEL不支援深入分析功能。
查詢通常會在 3 到 5 分鐘內完成。由於服務期限為 5 分鐘，請將用戶端逾時時間設為相同值。
不支援多輪對話。對話記錄會在解決階段清除。

功能

Conversational Analytics API 現已符合《健康保險流通與責任法案》(HIPAA) 規定。詳情請參閱「Google Cloud 的《健康保險流通與責任法案》法規遵循」。

功能

Conversational Analytics API 現在支援 DataAgent 和 Conversation 資源的資料存取透明化控管機制和存取權核准。

2026 年 6 月 23 日

Conversational Analytics API 更新：

公告

Conversational Analytics API 已正式發布 (GA)，適用於 BigQuery 和 Looker。

如要瞭解定價，請參閱「Data Cloud Agent 定價和免費試用」。

功能

Conversational Analytics API 支援 v1 REST 端點。

功能

Conversational Analytics API 現已支援資料落地。您可以使用區域和多區域端點，控管 DataAgent 和 Conversation 資源的實體位置。這些端點會對靜態資料提供承諾，並根據資料來源，對使用中的資料提供管轄區機器學習 (ML) 處理。詳情請參閱「資料落地」和「位置」。

功能

Conversational Analytics API 支援下列企業安全性和法規遵循功能：

客戶自行管理的加密金鑰 (CMEK)，用於保護資料代理和對話
VPC Service Controls：保護 service perimeter 內的資源
Cloud 稽核記錄：記錄管理員活動和資料存取
資料保留與刪除：支援企業資料抹除和保留政策

功能

Conversational Analytics API 現已支援 Agent2Agent (A2A) 通訊協定 (預先發布版)。您可以使用新的 API 方法 (例如 SendMessage、SendStreamingMessage 和 GetAgentCard) 協調多個代理。如需這些方法的使用範例，請參閱 A2A SDK 範例筆記本。

功能

Conversational Analytics API 現在支援清單方法的篩選和排序功能。使用 filter 欄位，縮小資料代理、對話和訊息的搜尋結果範圍。使用 orderBy 欄位，依名稱或建立時間排序資料代理。

如果是資料代理程式，您可以依名稱、建立時間和標籤篩選。
如果是對話，可以依相關聯的代理和標籤篩選。
如果是訊息，可以依建立時間篩選。
萬用字元支援包含 has (:) 運算子和結尾星號 (*) 的字串篩選器。例如：filter=display_name:"*" 或 filter=display_name:"foo*"。
系統會依最近活動的順序傳回對話和訊息，這些資源不支援自訂排序。

功能

此版本包含下列 BigQuery 資料來源功能和改善項目：

您現在可以在代理設定中使用 big_query_max_billed_bytes 欄位，限制代理啟動的 BigQuery 工作計費位元組數。
資料代理現在可以引用來源，例如詞彙表字詞或範例查詢，用於生成回覆。
您現在可以提供自訂 BigQuery user-defined function (UDF)，讓代理用來回答問題。
如果使用者的問題與定義的範例查詢充分相符，代理可能會直接執行該查詢，而不是生成新的查詢。發生這種情況時，API 回應會包含 matchedQuery 物件，指出已使用經過驗證的查詢。

功能

Conversational Analytics API 現已支援與 BigQuery Graph 對話。這項功能為預先發布版。

已變更

v1 API 的下列異動和淘汰項目已生效：

v1 版本不支援 SVG 和 PNG 格式的圖表。ChartOptions 中的 options.chart 欄位僅限 v1alpha 和 v1beta 版本。
context 欄位下的 credentials 欄位 (例如 dataAgentContext.credentials) 已淘汰。如要進行驗證，請直接在 ChatRequest 物件中提供憑證。
系統產生的釐清訊息 (systemMessage.clarification) 已淘汰。請改用 TextMessage 搭配 FINAL_RESPONSE 文字類型。

2026 年 4 月 16 日

Conversational Analytics API 更新：

功能

Conversational Analytics API 現在支援查詢 Lakehouse 資料表，這些資料表可連結至 Apache Iceberg REST 目錄，或與外部目錄聯合。如果使用 Lakehouse 資料表，請採用四部分 project.catalog.namespace.table (P.C.N.T) 語法。詳情請參閱「驗證並連線至資料來源」。

2026 年 3 月 30 日

Conversational Analytics API 更新：

功能

Conversational Analytics API 現在支援 AlloyDB for PostgreSQL、MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 和 Spanner 做為資料來源。這項功能可讓使用者以自然語言查詢作業資料，並將複雜的人類對話轉譯為精確的資料庫查詢，提供可做為行動依據的洞察資料。這項功能為預先發布版。如要瞭解詳情，請參考下列資源：

功能

Conversational Analytics API 的 BigQuery 資料來源更新，包含下列功能和改善項目：

Conversational Analytics API 現已透過 ObjectRef 函式與 Cloud Storage 整合。這樣一來，API 就能參照任何資料表中的 ObjectRef 資料欄，回答 Cloud Storage bucket 中非結構化資料 (例如圖片和 PDF) 的相關問題。
API 現在支援一組 BigQuery ML 函式，包括 AI.FORECAST、AI.DETECT_ANOMALIES 和 AI.GENERATE。API 可使用這些函式回答更廣泛的問題，例如預測、異常偵測和生成式 AI 任務。
Conversational Analytics API 現在可以使用 BigQuery 資料表分區功能。API 可在日期分區資料表上使用分區資料欄 (例如日期範圍)，最佳化 SQL 查詢，進而提升查詢效能並降低成本。
Conversational Analytics API 啟動的 BigQuery 工作現在會包含標籤，方便您在 Google Cloud 控制台的「BigQuery 工作記錄」中識別這些工作。這些標籤有助於監控費用、稽核代理活動，以及分析查詢效能。這些標籤不會直接顯示在 BigQuery Studio 工作記錄資料表中，但您可以查詢 INFORMATION_SCHEMA.JOBS，找出類似 {'ca-bq-job': 'true'} 的標籤：
```
SELECT
  COUNT(*) AS job_count
FROM
  `PROJECT_ID`.`region-LOCATION`.INFORMATION_SCHEMA.JOBS
WHERE
  EXISTS (
    SELECT 1
    FROM UNNEST(labels) AS label
    WHERE label.key = 'ca-bq-job' AND label.value = 'true'
  );
```
在範例查詢中，您需要替換範例值，如下所示：
- PROJECT_ID：您的 Google Cloud 專案 ID。
- LOCATION：BigQuery 工作的所在位置。

功能

如果資料代理使用 Looker 或 BigQuery 資料來源，您現在可以在對話要求中指定 thinkingMode 值為 FAST，啟用「快速」思考模式。快速思考模式可縮短整體思考時間，進而降低延遲。不過，由於回覆串流中不會發出 TextType 值為 THOUGHT 的訊息，因此這個模式會降低答案的透明度。此外，使用此模式可能會影響回覆的準確度。

功能

如果資料代理使用 Looker 資料來源，現在可以提出後續問題，釐清查詢中的模糊之處，例如有多個名稱相似的欄位。這些問題會以 TextMessage 回應的形式傳回，並加上 Clarification needed: 前置字元。詳情請參閱「提出有效問題」。

功能

如果資料代理使用 BigQuery 資料來源，現在可以提出後續問題，釐清查詢中的模糊之處，例如有多個欄位名稱相似時。系統會以 TextMessage 回應傳回這些問題。

已變更

對於使用 Looker 資料來源的資料代理，我們已進行多項改善，包括平行工具呼叫和更有效地使用 Looker 快取，以減少延遲。

2026 年 3 月 26 日

Conversational Analytics API 更新：

功能

如果是使用 Looker 資料來源的 Conversational Analytics API，您可以使用客戶自行管理的加密金鑰 (CMEK)，保護靜態 DataAgent 和 Conversation 資源。Conversational Analytics API 的 CMEK 功能目前為預先發布版。詳情請參閱「客戶自行管理的加密金鑰 (CMEK)」。

2026 年 2 月 11 日

Conversational Analytics API 更新：

功能

現在，使用 BigQuery 資料來源的對話要求，會提供更多有關代理推論過程的洞察資訊。雖然 API 架構不變，但您會發現回應串流出現下列新行為：

API 回應串流現在包含額外的 systemMessage.text 訊息，其中含有 textType = THOUGHT。這些訊息會逐步說明代理的推論和決策過程。
THOUGHT 訊息後，API 會以訊息序列的形式傳回答案，例如查詢、工作、文字、資料結果和圖表訊息。如要進一步瞭解訊息類型，請參閱「SystemMessage」。
BigQuery 資料來源的回應串流不再包含結構定義訊息。

功能

您可以使用同步代理程式管理方法。這些方法可讓您同步建立、更新及刪除資料代理，做為現有非同步方法的替代方案：

CreateDataAgentSync
UpdateDataAgentSync
DeleteDataAgentSync

已變更

BigQuery 資料來源不再支援 Python 分析選項 (options.analysis.python.enabled)。

2026 年 2 月 6 日

Conversational Analytics API 更新：

功能

如果資料代理使用 Looker 資料來源，您現在可以將黃金 Looker 查詢定義為結構化情境。

2026 年 1 月 26 日

Conversational Analytics API 更新：

功能

推論透明度提升，可透過 textType = THOUGHT 訊息逐步瞭解代理的推論和決策過程，不再需要加入許可清單，所有使用者都能用於 Looker 資料來源。

功能

Looker 資料來源的精細資料擷取功能，現在可透過 textType = PROGRESS 訊息提供資料值搜尋的更新，且不再需要加入許可清單，所有使用者都能使用。

2025 年 12 月 15 日

Conversational Analytics API 更新：

功能

Looker 資料來源的 API 回應串流包含額外的 systemMessage.text 訊息，其中含有 textType = THOUGHT。這些訊息會逐步說明代理在回答查詢時的推論和決策過程。如要執行示範這項推論功能的對話範例，請參閱 HTTP 和 Python SDK Colaboratory 筆記本。如要瞭解如何使用 Looker 資料來源轉譯 THOUGHT 訊息，請參閱「轉譯 Looker 資料來源的代理回覆」。這項實驗功能必須經過申請才會啟用，我們在此提前公告。如要申請使用這項功能，請傳送電子郵件至 conversational-analytics-api-feedback@google.com。

注意：自 2026 年 1 月 26 日起，這項功能不再需要加入許可清單，所有使用者都能用於 Looker 資料來源；請參閱 2026 年 1 月 26 日的項目。

功能

如果是 Looker 資料來源，代理會使用更精細的方法擷取探索結構定義和資料值。代理搜尋特定資料值時，API 串流也會包含 systemMessage.text 訊息和 textType = PROGRESS，提供搜尋狀態和結果的最新資訊。如需轉譯 PROGRESS 訊息的指引，請參閱「轉譯 Looker 資料來源的代理回覆」。這項實驗功能必須經過申請才會啟用，我們在此提前公告。如要申請使用這項功能，請傳送電子郵件至 conversational-analytics-api-feedback@google.com。

注意：自 2026 年 1 月 26 日起，這項功能不再需要加入許可清單，所有使用者都能用於 Looker 資料來源；請參閱 2026 年 1 月 26 日的項目。

功能

Conversational Analytics API 與 VPC Service Controls 的整合功能目前處於預先發布版階段。這項整合功能已可進行更廣泛的測試和使用，但尚未完全支援正式環境。詳情請參閱支援的產品清單。

修正項目

修正 big_query_max_billed_bytes 未正確套用的問題。

修正項目

我們已修正 API 處理 Looker 資料來源的問題，包括：

文字回覆中的值格式更清楚
更精準篩選完全比對的結果
改善對前期比較 (PoP) 測量指標的支援
改善 always_filter 支援

用戶端程式庫更新：

功能

新增的用戶端程式庫如下：

2025 年 10 月 21 日

Conversational Analytics API 更新：

功能

REST API 和 SDK 已新增對 deleteConversation API 方法的支援。

2025 年 9 月 25 日

Conversational Analytics API 更新：

功能

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

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

功能

systemMessage.text.textType 列舉現在提供 FINAL_RESPONSE 和 THOUGHT 值，可協助用戶端區分不同類型的簡訊。Conversational Analytics API 現在會使用 systemMessage.text 訊息和 textType = THOUGHT 產生思考步驟。

功能

API 現在最多支援五個 Looker Explore 資料來源。聊天要求會根據最相關的探索產生查詢。詳情請參閱使用 HTTP 和使用 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 方法的支援。

功能

現在，您可以根據使用私人 IP 網路的 Looker (Google Cloud Core) 執行個體，從 Looker 資料來源建構資料代理。(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 資料分析無狀態對話使用者」和「Gemini 資料分析資料代理建立者」。如要進一步瞭解與 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 的完整正式版示範。這項專案僅供示範。不適合在正式環境中使用。

功能

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

功能

Conversational Analytics API 架構、工作流程和角色：進一步瞭解使用 Conversational Analytics API 的重要概念，包括資料代理的運作方式、一般資料代理工作流程、對話模式、Identity and Access Management 角色，以及如何設計使用多個資料代理的系統。

功能

Conversational Analytics API 已知限制：進一步瞭解資料來源數量、圖表樣式和資料集大小的限制。

功能

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

功能

監控及管理 Conversational Analytics API 虛擬服務專員的 BigQuery 費用：進一步瞭解如何為 Conversational Analytics API 虛擬服務專員實施費用控管。

功能

SetIAMPolicy 和 GetIAMPolicy 方法可在 Conversational Analytics API 總覽說明文件頁面找到，用於共用資料代理。

功能

我們新增了說明文件頁面，解答 Conversational Analytics 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 日

公告

Conversational Analytics API 的初始私人預先發布版，推出了建立資料代理及與其互動的功能。

功能

下列互動式 Colaboratory 筆記本可協助您開始使用 REST 和 Python SDK：

API 更新：

功能

Data Agent Service 可讓您透過 Looker、Looker Studio 和 BigQuery，以程式輔助方式建立、設定及管理具備內容感知能力的永久 AI 代理。

功能

Data Chat Service 可讓您透過多種對話模式與代理對話。包括由 Google 管理對話記錄的有狀態模式、由應用程式管理對話的有狀態選項，以及由應用程式在每次要求時提供完整脈絡的無狀態模式。

功能

API 支援使用 Python 進行進階分析，並會自動重試失敗的查詢。

已變更

Conversational Analytics API (geminidataanalytics.googleapis.com) 會取代已淘汰的 Data QnA API (dataqna.googleapis.com)，包括從 DataQuestionService 遷移至新的 DataChatService。如需更新要求的詳細操作說明，請參閱遷移指南。

Conversational Analytics API 版本說明 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

2026 年 10 月 16 日

2026 年 10 月 13 日

2026 年 9 月 30 日

2026 年 9 月 3 日

2026 年 6 月 23 日

2026 年 4 月 16 日

2026 年 3 月 30 日

2026 年 3 月 26 日

2026 年 2 月 11 日

2026 年 2 月 6 日

2026 年 1 月 26 日

2025 年 12 月 15 日

2025 年 10 月 21 日

2025 年 9 月 25 日

2025 年 8 月 25 日

2025 年 7 月 15 日

2025 年 6 月 25 日

2025 年 6 月 5 日

Conversational Analytics API 版本說明