이 Genesys Cloud 오디오 커넥터는 고객센터 상호작용의 실시간 오디오 스트림을 효율적으로 캡처, 처리, 분석합니다. Audiohook 서비스에 대한 지속적인 WebSocket 연결을 사용하여 Genesys Cloud Audiohook API와 원활하게 통합됩니다. 이 연결을 통해 gRPC를 사용하여 Agent Assist 통합 백엔드로 실시간 오디오 스트리밍을 할 수 있습니다. 이 커넥터는 수신되는 오디오 청크를 처리하기 위한 프레임워크를 제공하므로 맞춤 오디오 처리, 스크립트 작성 또는 기타 AI 기반 기능(예: 요약, 사전 예방적 생성형 지식 지원)을 사용할 수 있습니다.
기본 요건
Genesys Cloud 음성 통합을 시작하기 전에 다음 단계를 따르세요.
- Genesys Cloud 애플리케이션 서버를 설치합니다.
- Genesys Cloud OAuth 클라이언트와 상호작용 위젯을 모두 구성합니다.
- Agent Assist 통합 백엔드를 설치합니다.
- 다음 변수를 참고하세요.
- VPC_CONNECTOR_NAME
- SERVICE_REGION
- REDIS_INSTANCE_ID
- Genesys Cloud에 AudioHook 모니터 설치
Google Cloud CLI를 사용하여 Genesys Cloud 오디오 커넥터 서버 배포
Google Cloud CLI를 사용하여 오디오 커넥터 서버를 배포하려면 다음 단계를 따르세요.
- 다음 코드를 사용하여 GitHub 저장소를 로컬 머신 또는 개발 환경에 클론합니다.
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations cd genesyscloud/genesyscloud-audiohook
- 오디오 커넥터 루트 디렉터리로 이동합니다.
루트 디렉터리에 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}
./aa-integration-backend/audiohook
디렉터리에 있는 deploy.sh 스크립트를 실행합니다.sh deploy.sh
Genesys Cloud AudioHook 모니터 통합 구성
다음 단계에 따라 통합을 구성하세요.
- Cloud Run에 음성 커넥터를 배포한 후 Genesys Cloud에서 AudioHook 모니터를 구성하고 활성화합니다.
- Audiohook Monitor Configuration(모니터 구성) 탭에서 다음 변수를 업데이트합니다.
- 채널에 둘 다를 선택합니다.
- Audiohook 연결 URI의 경우 다음을 사용합니다.
wss://your-cloud-run-domain.run.app/connect
- 사용자 인증 정보 탭에서 API 키를 설정한 후 ENV 파일에서
API_KEY
환경 변수를 업데이트합니다. - 음성 커넥터 서비스를 다시 배포합니다.
- 대기열 내에서 AudioHook 모니터를 사용 설정합니다. 자세한 내용은 Genesys Cloud 대기열 만들기 및 구성에 관한 도움말의 '모든 상호작용 유형에 대한 동작 및 임곗값 설정' 섹션을 참고하세요.