透過對話分析資料

本文說明如何在 MySQL 適用的 Cloud SQL 中建立、編輯及刪除對話。對話是指與資料代理持續進行的對話。

您可以向資料代理提出多部分問題，並使用「銷售」或「最熱門」等常見字詞，不必指定資料表欄位名稱，或定義篩選資料的條件。對話回覆會以文字和程式碼的形式提供問題答案，並在適當情況下生成圖表。回覆中會包含結果背後的推論。

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

事前準備

  1. 確認 Google Cloud 專案已啟用計費功能。

  2. 啟用 Cloud SQL、Data Analytics API with Gemini 和 Gemini for Google Cloud API (如有尚未啟用的 API)。

    啟用 API 所需的角色

    您必須具備 serviceusage.services.enable 權限，才能啟用 API。如果您建立了專案，可能已透過擁有者角色 (roles/owner) 取得這項權限。否則，您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    啟用 API

必要的角色

如要使用資料代理，您必須具備符合用途的 IAM 權限。下表列出所需角色，取決於您是要建立及發布代理、在 Gemini Enterprise 中佈建代理，還是探索及使用代理。詳情請參閱「Conversational Analytics API 身分與存取權管理角色」。

用途 必要的角色
建立、編輯、發布、共用及刪除代理
  • 如要在專案中建立資料代理，請在專案中具備 Gemini Data Analytics 資料代理建立者 (roles/geminidataanalytics.dataAgentCreator) 角色。具備這個角色後，您建立的資料代理會自動授予您 Gemini 資料分析資料代理擁有者角色。
  • 如要編輯、共用或刪除資料代理，必須具備代理或專案的 Gemini 資料分析資料代理擁有者 (roles/geminidataanalytics.dataAgentOwner) 角色。
  • 如要編輯專案中的資料代理：專案的 Gemini Data Analytics 資料代理編輯者 (roles/geminidataanalytics.dataAgentEditor)。
  • 如要查看專案中的資料代理：專案的 Gemini Data Analytics 資料代理檢視者 (roles/geminidataanalytics.dataAgentViewer)。
  • 此外，您必須具備下列角色，才能建立或編輯資料代理：
在 Gemini Enterprise 中佈建代理

如要讓 Gemini Enterprise 使用者存取已發布的代理，您必須具備在 Gemini Enterprise 管理控制台中註冊及管理 A2A 代理的權限。
探索及使用代理
  • 與資料代理對話：Gemini 資料分析資料代理使用者 (roles/geminidataanalytics.dataAgentUser)。
  • 如要查看專案中的所有資料代理：Gemini Data Analytics 資料代理檢視者 (roles/geminidataanalytics.dataAgentViewer)。

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

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

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

建立對話

在 MySQL 適用的 Cloud SQL Google Cloud 控制台中，您可以透過「Conversations」(對話) 頁面的「Agent Catalog」(代理目錄) 分頁，與代理或資料來源建立永久對話。

與資料代理對話

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

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

  1. 前往 Google Cloud 控制台的「MySQL 適用的 Cloud SQL」頁面。

    前往 Cloud SQL

  2. 從清單中選取執行個體。

  3. 在導覽選單中，按一下「對話」。

  4. 在「我的代理」或「組織中其他成員分享的代理」部分，點選要對話的代理資訊卡。新的對話面板隨即開啟。

  5. 在「Ask a question」(提出問題) 欄位中，輸入要向資料代理提出的問題。例如「上季總銷售額是多少？」或「顯示工作階段時間最長的前 5 名使用者」。您也可以點選 Gemini 建議的問題來開始。

    資料代理會回覆，說明為解決問題而採取的動作，然後傳回結果。

    如要查看資料代理為回答問題而採取的每個步驟，請點選「顯示思考過程」，查看代理推論過程中的每則訊息。

    如要瞭解結果的計算方式，請按一下 「How was this calculated?」(計算方式)。「Summary」(摘要) 部分現在會顯示生成的查詢，後面接著查詢結果。您可以複製程式碼，然後按一下「Studio」，將程式碼貼到查詢編輯器中。

    如果資料適合，資料代理會提供圖表、表格和其他視覺化內容。如要查看對話記錄，請前往「Conversation Management」(對話管理) 清單。

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

管理會話群組

您可以在「Conversations」(對話) 頁面開啟、重新命名或刪除對話。

開啟現有對話

  1. 前往 Google Cloud 控制台的「MySQL 適用的 Cloud SQL」頁面。

    前往 Cloud SQL

  2. 從清單中選取執行個體。

  3. 在導覽選單中，按一下「對話」。

  4. 在「Conversations」(對話) 分頁的對話清單中，按一下要開啟的對話。

重新命名對話

  1. 前往 Google Cloud 控制台的「MySQL 適用的 Cloud SQL」頁面。

    前往 Cloud SQL

  2. 從清單中選取執行個體。

  3. 在導覽選單中，按一下「對話」。

  4. 在「Conversations」(對話) 分頁的對話清單中，按一下要重新命名的對話。

  5. 依序點選「查看動作」圖示 >「重新命名」。

  6. 在「Rename conversation」(重新命名對話) 對話方塊中，於「Conversation name」(對話名稱) 欄位輸入新的對話名稱。

  7. 按一下 [重新命名]。

刪除對話

  1. 前往 Google Cloud 控制台的「MySQL 適用的 Cloud SQL」頁面。

    前往 Cloud SQL

  2. 從清單中選取執行個體。

  3. 在導覽選單中，按一下「對話」。

  4. 在「Conversations」(對話) 分頁的對話清單中，按一下要刪除的對話。

  5. 依序點選 「View actions」(查看動作) >「Delete」(刪除)。

  6. 在「要刪除對話嗎？」對話方塊中，點選「刪除」。

位置

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

後續步驟