透過對話分析資料

本文說明如何在 MySQL 適用的 Cloud SQL 中建立、編輯及刪除對話。對話是指與資料代理程式的持續性即時通訊。

您可以向資料代理程式提出使用常見字詞的多部分問題，例如「銷售量」或「最熱門」，無須指定資料表欄位名稱，或定義篩選資料的條件。即時通訊回覆會以文字和程式碼提供問題的答案，並在適當情況下生成圖表。回應會說明結果背後的理由。

您可以與資料代理建立對話。建立直接對話時，對話式數據分析 API 會解讀您的問題，但不會使用資料代理程式提供的背景資訊和處理指示。

事前準備

確認專案已啟用計費功能 Google Cloud 。
啟用 Cloud SQL、Data Analytics API with Gemini 和 Gemini for Google Cloud APIs。
啟用 API 時所需的角色
如要啟用 API，您需要服務使用情形管理員 IAM 角色 (roles/serviceusage.serviceUsageAdmin)，其中包含 serviceusage.services.enable 權限。瞭解如何授予角色。
啟用 API

必要的角色

如要使用資料代理程式，您必須具備下列任一對話式數據分析 API Identity and Access Management (IAM) 角色：

使用 QueryData 方法查詢支援的資料庫來源資料：專案層級的 Gemini Data Analytics 資料查詢使用者 (roles/geminidataanalytics.queryDataUser)。
在專案層級建立、編輯、共用及刪除專案中的所有資料代理：Gemini Data Analytics 資料代理擁有者 (roles/geminidataanalytics.dataAgentOwner)。
在專案中建立自己的資料代理：專案層級的 Gemini Data Analytics 資料代理建立者 (roles/geminidataanalytics.dataAgentCreator)。這個角色會自動授予您所建立資料代理的 Gemini Data Analytics 資料代理擁有者角色。
查看及編輯專案中的所有資料代理：專案層級的 Gemini Data Analytics 資料代理編輯者 (roles/geminidataanalytics.dataAgentEditor)。
查看專案中的所有資料代理：專案層級的 Gemini Data Analytics 資料代理檢視者 (roles/geminidataanalytics.dataAgentViewer)。

此外，您必須具備下列角色，才能建立或編輯資料代理程式：

在執行個體層級新增的 IAM 使用者或服務帳戶。詳情請參閱「為使用者、服務帳戶或群組新增 IAM 政策繫結」。
在專案層級授予 IAM 使用者的 cloudsql.studioUser 和 cloudsql.instanceUser 角色。詳情請參閱「為專案新增 IAM 政策繫結」。
以資料庫的密碼型使用者身分登入，即可將資料庫權限授予 IAM 使用者或服務帳戶。
```
GRANT ALL PRIVILEGES ON *.* TO 'your-iam-user@example.com';
```
詳情請參閱「授予個別 IAM 使用者或服務帳戶資料庫權限」。

管理 MySQL 適用的 Cloud SQL 資料庫資源存取權時，請考慮下列權限層級：

Google Cloud IAM：控管資料庫執行個體做為雲端資源的存取權。包括連線、管理執行個體和執行 SQL 查詢的權限，例如使用 executeSql 權限。
資料庫權限：控管資料庫中物件的存取權，例如資料表、檢視表和結構定義。這些項目是使用 SQL 指令 (例如 GRANT ) 和資料庫專屬的使用者與角色系統進行管理。

如果是 MySQL 適用的 Cloud SQL，您需要適當的 Cloud SQL IAM 角色，才能連線至執行個體並獲得傳送查詢的授權。如要與資料表和檢視區塊等物件互動，連線的資料庫使用者必須透過 MySQL 適用的 Cloud SQL GRANT 系統取得必要權限。詳情請參閱「MySQL 適用的 Cloud SQL 使用者簡介」。如果代理程式使用服務帳戶，您可以取得指派的資料庫角色。如需範例，請參閱「使用 IAM 資料庫驗證功能管理使用者」。

建立對話

您可以在 MySQL 適用的 Cloud SQL 的 Google Cloud 控制台中，透過「代理程式」頁面的「代理程式目錄」分頁，與代理程式或資料來源建立持續性對話。

與資料代理展開對話

如要與資料代理程式對話，請先建立資料代理程式並發布。你也可以與他人分享的代理發起對話。

如要在 Google Cloud 控制台中與資料代理程式建立對話，請按照下列步驟操作：

前往 Google Cloud 控制台的 MySQL 適用的 Cloud SQL 頁面。

前往 Cloud SQL
從清單中選取執行個體。
在導覽選單中，按一下「代理商」。
在「我的代理」或「組織中其他成員分享的代理」部分中，按一下要與之對話的代理資訊卡。
按一下「開始對話」。系統會開啟新的對話面板。
在「Ask a question」(提出問題) 欄位中，輸入要向資料代理程式提出的問題。例如：「上季的總銷售額是多少？」或「依工作階段時間顯示前 5 名使用者」。你也可以點選 Gemini 建議的問題，開始對話。

資料代理程式會回覆為解決問題所採取的行動，然後傳回結果。

如要查看資料代理程式提供問題答案的每個步驟，請點選「顯示推理過程」，查看代理程式推理過程中的每則訊息。

如要查看結果的計算方式，請按一下「計算方式」。「摘要」部分現在會顯示生成的查詢，以及查詢結果。您可以複製程式碼，然後按一下「Studio」，將程式碼貼到查詢編輯器。

如果資料適合以圖表呈現，資料代理程式會提供圖表、表格和其他視覺化內容。如要查看即時通訊記錄，請前往「對話管理」清單。

如要查看代理程式資訊，請前往「詳細資料」面板。這個面板會顯示代理程式的說明和知識來源。

管理會話群組

您可以在「代理程式」頁面開啟、重新命名或刪除對話。

開啟現有對話

前往 Google Cloud 控制台的 MySQL 適用的 Cloud SQL 頁面。

前往 Cloud SQL
從清單中選取執行個體。
在導覽選單中，按一下「代理商」。
在「對話」分頁的對話清單中，按一下要開啟的對話。

重新命名對話

前往 Google Cloud 控制台的 MySQL 適用的 Cloud SQL 頁面。

前往 Cloud SQL
從清單中選取執行個體。
在導覽選單中，按一下「代理商」。
在「對話」分頁的對話清單中，按一下要重新命名的對話。
依序點選「查看動作」 >「重新命名」。
在「重新命名對話」對話方塊的「對話名稱」欄位中，輸入對話的新名稱。
按一下 [重新命名]。

刪除對話

前往 Google Cloud 控制台的 MySQL 適用的 Cloud SQL 頁面。

前往 Cloud SQL
從清單中選取執行個體。
在導覽選單中，按一下「代理商」。
在「對話」分頁的對話清單中，按一下要刪除的對話。
依序點選「查看動作」 >「刪除」。
在「要刪除對話嗎？」對話方塊中，按一下「刪除」。

位置

對話內容分析功能適用於全球，無法選擇要使用的區域。