匯出及匯入主題模型

您可以匯出已訓練的模型，以便備份。 您可以利用這些備份還原現有模型，或是將模型轉移至新專案。

注意： 匯出及匯入模型僅適用於 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 呼叫匯入方法，指向先前從相同專案匯出的主題模型。Customer Experience Insights 會從匯出的檔案中擷取替代機型 ID。
• 如果專案中沒有主題模型，或是要匯入新專案，Customer Experience Insights 會自動建立新的主題模型。
• 如不想取代現有模型，可以視需要設定 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"
}