Genesys Cloud AudioHook 통합

이 Genesys Cloud 오디오 커넥터는 컨택 센터 상호작용에서 실시간 오디오 스트림을 효율적으로 캡처, 처리, 분석합니다. Audiohook 서비스에 대한 영구 WebSocket 연결을 사용하여 Genesys Cloud Audiohook API와 원활하게 통합됩니다. 이 연결을 통해 gRPC를 사용하여 Agent Assist 통합 백엔드로 실시간 오디오 스트리밍을 할 수 있습니다. 커넥터는 수신 오디오 청크를 처리하기 위한 프레임워크를 제공하여 맞춤 오디오 처리, 스크립트 작성 또는 요약, 사전 예방적 생성형 지식 지원과 같은 기타 AI 기반 기능을 지원합니다.

기본 요건

Genesys Cloud 음성 통합을 시작하기 전에 다음 단계를 따르세요.

  1. Genesys Cloud 애플리케이션 서버를 설치합니다.
  2. Genesys Cloud OAuth 클라이언트와 상호작용 위젯을 모두 구성합니다.

Geneysys Cloud용 Oauth 클라이언트를 만들고 사용하는 방법에 관한 문서에서는 승인 유형, 리디렉션, 토큰 기간, 에이전트가 사용하는 AI 기반 기능을 지정하는 방법을 안내합니다.

  1. Agent Assist 통합 백엔드를 설치합니다.
  2. 다음 변수를 기록해 둡니다.
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION
    • REDIS_INSTANCE_ID
  3. Genesys Cloud에 AudioHook 모니터를 설치합니다.

Google Cloud CLI를 사용하여 Genesys Cloud 오디오 커넥터 서버 배포

Google Cloud CLI를 사용하여 오디오 커넥터 서버를 배포하려면 다음 단계를 따르세요.

  1. 다음 코드를 사용하여 GitHub 저장소를 로컬 머신 또는 개발 환경에 클론합니다. 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd  genesyscloud/genesyscloud-audiohook
  2. 오디오 커넥터 루트 디렉터리로 이동합니다.

  3. 루트 디렉터리에 ENV 파일을 만들고 다음 변수로 업데이트합니다.

    Agent Assist 통합 백엔드의 환경 변수에서 동일한 값을 사용합니다.

    • REDIS_INSTANCE_ID
    • VPC_CONNECTOR_NAME
    • SERVICE_REGION

    다른 소스의 값을 사용합니다.

    • UI_CONNECTOR: 배포된 Agent Assist 통합 백엔드 서비스의 도메인 이름입니다.
    • GCP_PROJECT_ID: 프로젝트의 전역적으로 고유한 식별자입니다. 다음 단계에 따라 찾습니다.
    • SERVICE_ACCOUNT: AudioHook 커넥터 서비스의 서비스 계정입니다. 존재하지 않으면 deploy.sh 스크립트가 새 계정을 만듭니다.
    • API_KEY: AudioHook 모니터 통합에서 API 키를 생성합니다. AudioHook 모니터 사용자 인증 정보 추가 섹션을 참고하세요. 지금은 비워 두고 AudioHook을 구성한 후 값을 업데이트합니다.
    • VOICE_INTERCEPTOR_SERVICE: 음성 커넥터 Cloud Run 서비스의 이름을 선택합니다.

    ENV 파일 예시:

    CONVERSATION_PROFILE_NAME=projects/{your-project-id}/locations/{your-service-region}/conversationProfiles/{your-conversation-profile-id}
SERVICE_REGION={your-service-region}
GCP_PROJECT_ID={your-project-id}
API_KEY={api-key-from-genesys}
VPC_CONNECTOR_NAME={vpc-connector-name-from-aa-integration-backend}
SERVICE_ACCOUNT={your-service-account-name}
UI_CONNECTOR={your-agent-assist-backend-domain-name}
REDIS_INSTANCE_ID={redis-instance-id-from-aa-integration-backend}
VOICE_INTERCEPTOR_SERVICE={your-voice-interceptor-service-name}

  4. ./genesyscloud/genesyscloud-audiohook 디렉터리에 있는 deploy.sh 스크립트를 실행합니다.

    sh deploy.sh

Genesys Cloud AudioHook 모니터 통합 구성

다음 단계에 따라 통합을 구성합니다.

  1. Cloud Run에 음성 커넥터를 배포한 후 Genesys Cloud에서 AudioHook 모니터를 구성하고 활성화합니다.
  2. Audiohook 모니터 구성 탭에서 다음 변수를 업데이트합니다.
    • 채널에 대해 둘 다 를 선택합니다.
    • Audiohook 연결 URI의 경우 다음을 사용합니다. 
      wss://your-cloud-run-domain.run.app/connect
  3. 사용자 인증 정보 탭에서 API 키를 설정한 후 ENV 파일에서 API_KEY 환경 변수를 업데이트합니다.
  4. 음성 커넥터 서비스를 다시 배포합니다.
  5. 대기열 내에서 AudioHook 모니터를 사용 설정합니다. 자세한 내용은 대기열 만들기 및 구성에 관한 Genesys Cloud 도움말의 '모든 상호작용 유형의 동작 및 임곗값 설정' 섹션을 참고하세요.