Genesys Cloud-Anwendungsserver bereitstellen

Sie können einen Anwendungsserver einrichten, um Agent Assist-Vorschläge im Web in Genesys Cloud zu rendern.

Ziele

Die Genesys Cloud-Integration umfasst die folgenden Prozesse:

Back-End-Server für das UI-Modul bereitstellen, um die Dialogflow API aufzurufen, ein Authentifizierungstoken zu registrieren und Cloud Pub/Sub und Memorystore for Redis einzurichten.
Genesys Cloud-Anwendungsserver bereitstellen, um das Agent Assist-UI-Modul in Cloud Run zu rendern.
OAuth-Client erstellen.
Die Umgebungsvariablen vervollständigen.
Richten Sie das Interaktions-Widget in Genesys Cloud ein.
Agent Assist-Integration mit dem Interaktionswidget in Genesys Cloud konfigurieren.
Messenger in Genesys Cloud konfigurieren.
Web-Chat- und Messaging-Tools von Genesys Cloud verwenden, um die Integration zu testen.

Hinweis

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

Installieren Sie die Google Cloud CLI, falls Sie sie noch nicht konfiguriert haben.
Folgen Sie der Google Cloud Anleitung, um ein Dienstkonto zu erstellen und die Rolle „Dialogflow API Client“ zu weisen.
Wenden Sie sich an agent-assist-ui-modules-support@google.com, um Zugriff auf das Genesys Cloud-Repository zu erhalten.
Back-End für Agent Assist-UI-Module bereitstellen. Wenn Sie den Back-End-Server bereitstellen, geben Sie die Umgebungsvariable AUTH_OPTION als GenesysCloud an. Folgen Sie dabei der Bereitstellungsanleitung.

Genesys Cloud-Anwendungsserver mit der CLI 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
```
Ändern Sie im lokalen Terminal mit dem folgenden Code das aktive Verzeichnis in das Stammverzeichnis des Repositorys, in dem sich die Docker-Datei befindet, bevor Sie die Google Cloud CLI-Builds ausführen.
```
cd genesyscloud/frontend
```
Wenn Sie zur Eingabe eines Dienstnamens aufgefordert werden, drücken Sie die Eingabetaste , um den Standardwert zu akzeptieren.
Stellen Sie die Integration mit dem folgenden Befehl bereit. Ersetzen Sie PROJECT-ID durch die Projekt-ID Ihres Agenten Google Cloud , UI_MODULE_SERVICE_ACCOUNT durch die E-Mail-Adresse Ihres Dienstkontos 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 
```
Drücken Sie die Eingabetaste , um den Standarddienstnamen zu akzeptieren.

Weitere Informationen finden Sie in der Cloud Run-Dokumentation. In der Google Cloud Konsole können Sie unter Cloud Run eine Liste Ihrer aktiver Integrationsbereitstellungen aufrufen.

OAuth-Client erstellen

Folgen Sie der Anleitung in der Genesys Cloud-Dokumentation, um einen neuen OAuth-Client zu erstellen.
Der Grant-Typ muss Code Authorization / PKCE sein.
Fügen Sie die URL Ihrer Anwendung im Abschnitt Autorisierte Weiterleitungs-URIs hinzu.
Aktualisieren Sie die Dauer des OAuth 2.0-Clienttokens auf 3600 Sekunden. Dies entspricht der Standarddauer von 1 Stunde für das JWT-Token für den Zugriff auf die Dialogflow API. Wenn Sie eine benutzerdefinierte Dauer benötigen, aktualisieren Sie die Dauer des OAuth- und des JWT-Tokens entsprechend.
```
{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}
```
Ersetzen Sie {APPLICATION_SERVER_URL} durch die URL Ihres UI-Anwendungsservers.
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 die Anwendung aufgenommen werden sollen. Wichtig: Fügen Sie nur Funktionen hinzu, die in Ihrem Unterhaltungsprofil konfiguriert sind. Genesys Cloud unterstützt die folgenden Funktionen
Wenn Sie dem OAuth-Client Bereiche hinzufügen möchten, rufen Sie den Abschnitt Bereiche auf.
Wählen Sie die folgenden Bereiche aus: alerting, authorization, conversations, notifications, messaging und organization.

Beispiel-URL:

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

Wir empfehlen, die Pop-out-Authentifizierung für eingebettete iFrames zu aktivieren, um eine nahtlose Anmeldung zu ermöglichen.

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 „USA, West(Oregon)“. Der Standardwert ist mypurecloud.com.
GENESYS_CLOUD_ENVIRONMENT: Genesys Cloud-Umgebung. Der Standardwert ist prod.
PROXY_SERVER: Die URL des Back-End-Connectors von Agent Assist.
APPLICATION_SERVER_URL: URL des UI-Anwendungsservers.
PROJECT_ID: Ihre Google Cloud Projekt-ID.
CONVERSATION_PROFILE: Das zu verwendende Unterhaltungsprofil. Dies muss mit dem Profil in der Weiterleitungs-URL des OAuth-Clients übereinstimmen.
FEATURES: Durch Kommas getrennte Konstante für Agent Assist-Funktionen. Dies muss mit den Funktionen in der Weiterleitungs-URL des OAuth-Clients übereinstimmen.
CHANNEL: Wählen Sie den Integrationstyp aus. Der Wert kann „voice“ oder „chat“ sein.

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 Bereitstellungsbefehl mit 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_ENVIRONMENT=$GENESYS_CLOUD_ENVIRONMENT~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. Verwenden Sie App Engine oder Cloud Run.

Anwendungsserver herunterfahren

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

Führen Sie dazu diesen Befehl aus:

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

Haftungsausschluss für Preise

Wenn Sie die Genesys Cloud-Integration verwenden, fallen Kosten für den zugrunde liegenden Cloud Run-Dienst an.

Genesys Cloud-Anwendungsserver bereitstellen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.