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