建立及管理 Explore 資料代理程式

資料代理程式可讓您為使用者打造專屬的對話式數據分析體驗。您可以提供代理背景資訊和操作說明，讓對話式數據分析更有效地回答特定用途的問題。分析師可透過代理，將業務術語對應至特定欄位、指定最適合篩選的欄位，以及定義自訂計算。

本頁面會引導您完成下列程序：

瞭解 Gemini for Google Cloud 如何使用您的資料。

事前準備

對話式數據分析的使用權限，是透過內容存取權、資料存取權和功能存取權的組合來管理。資料代理程式可視為另一種 Looker 內容，例如資訊主頁、Look 或資料夾。如要與資料代理程式互動，您必須獲派 Looker 角色，且該角色具備個別探索或資料代理程式將查詢的基礎模型所需權限。在某些情況下，您也需要具備代理本身的存取權。

如要進一步瞭解管理及使用資料代理程式所需的權限和存取權，請參閱「在 Looker 中設定對話式數據分析」說明文件頁面的權限表格。

Looker 管理員在 Gemini in Looker 管理頁面啟用下列功能後，即可使用對話式數據分析探索代理：

  • 對話式數據分析：
    • 對話式數據分析 (「會話群組頁面」)：開啟這項設定，即可讓資料代理存取「會話群組頁面」，並直接與探索對話。
  • 其他選項：
    • 進階數據分析：如要允許代理使用進階數據分析功能，將自然語言問題轉譯為 Python 程式碼並執行，提供進階分析和圖表，請開啟「進階數據分析」設定。這項設定為選用項目。
  • 啟用早鳥測試者功能

建立及編輯資料代理

如要建立新的資料代理程式，請按照下列步驟操作：

  1. 前往「對話」頁面。
  2. 在「代理」分頁中，選取「+ 新增代理」。或者，在左側面板中依序選取「spark」「管理代理」，然後選取「+ 新增代理」。

  3. 在「New agent」(新增代理) 頁面，提供資料代理的下列資訊。

    • 代理名稱：輸入代理名稱。名稱應不重複且具描述性。
    • 代理說明：簡短說明這個代理的功能和使用的資料。使用者選取代理開始對話或您與他們共用代理時，都會看到這段說明，因此請務必清楚說明代理的用途和實用性。
    • 資料：按照下列步驟，最多可連結五個現有的 Looker 探索：
      1. 在「資料」欄位中，點選「+ 選取探索」。
      2. 在「搜尋探索」視窗中，點選要納入資料代理的探索。這些探索檢視表會顯示在視窗的「選取的探索檢視表」面板中。
      3. 如要將所選探索新增至資料代理，請按一下「儲存」。

  4. 操作說明：提供背景資訊，協助對話式數據分析瞭解如何與資料互動，並提供準確且相關的回覆。如需可提供的脈絡類型範例，請參閱「撰寫代理指令」。

  5. (選用) 選取「進階選項」展開該部分，然後設定下列設定：

    • 啟用進階分析：開啟這項設定，即可為所有與代理的對話啟用進階分析。
    • 「顯示思考過程」：開啟這項切換鈕，即可允許代理在每段對話的所有回覆中，顯示推論步驟、生成的 Looker 查詢和基礎資料表。
    • 「顯示偵錯資訊」：開啟這項切換鈕，即可允許代理顯示在每段對話中，為所有回覆執行的步驟。

  6. 您也可以測試代理，調整操作說明和設定。

  7. 如要儲存新的資料代理，請按一下「Save」(儲存)。

儲存資料代理後，您可以與其他使用者共用代理，並與代理對話。

撰寫代理指令

建立資料代理時，您可以新增任意形式的操作說明，定義資料代理的核心行為，並提供基礎背景資訊，讓資料代理在處理使用者提示前考量。

以下列舉幾種可在「指示」欄位中提供的脈絡資訊：

  • 關鍵欄位：分析作業中最重要的欄位
  • 排除的欄位：資料代理應避免使用的欄位
  • 篩選及分組：代理在篩選及分類資料時應使用的欄位
  • 人物角色：您指派給代理的角色、專業知識、個性或語氣

如需撰寫代理操作說明的提示和最佳做法，請參閱「在 Looker 設定 Conversational Analytics 的最佳做法」說明文件頁面。

定義已驗證的查詢

驗證過的查詢 (在部分 Google 文件中也稱為精確查詢) 是預先定義的自然語言問題和對應的確切 Looker 探索查詢。這些問答組合是經過驗證的「黃金標準」，可做為代理的依據，讓代理瞭解如何處理複雜的業務要求，不必猜測。定義明確的已驗證查詢，有助於提高探索資料代理的回覆準確度。

已驗證查詢的限制

使用已驗證查詢時，請注意下列限制：

  • 已驗證的查詢僅適用於探索資料代理。不適用於與 Explore 或資訊主頁資料代理的直接對話。
  • 您必須使用已為代理定義的探索。如果參照的探索資料並非資料代理所用，系統會顯示錯誤訊息 This query will not be used as it references an Explore that has not been defined in this agent. For best results, make sure that verified queries are based on Explores used in this agent.
  • 已驗證查詢不支援含有自訂欄位或透視表的探索查詢。
  • 雖然新增的已驗證查詢數量沒有限制，但建議每個代理最多加入 30 到 50 個問題和查詢組合。

建立通過驗證的查詢

如要將已驗證的查詢新增至新的或現有的資料代理，請按照下列步驟操作：

  1. 建立新的資料代理，或編輯現有資料代理，並使用至少一個「探索」做為資料來源。
  2. 在代理建立或編輯頁面，選取「+ 新增已驗證的查詢」。
  3. 在「新增已驗證的查詢」下方，輸入自然語言問題和對應的答案：
    • 問題：輸入使用者可能會提出的自然語言問題。
    • 答案：貼上擷取正確查詢或圖表的探索網址。
  4. 如要驗證「探索」查詢，請按一下「預覽」。
    • 替代做法：將「答案」欄位留空，然後點選「預覽」，在「探索」建立工具中從頭建立查詢，然後儲存產生的網址以供使用。
  5. 按一下 [儲存]。

編輯通過驗證的查詢

如要編輯現有的已驗證查詢，請按照下列步驟操作：

  1. 在與代理程式的對話中，選取「編輯代理程式」。
  2. 在「通過驗證的查詢」下方，找到要編輯的通過驗證查詢。
  3. 按一下「 編輯通過驗證的查詢」。
  4. 在「編輯通過驗證的查詢」對話方塊中，變更問題或答案。
  5. 按一下 [儲存]。

刪除已驗證的查詢

如要刪除已驗證的查詢，請按照下列步驟操作：

  1. 在與代理程式的對話中，選取「編輯代理程式」。
  2. 在「通過驗證的查詢」下方，找到要刪除的已驗證查詢。
  3. 按一下「 刪除已驗證的查詢」。

測試代理

建立或編輯代理時，代理詳細資料頁面會顯示「預覽代理」窗格。你可以與服務專員對話，測試服務專員的設定和指令。

您必須按一下「更新」，變更才會反映在預覽畫面中。如果儲存狀態為「Not saved」，預覽畫面就不會反映設定更新。

編輯現有資料代理程式

如要編輯現有的資料代理，請按照下列步驟操作：

  1. 在「對話」頁面中，依序選取「spark管理代理」。
  2. 在「管理代理程式」頁面中，選取要編輯的資料代理程式。
  3. 視需要更新代理商詳細資料。您可以修改建立代理時指定的詳細資料，包括「代理名稱」、「代理說明」、「資料」、「指令」和「進階選項」設定。您也可以選擇為代理啟用程式碼解譯器。
  4. 如要儲存變更，請按一下「更新」。

共用資料代理

共用後，其他使用者就能與代理和其探索對話。您可以授予代理的內容存取權，與其他使用者共用資料代理。只有具備適當權限和內容存取權的使用者才能共用代理程式。建立代理後，可能需要幾分鐘才能分享。

如要共用資料代理，請按照下列步驟操作：

  1. 在「對話」頁面中，選取左側面板的「spark」「管理代理程式」。
  2. 按一下所選代理的「更多選項」圖示，開啟選單，然後按一下「共用」。
  3. 在「誰可以存取這個代理」部分新增個人或群組，並選擇其權限層級後，按一下「新增」，即可將其加入共用清單。
  4. 如要讓新使用者或群組收到通知電子郵件，請勾選「傳送電子郵件給您剛新增的使用者」核取方塊。
  5. 完成所有變更後，按一下「儲存」。

您也可以在代理設定頁面，點選「 分享」，然後按照上述步驟操作，分享剛建立或正在編輯的代理。

撤銷資料代理的存取權

如要撤銷代理程式的存取權，請按照下列步驟操作：

  1. 在「對話」頁面，按一下左側面板中的「spark管理代理」。
  2. 按一下所選代理的「更多選項」圖示，開啟選單，然後按一下「共用」。
  3. 找出要移除存取權的使用者或群組，然後點選旁邊的「X」X。
  4. 完成所有變更後，按一下「儲存」。

如果遭移除的使用者正在進行對話，在變更生效前，他們仍可存取對話一到兩分鐘。

如果使用者在代理存取權遭移除後嘗試提出更多問題，就會看到「The agent in this conversation may not be shared with you, or may have been deleted. You can view any past conversations with the agent, but can't ask new questions.」訊息

發布資料代理

您可以在 Gemini Enterprise 中發布資料代理，讓更多使用者 (包括不熟悉 Looker 介面的使用者) 存取代理的預先定義內容和分析資料。Gemini Enterprise 是中央中樞，使用者可在此管理在 Google Cloud 應用程式中建立的資料代理，並根據分析需求找到最合適的代理。

事前準備

如要在 Looker 中建立資料代理，並提供給 Gemini Enterprise 使用者，您必須在 Looker 執行個體、 Google Cloud 控制台的 Gemini Enterprise 頁面，以及 Gemini Enterprise 執行個體中執行工作。

具備下列角色的使用者必須按照相關章節所述步驟操作：

  1. 資料代理編輯者 (Looker 功能)：在 Looker 發布代理。
  2. Discovery Engine 管理員 (IAM 角色)：授予 Google Cloud 控制台中的代理存取權。
  3. Gemini Enterprise 企業版使用者 (IAM 角色)；資料代理使用者 (Looker 功能)：在 Gemini Enterprise 執行個體中與代理對話。

發布服務專員前，必須符合下列規定：

  • Looker 管理員必須前往「管理」面板的「Gemini in Looker」頁面，啟用「啟用『信任的測試人員』功能」和「發布至 Gemini Enterprise」設定，以及「對話式數據分析 (『對話』頁面)」設定。
  • Looker 管理員必須授予您包含 publish_agent_externally 權限的角色。此外，您也必須能夠編輯資料代理。
  • 在託管 Gemini Enterprise 引擎的 Google Cloud 專案中，Looker 服務帳戶必須具備 Discovery Engine 管理員 Identity and Access Management 角色。授予這個角色後，系統會在發布第一個資料代理時，將 Gemini Enterprise 授權指派給帳戶。如果沒有可指派給 Looker 服務帳戶的 Gemini Enterprise 授權， Google Cloud 控制台的 Gemini Enterprise 引擎頁面會顯示「Failed to allocate quota for agent creation」(無法分配建立代理程式的配額) 錯誤。接著，具備 Discovery Engine 管理員 Identity and Access Management 角色的使用者，必須為 Looker 服務帳戶佈建新的 Gemini Enterprise 授權，或重新指派現有授權。

將資料代理發布至 Gemini Enterprise

如要完成本節所述步驟，您必須具備包含 publish_agent_externally 權限的 Looker 角色，以及適當權限和內容存取權，才能編輯資料代理。

如要發布代理，請按照下列步驟操作：

  1. 編輯代理。
  2. 選取「發布設定」，開啟「代理發布設定」視窗。
  3. 在「代理發布設定」視窗中，啟用「Gemini Enterprise」設定，然後選取「更新」。啟用這項設定後，代理就會發布至 Gemini Enterprise 執行個體，並顯示在「管理面板」的「Gemini in Looker」頁面。
  4. 發布代理後，您可以選取「Share」，將資料代理的存取權授予其他 Looker 使用者，或選取「Start conversation」，與資料代理展開新對話。

在 Gemini Enterprise 授予使用者代理存取權

如要完成本節所述步驟，您必須具備 Discovery Engine 管理員 Identity and Access Management 角色，才能管理含有 Gemini Enterprise 引擎的 Google Cloud 專案。

使用者必須有權存取 Gemini Enterprise 執行個體和個別代理，才能在 Gemini Enterprise 與代理對話。

如要授予使用者 Gemini Enterprise 執行個體的存取權，Discovery Engine 管理員必須為包含 Gemini Enterprise 引擎的 Google Cloud 專案，指派 Gemini Enterprise 使用者 IAM 角色給使用者。

如要授予使用者個別代理的存取權，Discovery Engine 管理員必須在 Google Cloud 控制台中完成下列步驟：

  1. 前往含有 Gemini Enterprise 引擎的 Google Cloud 專案。
  2. 開啟 Gemini Enterprise 產品頁面。
  3. 在主導覽中選取「應用程式」頁面，然後選取 Gemini Enterprise 執行個體的名稱。
  4. 在主要導覽列中，選取「代理」。
  5. 選取要授予存取權的代理。
  6. 選取「使用者授權」分頁標籤。
  7. 選取「新增使用者」。
  8. 在「Add user permissions roles to agent」(為代理新增使用者授權角色) 視窗中，新增每位使用者並指派「代理使用者」角色。

在 Gemini Enterprise 與代理對話

如要完成本節所述步驟，您必須具備 Google Cloud 專案的 Gemini Enterprise 企業版使用者 Identity and Access Management 角色，該專案包含 Gemini Enterprise 引擎。此外，您也必須具備適當的權限和內容存取權，才能在 Looker 執行個體中與代理程式對話。

如要在 Gemini Enterprise 執行個體中與資料代理對話，請按照下列步驟操作：

  1. 開啟 Gemini Enterprise 執行個體。
  2. 選取主要導覽選單中的「代理」。
  3. 在「代理」頁面，選取要對話的代理。選取代理後，對話視窗會開啟，您可以在視窗中詢問資料相關問題。

首次與代理對話時，您必須授權代理存取您的 Looker 身分。

在 Gemini Enterprise 中重新發布資料代理

Looker 更新資料代理功能或能力時，您必須更新或重新發布代理，變更才會在 Gemini Enterprise 生效。

Looker 26.12 開始支援在代理回覆中加入圖表。如果代理是在 Looker 26.12 之前建立，則必須更新或重新發布代理，才能在回覆中使用圖表。

如要更新代理程式，請按照下列步驟操作：

  1. 編輯資料代理程式。
  2. 修改代理的任何中繼資料。
  3. 選取「更新」。

如要重新發布資料代理程式，請按照下列步驟操作：

  1. 編輯資料代理程式。
  2. 選取「發布設定」，開啟「代理發布設定」視窗。
  3. 關閉「Gemini Enterprise」切換鈕，然後選取「更新」。
  4. 等待代理從 Gemini Enterprise 移除。
  5. 在 Looker 中編輯資料代理，重新開啟「代理發布設定」視窗。
  6. 選取「發布設定」，開啟「Gemini Enterprise」切換鈕，然後選取「更新」。

刪除資料代理

如要刪除資料代理，請按照下列步驟操作：

  1. 在「對話」頁面，按一下左側面板中的「spark」「管理代理程式」。
  2. 按一下所選代理的 「更多選項」圖示開啟選單，然後點選「刪除」。
  3. 在「Delete agent?」視窗中，按一下「Move to trash」，刪除資料代理。

移至垃圾桶的代理程式會在 30 天後永久刪除。您可以手動永久刪除資料代理人，也可以在永久刪除前從垃圾桶還原資料代理人。如未採取任何行動，系統會在 30 天後自動永久刪除該服務專員。

永久刪除資料代理

如要永久刪除資料代理，請按照下列步驟操作：

  1. 前往「Conversations」(對話) 頁面。
  2. 在左側導覽面板中，展開「垃圾桶」部分。
  3. 如要開啟所選代理程式的選單，請選取 圖示，然後按一下「永久刪除」。
  4. 在「確定要永久刪除嗎？」視窗中，按一下「永久刪除」。

從垃圾桶還原資料代理

如要從垃圾桶還原資料代理，請按照下列步驟操作：

  1. 前往「對話」頁面。
  2. 在左側導覽面板中，展開「垃圾桶」部分。
  3. 如要開啟所選代理的選單，請選取 圖示，然後按一下「還原」。