本文說明如何在 Spanner 中建立、編輯及刪除對話。對話是與資料代理程式的持續性即時通訊。
您可以向資料代理程式提出使用常見字詞的多部分問題,例如「銷售量」或「最熱門」,無須指定資料表欄位名稱,或定義篩選資料的條件。即時通訊回覆會以文字和程式碼提供問題的答案,並在適當情況下生成圖表。回應會說明結果背後的理由。
您可以與資料代理建立對話。建立直接對話時,對話式數據分析 API 會解讀您的問題,但不會使用資料代理程式提供的背景資訊和處理指示。
事前準備
-
啟用 Spanner、Data Analytics API with Gemini 和 Gemini for Google Cloud APIs。
啟用 API 時所需的角色
如要啟用 API,您需要服務使用情形管理員 IAM 角色 (
roles/serviceusage.serviceUsageAdmin),其中包含serviceusage.services.enable權限。瞭解如何授予角色。
必要的角色
如要使用資料代理程式,您必須具備下列任一對話式數據分析 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 使用者的
spanner.databaseReader角色。詳情請參閱「為專案新增 IAM 政策繫結」。 - 在專案層級授予 IAM 使用者必要資料庫的角色和權限。詳情請參閱「授予角色和權限」。
如要使用 Spanner 資源,請參閱「Spanner 角色和權限」。
建立對話
您可以在 Spanner 的 Google Cloud 控制台中,透過「Agents」(代理) 頁面的「Agent Catalog」(代理目錄) 分頁,與代理或資料來源建立持續性對話。
與資料代理展開對話
如要與資料代理程式對話,請先建立資料代理程式並發布。你也可以與他人分享的代理發起對話。
如要在 Google Cloud 控制台中與資料代理程式建立對話,請按照下列步驟操作:
前往 Google Cloud 控制台的「Spanner」頁面。
從清單中選取執行個體,然後選取資料庫。
在導覽選單中,按一下「代理商」。
在「我的代理」或「組織中其他成員分享的代理」部分中,按一下要與之對話的代理資訊卡。
按一下「開始對話」。系統會開啟新的對話面板。
在「Ask a question」(提出問題) 欄位中,輸入要向資料代理程式提出的問題。 例如:「上季的總銷售額是多少?」或「依工作階段時間顯示前 5 名使用者」。你也可以點選 Gemini 建議的問題,開始對話。
資料代理程式會回覆為解決問題所採取的行動,然後傳回結果。
如要查看資料代理程式提供問題答案的每個步驟,請點選「顯示推理過程」,查看代理程式推理過程中的每則訊息。
如要查看結果的計算方式,請按一下「計算方式」。「摘要」部分現在會顯示生成的查詢,以及查詢結果。您可以複製程式碼,然後按一下「Studio」,將程式碼貼到查詢編輯器。
如果資料適合以圖表呈現,資料代理程式會提供圖表、表格和其他視覺化內容。如要查看即時通訊記錄,請前往「對話管理」清單。
如要查看代理程式資訊,請前往「詳細資料」面板。這個面板會顯示代理程式的說明和知識來源。
管理會話群組
您可以在「代理程式」頁面開啟、重新命名或刪除對話。
開啟現有對話
前往 Google Cloud 控制台的「Spanner」頁面。
從清單中選取執行個體,然後選取資料庫。
在導覽選單中,按一下「代理商」。
在「對話」分頁的對話清單中,按一下要開啟的對話。
重新命名對話
前往 Google Cloud 控制台的「Spanner」頁面。
從清單中選取執行個體,然後選取資料庫。
在導覽選單中,按一下「代理商」。
在「對話」分頁的對話清單中,按一下要重新命名的對話。
依序點選 「查看動作」 >「重新命名」。
在「重新命名對話」對話方塊的「對話名稱」欄位中,輸入對話的新名稱。
按一下 [重新命名]。
刪除對話
前往 Google Cloud 控制台的「Spanner」頁面。
從清單中選取執行個體,然後選取資料庫。
在導覽選單中,按一下「代理商」。
在「對話」分頁的對話清單中,按一下要刪除的對話。
依序點選 「查看動作」 >「刪除」。
在「要刪除對話嗎?」對話方塊中,按一下「刪除」。
位置
對話內容分析功能適用於全球,無法選擇要使用的區域。
後續步驟
- 進一步瞭解 Spanner 中的對話式數據分析。
- 進一步瞭解 對話式數據分析 API。
- 在 Spanner 中建立資料代理程式。