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

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

この統合デプロイは任意のホスティングプラットフォームに設定できますが、この手順では Google's 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 のドキュメントページで、オペレーティングシステムを選択し、インストール手順に沿って操作します。
gcloud config get-value project を実行して、Google Cloud Platform プロジェクトの構成を確認します。
Dialogflow エージェントの設定に移動し、エージェントに関連付けられているプロジェクト ID を確認します。gcloud CLI で構成された Google Cloud Platform プロジェクトは、エージェントのプロジェクト ID と一致している必要があります。
プロジェクト ID が一致しない場合は、gcloud config set project PROJECT-ID を実行します。は、ステップ 3 のプロジェクト ID に置き換えてください。PROJECT-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 コンソールの 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

アプリケーション サーバーをデプロイする コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

構成