開發人員可透過 geminidataanalytics.googleapis.com 存取 Conversational Analytics API，建構以人工智慧 (AI) 技術為基礎的聊天介面或資料代理，以自然語言回答 BigQuery、Looker 和 Looker Studio 中結構化資料的問題。透過 Conversational Analytics API，您可以為資料代理程式提供業務資訊和資料 (「內容」)，以及 SQL、Python 和視覺化程式庫等工具的存取權。這些服務專員回覆會顯示給使用者，且可由用戶端應用程式記錄，打造流暢且可稽核的資料即時通訊體驗。
瞭解 Gemini for Google Cloud 如何使用您的資料，以及使用時機。
開始使用 Conversational Analytics API
如要開始使用 Conversational Analytics API，請先參閱架構和重要概念說明文件，瞭解代理程式如何處理要求、代理程式建立者和使用者的工作流程、對話模式，以及身分與存取權管理 (IAM) 角色。接著，如要開始建構資料代理程式，您可以選擇透過 Colaboratory 筆記本取得指引，也可以按照「設定和必要條件」中的步驟自行操作。
互動式 Colaboratory 筆記本
如需互動式逐步指南，瞭解如何設定環境、建構資料代理程式及發出 API 呼叫，請參閱下列 Colaboratory 筆記本：
- Conversational Analytics API HTTP Colaboratory 筆記本
- Conversational Analytics API SDK Colaboratory 筆記本
設定和前置條件
使用 API 或範例之前，請先完成下列步驟：
- 啟用 Conversational Analytics API：說明啟用 Conversational Analytics API 的必要條件。
- 授予 Conversational Analytics API IAM 角色和權限：說明用於管理資料代理程式存取權的預先定義 IAM 角色。
- 使用 Conversational Analytics API 驗證及連線至資料來源：提供驗證 API 的操作說明，以及設定與 BigQuery、Looker 和 Looker Studio 資料的連線。
建構資料代理程式並與之互動
完成上述步驟後，請按照下列步驟，使用 Conversational Analytics API 建構資料代理程式並與之互動：
- 使用 HTTP 建構資料代理程式：提供完整範例，說明如何使用 Python 的直接 HTTP 要求，建構及與資料代理程式互動。
- 使用 Python SDK 建構資料代理程式：提供使用 Python SDK 建構及與資料代理程式互動的完整範例。
- 撰寫有效的系統指示：瞭解如何為
system_instruction參數建構 YAML 內容，引導代理程式行為並提升回覆準確度。您也可以在 BigQuery 資料來源和 Looker 資料來源中查看系統指令範例。 - 將 Conversational Analytics API 代理程式的回應顯示為資料圖表：提供範例，說明如何使用 Python SDK 和 Vega-Altair 程式庫，處理 API 回應中的圖表規格，並將其顯示為資料圖表。
最佳做法
- 管理代理程式的 BigQuery 費用：瞭解如何設定專案層級、使用者層級和查詢層級的支出上限，監控及管理 Conversational Analytics API 代理程式的 BigQuery 費用。
主要 API 作業
這個 API 提供下列核心端點，用於管理資料代理程式和對話：
| 作業 | HTTP 方法 | 端點 | 說明 |
|---|---|---|---|
| 建立虛擬服務專員 | POST |
/v1beta/projects/*/locations/*/dataAgents |
建立新的資料代理程式。 |
| 取得代理程式 | GET |
/v1beta/projects/*/locations/*/dataAgents/* |
擷取特定資料代理程式的詳細資料。 |
| 取得身分與存取權管理政策 | POST |
/v1beta/projects/*/locations/*/dataAgents/*:getIamPolicy |
取得指派給特定資料代理程式的每位使用者身分與存取權管理權限。具有資料代理程式擁有者角色的使用者可以呼叫這個端點，查看資料代理程式的身分與存取權管理政策，然後使用 setIAMpolicy 端點與其他使用者共用資料代理程式。 |
| 設定身分與存取權管理政策 | POST |
/v1beta/projects/*/locations/*/dataAgents/*:setIamPolicy |
為特定資料代理程式設定 Identity and Access Management 政策。具有資料代理程式擁有者角色的使用者應呼叫這個端點，與其他使用者共用資料代理程式，這會有效更新這些使用者的身分與存取權管理權限。 |
| 更新代理程式 | PATCH |
/v1beta/projects/*/locations/*/dataAgents/* |
修改現有資料代理程式。 |
| 列出代理程式 | GET |
/v1beta/projects/*/locations/*/dataAgents |
列出專案中可用的資料代理程式。 |
| 刪除代理程式 | DELETE |
/v1beta/projects/*/locations/*/dataAgents/* |
移除資料代理程式。 |
| 建立對話 | POST |
/v1beta/projects/*/locations/*/conversations |
發起新的持續性對話。 |
| 使用對話參考資料進行即時通訊 | POST |
/v1beta/projects/*/locations/*:chat |
傳送參照現有對話及其相關聯代理程式環境的即時通訊訊息，繼續進行有狀態的對話。如果是多輪對話， Google Cloud 會儲存及管理對話記錄。 |
| 使用資料代理程式參照進行即時通訊 | POST |
/v1beta/projects/*/locations/*:chat |
傳送無狀態的即時通訊訊息，並參照已儲存的資料代理程式來提供背景資訊。如果是多輪對話，應用程式必須管理對話記錄，並在每個要求中提供記錄。 |
| 使用內嵌脈絡對話 | POST |
/v1beta/projects/*/locations/*:chat |
直接在要求中提供所有內容，不使用已儲存的資料代理程式，傳送無狀態的即時通訊訊息。如果是多輪對話，應用程式必須管理對話記錄，並在每個要求中提供記錄。 |
| 取得對話 | GET |
/v1beta/projects/*/locations/*/conversations/* |
擷取特定對話的詳細資料。 |
| 列出對話 | GET |
/v1beta/projects/*/locations/*/conversations |
列出特定專案中的對話。 |
| 列出對話中的訊息 | GET |
/v1beta/projects/*/locations/*/conversations/*/messages |
列出特定對話中的訊息。 |
提供意見
請使用下列連結回報錯誤或要求功能。
提供意見
請使用下列連結回報錯誤或要求功能。
其他資源
- Conversational Analytics API 參考說明文件：詳細說明要求和回應結構的方法、端點和型別定義。
- 排解 Conversation Analytics API 錯誤：排解常見的 Conversation Analytics API 錯誤。