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

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

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

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

事前準備

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

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

如果 Looker 管理員已在 Gemini in Looker 管理頁面啟用下列功能，您就能使用對話式數據分析探索代理：

  • 對話式數據分析
  • 啟用「信任的測試人員」功能
    • Agentic Workflows [預覽版]：建立Agentic Workflows，指示代理監控資料變更。
    • 已驗證查詢 [預覽]：定義已驗證查詢，即自然語言問題和對應的探索查詢組合，做為代理的背景資訊。這項預先發布功能僅適用於 Looker (原始版)。
    • 發布至 Gemini Enterprise [預覽]：將代理發布至 Gemini Enterprise，讓更多使用者存取代理的預先定義脈絡和數據分析。

建立及編輯資料代理

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

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

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

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

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

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

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

    • 顯示思考過程：開啟這個切換鈕，即可在回覆中顯示代理的推論步驟、生成的 Looker 查詢和基礎資料表。
    • 顯示偵錯資訊：開啟這個切換鈕，即可顯示代理在每則回覆中執行的步驟，協助您排解問題。

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

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

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

撰寫代理指令

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

以下列舉幾個您可以在「指示」欄位中提供的內容：

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

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

定義已驗證的查詢

已驗證的查詢 (在部分 Google 文件中也稱為黃金查詢) 是預先定義的自然語言問題配對，以及對應的確切 Looker 探索查詢。這些問題和查詢配對會做為經過驗證的「黃金標準」，教導代理程式如何處理複雜的業務要求，而不只是猜測。定義明確的已驗證查詢，有助於提升探索資料代理程式回覆的準確度。

已驗證查詢的限制

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

  • 只有 Explore 資料代理商才能使用已驗證的查詢。不適用於獨立對話或資訊主頁資料代理程式。
  • 您必須使用已為代理程式定義的探索。如果您參照資料代理程式未使用的 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 管理員身分與存取權管理角色的使用者，必須為 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 管理員必須為包含 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. 在「為代理新增使用者授權角色」視窗中，新增每位使用者並指派「代理使用者」角色。

在 Gemini Enterprise 中與代理互動

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

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

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

首次與代理進行即時通訊時，您必須授權代理存取您的 Looker 身分。

刪除資料代理程式

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

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

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

永久刪除資料代理人

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

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

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

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

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