「Export and import」(匯出及匯入)

本頁說明如何匯出及匯入代理程式應用程式和個別工具。

匯出及匯入代理程式

您可以匯出及匯入代理程式應用程式：

  1. 開啟 Gemini Enterprise for CX 控制台。
  2. 選取專案。 系統會顯示專案的代理程式應用程式清單。
  3. 按一下應用程式的內容選單，然後選取匯入或匯出。

環境檔案

匯出代理程式應用程式時，下載的封存檔根目錄中會包含名為 environment.json 的檔案。這個檔案可協助您管理應用程式的環境專屬設定，例如 Cloud Storage 值區、服務端點和資料存放區 URI。

使用這個檔案匯出及匯入資料有以下優點：

  • 提升可攜性： 修改單一檔案，即可在不同專案或環境 (例如從開發環境移至正式環境) 之間轉移代理程式應用程式。
  • 集中式設定： 所有重要的外部依附元件都會列在同一處， 方便管理並提供清楚的總覽。
  • 減少錯誤： 與手動編輯多個資源檔案的設定相比，可大幅降低出錯風險。
  • 自動化友善： JSON 格式可讓您使用指令碼，以程式輔助方式更新設定，做為 CI/CD 管道的一部分。

如要更新特定環境的設定，請按照下列步驟操作：

  1. 匯出： 下載匯出的代理程式應用程式，然後解壓縮。
  2. 修改： 開啟位於根目錄的 environment.json 檔案。 修改相依性的值，以符合目標環境的設定。
  3. 匯入： 將整個目錄 (包括修改後的 environment.json 檔案) 壓縮成新的 zip 封存檔。 將這個新封存檔匯入目標環境。 系統會套用 environment.json 中的更新值。

環境檔案詳細資料

environment.json 檔案可做為外部依附元件的中央資訊清單，這些依附元件可能會在不同環境 (例如開發、測試和實際工作) 之間變更。

匯出代理程式應用程式時，系統會識別應用程式資源中的環境專屬欄位。系統會擷取這些值，並將其放在 environment.json 檔案中，而不是以硬式編碼方式撰寫。這些值會依資源類型和名稱整理。 在原始資源資訊清單檔案中，這些擷取的值會替換為預留位置變數 $env_var。

匯入代理程式應用程式時，系統會讀取 environment.json 檔案。它會在資源資訊清單中找出 $env_var 預留位置，並以 environment.json 檔案中的對應值取代。這個程序會為新環境設定應用程式。

environment.json 檔案中管理的欄位如下：

  • ApiKeyConfig.key_name
  • ApiKeyConfig.api_key_secret_version
  • AudioRecordingConfig.gcs_bucket
  • BoostSpecs.data_stores
  • ConnectorTool.connection
  • DataStore.name
  • EngineSource.engine
  • FileSearchTool.file_corpus
  • OAuthConfig.client_secret_version
  • OAuthConfig.token_endpoint
  • OpenApiToolset.url (自動從 OpenApiToolset.open_api_schema 擷取)
  • ServiceAccountAuthConfig.service_account
  • VertexAiRagRetrievalTool.RagResource.rag_corpus
  • VertexAiRagRetrievalTool.RagResource.rag_file_ids

匯出及匯入工具

您可以匯出及匯入個別工具。 這項功能會在「工具」面板中提供兩個新選項：「匯入」和「匯出」。

  • 匯出：將工具內容下載為 JSON 檔案，並儲存至本機或 Cloud Storage。
  • 匯入：使用本機 JSON 檔案或儲存在 Cloud Storage 中的 JSON 檔案，建立新工具或更新現有工具。

匯出工具

如要匯出工具，請按照下列步驟操作：

  1. 開啟 Gemini Enterprise for CX 控制台，然後選取專案和代理程式。
  2. 開啟「工具」面板。
  3. 按一下要匯出工具的內容選單。
  4. 選取「匯出」。
  5. 在對話方塊中，選擇下列其中一個選項：
    • 下載：將 JSON 檔案儲存至本機。
    • Cloud Storage：將 JSON 檔案儲存至指定的 Cloud Storage URI。

匯入工具

匯入工具的工作流程有兩種：

匯入以覆寫

使用這個選項修改現有工具。匯入的 JSON 檔案必須與目前工具的類型相同。

  1. 開啟 Gemini Enterprise for CX 控制台，然後選取專案和代理程式。
  2. 開啟「工具」面板。
  3. 按一下要更新的工具的內容選單。
  4. 選取「匯入並覆寫」。
  5. 在對話方塊中，選擇下列其中一個選項：
    • 上傳 JSON：從本機選取 JSON 檔案。
    • Cloud Storage：輸入 Cloud Storage 中 JSON 檔案的 URI。

匯入為新項目

使用這個選項建立新工具。

  1. 開啟 Gemini Enterprise for CX 控制台，然後選取專案和代理程式。
  2. 開啟「建立工具」面板。
  3. 選取「匯入為新項目」。
  4. 在對話方塊中，選擇下列其中一個選項：
    • 上傳 JSON：從本機選取 JSON 檔案。
    • Cloud Storage：輸入 Cloud Storage 中 JSON 檔案的 URI。