トピックモデルをエクスポートしてインポートする

すでにトレーニングしたモデルをエクスポートしてバックアップできます。 これらのバックアップを使用して、既存のモデルをロールバックしたり、モデルを新しいプロジェクトに転送したりできます。

**注:** モデルのエクスポートとインポートは、V2 以降のトピックモデルでのみ使用できます。

モデルをエクスポートする

このタスクに必要な権限

このタスクを行うには、次の 権限が必要です:

• contactcenterinsights.issueModels.export

トピックモデルを Cloud Storage にエクスポートすると、モデルのバックアップ コピーを保存して、必要に応じて後で復元できます。

REST

トピックモデルをエクスポートするには、export メソッドを issueModel リソースで呼び出します。

リクエストのデータを使用する前に、 次のように置き換えます。

• PROJECT_ID: プロジェクト ID。
• ISSUE_MODEL_ID: エクスポートするトピックモデルの ID。
• GCS_DESTINATION: トピックモデルのエクスポート先の Cloud Storage URI。

注: すべての例で、グローバルな Customer Experience Insights インスタンスを使用しています。リージョン インスタンスの使用方法については、リージョン化をご覧ください。

HTTP メソッドと URL:

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 を指定して、import メソッドを呼び出します。Customer Experience Insights は、エクスポートされたファイルから置換モデル ID を取得します。
• トピックモデルがプロジェクトに存在しない場合、または新しいプロジェクトにインポートされる場合、Customer Experience Insights は新しいトピックモデルを自動的に作成します。
• 必要に応じて、既存のモデルを置き換えない場合は、create_new_model フラグを設定します。

REST

リクエストのデータを使用する前に、 次のように置き換えます。

• PROJECT_ID: プロジェクト ID。
• GCS_SOURCE: トピックモデルが保存されている Cloud Storage URI。
• CREATE_NEW_MODEL: 既存のモデルを置き換えるのではなく、新しいモデルを作成するためのブール値フラグ。
注: すべての例で、グローバルな Customer Experience Insights インスタンスを使用しています。リージョン インスタンスの使用方法については、リージョン化をご覧ください。

HTTP メソッドと URL:

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"
}