导出和导入主题模型

您可以导出已训练的模型以进行备份。 您可以使用这些备份来回滚现有模型，或将模型转移到新项目。

注意： 导出和导入模型仅适用于 V2 或更高版本的主题模型。

导出模型

执行此任务所需的权限

您必须拥有以下权限才能执行此任务：

• contactcenterinsights.issueModels.export

将主题模型导出到 Cloud Storage 可让您保存模型的备份副本，以便日后在需要时恢复模型。

REST

如需导出主题模型，请对 issueModel 资源调用 export 方法。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：您的项目 ID。
• ISSUE_MODEL_ID：要导出的主题模型的 ID。
• GCS_DESTINATION：主题模型导出到的 Cloud Storage URI。

注意：所有示例均使用全球客户体验数据分析实例。如需了解如何使用区域实例，请参阅区域化。

HTTP 方法和网址：

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels/ISSUE_MODEL_ID:export

请求 JSON 正文：

{ 
  gcs_destination: { 
    object_uri: 'GCS_DESTINATION'
  }
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels/ISSUE_MODEL_ID:export"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels/ISSUE_MODEL_ID:export" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID"
}

导入模型

执行此任务所需的权限

您必须拥有以下权限才能执行此任务：

• contactcenterinsights.issueModels.create
• contactcenterinsights.issueModels.import

从 Cloud Storage 导入主题模型可让您替换现有主题模型，或基于现有模型创建新的主题模型。如果您想进行调整，但不想更改原始模型，那么从现有模型开始会很有用。

• 如需替换现有主题模型，请使用 Cloud Storage 对象 URI 调用导入方法，指向之前从同一项目导出的主题模型。客户体验分析洞见会从导出的文件中提取替换模型 ID。
• 如果主题模型在项目中不存在或正在导入到新项目中，客户体验数据分析会自动创建新的主题模型。
• 您可以选择设置 create_new_model 标志，以免替换现有模型。

REST

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：您的项目 ID。
• GCS_SOURCE：用于保存主题模型的 Cloud Storage URI。
• CREATE_NEW_MODEL：用于创建新模型（而非替换现有模型）的布尔值标记。
注意：所有示例均使用全球客户体验数据分析实例。如需了解如何使用区域实例，请参阅区域化。

HTTP 方法和网址：

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels:import

请求 JSON 正文：

{
  gcs_source: {
    object_uri: 'GCS_SOURCE'
  }
  create_new_model: CREATE_NEW_MODEL
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels:import"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/issueModels:import" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "name": "projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID"
}