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

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

Genesys Cloud でウェブ上に Agent Assist の候補を表示するためのアプリケーションサーバーを設定できます。

目標

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

UI モジュールのバックエンドサーバーをデプロイして、Dialogflow API を呼び出し、認証トークンを登録し、Cloud Pub/Sub と Memorystore for Redis を設定します。
Cloud Run で Agent Assist UI モジュールをレンダリングするための Genesys Cloud アプリケーションサーバーをデプロイします。
OAuth クライアントを作成します。
環境変数を入力します。
Genesys Cloud でインタラクションウィジェットを設定します。
Genesys Cloud のインタラクションウィジェットを使用して、Agent Assist との統合を構成します。
Genesys Cloud で Messenger を構成します。
Genesys Cloud のウェブチャットとメッセージングツールを使用して、統合をテストします。

始める前に

Genesys Cloud 統合を開始する前に、次の操作を完了する必要があります。

Google Cloud CLI をインストールします（まだ構成していない場合）。
Google Cloud の手順に沿って、サービスアカウントを作成し、Dialogflow API クライアントロールを割り当てます。
Genesys Cloud リポジトリへのアクセスについては、agent-assist-ui-modules-support@google.com までお問い合わせください。
Agent Assist UI モジュールのバックエンドをデプロイします。バックエンドサーバーをデプロイするときに、デプロイ手順に沿って、環境変数 AUTH_OPTION を GenesysCloud に指定します。

CLI を使用して Genesys Cloud アプリケーションサーバーをデプロイする

次のコードを使用して、git リポジトリをローカルマシンまたは開発環境にクローンします。
```
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
```
ローカルターミナルで次のコードを使用して、アクティブディレクトリを Docker ファイルが存在するリポジトリのルートディレクトリに変更してから、Google Cloud CLI ビルドを実行します。
```
cd genesyscloud/frontend
```
サービス名の入力を求められたら、Enter キーを押してデフォルトを受け入れます。
次のコマンドを使用して統合をデプロイします。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 
```
[Enter] をクリックして、デフォルトのサービス名を受け入れます。

詳細については、Cloud Run のドキュメントをご覧ください。 Google Cloud コンソールで、[Cloud Run] の下にあるアクティブな統合デプロイのリストを表示できます。

OAuth クライアントを作成する

Genesys Cloud ドキュメントの手順に沿って、新しい OAuth クライアント（トークン暗黙的付与）を作成します。
権限付与タイプが [暗黙的権限付与（ブラウザ）] であることを確認します。
[承認済みのリダイレクト URI] セクションにアプリケーションの URL を追加します。
Oauth 2.0 クライアントトークンの有効期間を 3,600 秒に更新します。これは、Dialogflow API アクセスの JWT トークン（1 時間）と一致します。
```
{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
```
CONVERSATION_PROFILE_NAME は、会話プロファイルの名前に置き換えます（例: projects/your-project/locations/your-location/conversationProfiles/abc123）。
{FEATURES} は、アプリケーションに含めるエージェントアシスト機能のカンマ区切りリストに置き換えます。重要: 会話プロファイルで構成された機能のみを含めます。Genesys Cloud は、次の機能をサポートしています。
OAuth クライアントにスコープを追加するには、[スコープ] セクションに移動してタグを選択します。

。スコープには、アラート、認証、会話、通知、組織を含める必要があります。

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 Cloud 環境。デフォルト値は 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 を使用します。

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

Cloud Run サービスを削除します。
ローカルターミナルで、次のコマンドを実行します。
```
gcloud run services list
```
以前に選択したターゲットプラットフォームを選択して、アクティブなデプロイメントを一覧表示します。

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

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

価格に関する免責条項

Genesys Cloud インテグレーションを使用する場合、基盤となる Cloud Run サービスに関連する費用が発生します。

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

目標