导出和导入

本页面介绍如何导出和导入智能体应用和单个工具。

智能体导出和导入

您可以导出和导入智能体应用：

  1. 打开 CX Agent Studio 控制台。
  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. 打开 CX Agent Studio 控制台，然后选择您的项目和智能体。
  2. 打开工具 面板。
  3. 点击要导出的工具的上下文菜单。
  4. 选择导出 。
  5. 在对话框中，选择以下选项之一：
    • 下载： 将 JSON 文件保存到本地机器。
    • Cloud Storage： 将 JSON 文件保存到指定的 Cloud Storage URI。

导入工具

导入工具有两种工作流：

导入以覆盖

使用此选项可修改现有工具。导入的 JSON 文件必须与当前工具的工具类型相同。

  1. 打开 CX Agent Studio 控制台，然后选择您的项目和智能体。
  2. 打开工具 面板。
  3. 点击要更新的工具的上下文菜单。
  4. 选择导入以覆盖 。
  5. 在对话框中，选择以下选项之一：
    • 上传 JSON： 从本地机器中选择 JSON 文件。
    • Cloud Storage： 输入 Cloud Storage 中 JSON 文件的 URI。

作为新工具导入

使用此选项可创建新工具。

  1. 打开 CX Agent Studio 控制台，然后选择您的项目和智能体。
  2. 打开创建工具 面板。
  3. 选择作为新工具导入 。
  4. 在对话框中，选择以下选项之一：
    • 上传 JSON： 从本地机器中选择 JSON 文件。
    • Cloud Storage： 输入 Cloud Storage 中 JSON 文件的 URI。