透過對話分析資料

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

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

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

事前準備

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

  2. 啟用 Cloud SQL、Data Analytics API with Gemini 和 Gemini for Google Cloud APIs。

    啟用 API 時所需的角色

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

    啟用 API

必要的角色

如要使用資料代理程式，您必須具備符合用途的 IAM 權限。下表列出建立及發布代理程式、在 Gemini Enterprise 中佈建代理程式，或探索及使用代理程式時所需的角色。詳情請參閱「Conversational Analytics API Identity and Access Management 角色」。

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

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

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

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

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

建立對話

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

與資料代理展開對話

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

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

  1. 前往 Google Cloud 控制台的 Cloud SQL for MySQL 頁面。

    前往 Cloud SQL

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

  3. 在導覽選單中，按一下「代理商」。

  4. 在「我的代理」或「組織中其他成員分享的代理」部分中，按一下要與之對話的代理資訊卡。

  5. 按一下「開始對話」。系統會開啟新的對話面板。

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

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

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

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

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

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

管理會話群組

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

開啟現有對話

  1. 前往 Google Cloud 控制台的 Cloud SQL for MySQL 頁面。

    前往 Cloud SQL

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

  3. 在導覽選單中，按一下「代理商」。

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

重新命名對話

  1. 前往 Google Cloud 控制台的 Cloud SQL for MySQL 頁面。

    前往 Cloud SQL

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

  3. 在導覽選單中，按一下「代理商」。

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

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

  6. 在「重新命名對話」對話方塊的「對話名稱」欄位中，輸入對話的新名稱。

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

刪除對話

  1. 前往 Google Cloud 控制台的 Cloud SQL for MySQL 頁面。

    前往 Cloud SQL

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

  3. 在導覽選單中，按一下「代理商」。

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

  5. 依序點選 「查看動作」 >「刪除」。

  6. 在「要刪除對話嗎？」對話方塊中，按一下「刪除」。

位置

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

後續步驟