导出和导入

本页介绍了如何导出和导入代理应用和单个工具。

代理导出和导入

您可以导出和导入代理应用：

  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。