このページは Cloud Translation API によって翻訳されました。

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

このガイドでは、LivePerson でエージェントアシストの候補をレンダリングするために使用できるアプリケーションサーバーをセットアップするために必要な手順について説明します。アプリケーションサーバーは、同じディレクトリにあるプロキシサーバーで使用されます。エージェントワークスペースで UI モジュールをレンダリングする手順については、LivePerson のメインチュートリアルページをご覧ください。LivePerson でモジュールをレンダリングするには、アプリケーションサーバーとプロキシサーバーの両方が必要です。

このインテグレーションのデプロイは任意のホスティングプラットフォームで設定できますが、ここでは Google の Cloud Run を使用します。

構成

サービスをデプロイするときに、次の環境変数を定義する必要があります。アプリケーションサーバーを最初に作成するときに、LP_CLIENT_ID 変数と LP_CLIENT_SECRET 変数は空白のままにしてください。これらの変数は、Conversational Cloud アプリケーションを作成するときに LivePerson から提供され、そのときに更新します。また、最初は APPLICATION_SERVER_URL と DF_PROXY_SERVER_URL をスキップします。これらの 2 つの変数は、アプリケーションサーバーとプロキシサーバーがデプロイされ、必要な URL 値を返した後に設定されます。

LP_ACCOUNT_ID: LivePerson アカウント ID。
LP_CLIENT_ID: LivePerson クライアント ID。これは、Conversational Cloud アプリケーションがインストールされると、LivePerson から提供されます。（この変数はスキップし、情報が提供されたら更新します）。
LP_CLIENT_SECRET: LivePerson クライアントシークレット。これは、Conversational Cloud アプリケーションがインストールされると、LivePerson から提供されます。（この変数は当面スキップし、情報が提供されたら更新します）。
LP_SENTINEL_DOMAIN: https://developers.liveperson.com/domain-api.html にアクセスします。アカウント番号を入力し、ドメインで「sentinel」を検索します。
LP_ACCOUNT_CONFIG_READONLY_DOMAIN: https://developers.liveperson.com/domain-api.html にアクセスします。アカウント番号を入力し、ドメインで「accountConfigReadOnly」を検索します。
APPLICATION_SERVER_URL: UI アプリケーションサーバーの URL。（今はスキップし、アプリサーバーがデプロイされて URL がわかったら更新します）。
DF_PROXY_SERVER_URL: プロキシサーバーの URL。（現時点ではスキップし、プロキシサーバーがデプロイされて URL がわかったら更新します）。
PROJECT_ID: Google Cloud プロジェクト ID projects/ 接頭辞は含めないでください。

.env ファイルのサンプル:

    LP_ACCOUNT_ID = 12345678
    LP_CLIENT_ID = abc-123-f0f0
    LP_SENTINEL_DOMAIN = va.sentinel.liveperson.net
    LP_ACCOUNT_CONFIG_READONLY_DOMAIN = z1.acr.liveperson.net
    LP_CLIENT_SECRET = abc123abc123abc123abc123
    APPLICATION_SERVER_URL = https://my-project.wm.r.appspot.com
    DF_PROXY_SERVER_URL = https://proxy-server-dot-my-project.wm.r.appspot.com
    PROJECT_ID = my-project

デプロイ

UI アプリケーションサーバーは、Google Cloud ホスティングサービスにデプロイする必要があります。Google App Engine または Cloud Run を使用することをおすすめします。以下の手順では、Cloud Run を例として使用します。

gcloud CLI を設定する

このチュートリアルで説明するデプロイプロセスでは、gcloud CLI コマンドを使用します。このデプロイ用に gcloud CLI をローカルに設定する手順は次のとおりです。

gcloud CLI のドキュメントページで、OS を選択し、インストール手順に沿って操作します。
gcloud config get-value project を実行して、Google Cloud Platform プロジェクトの構成を確認します。
Dialogflow エージェントの設定に移動し、エージェントに関連付けられているプロジェクト ID を確認します。gcloud CLI で構成した Google Cloud Platform プロジェクトは、エージェントのプロジェクト ID と一致している必要があります。
プロジェクト ID が一致しない場合は、gcloud config set project PROJECT-ID を実行します。PROJECT-ID は、ステップ 3 のプロジェクト ID に置き換えます。

サービスアカウントを設定する

統合が適切に機能するように、Google Cloud Platform プロジェクトにサービスアカウントを作成する必要があります。詳細については、Dialogflow のドキュメントをご覧ください。

サービスアカウントを作成して統合を設定するには、次の操作を行います。

Agent Assist リソースに関連付けられている Google Cloud Platform プロジェクトを選択します。
Google Cloud Platform コンソールのナビゲーションメニューをクリックし、[IAM と管理] にカーソルを合わせて [サービスアカウント] をクリックします。
[+ サービスアカウントを作成] をクリックして詳細を入力し、[Dialogflow Client API] ロールを割り当てます。

必要な API の有効化

目的の Google Cloud Platform プロジェクトに移動します。
Google Cloud Platform コンソールのナビゲーションメニューをクリックし、[お支払い] を選択します。プロジェクトに対して課金が有効になっていることを確認します。
このプロジェクトで Cloud Build と Cloud Run API を有効にします。
次の git リポジトリのクローンをローカルマシンまたは開発環境に作成します。git clone [repository url]
ローカルマシンまたは開発環境でリポジトリのルートディレクトリを開きます。

CLI を使用してデプロイする

ローカルターミナルで、アクティブディレクトリをリポジトリのルートディレクトリに変更します。

次のコマンドを実行して、リポジトリの状態を Google Cloud Platform Container Registry に保存します。PROJECT-ID は、Google Cloud Platform プロジェクト ID に置き換えます。

    gcloud builds submit --tag gcr.io/PROJECT-ID/agent-assist-modules-application-server

次のコマンドを使用して、統合を本番環境にデプロイします。PROJECT-ID はエージェントの Google Cloud Platform プロジェクト ID に、SERVICE-ACCOUNT-EMAIL はサービスアカウントのクライアントメールアドレスに置き換えます。

    gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed

リージョンの入力を求められたら、リージョンを選択します（例: us-central1）。
サービス名の入力を求められたら、Enter キーを押してデフォルト名を受け入れます。
未認証の呼び出しを許可するよう求められたら、y キーを押します。

詳細については、Cloud Run のドキュメントをご覧ください。アクティブな統合デプロイメントのリストを表示するには、Google Cloud Platform Console の [Cloud Run] に移動します。

環境変数

Cloud Run の手順に沿って、必要な環境変数を設定します。

サービスがデプロイされると、CLI はアプリケーションがデプロイされた URL（target_url）を出力します。戻って、この値を使用して APPLICATION_SERVER_URL 環境変数を設定します。

アプリケーションサーバーをシャットダウンする

アプリケーションサーバーをシャットダウンするには、Cloud Run サービスを削除する必要があります。

ローカルターミナルで次のコマンドを実行し、前に選択したターゲットプラットフォームを選択して、アクティブなデプロイメントを一覧表示します。

    gcloud beta run services list

次に、次のコマンドを実行します。

   gcloud beta run services delete agent-assist-modules-application-server

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

構成