오디오 재생 사용 설정

이 페이지에서는 서명된 URL을 사용하여 고객 경험 통계 콘솔에서 오디오 재생을 사용 설정하는 방법을 설명합니다.

오디오 재생을 사용 설정하면 CX 인사이트 콘솔에서 직접 대화 오디오를 들을 수 있습니다. 오디오 재생은 서명된 URL을 사용하여 Cloud Storage 버킷에 저장된 오디오 파일에 대한 인증된 시간 제한 액세스를 제공합니다. 이렇게 하면 오디오 재생을 위해 사용자에게 Cloud Storage 버킷에 대한 직접 액세스 권한을 부여할 필요가 없습니다.

시작하기 전에

CX Insights 콘솔에서 오디오를 재생하려면 사용자에게 서명된 오디오 URL을 생성할 권한이 있어야 합니다. 필요한 IAM 권한은 대화에 액세스하는 방식에 따라 다릅니다.

  • 모든 대화: contactcenterinsights.conversations.generateSignedAudio 권한은 사전 정의된 역할 Contact Center AI Insights viewer 및 Contact Center AI Insights editor에 있습니다.
  • 데이터 세트를 통해 액세스하는 모든 대화: contactcenterinsights.datasets.generateSignedAudio 권한은 사전 정의된 역할 Contact Center AI Insights viewer 및 Contact Center AI Insights editor에 있습니다.
  • 승인된 뷰를 통해 세부적으로 액세스하는 경우: contactcenterinsights.authorizedConversations.generateSignedAudio 권한은 사전 정의된 역할 Contact Center AI Insights authorizedViewer 및 Contact Center AI Insights authorizedEditor에 있습니다.

승인된 뷰를 사용한 세분화된 권한에 대한 자세한 내용은 세분화된 액세스 제어 개요를 참고하세요.

시작하기 전에 다음 단계를 따르세요.

  1. CX 인사이트로 음성 대화를 가져왔으며 이러한 대화에 Cloud Storage 버킷의 오디오 파일을 가리키는 오디오 URI가 있는지 확인합니다. 다음과 같은 방법으로 확인할 수 있습니다.
  2. 프로젝트 설정 페이지로 이동하여 Google Cloud 프로젝트 번호를 찾습니다.

오디오 재생 사용 설정

서명된 URL을 사용하여 오디오 재생을 사용 설정하려면 CX Insights 서비스 계정에 Cloud Storage 버킷에 대한 액세스 권한을 부여하고 버킷에서 교차 출처 리소스 공유 (CORS)를 구성해야 합니다.

서비스 계정에 Cloud Storage 버킷 액세스 권한 부여

  • CX Insights는 서명된 URL을 생성하기 위해 대화 오디오가 저장된 Cloud Storage 버킷에 대한 액세스 권한이 필요합니다. 오디오 파일이 포함된 버킷에 대해 CX Insights 서비스 계정에 Storage Object Viewer 역할 (roles/storage.objectViewer)을 부여해야 합니다.

  • CX 통계 서비스 계정 식별자는 다음과 같습니다. service-PROJECT_NUMBER@gcp-sa-contactcenterinsights.

  • PROJECT_NUMBER를 Google Cloud 프로젝트 번호로 바꿉니다.

버킷의 서비스 계정에 대한 액세스 권한을 부여하는 방법은 버킷 수준 정책에 주 구성원 추가를 참고하세요.

Cloud Storage 버킷에서 CORS 구성

브라우저에서 CX Insights로 생성된 서명된 URL의 오디오를 재생할 수 있도록 하려면 CX Insights 콘솔 출처에서 액세스할 수 있도록 Cloud Storage 버킷에서 CORS를 구성해야 합니다.

먼저 다음 콘텐츠로 cors-config.json이라는 JSON 파일을 만듭니다.

  [
    {
      "origin": ["https://ccai.cloud.google.com"],
      "responseHeader": ["Content-Type"],
      "method": ["GET"],
      "maxAgeSeconds": 3600
    }
  ]

그런 다음 다음 gcloud 명령어를 실행하여 버킷에 CORS 구성을 적용합니다.

  gcloud storage buckets update gs://BUCKET_NAME --cors-file=cors-config.json

마지막으로 BUCKET_NAME을 오디오 파일이 포함된 Cloud Storage 버킷 이름으로 바꿉니다. 자세한 내용은 교차 출처 리소스 공유 (CORS) 구성을 참고하세요.