Genesys Cloud 애플리케이션 서버 배포

Genesys Cloud에서 웹에 Agent Assist 추천을 렌더링하는 애플리케이션 서버를 설정할 수 있습니다.

목표

Genesys Cloud 통합에는 다음 프로세스가 포함됩니다.

  1. UI 모듈이 Dialogflow API를 호출하고, 인증 토큰을 등록하고, Redis용 Cloud Pub/Sub 및 Memorystore를 설정할 수 있도록 백엔드 서버를 배포합니다.
  2. Cloud Run에서 Agent Assist UI 모듈을 렌더링하기 위해 Genesys Cloud 애플리케이션 서버를 배포합니다.
  3. OAuth 클라이언트를 만듭니다.
  4. 환경 변수를 작성합니다.
  5. Genesys Cloud에서 상호작용 위젯을 설정합니다.
  6. Genesys Cloud에서 상호작용 위젯과 Agent Assist 통합을 구성합니다.
  7. Genesys Cloud에서 Messenger를 구성합니다.
  8. Genesys Cloud 웹 채팅 및 메시지 도구를 사용하여 통합을 테스트합니다.

시작하기 전에

Genesys Cloud 통합을 시작하기 전에 다음 작업을 완료해야 합니다.

  1. 아직 구성하지 않았다면 Google Cloud CLI를 설치합니다.
  2. Google Cloud 안내에 따라 서비스 계정을 만들고 Dialogflow API 클라이언트 역할을 할당합니다.
  3. Genesys Cloud 저장소에 액세스하려면 agent-assist-ui-modules-support@google.com에 문의하세요.
  4. Agent Assist UI 모듈 백엔드를 배포합니다. 백엔드 서버를 배포할 때는 배포 안내에 따라 환경 변수 AUTH_OPTION를 GenesysCloud로 지정합니다.

CLI를 사용하여 Genesys Cloud 애플리케이션 서버 배포

  1. 다음 코드를 사용하여 git 저장소를 로컬 머신 또는 개발 환경에 클론합니다. 
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
  2. Google Cloud CLI 빌드를 실행하기 전에 로컬 터미널에서 다음 코드를 사용하여 활성 디렉터리를 Docker 파일이 있는 저장소 루트 디렉터리로 변경합니다. 
    cd genesyscloud/frontend
  3. 서비스 이름을 입력하라는 메시지가 표시되면 Enter 키를 눌러 기본값을 수락합니다.
  4. 다음 명령어를 사용하여 통합을 배포합니다. PROJECT-ID를 상담사의 Google Cloud 프로젝트 ID로, UI_MODULE_SERVICE_ACCOUNT를 서비스 계정 고객 이메일로 바꾸고 Cloud Run의 REGION를 설정합니다. 
    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 
    
--source= ./ 
    
--service-account=$ui_module_service_account 
    
--memory 1Gi --platform managed 
    
--region us-central1 
    
--allow-unauthenticated
  5. Enter 키를 클릭하여 기본 서비스 이름을 수락합니다.

자세한 내용은 Cloud Run 문서를 참고하세요. Google Cloud 콘솔의 Cloud Run에서 활성 상태의 통합 배포 목록을 확인할 수 있습니다.

OAuth 클라이언트 만들기

  1. Genesys Cloud 문서의 안내에 따라 새 OAuth 클라이언트 (토큰 암시적 부여)를 만듭니다.
  2. 부여 유형이 암시적 부여 (브라우저)인지 확인합니다.
  3. 승인된 리디렉션 URI 섹션에 애플리케이션 URL을 추가합니다.
  4. Oauth 2.0 클라이언트 토큰 기간을 3,600초로 업데이트합니다. 이는 1시간 동안 Dialogflow API에 액세스할 수 있는 JWT 토큰과 일치합니다. 
    {Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
  5. CONVERSATION_PROFILE_NAME을 대화 프로필의 이름(예: projects/your-project/locations/your-location/conversationProfiles/abc123)으로 바꿉니다.
  6. FEATURES를 애플리케이션에 포함할 상담사 지원 기능의 쉼표로 구분된 목록으로 바꿉니다. 대화 프로필에 구성된 기능만 포함하세요. Genesys Cloud는 다음과 같은 기능을 지원합니다.

URL 예: 

https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION

환경 변수 완료

Genesys Cloud 애플리케이션은 다음 환경 변수를 사용합니다. 환경 변수를 설정하려면 Cloud Run 안내를 따르세요.

  • OAUTH_CLIENT_ID: Genesys Cloud OAuth 클라이언트 ID입니다.
  • GENESYS_CLOUD_REGION: Genesys Cloud 리전입니다. 예를 들어 미국 서부(오레곤)의 경우 usw2.pure.cloud입니다. 기본값은 mypurecloud.com입니다.
  • GENESYS_CLOUD_ENVIRONMENT: Genesys 클라우드 환경입니다. 기본값은 prod입니다.
  • PROXY_SERVER: Agent Assist 백엔드 커넥터의 URL입니다.
  • APPLICATION_SERVER_URL: UI 애플리케이션 서버의 URL입니다.
  • PROJECT_ID: Google Cloud 프로젝트 ID입니다.
  • CONVERSATION_PROFILE: 사용할 대화 프로필입니다. 이는 OAuth 클라이언트의 리디렉션 URL에 있는 프로필과 일치해야 합니다.
  • FEATURES: 쉼표로 구분된 Agent Assist 기능의 상수입니다. 이는 OAuth 클라이언트의 리디렉션 URL에 있는 기능과 일치해야 합니다.
  • CHANNEL: 통합 유형을 선택합니다. 값은 'voice' 또는 'chat'일 수 있습니다.

샘플 .env 파일: 

OAUTH_CLIENT_ID={your-oauth-client-id}
GENESYS_CLOUD_REGION={your-pure-cloud-region}
GENESYS_CLOUD_ENVIRONMENT={your-pure-cloud-environment}
PROXY_SERVER={your-proxy-server-endpoint}
PROJECT_ID={your-gcp-project-id}
CONVERSATION_PROFILE={your-conversation-profile}
FEATURES=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION
CHANNEL={use-voice-or-chat}

OAuth 클라이언트를 만들 때 Genesys Cloud에서 클라이언트 ID도 제공합니다.

업데이트된 환경 변수를 사용하여 배포 명령어를 실행합니다. 

    gcloud run deploy $AA_MODULE_APPLICATION_SERVER 

    --source ./ 

    --service-account=$ui_module_service_account 

    --memory 1Gi --platform managed 

    --region us-central1 

    --allow-unauthenticated 

    --set-env-vars ^~^OAUTH_CLIENT_ID=$OAUTH_CLIENT_ID~GENESYS_CLOUD_REGION=$GENESYS_CLOUD_REGION~GENESYS_CLOUD_ENVIORNMENT=$GENESYS_CLOUD_ENVIORNMENT~CONVERSATION_PROFILE=$CONVERSATION_PROFILE~FEATURES=$FEATURES~PROJECT_ID=$PROJECT_ID~APPLICATION_SERVER_URL=''~PROXY_SERVER=$PROXY_SERVER~APPLICATION_SERVER_URL=$APPLICATION_SERVER_URL

Genesys Cloud 애플리케이션 서버는 Google Cloud 호스팅 서비스에 배포해야 합니다. App Engine 또는 Cloud Run을 사용하세요.

애플리케이션 서버 종료

  1. Cloud Run 서비스를 삭제합니다.
  2. 로컬 터미널에서 다음 명령어를 실행합니다. 
    gcloud run services list
  3. 이전에 선택한 타겟 플랫폼을 선택하여 활성 배포를 표시합니다.
  4. 다음 명령어를 실행합니다. 
    gcloud run services delete agent-assist-modules-application-server

다음 단계