Genesys Cloud アプリケーション サーバーをデプロイする

Genesys Cloud で、ウェブ上でエージェント アシストの候補をレンダリングするアプリケーション サーバーを設定できます。

目標

Genesys Cloud の統合には、次のプロセスが含まれます。

  1. UI モジュールのバックエンド サーバーをデプロイして、Dialogflow API を呼び出し、認証トークンを登録し、Cloud Pub/Sub と Memorystore for Redis を設定します。
  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. ローカル ターミナルで、次のコードを使用して、アクティブなディレクトリを Docker ファイルが存在するリポジトリのルート ディレクトリに変更してから、Google Cloud CLI ビルドを実行します。
    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. アプリケーションの URL を [承認済みのリダイレクト URI] セクションに追加します。
  4. Oauth 2.0 クライアント トークンの有効時間を 3,600 秒に更新します。これは、Dialogflow API アクセスの 1 時間の 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: エージェント アシスト機能のカンマ区切り定数。これは、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

次のステップ