對話內容分析 API：建構資料代理程式，並與資料對話

不公開預先發布版

這項產品或功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。 正式發布前的產品和功能是依「原樣」提供，支援服務可能受限。 詳情請參閱「推出階段說明」。

開發人員可透過 geminidataanalytics.googleapis.com 存取 Conversational Analytics API，建構以人工智慧 (AI) 為基礎的聊天介面或資料代理，以自然語言回答 BigQuery、Looker 和 Looker Studio 中結構化資料的問題。透過 Conversational Analytics API，您可以為資料代理程式提供業務資訊和資料 (「內容」)，以及 SQL、Python 和視覺化程式庫等工具的存取權。這些服務專員回覆會顯示給使用者，且可由用戶端應用程式記錄，打造順暢且可稽核的資料即時通訊體驗。

重要事項： 如要從 Data QnA API 遷移，請參閱遷移指南，瞭解主要差異和必要遷移步驟。

瞭解 Gemini for Google Cloud 如何使用您的資料，以及使用時機。

Gemini for Google Cloud products 仍處於早期技術階段，因此可能會生成看似合理卻與事實不符的輸出內容。使用 Gemini for Google Cloud products 的輸出內容前，請先確認內容是否屬實。詳情請參閱「Gemini for Google Cloud 和負責任的 AI 技術」一文。

注意： 正式發布前預覽版產品 (1) 僅供測試環境使用，不得用於正式環境，也不得處理個人資料或其他受法律或法規遵循規定約束的資料；(2) 須遵守《服務專屬條款》的「正式發布前產品條款」和《Gemini for Google Cloud Trusted Tester Program 同意聲明附加條款》。

開始使用 Conversational Analytics API

請按照下列步驟設定環境，並使用 Conversational Analytics API 開始建構資料代理程式及與之互動。

注意： 如要使用 Conversational Analytics API，您必須加入私人搶先體驗計畫。如有意願參加，請填寫預覽版意願表單。

設定和必要條件

使用 API 或範例之前，請先完成下列步驟：

• 啟用對話式數據分析 API：說明啟用對話式數據分析 API 的先決條件。
• 授予 Conversational Analytics API IAM 角色和權限：說明用於管理資料代理程式存取權的預先定義 IAM 角色。
• 使用 Conversational Analytics API 驗證及連結資料來源：提供驗證 API 的操作說明，以及設定與 BigQuery、Looker 和 Looker Studio 資料的連結。

建構資料代理程式並與之互動

完成上述步驟後，請按照下列步驟，使用 Conversational Analytics API 建構資料代理程式並與之互動：

• 使用 HTTP 建構資料代理程式：提供完整範例，說明如何使用 Python 的直接 HTTP 要求，建構及與資料代理程式互動。
• 使用 Python SDK 建構資料代理程式：提供使用 Python SDK 建構及與資料代理程式互動的完整範例。
• 將 Conversational Analytics API 代理程式的回應顯示為資料圖表：提供範例，說明如何使用 Python SDK 和 Vega-Altair 程式庫，處理 API 回應中的圖表規格，並將其顯示為資料圖表。

主要 API 作業

這個 API 提供下列核心端點，用於管理資料代理程式和對話：

作業	HTTP 方法	端點	說明
建立虛擬服務專員	POST	/v1alpha/projects/*/locations/*/dataAgents	建立新的資料代理程式。
取得代理程式	GET	/v1alpha/projects/*/locations/*/dataAgents/*	擷取特定資料代理程式的詳細資料。
更新代理程式	PATCH	/v1alpha/projects/*/locations/*/dataAgents/*	修改現有資料代理程式。
列出代理程式	GET	/v1alpha/projects/*/locations/*/dataAgents	列出專案中可用的資料代理程式。
刪除代理程式	DELETE	/v1alpha/projects/*/locations/*/dataAgents/*	移除資料代理程式。
建立對話	POST	/v1alpha/projects/*/locations/*/conversations	發起新的持續性對話。
使用對話參考資料進行即時通訊	POST	/v1alpha/projects/*/locations/*:chat	傳送參照現有對話及其相關聯代理程式環境的即時通訊訊息，繼續進行有狀態的對話。如果是多輪對話， Google Cloud 會儲存及管理對話記錄。
使用資料代理程式參照進行即時通訊	POST	/v1alpha/projects/*/locations/*:chat	傳送無狀態的即時通訊訊息，並參照已儲存的資料代理程式來提供背景資訊。如果是多輪對話，應用程式必須管理對話記錄，並在每個要求中提供記錄。
使用內嵌脈絡對話	POST	/v1alpha/projects/*/locations/*:chat	直接在要求中提供所有內容，不使用已儲存的資料代理程式，傳送無狀態的即時通訊訊息。如果是多輪對話，應用程式必須管理對話記錄，並在每個要求中提供記錄。
取得對話	GET	/v1alpha/projects/*/locations/*/conversations/*	擷取特定對話的詳細資料。
列出對話	GET	/v1alpha/projects/*/locations/*/conversations	列出特定專案中的對話。
列出對話中的訊息	GET	/v1alpha/projects/*/locations/*/conversations/*/messages	列出特定對話中的訊息。

其他資源

• 對話式分析 API 參考說明文件：詳細說明要求和回應結構的方法、端點和型別定義。