建立資料代理程式

預覽

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

注意： 如要提供意見回饋或尋求這項功能支援，請傳送電子郵件至 [e-mail]。

本文說明如何在 BigQuery 中建立、編輯、管理及刪除資料代理程式。

在 BigQuery 中，您可以與資料代理進行對話，以自然語言詢問有關 BigQuery 資料的問題。資料代理包含資料表的中繼資料，以及用例專屬的查詢處理指令，可定義回答使用者問題的最佳方式，問題內容與您選取的一組知識來源相關，例如資料表、檢視畫面或使用者定義函式 (UDF)。

事前準備

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

2. 啟用 BigQuery、Gemini Data Analytics 和 Gemini for Google Cloud API。

   啟用 API 時所需的角色

   如要啟用 API，您需要服務使用情形管理員 IAM 角色 (roles/serviceusage.serviceUsageAdmin)，其中包含 serviceusage.services.enable 權限。瞭解如何授予角色。

   啟用 API

必要的角色

如要使用資料代理程式，您必須具備符合用途的 Identity and Access Management 權限。下列各節會根據您是否要建立及發布代理程式、在 Gemini Enterprise 中佈建代理程式，或是探索及使用代理程式，列出必要角色。詳情請參閱「對話式數據分析 API Identity and Access Management 角色」。

• 建立、編輯、發布、共用及刪除代理程式：
  • 如要對專案中的所有資料代理執行動作，請在專案中擔任 Gemini Data Analytics 資料代理擁有者 (roles/geminidataanalytics.dataAgentOwner) 角色。
  • 如要只對專案中的自有資料代理採取行動：Gemini Data Analytics 資料代理建立者 (roles/geminidataanalytics.dataAgentCreator) 專案。這個角色會自動授予您所建立資料代理的 Gemini Data Analytics 資料代理擁有者角色。
  • 如要查看及編輯專案中的所有資料代理，請在專案層級指派 Gemini Data Analytics 資料代理編輯者 (roles/geminidataanalytics.dataAgentEditor) 角色。
• 在 Gemini Enterprise 中佈建代理：
  • 如要讓 Gemini Enterprise 使用者存取已發布的代理，您必須在 Gemini Enterprise 管理控制台中，具備註冊及管理 A2A 代理的權限。
• 探索及使用代理：
  • 如要與資料代理對話，請使用 Gemini Data Analytics 資料代理使用者角色 (roles/geminidataanalytics.dataAgentUser)。
  • 如要查看專案中的所有資料代理程式，請使用 Gemini Data Analytics 資料代理檢視者 (roles/geminidataanalytics.dataAgentViewer)。

此外，您必須具備下列角色，才能建立或編輯資料代理程式：

• Gemini Data Analytics 無狀態對話使用者 (roles/geminidataanalytics.dataAgentStatelessUser)。
• 資料代理程式做為知識來源的任何資料表，都必須具備 BigQuery 資料檢視者 (roles/bigquery.dataViewer) 權限。
• 專案的 Data Catalog 檢視者 ( roles/datacatalog.catalogViewer)
• 如果資料表使用資料欄層級存取控管機制，請在適當的政策標記上選取「精細讀取者」圖示 roles/datacatalog.categoryFineGrainedReader。詳情請參閱「搭配欄層級存取權控管使用的角色」。
• 如果資料表使用資料列層級存取權控管，您必須擁有該資料表的資料列層級存取權政策。詳情請參閱「建立或更新資料列層級存取權政策」。
• 如果資料表使用資料遮蓋，請在適當的資料政策中，將 Masked Reader (roles/bigquerydatapolicy.maskedReader) 設為資料表存取權。詳情請參閱「查詢遮蓋資料的角色」。

如要使用 BigQuery 資源 (例如查看資料表或執行查詢)，請參閱 BigQuery 角色。

最佳做法

對話式數據分析會自動為您執行查詢，以回答您的問題。請考慮下列可能導致查詢費用增加的因素：

• 大型資料表
• 在查詢中使用資料彙整
• 在查詢中頻繁呼叫 AI 函式

產生深入分析資訊

您可以選擇在 Knowledge Catalog 中產生資料洞察，做為知識來源的任何表格都適用。

生成的洞察資料會提供資料表的中繼資料，資料代理程式可使用這些資料生成問題回覆。

如果您未事先產生洞察資料，在建立資料代理程式時選取資料表做為知識來源，系統就會自動產生洞察資料。

使用範例資料代理

如果您不熟悉如何設定對話式數據分析的代理程式，可以選擇查看為每個Google Cloud 專案產生的預先定義範例代理程式。你可以與其對話，並查看參數瞭解建立方式，但無法修改。

如要查看範例代理程式，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的 BigQuery Agents 頁面。

   前往「代理程式」頁面

2. 選取「代理程式目錄」分頁標籤。

3. 在「Google 的代理範例」部分下方，按一下代理範例資訊卡。

建立資料代理

下列各節說明如何建立資料代理程式。

建立代理程式後，您可以編輯其設定。

注意： 如果正在與資料來源對話，也可以從該對話建立代理。

初始步驟

1. 前往 Google Cloud 控制台的 BigQuery Agents 頁面。

   前往「代理程式」頁面

2. 選取「代理程式目錄」分頁標籤。

3. 按一下「新增代理程式」。「New agent」(新增代理程式) 頁面隨即開啟。

4. 在「編輯器」部分的「代理程式名稱」欄位中，輸入資料代理程式的描述性名稱，例如 Q4 sales data 或 User activity logs。

5. 在「代理程式說明」欄位中，輸入資料代理程式的說明。好的說明會解釋代理的功用、使用的資料，以及協助您判斷是否要與這個資料代理對話，例如 Ask questions about customer orders and revenue。

6. 在「知識來源」部分中，按一下「新增來源」。「新增知識來源」頁面隨即開啟。

7. 在「最近項目」部分，選取要做為知識來源的任何資料表、檢視區塊、圖表或 UDF。在 Google Cloud 控制台中，UDF 會加上「fx」前置指標。

8. 如要查看其他知識來源，請選取 顯示更多。

9. 選用：新增「最近」部分未列出的知識來源：

   1. 在「搜尋」部分中，於「搜尋表格」欄位輸入來源名稱，然後按下 Enter 鍵。來源名稱不必完全相符。

   2. 在「搜尋結果」部分中，選取一或多個來源。

10. 按一下「Add」(新增)。系統會重新開啟新的代理程式頁面。

自訂資料表和欄位說明

如要提高資料代理程式的準確率，您可以選擇提供額外的資料表中繼資料。只有資料代理程式會使用這項中繼資料，且不會影響來源資料表。

建立表格和欄位說明時，請遵循下列最佳做法：

• 請參考這些說明，瞭解資料代理程式如何解讀結構定義。如果代理商建議的說明正確無誤，可以接受。

• 設定這些說明後，如果資料代理程式仍無法瞭解結構定義，請手動調整說明，提供正確資訊。

請按照下列步驟設定表格和欄位說明：

1. 在「知識來源」部分中，按一下表格的「自訂」連結。

2. 建立資料表說明。您可以在「表格說明」欄位中輸入說明，或接受 Gemini 的建議。

3. 在「欄位」部分，查看 Gemini 建議的欄位說明。

4. 選取要接受的欄位說明，然後按一下「接受建議」。選取要拒絕的說明，然後按一下「拒絕建議」。

5. 如要手動編輯任何欄位說明，請按一下欄位旁邊的「編輯」。「編輯欄位」窗格隨即開啟。

   1. 在「Description」(說明) 欄位中輸入欄位說明。
   2. 如要儲存欄位說明，請按一下「更新」。

6. 如要儲存說明和欄位更新，請按一下「更新」。系統會重新開啟新的代理程式頁面。

7. 針對需要自訂的每個表格重複執行這些步驟。

建立代理指令

代理程式應瞭解使用者問題的背景資訊，不必提供任何自訂指令。只有在需要變更代理程式的行為，或以其他情境功能 (例如自訂表格和欄位中繼資料，或已驗證的查詢) 無法支援的方式改善情境時，才需要為代理程式建立自訂指令。

在「說明」部分，於「代理說明」欄位中輸入資料代理的說明。資料代理程式會使用這些指令瞭解使用者問題的脈絡並提供答案，因此請盡可能清楚地撰寫指令。

如果代理程式無法提供令人滿意的答案，請加入結構化內容，例如說明、範例或詞彙表。如果還是無法獲得滿意的答案，請新增自訂指令，例如下表中的範例。

如需更多指令範例，請按一下「顯示範例」。

資訊類型	說明	範例
重要欄位	分析作業中最重要的欄位。	「這個資料表最重要的欄位是：客戶 ID、產品 ID、訂單日期。」
篩選及分組	代理在篩選及分類資料時應使用的欄位。	「如果問題與時間軸或『一段時間內』有關，請一律使用 order_created_date 欄。」「如果有人說『依產品』，請依 product_category 資料欄分組。」
預設篩選	預設要篩選的欄位。	「除非另有說明，否則請一律依 order_status = 'Complete' 篩選資料。」
同義詞和企業字詞	關鍵欄位的替代字詞。	「如果有人詢問『收益』或『銷售』，請使用 total_sale_amount 欄。」「我們認為『忠實』顧客是指 purchase_count > 5 的顧客。」
排除欄位	資料代理應避免使用的欄位。	「切勿使用下列欄位：衍生交易日期、衍生城市。」
彙整關係	兩個以上的資料表如何彼此關聯，以及用於彙整資料表的資料欄。代理程式必須對資料欄組合使用標準 SQL JOIN，才能合併資料。請參閱「範例」欄。	顧客活動 order_items.user_id = users.id (將銷售量與顧客連結) events.user_id = users.id (將網站活動連結至已登入的顧客)

建立通過驗證的查詢

服務專員會透過兩種方式使用已驗證的查詢：

• 如果代理程式可以使用經過驗證的查詢來回答您提出的問題，為確保答案值得信賴，代理程式會完全按照查詢內容執行。
• 如果服務專員無法使用已驗證的查詢來回答問題，仍會將查詢做為參考，瞭解資料和查詢資料的最佳做法。

您可以從系統生成的清單中選取已驗證的查詢，也可以自行建立查詢。

注意： 如要建立參數化已驗證查詢，請參閱「建立參數化已驗證查詢」。

如要為資料代理程式建立已驗證的查詢 (舊稱精確查詢)，請按照下列步驟操作：

1. 選取一或多個 Gemini 建議的已驗證查詢：

   1. 在「已驗證的查詢」部分，按一下「查看建議」。「查看建議的已驗證查詢」頁面隨即開啟。
   2. 查看建議的已驗證查詢。請選取所有適用於您用途的項目。
   3. 按一下「Add」(新增)。系統會重新開啟新的代理程式頁面。

2. 如要建立自己的已驗證查詢，請按一下「新增查詢」。「新增已驗證的查詢」頁面隨即開啟。

   1. 在「問題」欄位中，輸入經過驗證的查詢會回答的使用者問題。
   2. 按一下「生成 SQL」，讓 Gemini 生成與您指定使用者問題相符的已驗證查詢。
   3. 視需要修改通過驗證的查詢。
   4. 點選「執行」，確認查詢傳回的結果符合預期。
   5. 按一下「Add」(新增)。系統會重新開啟新的代理程式頁面。

3. 視需要重複上述步驟，建立其他已驗證的查詢。

建立參數化驗證查詢

參數化驗證查詢會從使用者的問題中擷取值，提供給對話式分析代理程式，並提供量身打造的結果。

分析師和建構者可以建立可重複使用的 SQL 範本，其中包含這些值的預留位置。範本會在執行階段動態替換參數，因此比一般已驗證的查詢能回答更多使用者問題。

當使用者提出的問題符合範本模式時，對話式數據分析代理程式會從問題中擷取參數值，例如產品名稱、區域和日期。然後將這些值插入參數化 SQL 查詢。查詢範本中相符的回覆會顯示為「已驗證」。

參數化驗證查詢可大幅提升驗證查詢的功能和彈性。確保各種輸入內容都能獲得一致且可信的答案，並減少需要維護的個別查詢數量。詳情請參閱下列文章：

• 如要建立參數化已驗證查詢，請參閱「建立參數化已驗證查詢」。
• 如要瞭解一般參數化查詢，請參閱「執行參數化查詢」。

運作方式

資料分析師等專家會使用範本問題定義已驗證的查詢，例如「@region在 @region 的銷售額是多少？」。接著，專家會使用 SQL 參數建立或修改已驗證的查詢，如下例所示：@product

SELECT * FROM sales WHERE region = @region AND product = @product

儲存已驗證的查詢後，使用者就能以自然語言向對話式分析代理程式提問，例如「北美地區的筆電銷售額是多少？」

為回答使用者的問題，對話式代理程式會執行下列步驟：

1. 將問題與參數化驗證查詢相關聯的模式進行比對。代理程式會使用自然語言理解 (NLU)，從使用者的問題中找出並擷取 @region (北美) 和 @product (筆電) 的值。
2. 將擷取的值代入 SQL 範本中的 @region 和 @product 預留位置。
3. 執行完整的 SQL 查詢，例如 SELECT * FROM sales WHERE region = 'North America' AND product = 'Laptops'。
4. 將結果傳回給使用者。比對結果一律會標示為「已驗證」。

建立有效參數化查詢的訣竅

• 使用明確的參數名稱。為參數使用描述性名稱，例如 @start_date，而非 @d1。
• 建立詳細的參數說明。對話式數據分析的大型語言模型 (LLM) 會使用參數說明，從使用者問題中找出參數及其值。舉例來說，num_enrollments 是有效的參數名稱，但 number of student enrollments from ages 5-14 是參數說明，可提供更多查詢背景資訊。
• 確保資料型別一致。確認 SQL 查詢預期的資料類型，與使用者問題中可能擷取的資料類型相符。
• 提供明確定義的範圍。針對常見且重要的問題模式建立範本，這類問題的查詢建構方式複雜，或邏輯不直覺。這樣做有助於 LLM 傳回最佳結果。
• 全面測試。使用各種自然語言措辭進行測試，確保系統正確擷取參數。

建立參數化驗證查詢

您可以從系統生成的清單中選取已驗證的查詢，也可以自行建立。

建立或修改查詢前，請先草擬查詢，並考量自然語言模式和您的問題。舉例來說，如果詢問「我們是否知道美國東部倉庫的有機香蕉總庫存量？」，您可以將問題改寫為參數化驗證查詢「@region 倉庫的 @product 總庫存量是多少？」。對話式數據分析代理程式會將這個問題轉換為 SQL 查詢，您可以使用預設值更新查詢。

如要為資料代理程式建立參數化驗證查詢，您可以在建立新代理程式時建立新查詢，也可以為新代理程式或現有代理程式編輯現有驗證查詢。

下列操作說明會使用經過驗證的查詢範例，設定參數。

選取現有的 Gemini 建議已驗證查詢

1. 在現有或新代理程式的「已驗證的查詢」部分，按一下「查看建議」。「查看建議的已驗證查詢」頁面隨即開啟。
2. 勾選建議的已驗證查詢旁的核取方塊。
3. 在查詢視窗中，按一下 顯示更多 展開查詢說明。
4. 如要開啟現有查詢，請按一下「編輯」。
5. 如要完成查詢設定，請參閱「設定已驗證查詢的參數」。

建立代理程式，然後建立已驗證的查詢

1. 請參閱「初始步驟」， 並繼續完成其餘設定步驟，以驗證查詢。
2. 在 Google Cloud 控制台中，點按新代理程式的「已驗證的查詢」部分中的「新增查詢」。「新增通過驗證的查詢」頁面隨即開啟。
3. 如要完成查詢設定，請參閱「設定已驗證查詢的參數」。

設定已驗證查詢的參數

1. 在「問題」欄位中，輸入經過驗證的查詢所回答的使用者問題。
2. 如要指定參數，請使用 @ 符號，後面加上參數名稱。這個語法會識別預留位置，從使用者問題擷取值。使用自然語言問題，說明參數在使用者問題中的用途。例如：「@region 倉庫中 @product 的總庫存量是多少？」

3. 按一下「Generate SQL」(生成 SQL 查詢)。SQL 如下所示：

      SELECT
          SUM(stock) AS total_stock
      FROM
          inventory
      WHERE
          product_id = @product
          AND region = @region;
   

4. 如要為查詢中的預留位置新增預設值，請按一下「管理查詢參數」，然後按一下「新增查詢參數」。

5. 第一個參數會顯示「名稱」、「類型」、「值」和「說明」四個欄位。

   • 在「Name」(名稱) 欄位中，複製問題中的 @product 並貼到這個欄位。
   • 在「Type」(類型) 部分，選取「STRING」。
   • 在「Value」中輸入 organic bananas。
   • 在「說明」中，盡可能輸入具體的說明。 例如位於區域倉庫的產品。

6. 針對第二個參數，按一下「新增查詢參數」。

   • 在「Name」(名稱) 欄位中，複製問題中的 @region 並貼到這個欄位。
   • 在「Type」(類型) 部分，選取「STRING」。
   • 在「Value」中輸入 US-EAST。
   • 在「說明」部分輸入盡可能具體的說明，例如 a regional warehouse where products are located.

7. 填寫完兩個參數的欄位後，請按一下「儲存」。

測試參數化已驗證查詢

1. 按一下「執行」，確認查詢傳回的結果符合預期。
2. 如要在後續畫面測試使用者的查詢，請複製整個問題欄位。
3. 按一下「儲存」，離開「新增查詢」畫面，然後返回代理程式「編輯」頁面。
4. 在代理程式的「編輯」頁面，將先前複製的問題欄位貼到「預覽」視窗。
   1. 將 @product 變數替換為 organic bananas。
   2. 將 @region 變數替換為 US-EAST。
5. 按下 Enter 鍵，請查看結果，在本例中，有效答案是美國東部地區的香蕉總庫存量，例如 1,000。
6. 如要建立或編輯其他已驗證的查詢，請視需要重複執行這些步驟。

儲存查詢後，使用者可以詢問「Do we know the total stock for organic bananas in the US-EAST warehouse?」(我們知道美國東部倉庫的有機香蕉總庫存量嗎？)對話式數據分析接著會執行下列動作：

1. 將這個問題與模式比對。
2. 從問題中擷取 @product 參數 (@product =「organic bananas」) 和 @region 參數 (@region =「US-EAST」)。
3. 執行查詢：SELECT SUM(stock) AS total_stock FROM inventory WHERE product_id = 'organic bananas' AND region = 'US-EAST';
4. 傳回計算出的 total_stock。

建立或查看詞彙表字詞

您可以為代理程式建立 BigQuery 自訂術語，或是查看從 Knowledge Catalog 匯入的組織詞彙，這些術語適用於您為代理程式選取的知識來源。

• 由於 Knowledge Catalog 中的組織詞彙會全域套用至 BigQuery 資源，因此如果您使用 Knowledge Catalog，請在 Knowledge Catalog 中建立及管理組織詞彙，而不是為個別代理程式建立及管理。
• 如要修改從 Knowledge Catalog 匯入的組織詞彙字詞，請在 Knowledge Catalog 中編輯，然後返回對話式數據分析查看。
• BigQuery 自訂字彙表字詞會保留在 BigQuery 中。不會顯示在 Knowledge Catalog 中。
• 如果未使用 Knowledge Catalog，可以為特定代理程式需要定義的字詞建立 BigQuery 自訂字彙表字詞。

如要為代理程式建立自訂詞彙，請按照下列步驟操作：

1. 在代理程式「編輯器」頁面的「詞彙表」部分，按一下「新增字詞」。
2. 在「自訂條款」部分，你可以編輯或刪除現有的自訂條款。
3. 如要建立一或多個新學期，請按一下「建立學期」。
   1. 輸入字詞、定義，以及一或多個同義詞 (以半形逗號分隔)。
   2. 如要建立字詞，請按一下「新增」。
   3. 如要刪除新字詞，請按一下「刪除」。
4. 如要建立更多自訂字詞，請重複執行這些步驟。

如要查看從 Knowledge Catalog 匯入的組織詞彙字詞，請按照下列步驟操作：

1. 在代理程式「編輯器」頁面的「詞彙表」部分，按一下「新增字詞」。
2. 前往名為「從 Dataplex 匯入」的網頁區塊。
3. 如要在 Knowledge Catalog 中修改匯入的字詞，必須點選「前往 Dataplex 詞彙表」連結。
4. 修改 Knowledge Catalog 中的字詞後，您可以返回代理程式的編輯器頁面，查看修改後的字詞。

調整設定

在「設定」部分，您可以設定下列選用設定：

1. 建立標籤，協助您整理Google Cloud 資源。標籤是鍵/值組合，可用來將相關物件分組，或與其他 Google Cloud 資源組合。

   1. 在「設定」部分，按一下「管理標籤」。
   2. 按一下「新增標籤」。
   3. 在「key」和「value」欄位中，輸入標籤的鍵/值組合。
   4. 如要新增其他標籤，請再次按一下「新增標籤」。
   5. 如要刪除標籤，請按一下「刪除」。
   6. 完成後，按一下「新增」。系統會重新開啟新的代理程式頁面。

2. 選用：為資料代理程式處理的查詢設定大小限制。在「設定」部分中，於「帳單結算位元組上限」欄位輸入值。您必須將這項限制設為 10485760 以上，否則會收到下列錯誤訊息：

Value error. In BigQuery on-demand pricing charges are
rounded up to the nearest MB, with a minimum of 10 MB of data processed
per query. So, max bytes billed must be set to greater or equal to
10485760.

如未指定值，maximum bytes billed 預設為專案的每日查詢用量配額。除非您指定自訂配額，否則每日用量配額沒有上限。

請前往下一節，將代理程式設為草稿模式或發布代理程式。

預覽及發布代理程式

1. 在「預覽」部分，於「提出問題」欄位中輸入使用者問題範例，然後按 Enter 鍵。如要確認資料代理程式是否傳回預期資料，請查看代理程式的回應。如果回覆不符合預期，請變更「編輯器」部分中的設定，微調資料代理程式設定，直到獲得滿意的回覆為止。您可以繼續測試及修改代理，以改善代理的結果。

2. 按一下 [儲存]。

3. 如要將資料代理程式設為草稿模式，以便稍後重新編輯，請按一下「返回」，返回「代理程式目錄」頁面。由於代理現在處於草稿模式，因此會顯示在「代理目錄」分頁的「我的草稿代理」部分。

   如要發布代理程式，請留在代理程式建立頁面，然後繼續執行下一個步驟。

4. 按一下「發布」，發布資料代理程式，即可在專案中使用。您可以使用 BigQuery Studio 或 數據分析，與資料代理建立對話。您也可以使用對話式數據分析 API，建構自己的介面與資料代理對話。如要瞭解如何發布至 Gemini Enterprise，請參閱「在 Gemini Enterprise 中發布資料代理程式」。

5. 選用：在「您的代理已發布」對話方塊中，按一下「分享」，即可與其他使用者共用資料代理。

   1. 在「共用權限」窗格中，按一下「新增主體」。

   2. 在「New principals」(新增主體) 欄位中，輸入一或多個主體。

   3. 按一下「選取角色」清單。

   4. 在「Role」(角色) 清單中，選取下列其中一個角色：

      • Gemini Data Analytics 資料代理使用者 (roles/geminidataanalytics.dataAgentUser)：授予與資料代理對話的權限。
      • Gemini Data Analytics 資料代理編輯者 (roles/geminidataanalytics.dataAgentEditor)：可編輯資料代理。
      • Gemini Data Analytics 資料代理檢視者 (roles/geminidataanalytics.dataAgentViewer)：授予檢視資料代理的權限。

6. 按一下 [儲存]。

7. 如要返回新代理程式頁面，請按一下「關閉」。儲存或發布代理程式後，您會立即在代理程式目錄中看到該程式。

管理資料代理程式

您可以在「代理程式目錄」分頁中找到現有代理程式，該分頁包含三個部分：

• 我的代理程式：列出您建立及發布的所有代理程式。您可以修改已發布的代理，並與他人共用。
• 我的代理草稿：尚未發布的代理。您無法共用草稿代理程式。
• 組織中其他成員分享的代理：其他使用者建立並與您共用的代理。如果其他人授予您權限，您就可以編輯這些共用代理程式。

編輯資料代理程式

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

1. 前往 BigQuery Agents 頁面。

   前往「代理程式」頁面

2. 選取「代理程式目錄」分頁標籤。

3. 找出要修改的資料代理人代理人資訊卡。

4. 如要在代理程式編輯器中開啟資料代理程式，請依序點選 「開啟動作」> 代理程式資訊卡上的「編輯」。

5. 視需要編輯資料代理程式的設定。

6. 如要儲存變更但不發布，請按一下「儲存」。

7. 如要發布變更，請按一下「發布」。在「共用」對話方塊中，您可以與他人共用代理程式，或按一下「取消」。

8. 如要返回「代理」窗格，請按一下「返回」。

   

共用資料代理

如要分享已發布的資料代理程式，請按照下列步驟操作。您無法共用草稿代理程式。

1. 前往 BigQuery Agents 頁面。

   前往「代理程式」頁面

2. 選取「代理程式目錄」分頁標籤。

3. 找出要修改的資料代理人代理人資訊卡。

4. 如要在代理程式編輯器中開啟資料代理程式，請依序點選 「開啟動作」> 代理程式資訊卡上的「編輯」。

5. 如要與其他使用者共用資料代理人，請按一下「共用」。

6. 在「共用權限」窗格中，按一下「新增主體」。

7. 在「New principals」(新增主體) 欄位中，輸入一或多個主體。

8. 按一下「選取角色」清單。

9. 在「Role」(角色) 清單中，選取下列其中一個角色：

   • Gemini Data Analytics 資料代理使用者 (roles/geminidataanalytics.dataAgentUser)：可與資料代理對話。
   • Gemini Data Analytics 資料代理編輯者 (roles/geminidataanalytics.dataAgentEditor)：可編輯資料代理。
   • Gemini Data Analytics 資料代理檢視者 (roles/geminidataanalytics.dataAgentViewer)：可檢視資料代理。

10. 按一下 [儲存]。

11. 如要返回代理編輯頁面，請按一下「關閉」。

12. 如要返回「代理程式」窗格，請按一下 「返回」。

    

在數據分析中共用資料代理

預覽

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

發布代理程式並分享給數據分析工具使用者後，代理程式就會自動顯示在數據分析工具的「與資料對話」頁面。

您也可以複製代理程式的直接連結，直接在 Google 數據分析中開啟與該特定 BigQuery 資料代理程式的連線。你可以透過下列方式複製專屬代理程式網址：

• 從代理程式目錄：選取 「開啟動作」，然後依序選取「複製連結」和「數據分析」。
• 在代理程式詳細資料檢視畫面中，依序選取 「複製代理程式連結」和「數據分析」。
• 在「共用」溢位選單中，選取「複製數據分析工具中代理的連結」。

刪除資料代理程式

1. 前往 BigQuery Agents 頁面。

   前往「代理程式」頁面

2. 選取「代理程式目錄」分頁標籤。

3. 在「代理程式目錄」分頁的「我的代理程式」或「我的草稿代理程式」部分，找到要刪除的資料代理程式資訊卡。

4. 依序點選「開啟動作」>「刪除」。

5. 在「Delete agent?」(要刪除代理程式嗎？) 對話方塊中，按一下「Delete」(刪除)。

在 Gemini Enterprise 中發布資料代理

預覽

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

注意： 如要使用這項功能，必須先加入許可清單。如要申請存取權，請填寫申請表單。如要提供意見回饋或尋求這項功能的支援，請傳送電子郵件至 [e-mail]。

下列各節說明如何在 Gemini Enterprise 中發布資料代理程式。這個程序通常需要資料分析師、Gemini Enterprise 管理員和商務使用者共同合作。如要進一步瞭解這些使用者所需的角色，請參閱「必要的角色」。

如要在 Gemini Enterprise 中發布資料代理程式，請完成下列步驟：

1. 建立並發布資料代理。
2. 佈建代理程式。
3. 探索及使用代理程式。

建立及發布代理程式

身為資料分析師，您可以完成下列步驟，建立、編輯及發布 Gemini Enterprise 代理程式：

1. 在 BigQuery 中建立或編輯資料代理程式。
2. 發布代理程式。發布代理程式時，請選取「Gemini Enterprise」做為發布選項。
3. 複製 A2A 端點 JSON。
4. 將 A2A 端點 JSON 和使用者名單提供給 Gemini Enterprise 管理員。
5. 共用代理與需要存取權的使用者和群組。

佈建代理程式

Gemini Enterprise 管理員可以讓 Google Cloud 控制台中的使用者存取已發布的代理程式。

1. 前往 Google Cloud 控制台的「Gemini Enterprise」。

   Gemini Enterprise

2. 按一下要註冊代理程式的應用程式名稱。

3. 依序點選「代理程式」 > 「新增代理程式」。

4. 在「選擇代理類型」部分，按一下「透過 A2A 新增自訂代理」的「新增」。

5. 在「代理商資訊卡 JSON」欄位中，輸入您先前從資料分析師收到的代理商資訊卡詳細資料 (JSON 格式)。如需可用欄位的完整清單，請參閱 Agent2Agent (A2A) 通訊協定規格。範例僅使用必填欄位。

6. 按一下「預覽代理商詳細資料」>「下一步」。

7. 如要允許代理程式代表您存取 Google Cloud 資源，請完成下列步驟：

8. 輸入您在「設定授權詳細資料」部分產生的「Client ID」(用戶端 ID)、「Client secret」(用戶端密鑰)、「Authorization URI」(授權 URI) 和「Token URI」(權杖 URI)。

9. 輸入範圍。

10. 按一下「完成」。

11. 與資料分析師提供的使用者或群組共用代理程式。

如要進一步瞭解如何在 Gemini Enterprise 中使用 A2A 代理程式，請參閱「註冊及管理 A2A 代理程式」。

探索及使用代理程式

您可以使用下列任一方法，在 Gemini Enterprise 中探索及使用資料代理：

• 手動探索：在代理庫中找出資料代理，然後使用下列任一方法：
  • 瀏覽圖庫：選取代理並開始專屬的即時通訊。
  • 直接連結：使用代理的專屬網址直接開啟 Gemini Enterprise，並與該特定 BigQuery 資料代理進行對話。
  • 直接意圖：在 Gemini Enterprise 核心聊天室中，使用 @mention 呼叫代理 (例如 @sales_pipeline_agent)。
  • 無縫協調：提出一般分析問題 (例如「過去 3 個月內的銷售管道趨勢如何？」)，Gemini Enterprise 就會自動將查詢傳送至相關資料代理程式。

探索代理程式後，您可以執行下列步驟與代理程式互動：

• 驗證：完成一次性 OAuth 登入，安全地驗證 BigQuery。
• 即時通訊：以自然語言向服務專員提問。要求會由 BigQuery 對話式數據分析代理程式處理，並以文字、Markdown、圖表或表格的形式，將回應串流回 Gemini Enterprise。
• 查看對話記錄：對話會自動儲存在記錄窗格中。

位置

對話內容分析功能適用於全球，無法選擇要使用的區域。

後續步驟

• 進一步瞭解 BigQuery 中的對話式數據分析。
• 進一步瞭解 對話式數據分析 API。
• 透過對話分析資料。
• 進一步瞭解 Gemini Data Analytics 資料代理檢視者 (roles/geminidataanalytics.dataAgentViewer) 角色如何授予檢視資料代理的權限。