透過對話分析資料

本文說明如何在 Spanner 中建立、編輯及刪除對話。對話是指與資料代理持續進行的即時通訊。

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

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

事前準備

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

  2. 啟用 Spanner、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) 角色。
  • 此外，您必須具備下列角色，才能建立或編輯資料代理：
    • 新增至叢集的 IAM 使用者或服務帳戶。詳情請參閱「套用 IAM 角色」。
    • 在專案層級授予 IAM 使用者的 spanner.databaseReader 角色。詳情請參閱「新增專案的 IAM 政策繫結」。
    • 選用：如果資料庫資料代理使用情境集 (預先發布版)，則須在專案層級，將 Dataplex Catalog 編輯者 (roles/dataplex.catalogEditor) 或 Dataplex Catalog 管理員 (roles/dataplex.catalogAdmin) 角色授予 IAM 使用者，以便建立、上傳及管理情境集。詳情請參閱「情境組合權限」。
    • 在專案層級授予 IAM 使用者的角色和權限，用於所需資料庫。詳情請參閱「授予角色和權限」。
在 Gemini Enterprise 佈建代理

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

如要使用 Spanner 資源，請參閱「Spanner 角色和權限」。

建立對話

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

與資料代理對話

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

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

  1. 前往 Google Cloud 控制台的「Spanner」頁面。

    前往「Spanner」頁面

  2. 從清單中選取執行個體，然後選取資料庫。

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

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

  5. 按一下「開始對話」。新的對話面板隨即開啟。

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

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

    如要查看資料代理為回答問題而採取的每個步驟，請按一下「Show reasoning」(顯示推論)，查看代理推論程序中的每則訊息。

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

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

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

管理會話群組

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

開啟現有對話

  1. 前往 Google Cloud 控制台的「Spanner」頁面。

    前往「Spanner」頁面

  2. 從清單中選取執行個體，然後選取資料庫。

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

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

重新命名對話

  1. 前往 Google Cloud 控制台的「Spanner」頁面。

    前往「Spanner」頁面

  2. 從清單中選取執行個體，然後選取資料庫。

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

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

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

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

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

刪除對話

  1. 前往 Google Cloud 控制台的「Spanner」頁面。

    前往「Spanner」頁面

  2. 從清單中選取執行個體，然後選取資料庫。

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

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

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

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

位置

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

後續步驟