本頁說明如何為 Google Cloud 專案啟用 Conversational Analytics API (透過 geminidataanalytics.googleapis.com 或區域端點存取)。Conversational Analytics API 是 Google Cloud 控制台中 Data Analytics API with Gemini 的第一項功能。
事前準備
如要使用 Conversational Analytics API，必須先準備一個 Google Cloud 專案，以便存取要處理的資料。如要設定專案，請完成下列步驟：
- 找出要搭配 Conversational Analytics API 使用的資料。您可以使用 BigQuery 表格、Looker 探索、Google 數據分析報表等資料來源，以及 AlloyDB for PostgreSQL、GoogleSQL for Spanner、MySQL 適用的 Cloud SQL 和 PostgreSQL 適用的 Cloud SQL 中的資料。
在 Google Cloud 控制台的專案選擇器頁面中，建立 Google Cloud 專案，以便存取要透過 Conversational Analytics API 使用的資料。
Looker 和 數據分析 Pro 需求
如果您搭配使用 Conversational Analytics API 和 Looker，Looker 執行個體必須符合特定需求：
如要在數據分析 Pro 中使用 Conversational Analytics API，Pro 訂閱方案必須位於 VPC-SC 範圍外。
AlloyDB 需求條件
如果您搭配 AlloyDB 使用對話式數據分析 API，AlloyDB 執行個體必須符合特定需求。完成「事前準備」中的所有步驟。
MySQL 適用的 Cloud SQL 需求條件
如果您搭配使用 Conversational Analytics API 與 MySQL 適用的 Cloud SQL，您的 Cloud SQL 執行個體必須符合特定需求。完成「事前準備」中的所有步驟。
PostgreSQL 適用的 Cloud SQL 需求
如果您搭配使用 Conversational Analytics API 與 PostgreSQL 適用的 Cloud SQL，Cloud SQL 執行個體必須符合特定需求。完成「事前準備」中的所有步驟。
Spanner 需求
如果您搭配 Spanner 使用對話式數據分析 API，Spanner 執行個體必須符合特定需求。完成「事前準備」中的所有步驟。
啟用必用的 API。
如要使用對話式數據分析 API，請在專案中啟用一組必要 API。 Google Cloud 如果您打算從 Colab Enterprise 環境使用 Conversational Analytics API，也必須啟用其他 API。
必要 API
主控台
在 Google Cloud 控制台中，為要搭配 Conversational Analytics API 使用的 Google Cloud 專案啟用下列 API。
gcloud
使用 Google Cloud CLI 執行下列 gcloud services enable 指令，分別啟用 Gemini Data Analytics API、Gemini for Google Cloud API 和 BigQuery API：
gcloud services enable geminidataanalytics.googleapis.com --project=project_id gcloud services enable cloudaicompanion.googleapis.com --project=project_id gcloud services enable bigquery.googleapis.com --project=project_id
在先前的 gcloud CLI 指令範例中，將 project_id 替換為您的 Google Cloud 專案 ID。
Colab Enterprise API
如果您打算從 Colab Enterprise 環境使用 Conversational Analytics API，請一併啟用下列 API：
授予必要角色
如要使用 Conversational Analytics API，主體 (例如使用者或服務帳戶) 必須具備 Identity and Access Management (IAM) 角色，才能存取 API 和基礎資料來源。
如要授予這些角色，請使用 Google Cloud 控制台：
Gemini Data Analytics 角色
如要讓主體建立 Conversational Analytics API 代理，並使用對話的具狀態即時通訊方法，請授予下列 IAM 角色：
- Gemini Data Analytics 資料代理建立工具 (
roles/geminidataanalytics.dataAgentCreator)：僅在 BigQuery、Looker 和 Data Studio Pro 中建立代理時需要。 - Gemini for Google Cloud User (
roles/cloudaicompanion.user)：使用對話的具狀態聊天方法時必須提供。
此外，管理代理程式等動作的權限由 Gemini Data Analytics 角色控管，詳情請參閱「使用 IAM 控管 Conversational Analytics API 存取權」。
BigQuery 角色
如要讓主體透過 Conversational Analytics API 查詢 BigQuery 資料來源，請授予下列 IAM 角色：
- BigQuery 使用者 (
roles/bigquery.user)：存取 BigQuery 中的資料時需要此角色。 - BigQuery Studio 使用者 (
roles/bigquery.studioUser)：如果您使用 BigQuery Studio 和資料畫布，則必須具備這項角色。
Looker 角色
如要讓主體透過 Conversational Analytics API 查詢 Looker 資料來源，請授予下列 IAM 角色：
- Looker 執行個體使用者 (
roles/looker.instanceUser)：必須具備這項權限，才能存取 Looker (Google Cloud Core) 執行個體的資料。
如要使用對話式數據分析和對話式數據分析 API，必須為 Looker 使用者指派包含 gemini_in_looker 權限的Looker 角色，才能與模型互動。
資料庫角色
如要讓主體透過 Conversational Analytics API 查詢 AlloyDB、MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 或 Spanner 資料來源，請授予下列 IAM 角色：
- AlloyDB 資料庫使用者 (
roles/alloydb.databaseUser)：存取 AlloyDB 執行個體中的資料時必須具備這項權限。 - MySQL 適用的 Cloud SQL 和 PostgreSQL 適用的 Cloud SQL Studio 使用者 (
roles/cloudsql.studioUser)：必須具備此角色，才能使用 Google Cloud 控制台檢視及管理 MySQL 適用的 Cloud SQL 和 PostgreSQL 適用的 Cloud SQL 執行個體。 - MySQL 適用的 Cloud SQL 和 PostgreSQL 適用的 Cloud SQL 執行個體使用者 (
roles/cloudsql.instanceUser)：連線至 MySQL 適用的 Cloud SQL 和 PostgreSQL 適用的 Cloud SQL 執行個體時，必須具備這項權限。 - Spanner 資料庫讀取者 (
roles/spanner.databaseReader)：從 GoogleSQL for Spanner 資料庫讀取資料時必須具備這項角色。
後續步驟
- 瞭解對話式數據分析 API 的存取控管機制。
- 瞭解如何為 Conversational Analytics API 設定 VPC Service Controls。
後續步驟
- 瞭解如何向資料來源和 API 進行驗證。
- 瞭解如何使用 Python SDK 建構資料代理。
- 瞭解如何使用 HTTP 和 Python 建構資料代理程式。