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

資料代理程式可讓您為使用者打造專屬的對話式數據分析體驗。您可以透過代理提供脈絡和指令，讓對話式數據分析更有效地回答特定用途的問題。代理可協助分析師將業務字詞對應至特定欄位、指定最佳篩選欄位，以及定義自訂計算。

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

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

事前準備

對話式數據分析的使用權限是透過內容存取權、資料存取權和功能存取權的組合來管理。資料代理程式可視為另一種 Looker 內容，例如資訊主頁、Look 或資料夾。如要與資料代理程式互動，您必須獲派 Looker 角色，並具備個別探索所依據模型或資料代理程式將查詢的模型所需權限。在某些情況下，您也需要存取代理程式本身。如要進一步瞭解管理及使用資料代理程式所需的權限和存取權，請參閱「在 Looker 中設定對話式數據分析」說明文件頁面的權限表格。

建立及編輯資料代理

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

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

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

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

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

  5. 如要為與代理程式的所有對話啟用進階分析，請選取「啟用進階分析」。

  6. (選用) 您可以測試代理程式，進一步調整指令和設定。

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

儲存資料代理後，您就能與其他使用者共用代理，並開始與代理對話。

撰寫代理指令

建立資料代理程式時，您可以新增任意格式的指令，定義資料代理程式的核心行為，並提供基礎背景資訊，供代理程式在處理使用者提示詞前參考。

以下列舉幾種可在「指示」欄位中提供的情境：

  • 重要欄位：分析作業中最重要的欄位
  • 排除的欄位：資料代理應避免使用的欄位
  • 篩選及分組：代理在篩選及分類資料時應使用的欄位
  • 黃金查詢：自然語言問題和對應的探索查詢配對
  • 角色：您指派給代理程式的角色、專業知識、個性或語氣

如需撰寫代理程式指令的訣竅和最佳做法，請參閱「在 Looker 中設定對話式數據分析的最佳做法」說明文件頁面。

定義 Looker 精確查詢

如要為特定「探索」定義每個 Looker 精確查詢，請提供下列兩個欄位的值：

  • natural_language_questions：使用者可能會提出的自然語言問題
  • looker_query：與自然語言問題相應的 Looker 精確查詢

在 natural_language_questions 欄位中，請考慮使用者可能會對該探索提出的問題，並以自然語言撰寫這些問題。您可以在這個欄位的值中加入多個問題。您可以從「探索」的查詢中繼資料取得 looker_query 欄位的值。

黃金查詢支援下列欄位：

  • model (字串)：用於產生查詢的 LookML 模型。這是必填欄位。
  • explore (字串)：用於產生查詢的探索。這是必填欄位。
  • fields[] (字串)：要從「探索」擷取的欄位，包括維度和指標。此為選填欄位。
  • filters[] (字串)：要套用至「探索」的篩選器。此為選填欄位。
  • sorts[] (字串)：要套用至「探索」的排序方式。此為選填欄位。
  • limit (字串)：要套用至探索的資料列限制。這是選填欄位。

您可以按照下列步驟，直接從「探索」擷取查詢中繼資料：

  1. 在「探索」中，選取「探索動作」選單，然後選取「取得 LookML」。
  2. 選取「資訊主頁」分頁標籤。
  3. 從 LookML 複製查詢詳細資料。舉例來說，下圖顯示名為「Order Items」的探索 LookML：

複製所選中繼資料，以用於 Looker 精確查詢：

  model: thelook
  explore: order_items
  fields: [order_items.order_id, orders.status]
  sorts: [orders.status, order_items.order_id]
  limit: 500

測試代理

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

您必須按一下「更新」，變更才會反映在預覽畫面中。如果儲存狀態為 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 執行個體中執行工作。

如要在 Looker 中建立資料代理程式，並提供給 Gemini Enterprise 的使用者，具有下列角色的使用者必須按照這些步驟操作 (詳情請參閱相關章節)：

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

事前準備

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

將資料代理發布至 Gemini Enterprise

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

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

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

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

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

如要與 Gemini Enterprise 中的代理對話，使用者必須有權存取 Gemini Enterprise 執行個體和個別代理。

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

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

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

在 Gemini Enterprise 中與代理程式對話

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

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

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

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

刪除資料代理程式

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

1. 在「對話」頁面，按一下左側面板中的「spark」「管理代理程式」。 1. 按一下所選代理的「更多選項」圖示，開啟選單，然後按一下「刪除」。 1. 在「Delete agent?」(要刪除代理程式嗎？) 視窗中，按一下「Move to trash」(移至垃圾桶) 即可刪除資料代理程式。

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

永久刪除資料代理人

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

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

從垃圾桶還原資料代理程式

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

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