Diese Seite wurde von der Cloud Translation API übersetzt.

Genesys Cloud-Anwendungsserver bereitstellen

Sie können einen Anwendungsserver für das Rendern von Agent Assist-Vorschlägen im Web in Genesys Cloud einrichten.

Lernziele

Die Genesys Cloud-Integration umfasst die folgenden Prozesse:

Bereitstellen Sie den Backend-Server für das UI-Modul, um die Dialogflow API aufzurufen, ein Authentifizierungstoken zu registrieren und Cloud Pub/Sub und Memorystore for Redis einzurichten.
Stellen Sie den Genesys Cloud-Anwendungsserver für das Rendern des UI-Moduls für Agent Assist in Cloud Run bereit.
Erstellen Sie einen OAuth-Client.
Füllen Sie die Umgebungsvariablen aus.
Richten Sie das Interaktions-Widget in Genesys Cloud ein.
Konfigurieren Sie die Agent Assist-Integration mit dem Interaktions-Widget in Genesys Cloud.
Konfigurieren Sie Messenger in Genesys Cloud.
Verwenden Sie die Webchat- und Messaging-Tools von Genesys Cloud, um die Integration zu testen.

Hinweise

Sie müssen die folgenden Aktionen ausführen, bevor Sie mit der Genesys Cloud-Integration beginnen:

Installieren Sie die Google Cloud CLI, falls noch nicht geschehen.
Folgen Sie der Anleitung für Google Cloud , um ein Dienstkonto zu erstellen und die Dialogflow API-Clientrolle zuzuweisen.
Wenden Sie sich an agent-assist-ui-modules-support@google.com, um Zugriff auf das Genesys Cloud-Repository zu erhalten.
Stellen Sie ein Agent Assist-UI-Modul-Back-End bereit. Geben Sie beim Bereitstellen des Back-End-Servers GenesysCloud als Wert für die Umgebungsvariable AUTH_OPTION an. Folgen Sie dazu der Bereitstellungsanleitung.

Genesys Cloud-Anwendungsserver mit der Befehlszeile bereitstellen

Klonen Sie das Git-Repository mit dem folgenden Code auf Ihren lokalen Computer oder in Ihre Entwicklungsumgebung:
```
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
```
Verwenden Sie in Ihrem lokalen Terminal den folgenden Code, um das aktive Verzeichnis in das Stammverzeichnis des Repositorys zu ändern, in dem sich die Docker-Datei befindet, bevor Sie die Google Cloud CLI-Builds ausführen.
```
cd genesyscloud/frontend
```
Wenn Sie nach einem Dienstnamen gefragt werden, drücken Sie die Eingabetaste, um den Standardnamen zu akzeptieren.
Stellen Sie die Integration mit dem folgenden Befehl bereit. Ersetzen Sie PROJECT-ID durch die Projekt-ID Ihres Kundenvertreters in Google Cloud , UI_MODULE_SERVICE_ACCOUNT durch die E-Mail-Adresse des Kunden für das Dienstkonto und legen Sie die REGION für Cloud Run fest.
```
gcloud run deploy $AA_MODULE_APPLICATION_SERVER 

--source= ./ 

--service-account=$ui_module_service_account 

--memory 1Gi --platform managed 

--region us-central1 

--allow-unauthenticated 
```
Klicken Sie auf die Eingabetaste, um den Standarddienstnamen zu akzeptieren.

Weitere Informationen finden Sie in der Cloud Run-Dokumentation. In der Google Cloud -Konsole finden Sie unter Cloud Run eine Liste Ihrer aktiven Integrationsimplementierungen.

OAuth-Client erstellen

Folgen Sie der Anleitung in der Genesys Cloud-Dokumentation, um einen neuen OAuth-Client (Token Implicit Grant) zu erstellen.
Der Grant-Typ muss Implicit Grant (Browser) sein.
Fügen Sie die URL Ihrer Anwendung im Abschnitt Autorisierte Weiterleitungs-URIs hinzu.
Aktualisieren Sie die Gültigkeitsdauer des OAuth 2.0-Clienttokens auf 3.600 Sekunden. Dies entspricht dem JWT-Token für den Zugriff auf die Dialogflow API von 1 Stunde.
```
{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
```
Ersetzen Sie CONVERSATION_PROFILE_NAME durch den Namen des Unterhaltungsprofils, z. B. projects/your-project/locations/your-location/conversationProfiles/abc123.
Ersetzen Sie FEATURES durch eine durch Kommas getrennte Liste der Agent Assist-Funktionen, die in der Anwendung enthalten sein sollen. Fügen Sie nur Funktionen hinzu, die in Ihrem Unterhaltungsprofil konfiguriert sind. Genesys Cloud unterstützt die folgenden Funktionen

Beispiel-URL:

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

Umgebungsvariablen vervollständigen

Die Genesys Cloud-Anwendung verwendet die folgenden Umgebungsvariablen. Folgen Sie der Cloud Run-Anleitung, um die Umgebungsvariablen festzulegen.

OAUTH_CLIENT_ID: Genesys Cloud OAuth-Client-ID.
GENESYS_CLOUD_REGION: Genesys Cloud-Region. Beispiel: usw2.pure.cloud für die USA West(Oregon). Der Standardwert ist mypurecloud.com.
GENESYS_CLOUD_ENVIRONMENT: Genesys-Cloud-Umgebung. Der Standardwert ist prod.
PROXY_SERVER: Die URL des Agent Assist-Backend-Connectors.
APPLICATION_SERVER_URL: URL des UI-Anwendungsservers.
PROJECT_ID: Die Projekt-ID Ihres Google Cloud -Abos.
CONVERSATION_PROFILE: Das zu verwendende Unterhaltungsprofil. Dieser sollte mit dem Profil in der Weiterleitungs-URL des OAuth-Clients übereinstimmen.
FEATURES: Kommagetrennte Konstante für Agent Assist-Funktionen. Dieser muss mit den Funktionen in der Weiterleitungs-URL des OAuth-Clients übereinstimmen.
CHANNEL: Wählen Sie den Integrationstyp aus. Mögliche Werte sind „Sprache“ oder „Chat“.

Beispiel für eine .env-Datei:

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}

Wenn Sie einen OAuth-Client erstellen, stellt Genesys Cloud auch eine Client-ID bereit.

Führen Sie den Befehl zum Bereitstellen mit den aktualisierten Umgebungsvariablen aus.

    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

Der Genesys Cloud-Anwendungsserver muss in einem Google Cloud -Hostingdienst bereitgestellt werden. App Engine oder Cloud Run verwenden

Anwendungsserver herunterfahren

Löschen Sie den Cloud Run-Dienst.
Führen Sie in Ihrem lokalen Terminal den folgenden Befehl aus:
```
gcloud run services list
```
Wählen Sie die zuvor ausgewählte Zielplattform aus, um aktive Bereitstellungen aufzulisten.

Führen Sie dazu diesen Befehl aus:

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