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

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

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

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

このタスクに必要な権限

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

• contactcenterinsights.issueModels.export

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

REST

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

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

• 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 を使用してインポート メソッドを呼び出し、同じプロジェクトから以前にエクスポートされたトピックモデルを指定します。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"
}