주제 모델 내보내기 및 가져오기

이미 학습한 모델을 내보내 백업할 수 있습니다. 이러한 백업을 사용하여 기존 모델을 롤백하거나 모델을 새 프로젝트로 이전할 수 있습니다.

참고: 모델 내보내기 및 가져오기는 V2 이상의 주제 모델에서만 사용할 수 있습니다.

모델을 내보냅니다.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한이 있어야 합니다.

• contactcenterinsights.issueModels.export

주제 모델을 Cloud Storage로 내보내면 모델의 백업 사본을 저장하여 나중에 필요한 경우 복원할 수 있습니다.

REST

주제 모델을 내보내려면 issueModel 리소스에서 export 메서드를 호출합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 프로젝트 ID입니다.
• ISSUE_MODEL_ID: 내보낼 주제 모델의 ID입니다.
• GCS_DESTINATION: 주제 모델이 내보내지는 Cloud Storage URI입니다.

참고: 모든 예시에서는 전역 고객 경험 통계 인스턴스를 사용합니다. 리전 인스턴스 사용에 관한 안내는 리전화를 참고하세요.

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를 사용하여 가져오기 메서드를 호출합니다. 고객 경험 통계는 내보낸 파일에서 교체 모델 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"
}